Op ieder bij CB aangeboden Digicom bericht vindt een syntactische controle plaats. Het resultaat van deze syntactische controle wordt teruggekoppeld in de vorm van een ontvangstbevestigingsbericht. In dit document wordt de berichtdefinitie beschreven.
Het kan voorkomen dat een bij CB aangeboden Digicom dermate corrupt is dat er geen ontvangstbevestigingsbericht kan worden aangemaakt, ik dat geval zal er een xml error bestand worden aangeboden.
Digicom formaat
Het bericht is opgesteld in Digicom formaat.
Digicom
De berichten van digitale communicatie, Digicom, hebben als voornaamste kenmerk de gelaagde opbouw en de gebruikte veld identificatie (attributen). Gegevens worden gegroepeerd rondom de diverse transactiegegevens. Op deze wijze wordt de informatie in een logische combinatie gepresenteerd en worden zo min mogelijk gegevens herhaald. Verder is er sprake van een opbouw die controle op compleetheid en uniekheid van het bericht mogelijk maakt door middel van een header, footer en unieke berichtidentificatie.
Tekenset
De tekenset is ISO 8859-1.
Veld identificatie - CB-id
In de berichten worden de attributen gespecificeerd door middel van attribuut nummers (4-cijferig). Ter herkenning wordt ieder attribuutnummer (CB-id) vooraf gegaan door een #. Dit teken kan of zal op geen enkele andere wijze in het bericht worden gebruikt.
Veld met decimale scheiding
In velden met een decimale scheiding (bij valuta en korting) wordt als scheiding een punt gebruikt.
Verplicht of Optioneel
In de berichtdefinitie is aangegeven of een veld Verplicht of Optioneel is, dit wordt aangeduid door opname van een V of O in kolom V/O.
Format
In de berichtdefinitie is aangegeven wat het format van een veld is, dit wordt als volgt aangeduid:
Mogelijke waarde | Toelichting |
---|---|
N | Numeriek |
AN | Alfanumeriek |
Algemene informatie FTP account
Berichttype, bestandsnaam en extensie
Berichttype | ONTBEV |
Bestandsnaam | prefix relatie nummer u 4-cijferige codering datum notatie yyyymmdd |
Extensie | .ont (kleine letters) |
Berichtdefinitie
Header informatie Partij specificatie afzender Partij specificatie ontvanger Transactiegegevens Foutmeldingsregels Footer informatie
Headerinformatie (verplicht) | ||||||
---|---|---|---|---|---|---|
CB-id | Attribuut naam | V/O | Format | Maximale veldlengte | Standaard waarde | Toelichting |
0001 | Record_type | V | N | 1 | 0 | Recordtype |
0002 | Bericht_type | V | AN | 6 | ONTBEV | Berichttype |
0003 | Versie_nr | V | AN | 5 | 9908A | Versie van het bericht |
0004 | Verzend_dat | V | N | 8 | yyyymmdd | Datum van verzenden |
0005 | Verzend_tijd | V | N | 4 | uu24mm | Tijdstip van verzenden |
0006 | Bericht_referentie | V | N | 14 | Unieke identificatie van bericht. Waarde in header en footer dient identiek te zijn. | |
0007 | Acknowledgement_ind | V | N | 1 | 0 | Verzendbevestiging t.b.v. controle CB |
0008 | Test_ind | V | N | 1 | 0 | Geeft aan of het om een testbericht gaat, altijd waarde 0. Testen wordt niet op de productieomgeving gedaan. |
Partijspecificatie - Bij communicatie betrokken partijen (verplicht) | ||||||
CB-id | Attribuut naam | V/O | Format | Maximale veldlengte | Standaard waarde | Toelichting |
0001 | Record_type | V | N | 1 | 1 | Recordtype |
0009 | Partij_type | V | AN | 4 | AFZ | De afzender van het bericht |
0010 | Partij_id | V | N | 13 | 8894126 | Het relatie id wat bij CB is vastgelegd |
0011 | Partij_id_type | V | AN | 3 | CB | Het type van de betrokken partij |
CB-id | Attribuut naam | V/O | Format | Maximale veldlengte | Standaard waarde | Toelichting |
0001 | Record_type | V | N | 1 | 1 | Recordtype |
0009 | Partij_type | V | AN | 4 | ONTV | De ontvanger van het bericht |
0010 | Partij_id | V | N | 13 | Het relatie id wat bij CB is vastgelegd | |
0011 | Partij_id_type | V | AN | 3 | CB | Het type van de betrokken partij |
Transactiegegevens (verplicht) | ||||||
CB-id | Attribuut naam | V/O | Format | Maximale veldlengte | Standaard waarde | Toelichting |
0001 | Record_type | V | N | 1 | 2 | Recordtype |
0002 | Bericht_type | V | AN | 6 | Berichttype | |
0003 | Versie_nr | V | N | 5 | Versie van het bericht | |
0006 | Bericht_referentie | V | AN | 14 | Unieke identificatie van bericht van het bij CB aangeboden bericht. | |
0021 | Bericht_nr | V | N | 10 | Uniek nummer waaronder het bericht bij CB is geregistreerd. | |
0022 | Ontvangst_dat | V | N | 8 | yyyymmdd | Datum van ontvangst |
0023 | Ontvangst_tijd | V | N | 4 | uu24mm | Tijdstip van ontvangst |
Foutmeldingen (optioneel, alleen opgenomen als er fouten te melden zijn) | ||||||
CB-id | Attribuut naam | V/O | Format | Maximale veldlengte | Standaard waarde | Toelichting |
0001 | Berichtregel | O | N | 1 | 3 | Recordtype |
0024 | Berichtregel | O/V | N | 5 | De regel, het recordtype waar de foutmelding betrekking op heeft. | |
0025 | Text | O/V | AN | 32767 | De foutmeldingstekst. | |
Footerinformatie (verplicht) | ||||||
CB-id | Attribuut naam | V/O | Format | Maximale veldlengte | Standaard waarde | Toelichting |
0001 | Record_type | V | N | 1 | 9 | Recordtype |
0015 | Aant_detail_2 | V | N | 6 | Totaal aantal regels van recordtype 2 in dit bericht | |
0016 | Aant_detail_3 | V | N | 6 | Totaal aantal regels van recordtype 3 in dit bericht | |
0006 | Bericht_referentie | V | AN | 14 | Unieke identificatie van bericht. Waarde in header en footer dient identiek te zijn. |
Voorbeelden van een ONTBEV bericht met foutmeldingen
Voorbeeld van een ONTBEV bericht zonder foutmelding