Naar hoofdinhoud

ETIM xChange: de JSON-opvolger van ETIM BMEcat uitgelegd

Wat ETIM xChange is, hoe de JSON-opbouw en ETIM-velden zich verhouden tot ETIM BMEcat, welke versies er zijn, wie het accepteert en hoe je overstapt.

Diego Nijboer

ETIM xChange: de JSON-opvolger van ETIM BMEcat uitgelegd

ETIM xChange is het JSON-formaat van ETIM International voor het uitwisselen van productstamgegevens tussen fabrikanten, groothandels en datapools. Het vervangt de ETIM BMEcat-richtlijn als het aanbevolen uitwisselingsformaat van ETIM: versie 1.0 verscheen op 19 februari 2024, de actuele versie 2.0 op 27 november 2025. Anders dan BMEcat, een Duitse inkoopstandaard waarvoor ETIM een richtlijn schreef, is xChange in eigendom van ETIM International en wordt het door de ETIM-community doorontwikkeld.

Voor een leverancier verandert er in de praktijk drie dingen: het bestand is JSON met een gepubliceerd JSON Schema in plaats van XML, productgegevens staan los van handelsartikelgegevens (wat er gemaakt wordt tegenover wat er verkocht wordt), en ETIM-classificatie is op internationaal niveau optioneel, terwijl je nog steeds elk kenmerk van een klasse moet aanleveren zodra je classificeert. Hieronder lees je hoe het formaat is opgebouwd, hoe het ETIM-blok zich per veld verhoudt tot BMEcat, wie het vandaag accepteert en wat ETIM-releases betekenen voor wat je aanlevert.

Waarom ETIM na BMEcat een eigen formaat bouwde

In mei 2021 kondigde ETIM International aan een nieuw internationaal uitwisselingsformaat te ontwikkelen als vervanger van ETIM BMEcat. De redenen uit die aankondiging: het basisformaat BMEcat lag al jaren vast zonder mogelijkheid om wijzigingen aan te vragen, dus elke uitbreiding moest als zelfgedefinieerde extensie worden gebouwd (de UDX.EDXF-elementen) om bestanden geldig te houden, en dat maakte het formaat verwarrend. ETIM BMEcat kreeg nog één laatste update, richtlijn 5.0 in juni 2021, en ETIM zei dat er geen nieuwe versie meer zou komen. Onze gids over het BMEcat-bestand behandelt dat formaat element voor element.

Het nieuwe formaat kostte meer tijd dan gepland. Een eerste opzet op basis van de Nederlandse DICO-standaard werd in 2022 herstart met de European Master Data Guideline (EMDG) als fundament. EMDG wordt uitgegeven door FEST, de Europese federatie van groothandels in sanitair en verwarming, en legt de gemeenschappelijke stamgegevens van producten vast. Volgens de ETIM xChange-richtlijn is daarnaast waar mogelijk inhoud uit ETIM BMEcat, DICO en het Franse FAB-DIS geharmoniseerd.

Het resultaat heeft drie eigenschappen die een BMEcat-gebruiker meteen opvallen. Het is JSON met een JSON Schema voor validatie, wat volgens ETIM ook beter past bij uitwisseling via web en API dan XML als bestand. Het valt onder de Apache License 2.0. En één bestand kan meerdere leveranciers bevatten, wat het volgens ETIM vooral geschikt maakt voor datapools.

Van aankondiging tot xChange 2.0: de releasegeschiedenis

Releasegeschiedenis van ETIM xChange

  1. Mei 2021

    Nieuw ETIM-uitwisselingsformaat aangekondigd

    ETIM International besluit ETIM BMEcat te vervangen door een eigen formaat.

  2. Juni 2021

    ETIM BMEcat-richtlijn 5.0

    Laatste ETIM BMEcat-versie, met alleen de meest noodzakelijke wijzigingen.

  3. 19 februari 2024

    ETIM xChange 1.0

    Eerste officiële release, met een mappingbestand van xChange-velden naar ETIM BMEcat-velden.

  4. 27 augustus 2024

    Versie 1.1 en validatietool

    Patchrelease voor imperiale en lokale normkenmerkcodes en de lengte van de douanecode. Bestanden voor 1.0 blijven valideren.

  5. 27 november 2025

    ETIM xChange 2.0

    Voegt milieuvelden (LCA/EPD), verpakkingsmateriaal, serienummers en MDX-bijlagecodes toe.

  6. 6

    December 2025

    Validatietool ondersteunt 2.0

    De validatietool voor leden herkent de schemaversie van een geüpload bestand.

Een valkuil als je het uitzoekt: de pagina over het uitwisselingsformaat van ETIM International zegt nog steeds "Currently, ETIM xChange 1.1 is applicable", terwijl het eigen nieuwsbericht over de 2.0-release en de downloadsectie versie 2.0 hebben. Bouw op 2.0, tenzij je ontvanger iets anders zegt; 2BA accepteert bijvoorbeeld 1.0, 1.1 en 2.0, maar raadt aan nieuwe ontwikkeling op 2.0 te baseren.

Binnenin een xChange-bestand: catalogus, leverancier, product, handelsartikel

Hiërarchie van een ETIM xChange-bestand

Diagram laden
Alleen het niveau Product is verplicht; handelsartikelen en verpakkingseenheden komen erbij als het bestand commerciële en logistieke gegevens bevat.

De root van het bestand is de catalogus: SchemaVersion (2.0), CatalogueId, CatalogueType, geldigheidsdata, talen en valuta. Daaronder staat een array met leveranciers, en onder elke leverancier een array met producten. Het 2.0-voorbeeldbestand van ETIM laat zien welke niveaus een volledige aanlevering vult:

  • Product (wat er gemaakt wordt): ProductIdentification met ManufacturerName en ManufacturerProductNumber (allebei verplicht), ProductGtin, BrandName en CountryOfOrigin; ProductDetails met status en omschrijvingen; ProductRelations; Legislation (RoHS, REACH, WEEE, gevaarlijke stoffen); LcaEnvironmental; ProductAttachments; EtimClassification; en OtherClassifications, waarin codes uit ECLASS, UNSPSC of een eigen bedrijfsclassificatie naast ETIM meegaan (in onze vergelijking ETIM vs ECLASS lees je wanneer je beide nodig hebt).
  • TradeItem (wat er verkocht wordt): ItemIdentification met het verplichte SupplierItemNumber plus ItemGtin; ItemDetails; ItemLogisticDetails met netto afmetingen en gewicht; Ordering met OrderUnit, MinimumOrderQuantity en OrderStepSize; Pricing met PriceUnit, PriceQuantity, GrossListPrice en btw.
  • PackagingUnit: verpakkingscode, aantal en afmetingen per verpakkingsniveau van een handelsartikel.

Die splitsing is belangrijk voor groothandelsdata. ETIM geeft zelf het voorbeeld van een kabel die je per meter, als doos van 100 meter of als haspel van 1.000 meter kunt kopen: één product, één keer geclassificeerd, met meerdere handelsartikelen die elk een eigen artikelnummer, prijs en besteleenheid hebben. In een platte artikellijst is elk daarvan een apart artikel dat de technische gegevens herhaalt. Heeft een fabrikant geen aparte code voor het onverpakte technische product, dan mag volgens de richtlijn het kleinste handelsartikel op productniveau staan, met herhaalde identificatie.

Volledige catalogi, wijzigingscatalogi en productstatus

Waar BMEcat drie transacties gebruikt, gebruikt xChange één veld. CatalogueType FULL is een complete catalogus met alle producten en handelsartikelen die de afnemer krijgt aangeboden. CatalogueType CHANGE betekent dat het bestand alleen nieuwe, gewijzigde of verwijderde producten bevat, en dan is ChangeReferenceCatalogueVersion verplicht: dat veld noemt de eerdere catalogusversie waarop de wijzigingen van toepassing zijn. Spreek per ontvanger af hoe vaak hij een FULL-bestand wil om weer gelijk te lopen, want een gemiste wijzigingsaanlevering brengt zijn kopie net zo goed uit de pas als een gemiste BMEcat-update.

De levenscyclus zit in statuscodes, niet in de transactie. ProductStatus en ItemStatus kennen PRE-LAUNCH, ACTIVE, ON HOLD, PLANNED WITHDRAWAL en OBSOLETE, zodat een groothandel ziet dat een product nog op voorraad is maar niet meer gemaakt wordt. Kent je artikelbestand alleen actief en inactief, dan is dat een veld om toe te voegen vóór de eerste xChange-aanlevering.

Formaatregels waarop eerste xChange-bestanden vastlopen

  • Veldnamen zijn exact. PascalCase zoals in het schema, en elk object is gesloten met additionalProperties false, dus een veld dat het schema niet kent, faalt op validatie.
  • Optioneel betekent weglaten, niet leeg laten. Een optioneel veld mag ontbreken, maar staat het in het bestand, dan moet het een geldige waarde hebben. 2BA noemt lege optionele arrays en ontbrekende verplichte arrays bij de veelgemaakte xChange-fouten.
  • Getallen zijn meestal strings met een patroon. GrossListPrice is bijvoorbeeld een string van maximaal 11 cijfers, een punt en maximaal 4 decimalen. Geen duizendtalscheiding, en ook geen komma als decimaalteken.
  • Codes, geen woorden. OrderUnit krijgt een eenheidscode zoals C62; talen zijn tags als nl-NL of en-GB; GTIN's hebben 8 tot 14 cijfers.
  • Bijlagen zijn links. 2BA meldt dat het 2.0-schema geen fysieke bestanden toestaat, alleen URL's, dus afbeeldingen en datasheets hebben vaste openbare adressen nodig.

ETIM-kenmerken in xChange naast ETIM BMEcat

Lever je al ETIM BMEcat aan, dan is het meeste werk mappen. ETIM publiceert een mappingbestand tussen beide; de tabel volgt de veldparen daaruit en de velddefinities uit de 2.0-richtlijn.

ETIM BMEcat 5.0 tegenover ETIM xChange 2.0

ETIM-releaseREFERENCE_FEATURE_SYSTEM_NAME, bijv. ETIM-10.0EtimReleaseVersion, bijv. 10.0, of DYNAMIC met EtimDynamicReleaseDate
ETIM-klasseREFERENCE_FEATURE_GROUP_ID (EC000042)EtimClassCode (EC000042), optioneel EtimClassVersion
KenmerkFNAME (EF000227)EtimFeatureCode (EF000227)
Alfanumerieke waardeFVALUE met een EV-codeEtimValueCode
Numerieke waardeFVALUEEtimValueNumeric
BereikwaardeTwee FVALUE-elementenEtimValueRangeLower en EtimValueRangeUpper
Logische waardeFVALUE true of falseEtimValueLogical (JSON-boolean)
Geen waardeFVALUE - met FVALUE_DETAILS NA, MV of UNReasonNoValue NA, MV of UN
Is ETIM verplicht?Kenmerkblok verplicht voor ETIM-geclassificeerde artikelenEtim-subtree optioneel; bij een klasse moeten alle kenmerken mee
Artikelnummer leverancierSUPPLIER_PID, max. 32SupplierItemNumber, max. 35
HoofdomschrijvingDESCRIPTION_SHORT, max. 150UniqueMainProductDescription, max. 255
Zeer korte omschrijvingUDX.EDXF.DESCRIPTION_VERY_SHORT, max. 40MinimalProductDescription, max. 80, verplicht
Volledige of gedeeltelijke leveringT_NEW_CATALOG, T_UPDATE_PRODUCTS, T_UPDATE_PRICESCatalogueType FULL of CHANGE, plus ChangeReferenceCatalogueVersion
Landspecifieke gegevensUDX.EDXF.PRODUCT_CHARACTERISTICSCountrySpecificFields en CountrySpecificExtensions
14 van 14 rijen
De ETIM-inhoud is hetzelfde model; wat verandert is de typering (één FVALUE-veld wordt getypeerde waardevelden), de lengtes en hoe je lege kenmerken verklaart.

Twee rijen verdienen aandacht. Ten eerste is ETIM-classificatie op internationaal niveau van verplicht naar optioneel gegaan, dus een fabrikant kan xChange sturen voordat elk artikel geclassificeerd is. Dat betekent niet dat ontvangers het accepteren: elk ETIM-land kan optionele velden verplicht maken, en een datapool die geclassificeerde data levert, vraagt om de klasse. Onze stappen voor ETIM-classificatie behandelen dat deel van het werk. Ten tweede zijn de redencodes gelijk gebleven: NA (niet van toepassing), MV (er bestaat geen juiste waarde in deze ETIM-versie) en UN (nu nog onbekend). Schrijft je BMEcat-export al "-" met een redencode, dan neem je die logica zo mee.

Wie ETIM xChange vandaag accepteert

De adoptie is ongelijk, en het eerlijke antwoord is: vraag het per ontvanger. Dit publiceren de standaardorganisatie en de datapools zelf:

  • Nederland: 2BA ondersteunt ETIM xChange 2.0 voor import en export, inclusief de LCA-milieugegevens, en accepteert nog steeds 1.0 en 1.1. 2BA noemt xChange naast BMEcat 2005 ETIM 5.0 en de Nederlandse formaten bij de actuele uitwisselingsformaten.
  • Italië: in februari 2026 koos METEL, dat de elektrotechnische industrie vertegenwoordigt binnen ETIM Italy, voor een hybride aanpak: gestructureerde xChange-data gebruiken waar die beschikbaar is en stap voor stap integreren.
  • Oostenrijk, Duitsland en Finland zijn de enige landen met landspecifieke regels in de landenrichtlijn van ETIM voor xChange 2.0 (versie 2.01, april 2026). Duitsland stelt teksteisen aan omschrijvingen, verwacht minstens één hoofdafbeelding per handelsartikel en vraagt WEEE-registratienummers; Oostenrijk maakt Country AT, FullProductDescription en ProductKeyword verplicht; Finland beperkt MinimalProductDescription tot 30 tekens. Nederland en België hebben geen extra regels, al legt 2BA Nederlandse kenmerken vast als landspecifieke velden.
  • Overal: ETIM International merkt op dat sommige landen nog nationale formaten als branchestandaard gebruiken, naast of in plaats van xChange en ETIM BMEcat.

ETIM International noemt de adoptie van xChange snel groeiend. Lees dat als het standpunt van de standaardorganisatie: voor je eigen planning tellen de twee of drie groothandels of datapools die het grootste deel van je volume afnemen, en veel daarvan accepteren ETIM BMEcat voorlopig ook nog.

Wat ETIM-releases veranderen aan een xChange-aanlevering

Elk geclassificeerd artikel in een xChange-bestand noemt zijn ETIM-release in EtimReleaseVersion, en de klassecode geldt alleen voor die release. Drie regels uit de 2.0-richtlijn tellen als releases wisselen:

  • Release en klasseversie zijn verschillende nummers. EtimClassVersion telt de wijzigingen aan één klasse; een klasse die tussen releases niet veranderde, houdt haar versie. Het veld is optioneel, maar verplicht als je ook ETIM MC-gegevens (modelling classes) meestuurt.
  • De dynamische release is toegestaan. In plaats van 10.0 kun je DYNAMIC schrijven, en dan is EtimDynamicReleaseDate verplicht. Controleer of je ontvanger data volgens de dynamische release accepteert voordat je die gebruikt.
  • De klasse bepaalt de kenmerkenlijst. Alle kenmerken van de klasse in die release moeten mee, behalve lokale normkenmerken (codes zoals EFUK0001). Een nieuwe release kan kenmerken aan een klasse toevoegen, dus een artikel dat in 10.0 compleet was, kan in de volgende release nieuwe waarden nodig hebben.

De volgende grote release komt eraan: ETIM International heeft ETIM 11.0 gepland voor definitieve release op 1 december 2026, na een deadline voor wijzigingsverzoeken op 30 juni 2026. Ontvangers stappen in hun eigen tempo over, dus reken erop dat je een tijd lang ETIM 10.0 aan de ene en 11.0 aan de andere afnemer levert. Leg de release per ontvanger vast als expliciete instelling in plaats van "nieuwste". In onze ETIM-gids lees je hoe het model van klassen, kenmerken en waarden achter die codes werkt.

Een leveranciersaanlevering omzetten van ETIM BMEcat naar xChange

Checklist voor de overstap van BMEcat naar xChange

0 van 9 klaar0%

Draai beide formaten minstens één volledige cyclus naast elkaar. Het importlog van een ontvanger zegt meer dan een geldige schemacontrole: je ziet welke velden hij echt overneemt en waar zijn datamodel korter of strenger is dan de standaard.

ETIM-artikelgegevens klaarzetten in WISEPIM, vóór elke xChange-export

WISEPIM exporteert geen ETIM xChange. Wat het wel afdekt, is de inhoud waar een xChange-bestand uit bestaat. In productclassificatie koppel je ETIM 10.0-klassen aan productfamilies, artikelen erven de klasse, kenmerkwaarden worden gecontroleerd tegen de toegestane waarden en eenheden van de klasse, en een ETIM-conformiteitsscore laat per artikel zien hoeveel klassekenmerken geldig zijn. Van daaruit schrijft Feed Hub een BMEcat-bestand met ETIM-kenmerken (kaal BMEcat 2005, niet het profiel van ETIM-richtlijn 5.0), en kan een CSV- of XLSX-export de ETIM-kenmerkattributen meenemen als kolommen die je kiest, voor een converter of datapool-upload die de JSON schrijft. Test per ontvanger eerst één bestand voordat je op een van beide routes bouwt.

Weet je niet zeker of je leveranciersbestanden klaar zijn voor een van beide formaten? Bij de gratis productdata-check loopt een collega één bestand met je door en wijst aan wat een ontvanger zou afkeuren.

Diego Nijboer

CTO and Co-Founder at WISEPIM, building AI-powered solutions that transform product data management for e-commerce businesses. Over 10 years of experience solving complex technical challenges in e-commerce and PIM systems.

Veelgestelde vragen

Nog vragen?

Kan je het antwoord niet vinden? Neem contact op met ons team.

Contact opnemen

ETIM xChange is een uitwisselingsformaat voor productstamgegevens op basis van JSON, in eigendom van en doorontwikkeld door ETIM International. Het bevat catalogus-, leveranciers-, product-, handelsartikel- en verpakkingsgegevens plus ETIM-classificatie en -kenmerken, met een JSON Schema voor validatie. Versie 1.0 verscheen in februari 2024, versie 2.0 in november 2025. Het vervangt de ETIM BMEcat-richtlijn als aanbevolen formaat van ETIM.

Het vervangt de BMEcat-richtlijn van ETIM, niet BMEcat zelf. ETIM International publiceerde in 2021 de laatste ETIM BMEcat-richtlijn, versie 5.0, en beveelt nu xChange aan. BMEcat blijft een standaard van de Duitse vereniging BME, en veel groothandels, datapools en inkoopplatforms accepteren nog steeds ETIM BMEcat-bestanden. Leveranciers leveren in de praktijk vaak beide formaten aan tot elke ontvanger bevestigt dat hij xChange importeert.

Gebruik versie 2.0, tenzij een ontvanger iets anders vraagt. Die verscheen op 27 november 2025 en de validatietool van ETIM ondersteunt hem sinds december 2025. Versie 1.1 was een achterwaarts compatibele patch van 1.0, dus 1.0-bestanden valideren ook tegen 1.1. 2BA accepteert 1.0, 1.1 en 2.0, maar raadt aan nieuwe ontwikkeling op 2.0 te baseren.

Niet op internationaal niveau: de Etim-subtree en de kenmerken zijn optioneel, dus ook ongeclassificeerde artikelen kun je uitwisselen. Heeft een artikel een ETIM-klasse, dan moeten alle kenmerken van die klasse mee, met ReasonNoValue NA, MV of UN als er geen waarde te geven is. ETIM-landen en datapools kunnen optionele velden verplicht maken, dus controleer de eisen per ontvanger.

Valideer het tegen het JSON Schema uit het documentatiepakket van ETIM International; elke JSON Schema-validator kan dat. ETIM-leden kunnen bestanden ook uploaden in de ETIM xChange-validatietool, die het schema en de gebruikte ETIM-classificatie controleert, de schemaversie herkent en een validatiecertificaat kan maken. Je logt in met de ETIM CMT-login die je via je lokale ETIM-organisatie krijgt.

Verder ontdekken

Zorgvuldig gekozen vervolgstappen om dieper te gaan.

Betere productdata, betere resultaten.Verkoop meer producten.

4,7