netsgiro 1.0.0a1

File parsers for Nets AvtaleGiro and OCR Giro

File parsers for Nets AvtaleGiro and OCR Giro.

File format examples

The following is an example of an AvtaleGiro payment request file:

>>> data = open('tests/data/avtalegiro_payment_request.txt').read()
>>> print(data)
NY000010555555551000081000080800000000000000000000000000000000000000000000000000
NY210020000000000400008688888888888000000000000000000000000000000000000000000000
NY2121300000001170604           00000000000000100          008000011688373000000
NY2121310000001NAVN                                                        00000
NY212149000000140011 Gjelder Faktura: 168837  Dato: 19/03/0400000000000000000000
NY212149000000140012                  ForfallsDato: 17/06/0400000000000000000000
NY2121300000002170604           00000000000000100          008000021688389000000
NY2121310000002NAVN                                                        00000
NY212149000000240011 Gjelder Faktura: 168838  Dato: 19/03/0400000000000000000000
NY212149000000240012                  ForfallsDato: 17/06/0400000000000000000000
NY2121300000003170604           00000000000000100          008000031688395000000
NY2121310000003NAVN                                                        00000
NY2121300000004170604           00000000000000100          008000041688401000000
NY2121310000004NAVN                                                        00000
NY2121300000005170604           00000000000000100          008000051688416000000
NY2121310000005NAVN                                                        00000
NY212149000000540011 Gjelder Faktura: 168841  Dato: 19/03/0400000000000000000000
NY212149000000540012                  ForfallsDato: 17/06/0400000000000000000000
NY2102300000006170604           00000000000000100          008000061688422000000
NY2102310000006NAVN                                                        00000
NY210088000000060000002000000000000000600170604170604000000000000000000000000000
NY000089000000060000002200000000000000600170604000000000000000000000000000000000

The same file is used in the API examples below.

Low level API

netsgiro’s low level API parses OCR files into a list of records:

>>> import netsgiro
>>> netsgiro.get_records(data)
[TransmissionStart(service_code=<ServiceCode.NONE: 0>, record_type=<RecordType.TRANSMISSION_START: 10>, data_transmitter='55555555', transmission_number='1000081', data_recipient='00008080'),
AssignmentStart(service_code=<ServiceCode.AVTALEGIRO: 21>, record_type=<RecordType.ASSIGNMENT_START:20>, assignment_type=<AssignmentType.TRANSACTIONS: 0>, assignment_number='4000086', assignment_account='88888888888', agreement_id='000000000'),
TransactionAmountItem1(service_code=<ServiceCode.AVTALEGIRO: 21>, record_type=<RecordType.TRANSACTION_AMOUNT_ITEM_1: 30>, transaction_type=<TransactionType.PURCHASE_WITH_TEXT: 21>, transaction_number=1, nets_date=datetime.date(2004, 6, 17), amount=100, kid='008000011688373', centre_id=None, day_code=None, partial_settlement_number=None, partial_settlement_serial_number=None, sign=None),
TransactionAmountItem2(service_code=<ServiceCode.AVTALEGIRO: 21>, record_type=<RecordType.TRANSACTION_AMOUNT_ITEM_2: 31>, transaction_type=<TransactionType.PURCHASE_WITH_TEXT: 21>, transaction_number=1, reference=None, form_number=None, bank_date=None, debit_account=None, payer_name='NAVN'),
TransactionSpecification(service_code=<ServiceCode.AVTALEGIRO: 21>, record_type=<RecordType.TRANSACTION_SPECIFICATION: 49>, transaction_type=<TransactionType.PURCHASE_WITH_TEXT: 21>, transaction_number=1, line_number=1, column_number=1, text=' Gjelder Faktura: 168837  Dato: 19/03/04'),
TransactionSpecification(service_code=<ServiceCode.AVTALEGIRO: 21>, record_type=<RecordType.TRANSACTION_SPECIFICATION: 49>, transaction_type=<TransactionType.PURCHASE_WITH_TEXT: 21>, transaction_number=1, line_number=1, column_number=2, text='                  ForfallsDato: 17/06/04'),
TransactionAmountItem1(service_code=<ServiceCode.AVTALEGIRO: 21>, record_type=<RecordType.TRANSACTION_AMOUNT_ITEM_1: 30>, transaction_type=<TransactionType.PURCHASE_WITH_TEXT: 21>, transaction_number=2, nets_date=datetime.date(2004, 6, 17), amount=100, kid='008000021688389', centre_id=None, day_code=None, partial_settlement_number=None, partial_settlement_serial_number=None, sign=None),
TransactionAmountItem2(service_code=<ServiceCode.AVTALEGIRO: 21>, record_type=<RecordType.TRANSACTION_AMOUNT_ITEM_2: 31>, transaction_type=<TransactionType.PURCHASE_WITH_TEXT: 21>, transaction_number=2, reference=None, form_number=None, bank_date=None, debit_account=None, payer_name='NAVN'),
TransactionSpecification(service_code=<ServiceCode.AVTALEGIRO: 21>, record_type=<RecordType.TRANSACTION_SPECIFICATION: 49>, transaction_type=<TransactionType.PURCHASE_WITH_TEXT: 21>, transaction_number=2, line_number=1, column_number=1, text=' Gjelder Faktura: 168838  Dato: 19/03/04'),
TransactionSpecification(service_code=<ServiceCode.AVTALEGIRO: 21>, record_type=<RecordType.TRANSACTION_SPECIFICATION: 49>, transaction_type=<TransactionType.PURCHASE_WITH_TEXT: 21>, transaction_number=2, line_number=1, column_number=2, text='                  ForfallsDato: 17/06/04'),
TransactionAmountItem1(service_code=<ServiceCode.AVTALEGIRO: 21>, record_type=<RecordType.TRANSACTION_AMOUNT_ITEM_1: 30>, transaction_type=<TransactionType.PURCHASE_WITH_TEXT: 21>, transaction_number=3, nets_date=datetime.date(2004, 6, 17), amount=100, kid='008000031688395', centre_id=None, day_code=None, partial_settlement_number=None, partial_settlement_serial_number=None, sign=None),
TransactionAmountItem2(service_code=<ServiceCode.AVTALEGIRO: 21>, record_type=<RecordType.TRANSACTION_AMOUNT_ITEM_2: 31>, transaction_type=<TransactionType.PURCHASE_WITH_TEXT: 21>, transaction_number=3, reference=None, form_number=None, bank_date=None, debit_account=None, payer_name='NAVN'),
TransactionAmountItem1(service_code=<ServiceCode.AVTALEGIRO: 21>, record_type=<RecordType.TRANSACTION_AMOUNT_ITEM_1: 30>, transaction_type=<TransactionType.PURCHASE_WITH_TEXT: 21>, transaction_number=4, nets_date=datetime.date(2004, 6, 17), amount=100, kid='008000041688401', centre_id=None, day_code=None, partial_settlement_number=None, partial_settlement_serial_number=None, sign=None),
TransactionAmountItem2(service_code=<ServiceCode.AVTALEGIRO: 21>, record_type=<RecordType.TRANSACTION_AMOUNT_ITEM_2: 31>, transaction_type=<TransactionType.PURCHASE_WITH_TEXT: 21>, transaction_number=4, reference=None, form_number=None, bank_date=None, debit_account=None, payer_name='NAVN'),
TransactionAmountItem1(service_code=<ServiceCode.AVTALEGIRO: 21>, record_type=<RecordType.TRANSACTION_AMOUNT_ITEM_1: 30>, transaction_type=<TransactionType.PURCHASE_WITH_TEXT: 21>, transaction_number=5_date=datetime.date(2004, 6, 17), amount=100, kid='008000051688416', centre_id=None, day_code=None, partial_settlement_number=None, partial_settlement_serial_number=None, sign=None),
TransactionAmountItem2(service_code=<ServiceCode.AVTALEGIRO: 21>, record_type=<RecordType.TRANSACTION_AMOUNT_ITEM_2: 31>, transaction_type=<TransactionType.PURCHASE_WITH_TEXT: 21>, transaction_number=5, reference=None, form_number=None, bank_date=None, debit_account=None, payer_name='NAVN'),
TransactionSpecification(service_code=<ServiceCode.AVTALEGIRO: 21>, record_type=<RecordType.TRANSACTION_SPECIFICATION: 49>, transaction_type=<TransactionType.PURCHASE_WITH_TEXT: 21>, transaction_number=5, line_number=1, column_number=1, text=' Gjelder Faktura: 168841  Dato: 19/03/04'),
TransactionSpecification(service_code=<ServiceCode.AVTALEGIRO: 21>, record_type=<RecordType.TRANSACTION_SPECIFICATION: 49>, transaction_type=<TransactionType.PURCHASE_WITH_TEXT: 21>, transaction_number=5, line_number=1, column_number=2, text='                  ForfallsDato: 17/06/04'),
TransactionAmountItem1(service_code=<ServiceCode.AVTALEGIRO: 21>, record_type=<RecordType.TRANSACTION_AMOUNT_ITEM_1: 30>, transaction_type=<TransactionType.AVTALEGIRO_WITH_PAYEE_NOTIFICATION: 2>, transaction_number=6, nets_date=datetime.date(2004, 6, 17), amount=100, kid='008000061688422', centre_id=None, day_code=None, partial_settlement_number=None, partial_settlement_serial_number=None, sign=None),
TransactionAmountItem2(service_code=<ServiceCode.AVTALEGIRO: 21>, record_type=<RecordType.TRANSACTION_AMOUNT_ITEM_2: 31>, transaction_type=<TransactionType.AVTALEGIRO_WITH_PAYEE_NOTIFICATION: 2>, transaction_number=6, reference=None, form_number=None, bank_date=None, debit_account=None, payer_name='NAVN'),
AssignmentEnd(service_code=<ServiceCode.AVTALEGIRO: 21>, record_type=<RecordType.ASSIGNMENT_END: 88>, assignment_type=<AssignmentType.TRANSACTIONS: 0>, num_transactions=6, num_records=20, total_amount=600, nets_date=datetime.date(2004, 6, 17), nets_date_earliest=datetime.date(2004, 6, 17), nets_date_latest=None),
TransmissionEnd(service_code=<ServiceCode.NONE: 0>, record_type=<RecordType.TRANSMISSION_END: 89>, num_transactions=6, num_records=22, total_amount=600, nets_date=datetime.date(2004, 6, 17))]

High level API

netsgiro’s high level API parses OCR files into a tree of objects:

>>> import netsgiro
>>> transmission = netsgiro.parse(data)
>>> transmission.to_dict()
{'assignments': [{'account': '88888888888',
   'agreement_id': '000000000',
   'number': '4000086',
   'service_code': <ServiceCode.AVTALEGIRO: 21>,
   'transactions': [{'amount': Decimal('1'),
     'kid': '008000011688373',
     'nets_date': datetime.date(2004, 6, 17),
     'number': 1,
     'payer_name': 'NAVN',
     'reference': None,
     'service_code': <ServiceCode.AVTALEGIRO: 21>,
     'text': ' Gjelder Faktura: 168837  Dato: 19/03/04                  ForfallsDato: 17/06/04\n',
     'type': <TransactionType.PURCHASE_WITH_TEXT: 21>},
    {'amount': Decimal('1'),
     'kid': '008000021688389',
     'nets_date': datetime.date(2004, 6, 17),
     'number': 2,
     'payer_name': 'NAVN',
     'reference': None,
     'service_code': <ServiceCode.AVTALEGIRO: 21>,
     'text': ' Gjelder Faktura: 168838  Dato: 19/03/04                  ForfallsDato: 17/06/04\n',
     'type': <TransactionType.PURCHASE_WITH_TEXT: 21>},
    {'amount': Decimal('1'),
     'kid': '008000031688395',
     'nets_date': datetime.date(2004, 6, 17),
     'number': 3,
     'payer_name': 'NAVN',
     'reference': None,
     'service_code': <ServiceCode.AVTALEGIRO: 21>,
     'text': '',
     'type': <TransactionType.PURCHASE_WITH_TEXT: 21>},
    {'amount': Decimal('1'),
     'kid': '008000041688401',
     'nets_date': datetime.date(2004, 6, 17),
     'number': 4,
     'payer_name': 'NAVN',
     'reference': None,
     'service_code': <ServiceCode.AVTALEGIRO: 21>,
     'text': '',
     'type': <TransactionType.PURCHASE_WITH_TEXT: 21>},
    {'amount': Decimal('1'),
     'kid': '008000051688416',
     'nets_date': datetime.date(2004, 6, 17),
     'number': 5,
     'payer_name': 'NAVN',
     'reference': None,
     'service_code': <ServiceCode.AVTALEGIRO: 21>,
     'text': ' Gjelder Faktura: 168841  Dato: 19/03/04                  ForfallsDato: 17/06/04\n',
     'type': <TransactionType.PURCHASE_WITH_TEXT: 21>},
    {'amount': Decimal('1'),
     'kid': '008000061688422',
     'nets_date': datetime.date(2004, 6, 17),
     'number': 6,
     'payer_name': 'NAVN',
     'reference': None,
     'service_code': <ServiceCode.AVTALEGIRO: 21>,
     'text': '',
     'type': <TransactionType.AVTALEGIRO_WITH_PAYEE_NOTIFICATION: 2>}],
   'type': <AssignmentType.TRANSACTIONS: 0>}],
 'data_recipient': '00008080',
 'data_transmitter': '55555555',
 'nets_date': datetime.date(2004, 6, 17),
 'number': '1000081'}

License

Copyright 2017 Otovo AS.

Licensed under the Apache License, Version 2.0. See the LICENSE file.

Project resources

• Source code

• Issue tracker