Wat is DICO?

DICO in het kort

DICO staat voor de afspraken waarmee software in de bouw en techniek berichten uitwisselt, ongeacht welk pakket de ontvanger gebruikt. Volgens Ketenstandaard gaat er dagelijks meer dan een miljoen keer informatie via DICO, en bijna alle softwareleveranciers in de sector ondersteunen het. De standaard heette eerder SALES (en daarvoor S@les in de bouw). De versie die nu in gebruik is, SALES005, verscheen in november 2018 als opvolger van INSBOU004, met ruim 130 wijzigingen.

Elk bedrijf en elke locatie staat in een DICO-bericht als GLN, een code van 13 cijfers. Ketenstandaard beheert namens GS1 de GLN's voor de Nederlandse bouw en techniek en zet ze in een adresregister. Een order hoeft dus geen adres te bevatten: de GLN van het afleveradres is genoeg. Hoe GS1-codes werken staat in wat is GS1 en GDSN.

Welke berichten zijn er?

Ketenstandaard verdeelt de berichten in vier groepen.

Twee databerichten zijn voor een webshop het belangrijkst. Het artikelbericht bevat per artikel de omschrijving, levertijd, verpakking, omrekenfactoren naar andere eenheden, de brutoprijs en een deeplink. Het conditiebericht bevat de kortingen per klant. Zo kan een leverancier één artikelbestand voor iedereen publiceren met alleen brutoprijzen, en de prijsafspraken per afnemer apart sturen. Projectprijzen gaan in geen van beide; die worden apart vastgelegd.

Hoe ziet een DICO-bericht eruit?

Een DICO-bericht is XML volgens een XSD-schema van Ketenstandaard. 2BA publiceert in zijn documentatie de opbouw van de kop van een artikelbericht. Met eigen waarden:

<PriceCatalogue xmlns="http://www.ketenstandaard.nl/artikelbericht/SALES/005">
  <PriceCatalogueNumber>CAT-2026-10</PriceCatalogueNumber>
  <MessageDate>2026-10-01</MessageDate>
  <PriceChangeIndicator>false</PriceChangeIndicator>
  <Currency>EUR</Currency>
  <MutationCode>4</MutationCode>
  <Datapool><GLN>8712345000011</GLN></Datapool>
  <Grouping>
    <Supplier><GLN>8712345000028</GLN></Supplier>
    <!-- artikelregels -->
  </Grouping>
</PriceCatalogue>

Het veld dat de meeste schade kan doen, is MutationCode. Waarde 4 is een mutatiebestand: alleen wat er in staat, verandert. Waarde 9 is een volledig bestand: bij 2BA overschrijft dat alle records van die leverancier. Een product dat in een volledig bestand ontbreekt, krijgt de status 130, vervallen; een handelsrecord dat ontbreekt, wordt verwijderd. Een volledig bestand dat per ongeluk maar een deel van het assortiment bevat, haalt de rest dus uit de databank.

Rekenvoorbeeld: van brutoprijs naar factuurregel

Een artikel staat in het artikelbericht met een brutoprijs van € 124,00 per 100 stuks en kortingsgroep K12. In het conditiebericht staat voor deze installateur 32% korting op K12. Dan:

• netto per 100 stuks: 124,00 x (1 - 0,32) = € 84,32
• netto per stuk: 84,32 / 100 = € 0,8432
• factuur voor 200 geleverde stuks: 2 x 84,32 = € 168,64

De installateur controleert die € 168,64 automatisch tegen zijn eigen berekening. Rekent de leverancier per stuk met een afgeronde prijs van € 0,84, dan staat er € 168,00 op de factuur en valt de factuur met een verschil van € 0,64 uit de automatische controle. De prijsbasis, de verpakking en de besteleenheid heten bij Ketenstandaard samen de eenhedendriehoek; Ketenstandaard heeft er een rekentool voor gemaakt omdat de verhoudingsgetallen in de praktijk vaak verkeerd worden ingevuld. Zie eenheden en verpakkingen.

Hoe gaan DICO-berichten heen en weer?

Elk transactiebericht wordt gecontroleerd tegen het vorige. De orderbevestiging wordt automatisch gekoppeld aan de order, waarbij de leverancier emballage en transportkosten mag toevoegen. De pakbon bevestigt wat er echt is geleverd. De factuur komt als XML binnen en wordt gecontroleerd tegen de afgesproken prijs en de geleverde aantallen; een pdf mag mee voor wie de factuur wil zien, met vaste regels over hoe de twee naar elkaar verwijzen.

De berichten gaan over Messageservice 3.1, een webservice tussen twee partijen. Er is een SOAP-variant en sinds april 2021 een REST-variant; beide sturen complete DICO-berichten. De service kent vier functies: Get Available Message, Get Message, Delete Message en Post Message. Daarmee vervalt het leeghalen van een postbus of een FTP-map. Ketenstandaard biedt deelnemers een test-endpoint om de verbinding te controleren.

Waar gaat het mis?

Daarnaast exporteert 2BA standaard in Latin-1, terwijl een webshop UTF-8 verwacht. Een korte omschrijving heeft volgens 2BA bij voorkeur hooguit 70 tekens, de lange omschrijving 256. Per artikel zijn maximaal 100 prijzen mogelijk, inclusief toekomstprijzen met een StartDatePriceInformation. Meer over coderingsfouten in tekencodering en UTF-8.

DICO naast ETIM, GS1 en Peppol

Sinds 1 januari 2022 vragen grote bouwbedrijven, waaronder BAM, Heijmans en VolkerWessels, hun leveranciers om alleen nog facturen volgens SALES005 te sturen. Een leverancier aan die bouwers factureert dus in SALES005. Meer over de branche op bouw en installatietechniek.

Wat betekent dit voor je koppeling?

Een webshop of ERP spreekt geen DICO uit zichzelf. De koppeling vertaalt: artikel- en conditieberichten naar producten en nettoprijzen in je webshop, een DICO-order naar een verkooporder in je ERP, en je pakbon en factuur terug naar SALES005 met de juiste GLN's. Wij bouwen die vertaling op jouw ERP en jouw afnemers, met een controle op aantallen en bedragen voordat een bericht de deur uit gaat.

Daarna hosten en bewaken we hem: een bericht dat de ontvanger weigert, blijft met de foutmelding in het dashboard staan tot het is opgelost. Hoe dit in de bredere stroom van berichten past staat op EDI-koppeling, de productdata op productdata. Vertel met welke afnemers je DICO wilt uitwisselen.