> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://support.robaws.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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.

## Instellen van de DICO integratie

Via **instellingen > integraties > DICO** kan je de instellingen configureren die noodzakelijk zijn voor het gebruik van DICO.

1. Open de integratie via het overzicht van de integraties.
2. Maak één of meerdere "Endpoints" aan. Hiervoor klik je bovenaan de pagina op de actieknop **toevoegen**.
3. 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](https://support.robaws.com/nl/article/vervangingscodes-1he52l3/) en [extra velden](https://support.robaws.com/nl/article/extra-velden-graym9/) 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.instructionData.maintenanceLocation.complexNumber}
* ${DICO.instructionData.maintenanceLocation.premisesNumber}
* ${DICO.instructionData.maintenanceLocation.realEstateUnitNumber}
* ${DICO.instructionData.maintenanceLocation.yearOfConstruction}
* ${DICO.instructionData.maintenanceLocation.address}
* ${DICO.instructionData.maintenanceLocation.street}
* ${DICO.instructionData.maintenanceLocation.street2}
* ${DICO.instructionData.maintenanceLocation.zipcode}
* ${DICO.instructionData.maintenanceLocation.city}
* ${DICO.instructionData.maintenanceLocation.country}
* ${DICO.instructionData.maintenanceLocation.lng}
* ${DICO.instructionData.maintenanceLocation.lat}
* ${DICO.instructionData.appointmentDateTimeInformation.deliveryTimeFrame.deliveryDateEarliest}
* ${DICO.instructionData.appointmentDateTimeInformation.deliveryTimeFrame.deliveryDateLatest}
* ${DICO.instructionData.instructionNumber}
* ${DICO.instructionData.instructionSubNumber}
* ${DICO.instructionData.instructionDate}

**Vervangingscodes voor de contactgegevens van de partijen in het bericht:**

Een MaintenanceInstruction-bericht vermeldt drie partijen: **DICO.buyer**, **DICO.affiliate** en **DICO.contractor**. Voor elk van hen kan je de naam van de contactpersoon, het telefoonnummer en het e-mailadres op je ordertemplate plaatsen. Je gebruikt deze codes net als de andere: in een extra veld van het type 'tekst' of 'tekstveld' op de ordertemplate van het Endpoint.

* ${DICO.buyer.contactInformation.contactPersonName}
* ${DICO.buyer.contactInformation.phoneNumber}
* ${DICO.buyer.contactInformation.emailAddress}
* ${DICO.affiliate.contactInformation.contactPersonName}
* ${DICO.affiliate.contactInformation.phoneNumber}
* ${DICO.affiliate.contactInformation.emailAddress}
* ${DICO.contractor.contactInformation.contactPersonName}
* ${DICO.contractor.contactInformation.phoneNumber}
* ${DICO.contractor.contactInformation.emailAddress}

|| Heeft een partij meerdere contacten in het bericht, dan wordt telkens het eerste contact gebruikt. Zit de partij of haar contactinformatie niet in het bericht, dan blijft de vervangingscode leeg.

![Voorbeeld gebruik vervangingscode in extra veld in ordertemplate](https://storage.crisp.chat/users/helpdesk/website/eadf6dec760ec000/schermafbeelding-2025-02-14-om_1lsix41.png)

### Dico Endpoint - Uitgaand

Eenmaal je een DICO Endpoint met type 'uitgaand' aangemaakt hebt, zal je merken dat er een nieuwe actieknop verschijnt in de bestelbon die je voor de betreffende leverancier aanmaakt. 

![DICO koppeling met leverancier](https://storage.crisp.chat/users/helpdesk/website/eadf6dec760ec000/schermafbeelding-2023-12-07-om_1hm5grt.png)
Nadat je op deze actieknop klikt, krijg je nog een dialoog waar je het **afleveradres eventueel kan wijzigen**. Default wordt het adres van het bedrijf gebruikt als afleveradres, maar er is een mogelijkheid voorzien om hiervan af te wijken.
Nadat je op **'verzenden via webshop'** klikt, 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 controleert elk uur of er nieuwe berichten beschikbaar zijn en geeft die ook als notificatie weer. Deze berichten worden ook zichtbaar weergeven als "opmerking" in de betreffende bestelbon.

||| De melding gaat naar de verantwoordelijke van de bestelbon. Heeft de bestelbon geen verantwoordelijke, dan krijgen de beheerders ze.

![Voorbeeld van een notificatie](https://storage.crisp.chat/users/helpdesk/website/eadf6dec760ec000/voorbeeld-notificatie_1n3rpho.png)

## 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'

||| GLN-nummer moet verplicht ingevuld zijn!