Wijzigingshistorie

Datum

Onderdeel

Wijziging

Jul 5, 2023

record 0015 Relatieindelingen

Op 12 augustus wordt het BRIN voor onderwijsinstellingen toegevoegd.

Daartoe worden de velden als volgt gevuld:

0129 BR
0130 BRIN
0138 BRIN

Voorbeeld School met BRIN

#00012#00206#01006726571#0101Basisschool De Helmstok#01060320 255 280#019065566
#00013#0120AFG#0121Volkerakstraat#012230#01248226 GS#0125LELYSTAD#0127NL
#00013#0120COR#0121Volkerakstraat#012230#01248226 GS#0125LELYSTAD#0127NL
#00013#0120FKT#0121Volkerakstraat#012230#01248226 GS#0125LELYSTAD#0127NL
#00013#0120VST#0121Volkerakstraat#012230#01248226 GS#0125LELYSTAD#0127NL
#00015#0129BC#01308010#0138Basisonderwijs NL#013120230704
#00015#0129DV#0130BTI#0138Business to Institutions#013120230706
#00015#0129BR#013006RU00#013806RU00#013120230615

- 1.1 Voorbeeld School met BRIN
2 Algemene info
3 Berichtdefinitie
- - 3.1.1 Opzet van het Relatie bericht
- 3.2 Voorbeeld bericht

Zoekadvies

Zoeken kan het best vanuit de inhoudsopgave op hoofd- en sub-pagina of door gebruik te maken van de functietoets F3 of CTRL + F op de betreffende pagina en niet het zoekveld rechts bovenaan in het CB Wiki scherm (zie onderstaande schermprint). Het document is opgebouwd uit diverse componenten, bij zoeken via het zoekveld wordt er gezocht in de componenten database en verlaat u het document en daarmee ook het overzicht op de structuur van de gebruikershandleiding en berichtdefinitie.

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 jaar heeft geleverd, berichttype REL_IK
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. REL_MA

Niet alle relaties in het initiële relatie 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:

Klik hier voor overzicht met opdrachtypes

CLADM

LRAMSJ

FCONS

FKLDEP

FOO

FRL

FRR

LADM

LNORM

LPROM

LNAFN

LTHUIS

LEBOEK

LEPROM

Unable to render {include} The included page could not be found.

FCTG

FCTGC

LABOMF

LNEIMF

LGEENF

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.

https://userguidescb.atlassian.net/wiki/x/BQCBBQ

Bestanden worden uitgewisseld middels het FTP(S) protocol, poort 21. Versleuteling van de berichten op basis van het protocol ftp(e)s (FTP over SSL) is verplicht.
CB ondersteunt op dit moment enkel TLS 1.2, data channels zijn gelimiteerd tot poortrange 41000:42000. Om gebruik te maken van versleuteld ftp, dient de gebruikte ftp cliënt software dit wel te ondersteunen.

Webservices en websites zijn secure zodra daar vertrouwelijke gegevens over gaan.

Wanneer er gebruik gemaakt wordt van communicatie via FTP wordt er een ftp account op de ftp1.boekhuis.nl server van CB aangemaakt. Via dit account kunnen de bestanden voor CB geplaatst worden en zullen de gewenste bestanden door CB worden klaargezet. De inloggegevens worden toegestuurd na activeren van het account.

Kenmerken FTP account

Kenmerken FTP account
/Relatie id/	Home directory
	in/	map voor bestanden van Klant naar CB	Geplaatste bestanden worden door CB direct na binnenkomst verplaatst voor syntactische controle en verdere verwerking. Na plaatsen van het bestand is het niet toegestaan om deze nog te bewerken . Van geplaatste bestanden wordt automatische een ontvangstbevestiging geplaatst in de out map
	out/	map voor bestanden van CB naar Klant	Bestanden die gedownload of geopend worden zullen automatisch van de ftp server verwijderd worden. Bestanden die niet worden opgehaald, zal CB na enige tijd verwijderen
Aanmaken van directories en sub-directories is niet toegestaan.

Naamgeving bestand bestaat uit 2 delen, gedeelte voor en na de 'punt'

Naamgeving bestand bestaat uit 2 delen, gedeelte voor en na de 'punt'
voor de 'punt'	bestandsnaam
na de 'punt'	extensie
De bestandsnaam mag opgebouwd worden m.b.v. cijfers 0 t/m 9, de letters a t/m z (hoofdletters en/of kleine letters) en de speciale karakters “punt “ (.), dash (-) en underscore (_). Alle andere karakters zoals spatie, trema, &, <, >, {, } etc. zijn niet toegestaan. Voor de extensie is het gebruik van hoofdletters niet toegestaan.

Connectie met ftp server - Transfer mode

Connectie met ftp server - Transfer mode
Frequentie voor inloggen op de ftp server is maximaal 1 keer per 10 minuten. Aan het eind van iedere sessie dient er uitgelogd te worden. Parallelle inlogsessies voor hetzelfde bestand zijn niet toegestaan.
Transfer mode	Voor de verbinding dient gebruik gemaakt te worden van commando PASV (passive mode)
Binair	alle bestanden met de extensies '.epub', '.jpg', '.pdf' en '.zip'
ASCII	alle overige extensies

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

Opzet van het Relatie bericht

Header informatie
    Partij specificatie afzender
    Partij specificatie ontvanger
       Relatiegegevens
Footer informatie

Headerinformatie

Headerinformatie
CB-id	Attribuut naam	V/O	Format	Maximale veldlengte	Standaard waarde	Toelichting
0001	Record_type	V	N	1	0
		V	AN		REL_MA / REL_IK
		V	AN		0105A
		V	N
		V	N
		V	AN
		V	N		0
		V	N		0
Partijspecificatie - Bij communicatie betrokken partijen
CB-id	Attribuut naam	V/O	Format	Maximale veldlengte	Standaard waarde	Toelichting
		V	N		1
		V	AN		AFZ
		V	N
		V	AN		CB
CB-id	Attribuut naam	V/O	Format	Maximale veldlengte	Standaard waarde	Toelichting
		V	N		1
		V	AN		ONTV
		V	N
		V	A		CB
Relatie gegevens
CB-id	Attribuut naam	V/O	Format	Maximale veldlengte	Standaard waarde	Toelichting
		V	N		2
		V	N
		V	N
		V	AN
		O	AN
		O	AN
		O	N
		O	AN
		O	AN
		O	AN
		O	N
Adres Informatie Afgifte goederen adres
		V	N		3
		V	A
		O	AN
		V	N
		O	AN
		O	AN
		V	AN
		O	AN
		O	A
		O	AN
Adres Informatie Vestigingsadres
		V	N		3
		V	A
		O	AN
		V	N
		O	AN
		O	AN
		V	AN
		O	AN

Relatiegegevens voor eigenaren