Naar de inhoud
SyncMyShop

Branches

Koppelingen voor bouw en installatietechniek: ETIM-data, groothandelsprijzen en OCI

In de bouw en installatietechniek komt productdata geclassificeerd volgens ETIM uit een databank, staat een prijs als brutoprijs met een kortingsgroep in het artikelbestand en bestelt de installateur vanuit zijn eigen software. De koppeling zet die drie in je webshop zoals je klant ze gewend is: filters op kenmerken, zijn eigen nettoprijs en een order die in je ERP landt.

Wat deze branche anders maakt

Een technische groothandel verkoopt aan installateurs en bouwbedrijven die precies weten wat ze zoeken: een aardlekschakelaar met 4 polen, 40 ampère en 30 milliampère foutstroom. Ze zoeken op kenmerken, ze kopen tegen hun eigen nettoprijs en ze bestellen vaak vanuit hun eigen software. Vier dingen maken een koppeling in deze branche anders dan in een gewone webshop.

Wat Waarom het telt Wat de koppeling doet
Classificatie volgens ETIM klanten filteren op kenmerken, niet op omschrijving kenmerken omzetten naar filterbare attributen
Product en artikel apart één product, meerdere verpakkingen met elk een GTIN productlaag en artikellaag apart bijhouden
Bruto plus kortingsgroep de prijs in het bestand is niet de prijs van de klant nettoprijs per debiteur uitrekenen
Branchestandaarden voor berichten orders, pakbonnen en facturen gaan als DICO-bericht berichten vertalen naar het ERP en de webshop

Classificatie als toegangskaartje

ETIM begon in 1991 bij de Nederlandse elektrotechnische installateurs. In 1998 kwamen de installatiebedrijven voor verwarming en sanitair erbij, in 2014 de bouwmaterialen en in 2020 gereedschap en bouwbenodigdheden. In Nederland beheert Ketenstandaard Bouw en Techniek de standaard. Een ETIM-klasse legt vast welke kenmerken een product heeft. De aardlekschakelaar is klasse EC000003; in ETIM 10.0 heeft die 31 kenmerken, van EF001391 (aantal polen) tot EF002560 (type lekstroom). De opbouw van klassen, kenmerken en waarden staat in wat is ETIM.

Product of artikel

Ketenstandaard maakt een scherp onderscheid. Het product beschrijft wat iets is: productnummer, ETIM-klasse, technische kenmerken. Het artikel beschrijft hoe het verkocht wordt: artikelnummer, GTIN, prijs, verpakking en besteleenheid. Ketenstandaard geeft zelf het voorbeeld van een spijker: een zakje van 100, een doos van 1.000 en een pallet zijn drie artikelen met elk een eigen GTIN, bij één product.

Een ERP maakt die scheiding vaak niet. Ketenstandaard noemt SAP als voorbeeld: daar is een artikel één stamrecord met alternatieve eenheden, wat in de branchetaal het product is. Wie de verpakkingen als losse artikelen inleest, verliest de samenhang met het product; wie het ERP-artikel als één handelsartikel doorgeeft, mist de verpakkingsniveaus. De koppeling legt per artikel vast bij welk product het hoort, zodat de webshop één productpagina toont met de verpakkingen als keuze.

Systemen

Systeem Rol Hoe de data binnenkomt
2BA databank van de installatiebranche, sinds 2004 download per selectieprofiel, volledig of mutaties; REST-webservices met OAuth2
EZ-base productdata van leveranciers aan groothandels afspraak per klant; geen publieke API-documentatie
AFAS, Exact Online, Business Central, Kerridge ERP met prijzen, condities, voorraad en orders API of GetConnector, per pakket
Webshop catalogus, filters, ingelogde klant API van het platform

2BA is in handen van de branche zelf. Volgens 2BA is meer dan 90% van de installatiegroothandel als aandeelhouder vertegenwoordigd, via de brancheorganisaties voor de elektrotechnische groothandel en de groothandel in sanitair en verwarming. Een groothandel haalt er de productgegevens van fabrikanten op en zet er zijn eigen handelsgegevens in. De webservices zijn volgens 2BA niet bedoeld voor bulkdownloads. Een assortiment van 40.000 artikelen komt daarom als bestand binnen; daarna gaan alleen de mutaties over. Bij 3% wijzigingen per week zijn dat 1.200 artikelen per week in plaats van 40.000.

2BA ondersteunt deze formaten (bekeken op 3 oktober 2026):

Formaat Basis Opmerking van 2BA
DICO SALES005 XML wordt niet meer doorontwikkeld
ETIM xChange 2.0 JSON alleen import
ETIM xChange 1.0 en 1.1 JSON import en export
BMEcat 2005, ETIM-richtlijn 5.0 XML import en export

ETIM International bracht xChange 2.0 uit op 27 november 2025, met onder meer velden voor milieugegevens en verpakkingsmateriaal. 2BA neemt 2.0 aan van leveranciers maar exporteert nog in 1.0 en 1.1, SALES005 en BMEcat. De koppeling leest het formaat dat jouw selectieprofiel levert; een overstap naar een ander formaat is een wijziging in de mapping, niet in de rest van de koppeling.

Tekencodering

De database van 2BA gebruikt de tekenset Latin-1 (ISO 8859-1), en exports zijn standaard ook Latin-1. Een webshop verwacht UTF-8. Leest de koppeling een Latin-1-bestand als UTF-8, dan wordt de ï in "geïsoleerd" een vervangingsteken en staat er "ge�soleerd" in de producttitel. De koppeling zet de codering om bij het inlezen. Zie tekencodering en UTF-8.

Standaarden

ETIM en GS1

ETIM 10.0 is van december 2024. ETIM 11.0 staat gepland voor 1 december 2026. Een nieuwe release verandert kenmerken van klassen: EC000003 heeft in ETIM 10.0 31 kenmerken en in de dynamische release 32, omdat EF005520 (aandraaimoment in Nm) erbij is gekomen. De koppeling mapt op codes en toont een kenmerk dat erbij komt in de diff van de run, voordat het een filter wordt.

GS1 levert de nummers waarmee artikelen en adressen worden herkend: de GTIN per verpakking en de GLN van 13 cijfers per vestiging of factuuradres. Wie deelnemer van DICO wordt, krijgt via Ketenstandaard één GLN. Zie wat is GS1 en GDSN en voor de mapping ETIM- en GS1-classificatie.

DICO

DICO is de berichtenstandaard van Ketenstandaard voor de bouw en techniek. Volgens Ketenstandaard gaat er dagelijks meer dan een miljoen keer informatie via DICO. Er zijn databerichten (product, artikel, condities, relaties tussen artikelen) en transactieberichten (offerte, order, orderbevestiging, pakbon, factuur). Berichten gaan over Messageservice 3.1, een webservice die er in een SOAP- en een REST-variant is. Meer in wat is DICO.

Prijzen: bruto, kortingsgroep en conditie

In het artikelbericht staat de brutoprijs. De korting die een klant krijgt, gaat apart in het conditiebericht: de leverancier geeft een groep artikelen een kortingscode, en per afnemer geldt een korting per code.

Van brutoprijs naar nettoprijs in de installatiebranche Een artikel heeft een brutoprijs uit het artikelbericht en een kortingsgroep. Het conditiebericht geeft per klant een korting per kortingsgroep. De koppeling rekent de nettoprijs uit: 58,40 euro min 32 procent is 39,71 euro. van bruto naar netto € 58,40 per stuk Brutoprijs Uit het artikelbericht, per prijseenheid K12 Kortingsgroep Code van de leverancier voor een groep artikelen debiteur 20417: K12 32% Conditie Korting per kortingsgroep voor deze klant 58,40 x 0,68 = € 39,71 Nettoprijs Wat de ingelogde installateur ziet
Een brutoprijs, een kortingsgroep en een conditie per klant leveren samen de nettoprijs op.

Een webshop toont een prijs per variant. De koppeling rekent daarom per ingelogde klant de nettoprijs uit: 58,40 x (1 - 0,32) = 39,712, afgerond € 39,71. Bij 600 debiteuren en 25 kortingsgroepen zijn dat 15.000 kortingsregels, die bij elke wijziging van een brutoprijs opnieuw tot nettoprijzen leiden. Een prijsverhoging per 1 januari op 20.000 artikelen raakt elke debiteur met korting op die artikelen. De koppeling zet zulke prijzen vooraf klaar met hun ingangsdatum en toont in een dry run de oude en nieuwe nettoprijs.

Twee afspraken passen niet in het conditiebericht. 2BA schrijft dat de standaard geen afspraken dekt over projectprijzen of over kortingen die afhangen van het afgenomen aantal of bedrag. Die komen uit het ERP als prijsafspraak of staffel, en de koppeling legt vast welke voorgaat. Hoe prijslagen elkaar opvolgen staat op prijzen en klantafspraken.

De stromen die het meeste werk schelen

  • Productdata van databank naar webshop. Klasse, kenmerken en GTIN uit 2BA of EZ-base, gekoppeld aan je eigen artikelnummer. Een artikel zonder match op GTIN of leveranciersartikelnummer gaat naar een controlelijst. Zie productdata.
  • Nettoprijzen per debiteur. Bruto, kortingsgroep en conditie uit het ERP, uitgerekend per klant.
  • Bestellen vanuit het inkoopsysteem. AFAS heeft OCI-koppelingen met 68 leveranciers op zijn lijst, waaronder Technische Unie; 12 staan als technische groothandel vermeld. Zie OCI en PunchOut.
  • Orders, pakbonnen en facturen als bericht. De order komt binnen, de orderbevestiging, pakbon en factuur gaan terug, zodat de installateur ze automatisch tegen zijn order controleert.

De systemen en eenheden die je met de algemene groothandel deelt, zoals een prijs per 1.000 meter bij een haspel van 500 meter, staan op groothandel en distributie. Wij bouwen de koppeling op jouw databank, jouw ERP en jouw webshop en hosten en bewaken hem daarna, met een log en een diff per run. Vertel uit welke databank je productdata komt en welk ERP je gebruikt.

Veelgestelde vragen

Moeten onze artikelen ETIM-geclassificeerd zijn om ze online te verkopen?

Nee, maar je klanten zoeken en filteren erop. Een installateur die een aardlekschakelaar zoekt, filtert op aantal polen, nominale stroom en type lekstroom. Die kenmerken staan in de ETIM-klasse EC000003. Komt de productdata al geclassificeerd uit 2BA of EZ-base, dan zet de koppeling de kenmerken om naar filters in je webshop. Zie wat is ETIM.

Kan de koppeling de productdata rechtstreeks uit 2BA halen?

Ja. 2BA levert per selectieprofiel een periodieke download, volledig of alleen de mutaties, in DICO SALES005, ETIM xChange of BMEcat. Daarnaast heeft 2BA REST-webservices met OAuth2, maar die zijn volgens 2BA bedoeld om een beperkt aantal artikelen snel bij te werken en niet voor bulkdownloads. De koppeling gebruikt de download voor het assortiment en de webservice voor losse artikelen.

Hoe krijgt elke installateur zijn eigen nettoprijs te zien?

De koppeling haalt de brutoprijs en de kortingsgroep per artikel op en de korting per kortingsgroep per debiteur uit je ERP. Daaruit rekent hij de nettoprijs per klant uit. Projectprijzen en kortingen per afname-aantal vallen buiten het conditiebericht en komen apart uit het ERP. Zie klantspecifieke prijzen.

Kunnen installateurs bestellen vanuit hun eigen software?

Dat kan op twee manieren. Met OCI opent het inkoopsysteem van de klant je webshop en krijgt het winkelmandje terug, zie OCI en PunchOut. Met DICO stuurt de software van de installateur een orderbericht dat je ERP automatisch verwerkt, en krijgt hij een orderbevestiging, pakbon en factuur in hetzelfde formaat terug. Welke van de twee je klanten gebruiken, hangt af van hun pakket.

Wat is het verschil tussen een product en een artikel?

Ketenstandaard maakt dat onderscheid expliciet. Een product is wat iets is: de technische kenmerken en de ETIM-klasse. Een artikel is hoe het verkocht wordt: per stuk, per doos of per pallet, elk met een eigen GTIN, artikelnummer en prijs. Eén product heeft dus vaak meerdere artikelen, en de koppeling moet die twee lagen apart houden.

Vertel wat je nodig hebt

Vertel welke systemen je gebruikt en wat je wilt verbeteren. Je krijgt binnen één werkdag een persoonlijk antwoord. We helpen je de werkzaamheden helder te krijgen en spreken de prijs en planning af voordat je iets toezegt.

  • Je weet de prijs en de doorlooptijd voordat je iets toezegt
  • Wij zoeken uit welke koppeling het werk uit handen neemt
  • Wij verzorgen de bouw, hosting, bewaking en het onderhoud
  • Je team krijgt minder overtypwerk en minder uitzoekwerk

Leveranciers, producten, orders per dag, een ruwe schatting is prima.

Of mail direct: carsten@syncmyshop.com