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
Mei 2021
Nieuw ETIM-uitwisselingsformaat aangekondigd
ETIM International besluit ETIM BMEcat te vervangen door een eigen formaat.
Juni 2021
ETIM BMEcat-richtlijn 5.0
Laatste ETIM BMEcat-versie, met alleen de meest noodzakelijke wijzigingen.
19 februari 2024
ETIM xChange 1.0
Eerste officiële release, met een mappingbestand van xChange-velden naar ETIM BMEcat-velden.
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.
27 november 2025
ETIM xChange 2.0
Voegt milieuvelden (LCA/EPD), verpakkingsmateriaal, serienummers en MDX-bijlagecodes toe.
- 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
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-release | REFERENCE_FEATURE_SYSTEM_NAME, bijv. ETIM-10.0 | EtimReleaseVersion, bijv. 10.0, of DYNAMIC met EtimDynamicReleaseDate |
|---|---|---|
| ETIM-klasse | REFERENCE_FEATURE_GROUP_ID (EC000042) | EtimClassCode (EC000042), optioneel EtimClassVersion |
| Kenmerk | FNAME (EF000227) | EtimFeatureCode (EF000227) |
| Alfanumerieke waarde | FVALUE met een EV-code | EtimValueCode |
| Numerieke waarde | FVALUE | EtimValueNumeric |
| Bereikwaarde | Twee FVALUE-elementen | EtimValueRangeLower en EtimValueRangeUpper |
| Logische waarde | FVALUE true of false | EtimValueLogical (JSON-boolean) |
| Geen waarde | FVALUE - met FVALUE_DETAILS NA, MV of UN | ReasonNoValue NA, MV of UN |
| Is ETIM verplicht? | Kenmerkblok verplicht voor ETIM-geclassificeerde artikelen | Etim-subtree optioneel; bij een klasse moeten alle kenmerken mee |
| Artikelnummer leverancier | SUPPLIER_PID, max. 32 | SupplierItemNumber, max. 35 |
| Hoofdomschrijving | DESCRIPTION_SHORT, max. 150 | UniqueMainProductDescription, max. 255 |
| Zeer korte omschrijving | UDX.EDXF.DESCRIPTION_VERY_SHORT, max. 40 | MinimalProductDescription, max. 80, verplicht |
| Volledige of gedeeltelijke levering | T_NEW_CATALOG, T_UPDATE_PRODUCTS, T_UPDATE_PRICES | CatalogueType FULL of CHANGE, plus ChangeReferenceCatalogueVersion |
| Landspecifieke gegevens | UDX.EDXF.PRODUCT_CHARACTERISTICS | CountrySpecificFields en CountrySpecificExtensions |
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
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.

