Hoe werkt de DICO integratie?
De DICO Standaard is een set afspraken die spelregels biedt voor de elektronische uitwisseling van informatie tussen fabrikanten, groothandels, bouw-, onderhouds- en installatiebedrijven en woningcorporaties. Deze toepassing is enkel voor Nederland.
Via instellingen > integraties > DICO kan je de instellingen configureren die noodzakelijk zijn voor het gebruik van DICO.
Open de integratie via het overzicht van de integraties.
Maak één of meerdere "Endpoints" aan. Hiervoor klik je op het +-icoontje dat bovenaan de pagina weergegeven wordt.
Vul vervolgens de betreffende gegevens in om het DICO Endpoint operationeel te maken. Aan een 'Endpoint' kan je gerust meerdere leveranciers toewijzen waarop de instellingen van toepassing zijn.
Eenmaal je een DICO Endpoint met type 'binnenkomend' aangemaakt hebt, zal een bericht, met type MaintenanceInstruction, die binnenkomt via het ingestelde Endpoint in Robaws omgezet worden in een order. Hierbij kan alle informatie van dit Endpoint verwerkt worden in het order, volgens de ordertemplate die je aanmaakt bij het instellen van het Endpoint.
Volgende informatie wordt overgenomen:
Alle info die we in de standaard velden van Robaws kunnen plaatsen, worden daarin verwerkt.
Bijkomende informatie waarvoor geen standaard veld is, kan verwerkt worden door gebruik te maken van vervangingscodes en extra velden met het type 'tekst' of 'tekstveld' die je instelt op de order template bij het configureren van het Endpoint.
Vervangingscodes die gebruikt kunnen worden voor MaintenanceInstruction berichten:
${DICO.instructionData.instructionInformation.instructionType}
${DICO.instructionData.instructionInformation.instructionAgreementMethod}
${DICO.instructionData.instructionInformation.instructionTypeSpecification}
${DICO.instructionData.contractReference.contractNumber}
${DICO.instructionData.contractReference.contractDate}
${DICO.instructionData.appointmentDateTimeInformation.requiredDeliveryDate}
${DICO.instructionData.appointmentDateTimeInformation.requiredDeliveryTime}
${DICO.instructionData.maintenanceLocation.contactPersonName}
${DICO.instructionData.maintenanceLocation.phoneNumber1}
${DICO.instructionData.maintenanceLocation.phoneNumber2}
${DICO.instructionData.maintenanceLocation.emailAddress1}
${DICO.instructionData.maintenanceLocation.emailAddress2}

Eenmaal je een DICO Endpoint met type 'uitgaand' aangemaakt hebt, zal je merken dat een nieuw icoontje zal verschijnen in de bestelbon die je voor de betreffende leverancier aanmaakt.

Klik je op dit icoontje, dan wordt er een actie ondernomen waarbij een verzoek verstuurd wordt naar de DICO endpoint.
Voorafgaand aan deze actie is het belangrijk om volgende zaken in te stellen:
GLN-nummer van het bedrijf
GLN-nummer van de leverancier
GTIN-nummer van het artikel
Eenmaal je een DICO actie hebt uitgevoerd, wordt deze actie verwerkt door het DICO endpoint. Een orderbevestiging zal vervolgens als notificatie weergegeven worden in Robaws. Robaws zal elke 5 minuten controleren of er nieuwe berichten beschikbaar worden en deze ook als notificatie weergeven. Deze berichten worden ook zichtbaar weergeven als "opmerking" in de betreffende bestelbon.
De meldingen zijn enkel zichtbaar voor de gebruiker die de bestelbon heeft opgemaakt en de beheerders.

GLN-nummer van leverancier: leveranciersfiche > financieel > 'Global Location Number (GLN)
GLN-nummer van bedrijf: instellingen > algemeen > bedrijf > open juiste bedrijf > 'Global Location Number (GLN)'
GTIN-nummer van artikel: artikelfiche > vul het GTIN-nummer in in het veld 'Artikel Nr'
Instellen van de DICO integratie
Via instellingen > integraties > DICO kan je de instellingen configureren die noodzakelijk zijn voor het gebruik van DICO.
Open de integratie via het overzicht van de integraties.
Maak één of meerdere "Endpoints" aan. Hiervoor klik je op het +-icoontje dat bovenaan de pagina weergegeven wordt.
Vul vervolgens de betreffende gegevens in om het DICO Endpoint operationeel te maken. Aan een 'Endpoint' kan je gerust meerdere leveranciers toewijzen waarop de instellingen van toepassing zijn.
Gebruik
DICO - Binnenkomend
Eenmaal je een DICO Endpoint met type 'binnenkomend' aangemaakt hebt, zal een bericht, met type MaintenanceInstruction, die binnenkomt via het ingestelde Endpoint in Robaws omgezet worden in een order. Hierbij kan alle informatie van dit Endpoint verwerkt worden in het order, volgens de ordertemplate die je aanmaakt bij het instellen van het Endpoint.
Volgende informatie wordt overgenomen:
Alle info die we in de standaard velden van Robaws kunnen plaatsen, worden daarin verwerkt.
Bijkomende informatie waarvoor geen standaard veld is, kan verwerkt worden door gebruik te maken van vervangingscodes en extra velden met het type 'tekst' of 'tekstveld' die je instelt op de order template bij het configureren van het Endpoint.
Vervangingscodes die gebruikt kunnen worden voor MaintenanceInstruction berichten:
${DICO.instructionData.instructionInformation.instructionType}
${DICO.instructionData.instructionInformation.instructionAgreementMethod}
${DICO.instructionData.instructionInformation.instructionTypeSpecification}
${DICO.instructionData.contractReference.contractNumber}
${DICO.instructionData.contractReference.contractDate}
${DICO.instructionData.appointmentDateTimeInformation.requiredDeliveryDate}
${DICO.instructionData.appointmentDateTimeInformation.requiredDeliveryTime}
${DICO.instructionData.maintenanceLocation.contactPersonName}
${DICO.instructionData.maintenanceLocation.phoneNumber1}
${DICO.instructionData.maintenanceLocation.phoneNumber2}
${DICO.instructionData.maintenanceLocation.emailAddress1}
${DICO.instructionData.maintenanceLocation.emailAddress2}

Dico Endpoint - Uitgaand
Eenmaal je een DICO Endpoint met type 'uitgaand' aangemaakt hebt, zal je merken dat een nieuw icoontje zal verschijnen in de bestelbon die je voor de betreffende leverancier aanmaakt.

Klik je op dit icoontje, dan wordt er een actie ondernomen waarbij een verzoek verstuurd wordt naar de DICO endpoint.
Voorafgaand aan deze actie is het belangrijk om volgende zaken in te stellen:
GLN-nummer van het bedrijf
GLN-nummer van de leverancier
GTIN-nummer van het artikel
Eenmaal je een DICO actie hebt uitgevoerd, wordt deze actie verwerkt door het DICO endpoint. Een orderbevestiging zal vervolgens als notificatie weergegeven worden in Robaws. Robaws zal elke 5 minuten controleren of er nieuwe berichten beschikbaar worden en deze ook als notificatie weergeven. Deze berichten worden ook zichtbaar weergeven als "opmerking" in de betreffende bestelbon.
De meldingen zijn enkel zichtbaar voor de gebruiker die de bestelbon heeft opgemaakt en de beheerders.

Instellen van het GLN- en GTIN nummer
GLN-nummer van leverancier: leveranciersfiche > financieel > 'Global Location Number (GLN)
GLN-nummer van bedrijf: instellingen > algemeen > bedrijf > open juiste bedrijf > 'Global Location Number (GLN)'
GTIN-nummer van artikel: artikelfiche > vul het GTIN-nummer in in het veld 'Artikel Nr'
Bijgewerkt op: 14/02/2025
Dankuwel!