EZ-base koppeling met je webshop: ETIM-data als filters en specificaties

Wat is EZ-base en wie gebruikt het?

EZ-base noemt zichzelf een Data-as-a-Service-platform dat tussen leveranciers en de markt zit. Leveranciers leveren productdata aan in de vorm die ze hebben: de site noemt GS1, ETIM, Excel, PDF, eigen formaten en legacy-formaten. EZ-base valideert, classificeert en verrijkt die data en levert haar af bij groothandels en de systemen die erop draaien: ERP, PIM, e-commerce, marktplaatsen, BIM-platformen en HVAC-configuratoren.

Twee standaarden staan centraal: ETIM voor de classificatie van technische producten en GS1 voor de identificatie. Daarnaast zegt EZ-base voorbereid te zijn op de eisen uit het Digital Product Passport en de CSRD. De gebruikers zijn fabrikanten en leveranciers van technische producten aan de ene kant en technische groothandels aan de andere. Klanten loggen in op twee portalen, Mijn EZ-base en EZ-catalog, en de site is er in het Nederlands, Engels, Frans en Duits.

EZ-base zegt zelf geen PIM te zijn. Een PIM beheert productinformatie binnen één bedrijf. EZ-base levert de data aan waarmee jouw PIM, ERP of webshop gevuld wordt. Voor een koppeling is EZ-base daarmee een bron van productdata, naast het ERP dat prijs en voorraad levert.

Wat je met EZ-base koppelt

De stroom loopt één kant op: van EZ-base naar je webshop of PIM. Het ERP blijft de bron voor alles waar inkoop en facturatie op draaien. Per veld ligt vast wie de eigenaar is.

De sleutel tussen de twee bronnen is het lastigste veld. EZ-base kent een artikel als leveranciersartikel met een GTIN; je ERP kent het onder je eigen artikelnummer. De koppeling zoekt eerst op GTIN en daarna op leverancier plus leveranciersartikelnummer. Wat op geen van beide een match geeft, gaat naar een controlelijst. De afweging tussen de twee sleutels staat in SKU of EAN.

Een geclassificeerd artikel ziet er in vereenvoudigde vorm zo uit. Dit is ons eigen voorbeeld om de opbouw te laten zien en niet het bestandsformaat van EZ-base:

{
  "leveranciersartikel": "RS-18-125",
  "gtin": "8712345000127",
  "etim_klasse": "EC001375",
  "klasseversie": 8,
  "kenmerken": [
    { "code": "EF000002", "type": "N", "waarde": 18 },
    { "code": "EF001985", "type": "N", "waarde": 5 },
    { "code": "EF026203", "type": "L", "waarde": true },
    { "code": "EF002846", "type": "R", "van": 4000, "tot": 10000 }
  ]
}

Klasse EC001375 is in ETIM de excentrische schuurmachine op accu. EF000002 is de nominale spanning in volt, EF001985 de accucapaciteit in ampère-uur, EF026203 de vraag of er een acculader bij zit en EF002846 de nullasttrillingsfrequentie per minuut.

Hoe EZ-base data vrijgeeft

Wat EZ-base publiceert

EZ-base publiceert geen ontwikkelaarsdocumentatie. Op ez-base.com staat geen API-referentie, geen lijst van exportformaten, geen authenticatiemethode en geen limiet (bekeken op 3 oktober 2026). Wat er wel staat: de data gaat naar de platformen van groothandels en naar gekoppelde systemen. De vorm van de aanlevering is een afspraak per klant. De koppeling begint daarom met jouw aanlevering: welk bestand of welke API, hoe vaak, en of je de hele set krijgt of alleen de wijzigingen.

Wat de standaard vastlegt

De inhoud ligt wel vast, omdat ETIM dat doet. Elke klasse, elk kenmerk en elke waarde heeft een code die in elke taal gelijk is: EC voor een klasse, EF voor een kenmerk, EV voor een waarde, elk met zes cijfers. Alleen de omschrijving verschilt per taal. Een kenmerk heeft één van vier typen:

Voor de uitwisseling van geclassificeerde productdata beheert ETIM International twee formaten: ETIM BMEcat, op basis van XML, en ETIM xChange, op basis van JSON. ETIM zegt erbij dat landen daarnaast eigen formaten gebruiken. De achtergrond staat in wat is ETIM.

Doorvoer aan de webshopkant

De limiet zit aan de kant die de data ontvangt. Neem 24.000 artikelen met gemiddeld 14 kenmerken: dat zijn 24.000 x 14 = 336.000 waarden. WooCommerce neemt via de batch-endpoints 100 objecten per verzoek aan, dus de eerste lading is 24.000 / 100 = 240 verzoeken. Duurt een verzoek 6 seconden, dan is dat 240 x 6 = 1.440 seconden, 24 minuten. Daarna gaan alleen de wijzigingen over: bij 3% gewijzigde artikelen per week zijn dat 720 artikelen, 8 verzoeken.

Waar het bij EZ-base op vastloopt

Vier typen kenmerken, één attribuutmodel

Een webshop kent geen ETIM-typen. Hij kent attributen met tekst, een getal of een keuzelijst. Elk type heeft daarom een eigen omzetting.

Een numeriek kenmerk gaat als getal naar de webshop en de eenheid apart. Staat er "18 V" als tekst in het attribuut, dan sorteert een filter op tekens en komt 110 V voor 18 V. Een bereik past niet in één filterbaar veld en wordt een minimum en een maximum. Een logisch kenmerk wordt Ja of Nee in de taal van de shop. Een alfanumeriek kenmerk komt als code; de koppeling zet de code om naar de omschrijving per taal, zodat een Nederlandse en een Duitse shop dezelfde waarde elk in hun eigen taal tonen.

Eén attribuut per kenmerk, niet per klasse

EC001375 heeft 15 kenmerken. Een assortiment met 400 klassen van die omvang heeft er op papier 400 x 15 = 6.000, maar kenmerken komen in meerdere klassen terug: de nominale spanning EF000002 staat bij elk elektrisch product. De koppeling maakt daarom één webshopattribuut per EF-code en hangt het aan elke categorie waar het voorkomt. Wie per klasse nieuwe attributen aanmaakt, krijgt in een categorie met meerdere klassen meerdere filters met de naam "Spanning". Welke kenmerken een filter worden en welke alleen in de specificatietabel staan, is een keuze per klasse; zie ETIM- en GS1-classificatie.

GTIN's met en zonder voorloopnul

Een GTIN heeft 8, 12, 13 of 14 cijfers. GS1 raadt aan hem op te slaan als tekstveld van 14 posities, links aangevuld met nullen. In de praktijk staat dezelfde code in het ERP als getal van 13 cijfers en in een productbestand met een voorloopnul. De koppeling vult beide aan tot 14 posities voordat hij vergelijkt, en controleert het controlecijfer. Een GTIN die door Excel is gegaan en zijn voorloopnul kwijt is, matcht anders nergens op.

Klasseversies en releases

De huidige ETIM-release is 10.0, van december 2024. Een officiële release komt ongeveer elke drie jaar en daartussen zijn er dynamische releases. Een klasse heeft een eigen versienummer: EC001375 staat op versie 8. Bij een nieuwe versie komen er kenmerken bij en vervallen er andere. De koppeling bewaart de klasseversie per artikel en toont in de diff van de run welke attributen nieuw zijn en welke leeg raken, voordat er iets in de webshop wijzigt.

Platformen die we aan EZ-base koppelen

De mapping is per platform anders, omdat elk platform kenmerken op een eigen plek bewaart.

• WooCommerce koppeling: kenmerken als productattributen, de GTIN in het veld global_unique_id, 100 objecten per batchverzoek.
• Magento koppeling: een attribuutset per ETIM-klasse, met gedeelde attributen per EF-code.
• Shopify koppeling: kenmerken in metafields; een product heeft maximaal drie opties en 2.048 varianten.
• Shopware koppeling: kenmerken als eigenschappen waarop de klant filtert.

Heb je een eigen PIM tussen EZ-base en de webshop, dan staat die route op Akeneo koppeling. Het overzicht van alle stromen en systemen staat op koppelingen, en de systemen die in deze branche samen voorkomen op bouw en installatietechniek.

Wij bouwen de koppeling voor een vaste prijs op jouw aanlevering, jouw ERP en jouw webshop, en hosten en bewaken hem daarna voor een vast bedrag per maand. Voor de livegang draait hij als dry run: je ziet per artikel welke attributen en waarden er zouden landen, zonder dat de webshop wijzigt. Vertel hoe je de data van EZ-base ontvangt en welke webshop je hebt.