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 dan zal er een error bestand worden aangeboden.
Inhoudsopgave
Algemene informatie FTP account
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 |
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 Foetmeldingsregels 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 | AN | 14 | Unieke identificatie van bericht. Waarde in header en footer dient identiek te zijn. | |
0007 | Acknowledgement_ind | V | N | 1 | 1 | 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 | inc | |
V | ||||||
0022 | V | 8 | yyyymmdd | |||
V | ||||||
Foutmeldingen | ||||||
CB-id | Attribuut naam | V/O | Format | Maximale veldlengte | Standaard waarde | Toelichting |
0001 | ||||||
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 | |
0017 | Aant_detail_4 | V | N | 6 | Totaal aantal regels van recordtype 4 in dit bericht | |
0018 | Aant_detail_5 | O | N | 6 | Totaal aantal regels van recordtype 5 in dit bericht | |
0019 | Aant_detail_6 | O | N | 6 | A | |
0006 | Bericht_referentie | V | AN | 14 | Unieke identificatie van bericht. Waarde in header en footer dient identiek te zijn. |
Meerdere orders voor consumenten in één OPDNAW
Orders voor verschillende consumenten kunnen met één OPDNAW bericht worden ingediend. Nadat de ordergegevens zijn opgenomen voor consument A in recordtype 2, 3, 4, 5 (optioneel) en 6 (optioneel), worden de set met deze recordtypen opgenomen voor consument B, vervolgens voor consument C.
Het OPDNAW bericht wordt afgesloten met de Footer informatie, recordtype 9. De Header informatie, recordtype 0 en de bij de communicatie betrokken partijen, recordtype 1, worden éénmaal opgenomen in het bericht.
Voorbeelden van een OPDNAW bericht
Overzicht met template tags
Tag | Omschrijving | Herkomst gegevens |
@01 | Fysiek doosnummer |
|
@02 | Nummer levereenheid |
|
@03 | Datum van afdrukken pakbon/factuur of de uitleverdatum bij een embargo titel |
|
@04 | Paginanummer |
|
@05 | Aantal pagina´s |
|
@06 | Naam van de afnemer (kort, maximaal 39 karakters) | OPDNAW 0151 |
@07 | Straat en huisnummer van de afnemer | OPDNAW 0152 |
@08 | Postcode en woonplaats van de afnemer (wanneer postcode en woonplaats minder dan 23 karakters bevatten, wordt @08 gevuld en is @09 leeg. Anders is @08 de postcode en @09 de woonplaats) | OPDNAW 0153 en 0154 |
@09 | Woonplaats van de afnemer (wanneer postcode en woonplaats minder dan 23 karakters bevatten, wordt @08 gevuld en is @09 leeg. Anders is @08 de postcode en @09 de woonplaats) | OPDNAW 0154 |
@10 | Eerste regel van NAW gegevens van afleveradres (maximaal 50 karakters, opmaak van het adres is volgens de vastgelegde gegevens in het CB systeem) | OPDNAW 0013, 0014, 0121 t/m 0127 en 0137 |
@11 | Tweede regel van NAW gegevens van afleveradres (maximaal 50 karakters, opmaak van het adres is volgens de vastgelegde gegevens in het CB systeem) |
|
@12 | Derde regel van NAW gegevens van afleveradres (maximaal 50 karakters, opmaak van het adres is volgens de vastgelegde gegevens in het CB systeem) |
|
@13 | Vierde regel van NAW gegevens van afleveradres (maximaal 50 karakters, opmaak van het adres is volgens de vastgelegde gegevens in het CB systeem) |
|
@14 | Vijfde regel van NAW gegevens van afleveradres (maximaal 50 karakters, opmaak van het adres is volgens de vastgelegde gegevens in het CB systeem) |
|
@15 | Zesde regel van NAW gegevens van afleveradres (maximaal 50 karakters, opmaak van het adres is volgens de vastgelegde gegevens in het CB systeem) |
|
@16 | Zevende regel van NAW gegevens van afleveradres (maximaal 50 karakters, opmaak van het adres is volgens de vastgelegde gegevens in het CB systeem) |
|
@20 | Eerste regel van bedrijfsgegevens webshop, bijv. Naam van de afnemer | OPDNAW 0141 t/m 0149 |
@21 | Tweede regel van bedrijfsgegevens webshop, bijv. Ter attentie van gegevens van de afnemer |
|
@22 | Derde regel van bedrijfsgegevens webshop, bijv. Straatnaam en huisnummer van de afnemer |
|
@23 | Vierde regel van bedrijfsgegevens webshop, bijv. Postcode en woonplaats van de afnemer |
|
@24 | Vijfde regel van bedrijfsgegevens webshop, bijv. Telefoonnummer van de afnemer |
|
@25 | Zesde regel van bedrijfsgegevens webshop, bijv. Faxnummer van de afnemer |
|
@26 | Zevende regel van bedrijfsgegevens webshop, bijv. KvK nummer van de afnemer |
|
@27 | Achtste regel van bedrijfsgegevens webshop, bijv. BTW nummer van de afnemer |
|
@28 | Negende regel van bedrijfsgegevens webshop, bijv. Bankrekeningnummer van de afnemer |
|
@29 | Koptekst boven de pakbon regels | OPDNAW 0475 KPR, waarde uit 0476 |
@30 | Artikelomschrijving |
|
@31 | Aantal exemplaren |
|
@32 | EAN/ISBN van de pakbonregel |
|
@33 | Deel van de stuksprijs van het artikel waarvoor een BTW-percentage geldt. Indien voor één artikel meerdere BTW-percentages gelden, komen er meerdere ‘prijsregels’ bij het betreffende artikel. Op ieder regel wordt het deel van de stuksprijs opgenomen waarvoor het percentage geldt met daarachter de stuksprijs. |
|
@34 | BTW percentage voor (een deel) van de stuksprijs |
|
@35 | Aantal exemplaren maal de stuksprijs |
|
@36 | Bruto prijs artikel |
|
@40 | “FACTUUR” indien prijsinformatie, anders “PAKBON” | Bevatten vaste waarde, afhankelijk of er prijsinformatie moet worden getoond. Waarde OPDNAW 0420 = ‘J’ |
@41 | “Prijs” wanneer de kolom Bruto prijs tonen = J is @41 “Netto” en @39 is “Prijs”, anders leeg |
|
@42 | “BTW%” indien prijsinformatie, anders leeg |
|
@43 | “Bedrag” indien prijsinformatie, anders leeg |
|
@44 | “BTW hoog” indien prijsinformatie, anders leeg |
|
@45 | “BTW laag” indien prijsinformatie, anders leeg |
|
@46 | “Totaal incl.BTW” indien prijsinformatie, anders leeg |
|
@50 | Totaal aantal exemplaren |
|
@51 | Totaal bruto bedrag, inclusief BTW |
|
@52 | Totaal BTW-bedrag voor het hoge BTW-tarief |
|
@53 | Totaal BTW-bedrag voor het lage BTW-tarief |
|
@54 | Betalingsomschrijving | OPDNAW 0475 BOM, waarde uit 0476 |
@61 | Eerste 8 posities van het betalingskenmerk | OPDNAW 0421 |
@62 | Laatste 8 posities van het betalingskenmerk | OPDNAW 0421 |
@63 | Hele euro’s van totaal bedrag |
|
@64 | Aantal eurocenten van totaal bedrag |
|
@71 | Bankrekening |
|
@72 | Naam van de eindafnemer |
|
@73 | Straat en huisnummer van de eindafnemer |
|
@74 | Postcode en woonplaats van de eindafnemer |
|
@75 | Rekeningnummer van de afnemer, zonder interpunctie |
|
@76 | Naam van de afnemer |
|
@77 | Straat en huisnummer van de afnemer |
|
@78 | Postcode en woonplaats van de afnemer |
|
@79 | Rekeningnummer van de afnemer, met interpunctie. Anders zonder interpunctie, wel of niet bankrekening (B) | OPDNAW 0136 |
@83 | Coderegel onderaan de acceptgiro ten behoeve van automatische verwerking door Interpay |
|
@84 | Eerste regel van de omschrijving bovenaan de acceptgiro |
|
@85 | Tweede regel van de omschrijving bovenaan de acceptgiro |
|
@86 | Betalingskenmerk opgedeeld in 4 maal 4 tekens |
|
@87 | Contractnummer op de acceptgiro (S498) |
|
@88 | Derde regel van de omschrijving bovenaan de acceptgiro |
|
@90 | Marketingregel 1 | OPDNAW 0475 MRK, waarde uit 0476 |
@91 | Marketingregel 2 | OPDNAW 0475 MRK, waarde uit 0476 |
@92 | Marketingregel 3 | OPDNAW 0475 MRK, waarde uit 0476 |
@93 | Marketingregel 4 | OPDNAW 0475 MRK, waarde uit 0476 |
@94 | Marketingregel 5 | OPDNAW 0475 MRK, waarde uit 0476 |
@95 | Barcode van de levereenheid |
|
@96 | Betalingsvoorwaarde regel 1 | OPDNAW 0475 BVW waarde uit 0476 |
@97 | Betalingsvoorwaarde regel 2 | OPDNAW 0475 BVW waarde uit 0476 |
@98 | Betalingsvoorwaarde regel 3 | OPDNAW 0475 BVW waarde uit 0476 |