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

# Comment fonctionne l'intégration DICO ?

Le **standard DICO** est un ensemble de conventions qui définit les règles de l'échange électronique d'informations entre les fabricants, grossistes, entreprises de construction, d'entretien et d'installation et sociétés de logement. Cette intégration n'est utilisable qu'aux Pays-Bas.

## Configurer l'intégration DICO

Via **paramètres > intégrations > DICO**, vous pouvez configurer les paramètres nécessaires à l'utilisation de DICO.

1. Ouvrez l'intégration via l'aperçu des intégrations.
2. Créez un ou plusieurs « Endpoints ». Pour cela, vous cliquez en haut de la page sur le bouton d'action **ajouter**.
3. Complétez ensuite les données concernées pour rendre le DICO Endpoint opérationnel. À un « Endpoint », vous pouvez sans problème attribuer plusieurs fournisseurs auxquels les paramètres s'appliquent.

## Utilisation

### DICO - Entrant

Une fois que vous avez créé un DICO Endpoint de type « entrant », un message de type MaintenanceInstruction, qui entre via l'Endpoint configuré, sera converti dans Robaws en une commande. Toutes les informations de cet Endpoint peuvent alors être traitées dans la commande, selon le modèle de commande que vous créez lors de la configuration de l'Endpoint. 

Les informations suivantes sont reprises :
* Toutes les infos que nous pouvons placer dans les champs standards de Robaws y sont traitées.
* Les informations supplémentaires pour lesquelles il n'y a pas de champ standard peuvent être traitées en utilisant des [codes de remplacement](https://support.robaws.com/fr/article/codes-de-remplacement-12ufrs5/) et des [champs supplémentaires](https://support.robaws.com/fr/article/comment-travailler-avec-les-champs-supplementaires-18057l1/) de type « texte » ou « champ de texte » que vous configurez sur le modèle de commande lors de la configuration de l'Endpoint.

**Codes de remplacement qui peuvent être utilisés pour les messages MaintenanceInstruction :**

* ${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}

**Codes de remplacement pour les coordonnées des parties mentionnées dans le message :**

Un message MaintenanceInstruction mentionne trois parties : **DICO.buyer**, **DICO.affiliate** et **DICO.contractor**. Pour chacune d'elles, vous pouvez placer le nom de la personne de contact, le numéro de téléphone et l'adresse e-mail sur votre modèle de commande. Vous utilisez ces codes comme les autres : dans un champ supplémentaire de type « texte » ou « champ de texte » sur le modèle de commande de l'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}

|| Si une partie comporte plusieurs contacts dans le message, c'est toujours le premier contact qui est utilisé. Si la partie ou ses coordonnées ne figurent pas dans le message, le code de remplacement reste vide.

![Exemple d'utilisation d'un code de remplacement dans un champ supplémentaire dans un modèle de commande](https://storage.crisp.chat/users/helpdesk/website/eadf6dec760ec000/schermafbeelding-2025-02-14-om_1lsix41.png)

### Dico Endpoint - Sortant

Une fois que vous avez créé un DICO Endpoint de type « sortant », vous remarquerez qu'un nouveau bouton d'action apparaîtra dans le bon de commande que vous créez pour le fournisseur concerné. 

![Liaison DICO avec le fournisseur](https://storage.crisp.chat/users/helpdesk/website/eadf6dec760ec000/schermafbeelding-2023-12-07-om_1hm5grt.png)
Après avoir cliqué sur ce bouton d'action, vous obtenez encore une boîte de dialogue où vous pouvez **éventuellement modifier l'adresse de livraison**. Par défaut, l'adresse de l'entreprise est utilisée comme adresse de livraison, mais une possibilité est prévue pour y déroger.
Après avoir cliqué sur **« Envoyer via boutique en ligne »**, une action est entreprise dans le cadre de laquelle une **requête est envoyée vers le DICO endpoint.**
Préalablement à cette action, il est important de configurer les éléments suivants :

* numéro GLN de l'entreprise
* numéro GLN du fournisseur
* numéro GTIN de l'article

Une fois que vous avez exécuté une action DICO, cette action est traitée par le DICO endpoint. Une confirmation de commande sera ensuite affichée comme notification dans Robaws. Robaws vérifiera chaque heure si de nouveaux messages sont disponibles et les affichera également comme notification. Ces messages sont aussi affichés de manière visible comme « remarque » dans le bon de commande concerné.

||| Les notifications sont uniquement visibles pour le responsable du bon de commande. Si le bon de commande n'a pas de responsable, ce sont les administrateurs qui reçoivent la notification.

![Exemple d'une notification](https://storage.crisp.chat/users/helpdesk/website/eadf6dec760ec000/voorbeeld-notificatie_1n3rpho.png)

## Configurer le numéro GLN et GTIN

* **Numéro GLN du fournisseur** : fiche fournisseur > financier > « Global location number (GLN) »
* **Numéro GLN de l'entreprise :** paramètres > général > entreprise > ouvrez l'entreprise appropriée > « Global location number (GLN) »
* **Numéro GTIN de l'article :** fiche article > complétez le numéro GTIN dans le champ « N° article »

||| Le numéro GLN doit obligatoirement être complété !