Multi-format data-export: BMEcat, ETIM xChange, CSV en API

Een groothandel exporteert productdata vanuit één datamodel naar meerdere formaten via exportprofielen per afnemer. In de technische keten zijn de twee hoofdformaten BMEcat 2005 met ETIM-richtlijn 5.0 (XML) en ETIM xChange 2.0 (JSON). 2BA ondersteunt ze allebei. Daarnaast vragen kleinere afnemers CSV of Excel, en webshops en calculatiesoftware halen data liever via een API. Elk exportbestand valideer je tegen het schema voordat het de deur uitgaat.

Welke formaten vragen afnemers van een groothandel

Een groothandel levert data aan partijen met heel verschillende systemen. De tabel geeft de formaten die in oktober 2026 in de Nederlandse keten gangbaar zijn.

Oudere formaten verdwijnen langzaam. 2BA vermeldt dat de import van PAB 2 tot mei 2025 liep en dat INSBOU004 de voorganger van DICO is. Houd ze alleen in stand voor afnemers die nog niet zijn overgestapt.

BMEcat 2005 met ETIM-richtlijn 5.0

BMEcat is volgens BME e.V. een op XML gebaseerd, gestandaardiseerd uitwisselformaat voor catalogusdata in B2B, ontworpen om het inkoopproces van bestelling tot afrekening te ondersteunen. De ETIM-richtlijn legt vast hoe ETIM-klassen, kenmerken en handelsdata in BMEcat worden geplaatst.

Voor een export naar 2BA gelden onder meer deze regels uit de 2BA-documentatie:

• Een volledige levering (T_NEW_CATALOG) overschrijft alle records. Productrecords die ontbreken krijgen de status vervallen, handelsrecords die ontbreken worden verwijderd. Mutaties lever je als T_UPDATE_PRODUCTS.
• REFERENCE_FEATURE_SYSTEM_NAME bevat de ETIM-versie van de data, in de vorm ETIM-x.x of DYNAMIC.
• Nederlands is verplicht. Zonder Nederlandse of Engelse omschrijving wordt het record geblokkeerd.
• Merk, serie en type zijn verplicht per productrecord, en SUPPLIER_ID is verplicht binnen de datapool.
• Een bereik vul je met twee FVALUE-elementen, laagste waarde eerst. Lege kenmerken krijgen FVALUE_DETAILS met NA, MV of UN.
• Berichten moeten zonder fouten valideren tegen het schema. ETIM International biedt daarvoor een BMEcat-validatietool, waarvoor je moet inloggen.

Grote bestanden zijn in BMEcat gewoon. Pimics meldt bij release 14.0 dat het BMEcat-imports van grote leverancierscatalogi ondersteunt, waarvan de grootste tot nu toe meer dan 4 GB was. Dat zegt iets over wat je eigen PIM moet aankunnen bij zowel import als export.

ETIM xChange 2.0

ETIM xChange is het op JSON gebaseerde formaat dat ETIM International als eerste uitwisselstandaard volledig zelf beheert. Volgens ETIM International beveelde het eerder BMEcat aan en heeft het xChange inmiddels uitgebracht als de nieuwe standaard. Elke lokale ETIM-organisatie mag wel een eigen voorkeursformaat aanwijzen.

Versie 2.0 is op 27 november 2025 officieel uitgebracht. Nieuw zijn uitgebreide milieudatavelden (LCA en EPD), een element voor verpakkingsmateriaal dat de belangrijkste data-eisen van de Verpakkingsverordening ondersteunt, een gesloten lijst MDX-codes voor bijlagetypes en ondersteuning voor serienummers. De Verpakkingsverordening (PPWR) is Verordening (EU) 2025/40 en is van toepassing sinds 12 augustus 2026. Dit is algemene informatie en geen juridisch advies.

2BA ondersteunt versie 2.0 voor import en export, conform het 2BA-datamodel en inclusief de LCA-elementen. Uit de 2BA-documentatie volgen een paar exportregels:

1. Kies een volledige levering (FULL) of een mutatie (CHANGE). 2BA adviseert volledige datasets.
2. Vul bestel- en gebruikseenheid, omrekenfactor, prijseenheidfactor, PriceOnRequest en de geldigheidsdatum van de prijs. Die zijn verplicht.
3. Zet logistieke gegevens alleen in de artikelsectie, in metrische eenheden.
4. Gebruik alleen officieel vrijgegeven ETIM-MC-klasseversies.
5. Leg productrelaties vast met de typen SELECT, SPAREPART of CONSISTS_OF.
6. Valideer tegen het JSON-schema. Veelvoorkomende fouten zijn onjuiste headers, lege optionele arrays, ontbrekende verplichte arrays en een afwijkende volgorde.

2BA noemt ook beperkingen: marketingtekst en deeplinks op artikelniveau ontbreken in het formaat, net als een goederencode op productniveau, een alternatieve productcode en het land van herkomst. Wil een afnemer die velden, dan heb je een aanvullend kanaal nodig.

Let op een verschil tussen bronnen. De pagina met uitwisselformaten van ETIM International noemt nog ETIM xChange 1.1 als geldende versie, terwijl het nieuwsbericht van 27 november 2025 en de 2BA-documentatie versie 2.0 als actueel behandelen. Spreek de versie daarom per afnemer expliciet af.

CSV, Excel en API

Niet elke afnemer kan BMEcat of xChange inlezen. Een kleine installateur met een eigen webshop of een inkoper met een spreadsheet wil een platte tabel. Maak ook daarvoor een vast exportprofiel met een gedocumenteerde kolomdefinitie, een vaste scheidingstekens- en tekencodering en eenheden in een aparte kolom. Een CSV zonder afspraken wordt bij de afnemer opnieuw handwerk.

API's zijn bedoeld voor gerichte, frequente vragen. De 2BA-webservices werken met JSON-endpoints en OAuth2-authenticatie en zijn volgens 2BA bedoeld om een gericht aantal artikelen snel bij te werken. Voor bulk adviseert 2BA directe downloads of selectieprofielen. Hanteer dezelfde verdeling voor je eigen PIM-API: catalogi als bestand, actuele details per artikel via de API. Hoe je PIM-integraties architectonisch opzet, beschrijft pimsysteem.nl bij integraties.

Exportprofielen inrichten

Een exportprofiel legt per afnemer vast wat hij krijgt. Neem minimaal op: afnemer, formaat en versie, ETIM-versie, selectie (assortiment, merken, klassen), velden en eenheden, transactietype, planning en het validatieschema.

Voorbeeld: een groothandel in elektrotechniek levert aan vier afnemertypen. Naar 2BA gaat elke week een volledige ETIM xChange 2.0-levering met handelsdata. Een Duitse inkoopcoöperatie krijgt maandelijks BMEcat 2005 met ETIM-richtlijn 5.0. Drie installatiebedrijven met een eigen webshop krijgen een nachtelijke CSV met hun klantassortiment. Het eigen klantportaal haalt omschrijvingen en kenmerken via de API op. Bij de overgang naar ETIM 11 past de groothandel alleen de profielen aan van afnemers die daarom vragen, terwijl de rest op ETIM 10 blijft.

Bewaar daarom de ETIM-versie per kenmerkwaarde, zoals beschreven in Leveranciersdata harmoniseren. Dan kan elk profiel zijn eigen versie exporteren. Klantspecifieke catalogi in print en web staan in Catalogi publiceren vanuit PIM. Hoe fabrikanten dezelfde formaten aan groothandels leveren, lees je in Distributiekanalen bedienen, en voor GDSN in food staat de uitleg in GS1 GDSN en GS1 Data Source. Meer over het formaat zelf vind je in de woordenlijst van pimsysteem.nl. Alle groothandelsonderwerpen staan op PIM voor groothandel.

Belangrijkste punten

• Ondersteun in de technische keten zowel BMEcat 2005 met ETIM-richtlijn 5.0 als ETIM xChange 2.0, want 2BA accepteert beide en er is geen einddatum voor BMEcat gepubliceerd.
• ETIM xChange 2.0 (27 november 2025) voegt milieudata, verpakkingsmateriaal, MDX-bijlagecodes en serienummers toe.
• Leg per afnemer een exportprofiel vast met formaat, versie, ETIM-versie, selectie, transactietype en schema.
• Valideer elke export tegen het XSD- of JSON-schema voordat je hem verstuurt.
• Gebruik bestanden voor volledige catalogi en API's voor gerichte, frequente vragen.