Algemene info
Het bericht wordt beschikbaar gesteld in Digicom formaat.
In dit document wordt het relatiebericht bericht beschreven. Het bericht geeft relatiegegevens van relaties waaraan geleverd is en gegevens van nieuw opgevoerde relaties zodat die gebruikt kunnen worden in orders.
Het Relatiebericht kent twee varianten,
- een initieel bericht wat alle relaties bevat waaraan de eigenaar de laatste 3 heeft geleverd
- een mutatie bericht wat enkel mutaties op bestaande relaties en nieuw opgevoerde relaties bevat, dit is niet eigenaar specifiek, dat wil zeggen dat het alle mutaties bevat ongeacht of de eigenaar heeft geleverd aan deze relatie.
Niet alle relaties waaraan geleverd is staan in het initiële relatie bericht (REL_IK bericht)
Niet alle relatie-id's waaraan geleverd wordt worden opgenomen in het initiële relatie bericht (REL_IK). In het REL_IK bericht staan relaties waarvoor er de afgelopen drie jaar een verkoop heeft plaatsgevonden. En onder verkoop verstaan we gefactureerde leveringen. Enige uitzondering is opdrachttype LGEENF. Ook relatie's die geleverd zijn met dit opdrachttype zijn terug te vinden.
Relaties met leveringen van één van onderstaande opdrachttypes worden opgenomen in het REL_IK bericht:
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 |
Levering van het bericht
Het bericht wordt dagelijks op vaste tijdstippen in de out map van het FTP account geplaatst. Het bestand heeft betrekking op de activiteiten die de voorgaande werkdag zijn uitgevoerd.
Berichttype, bestandsnaam en extensie
| Berichttype | REL_MA (mutaties) / REL_IK (initieel) |
| Bestandsnaam | prefix relatie nummer u 4-cijferige codering datum notatie yyyymmdd |
| Extensie | .rel (kleine letters) |
Berichtdefinitie
Header informatie
Partij specificatie afzender
Partij specificatie ontvanger
Relatiegegevens
Footer informatie
| Headerinformatie | ||||||
|---|---|---|---|---|---|---|
| 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 | REL_MA / REL_Ik | Berichttype |
0003 | Versie_nr | V | AN | 5 | 0105A | 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 | 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 | ||||||
| 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 | |
| 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 | A | 3 | CB | Het type van de betrokken partij |
| Relatie gegevens | ||||||
| CB-id | Attribuut naam | V/O | Format | Maximale veldlengte | Standaard waarde | Toelichting |
0001 | Record_type | V | N | 1 | 2 | Recordtype |
0020 | Berichtfunctie | V | N | 6 | 6 | Bevestigen (synchronisatie van relatie/artikel gegevens) |
0100 | Relatie_id | V | N | 7 | Relatie-id van het distributiepunt. Altijd het relatie-id van CB. | |
0101 | Relatie_nm | V | AN | 80 | De naam van de relatie | |
0102 | Rechtsvorm | O | AN | 5 | De rechtsvorm van de relatie, mits deze is vastgelegd | |
0103 | Btw_nr | O | AN | 20 | Het BTW nummer van de relatie, mits deze is vastgelegd | |
0104 | Opheffings_dat | O | N | 8 | yyyymmdd | Datum ingeval van een opgeheven/ beëindigde relatie |
0105 | Opheffings_reden | O | AN | 20 | De reden van opheffen/beeindigen van de relatie | |
0106 | Telefoon_nr | O | AN | 40 | Telefoonnummer, mits dit is vastgelegd | |
0107 | Fax_nr | O | AN | 40 | Faxnummer, mits dit is vastgelegd | |
0190 | Oud_Klant_Nr | O | N | 5 | Nummer bedoelt voor een intern proces bij CB | |
| Adres Informatie Afgifte goederen adres | ||||||
0001 | Record_type | V | N | 1 | 3 | Recordtype |
0120 | Adres_srt | V | A | 3 | AFG | Adrestypering voor Afgifte van goederen |
0121 | Straat_nm | O | AN | 43 | Straatnaam | |
0122 | Huis_nr | V | N | 6 | Huisnummer | |
0123 | Toevoeging | O | AN | 10 | Huisnummer toevoeging | |
0124 | Postcode | O | AN | 10 | Postcode | |
0125 | Woonplaats | V | AN | 40 | Woonplaats | |
0126 | Provincie | O | AN | 40 | Provincie | |
0127 | Land_kd | O | A | 2 | ISO Landcode | |
0128 | EAN_adres_kd | O | AN | 13 | EAN adrescode | |
| Adres Informatie Vestigingsadres | ||||||
0001 | Record_type | V | N | 1 | 3 | Recordtype |
0120 | Adres_srt | V | A | 3 | VST | Adrestypering voor Officiële identificatie/Vestigingsadres |
0121 | Straat_nm | O | AN | 43 | Straatnaam | |
0122 | Huis_nr | V | N | 6 | Huisnummer | |
0123 | Toevoeging | O | AN | 10 | Huisnummer toevoeging | |
0124 | Postcode | O | AN | 10 | Postcode | |
0125 | Woonplaats | V | AN | 40 | Woonplaats | |
0126 | Provincie | O | AN | 40 | Provincie | |
0127 | Land_kd | O | A | 2 | ISO Landcode | |
0128 | EAN_adres_kd | O | AN | 13 | EAN adrescode | |
| Adres Informatie Factuuradres | ||||||
0001 | Record_type | V | N | 1 | 3 | Recordtype |
0120 | Adres_srt | V | A | 3 | FKT | Adrestypering voor Facturering |
0121 | Straat_nm | O | AN | 43 | Straatnaam | |
0122 | Huis_nr | V | N | 6 | Huisnummer | |
0123 | Toevoeging | O | AN | 10 | Huisnummer toevoeging | |
0124 | Postcode | O | AN | 10 | Postcode | |
0125 | Woonplaats | V | AN | 40 | Woonplaats | |
0126 | Provincie | O | AN | 40 | Provincie | |
0127 | Land_kd | O | A | 2 | ISO Landcode | |
0128 | EAN_adres_kd | O | AN | 13 | EAN adrescode | |
| Adres Informatie Correspondentieadres | ||||||
0001 | Record_type | V | N | 1 | 3 | Recordtype |
0120 | Adres_srt | V | A | 3 | COR | Adrestypering voor Correspondentie |
0121 | Straat_nm | O | AN | 43 | Straatnaam | |
0122 | Huis_nr | V | N | 6 | Huisnummer | |
0123 | Toevoeging | O | AN | 10 | Huisnummer toevoeging | |
0124 | Postcode | O | AN | 10 | Postcode | |
0125 | Woonplaats | V | AN | 40 | Woonplaats | |
0126 | Provincie | O | AN | 40 | Provincie | |
0127 | Land_kd | O | A | 2 | ISO Landcode | |
0128 | EAN_adres_kd | O | AN | 13 | EAN adrescode | |
| Relatie indelingen Geeft informatie over de indeling waarbinnen de relatie is gecategoriseerd bij CB | ||||||
0001 | Record_type | V | N | 1 | 5 | Recordtype |
0129 | Indeling_type | V | A | 3 | BC BV C DH DV IC IKC UC | Branchecode Branchevereniging (samenwerkingsverband) Concern (samenwerkingsverband) Detailhandelsketen (samenwerkingsverband) Dienstverlening CB ISBN combinatie (samenwerkingsverband) Inkoopcombinatie (samenwerkingsverband) Uigeverscombinatie (samenwerkingsverband) |
0130 | Indeling_waarde | V | AN | 40 | Wanneer indeling_type een samenwerkingsverband is (zie domeinwaarden) => relatie-id van het samenwerkingsverband. In andere gevallen bevat het de waarde van een indeling | |
0138 | Indeling_toelichting | V | AN | 80 | Wanneer indeling_type een samenwerkingsverband is (zie domeinwaarden) => relatie-naam van het samenwerkingsverband. In andere gevallen bevat het de naam van een indeling | |
0131 | Indeling_ingang_dat | V | N | 8 | De ingangsdatum van de indeling code | |
0132 | Indeling_einde_dat | O | N | 8 | De einddatum van de indeling code | |
0133 | Indeling_extra_info | O | AN | 20 | Optioneel: Kan bijvoorbeeld het lidnummer zijn wanneer indeling_type een samenwerkingsverband is. | |
0134 | Indeling_rol | O | AN | 20 | Optioneel: Wanneer indeling_type een samenwerkingsverband is, bevat dit veld de 'rol' die de relatie daarin speelt. | |
| Stroomnummer(s) | ||||||
0001 | Record_type | V | N | 1 | 6 | Recordtype |
0160 | Stroom_nr | V | N | 2 | Stroomnummer van het relatie-id | |
0161 | TAV_stroom_nr | O | AN | 24 | De "ter attentie van" mits deze is opgenomen bij het stroomnummer. | |
| Footerinformatie | ||||||
| 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 | |
0006 | Bericht_referentie | V | AN | 14 | Unieke identificatie van bericht. Waarde in header en footer dient identiek te zijn. | |