Cet article est aussi disponible en :

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.

Robaws échange les messages DICO via SOAP, selon la version 3.1 de DICO. Avant de créer un Endpoint, vérifiez que votre partenaire prend en charge les messages dans cette version via SOAP.

Ouvrez l'intégration via l'aperçu des intégrations.
Créez un ou plusieurs « Endpoints ». Pour cela, vous cliquez en haut de la page sur le bouton d'action ajouter.
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 un ordre. Toutes les informations de cet Endpoint peuvent alors être traitées dans l'ordre, selon le modèle d'ordre 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 et des champs supplémentaires de type « texte » ou « champ de texte » que vous configurez sur le modèle d'ordre 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 d'ordre. Vous utilisez ces codes comme les autres : dans un champ supplémentaire de type « texte » ou « champ de texte » sur le modèle d'ordre 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 d'ordre

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

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

DICO - Factures d'achat

Une facture d'achat ou une note de crédit au format DICO entre via un DICO Endpoint ou via la Robawsbox avec le paramètre Traiter DICO. Si elle entre via un Endpoint, complétez sur cet Endpoint le Journal pour les factures entrantes et le Journal pour les notes de crédit entrantes. Si le journal manque, la facture n'est pas traitée et vous en recevez une notification.

Robaws reprend chaque ligne de facture du message comme ligne sur la facture d'achat. Si la facture contient en outre des suppléments pour l'ensemble de la facture, comme des frais de transport ou des frais administratifs, chaque supplément devient une ligne distincte, avec la quantité 1, le montant du supplément comme prix et le taux de TVA du supplément. La description provient du message, dans la langue de votre environnement.

Si le montant de TVA par taux sur la facture DICO diffère de la TVA que Robaws calcule sur les lignes, Robaws ajoute par taux de TVA une ligne Correction de la TVA avec cette différence, par ex. Correction de la TVA - 21.0%. Cela se produit lorsque votre fournisseur calcule la TVA sur le total plutôt que par ligne. Ainsi, le total de votre facture d'achat correspond à la facture reçue. Ne supprimez donc pas cette ligne.

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é !

Mis à jour le : 02/11/2026

Cet article a-t-il répondu à vos questions ?

Merci !