Zum Hauptinhalt springen

ETIM xChange erklärt: der JSON-Nachfolger von ETIM BMEcat

Was ETIM xChange ist, wie JSON-Aufbau und ETIM-Felder im Vergleich zu ETIM BMEcat aussehen, welche Versionen es gibt, wer es annimmt und wie du umstellst.

Diego Nijboer

ETIM xChange erklärt: der JSON-Nachfolger von ETIM BMEcat

ETIM xChange ist das JSON-Format von ETIM International für den Austausch von Produktstammdaten zwischen Herstellern, Großhändlern und Datenpools. Es löst den ETIM-BMEcat-Leitfaden als empfohlenes Austauschformat von ETIM ab: Version 1.0 erschien am 19. Februar 2024, die aktuelle Version 2.0 wurde am 27. November 2025 veröffentlicht. Anders als BMEcat, ein deutscher Beschaffungsstandard, für den ETIM einen Leitfaden geschrieben hat, gehört xChange ETIM International und wird von ETIM und seiner Community weiterentwickelt.

Für einen Lieferanten ändert sich in der Praxis dreierlei: Die Datei ist JSON mit einem veröffentlichten JSON Schema statt XML, Produktdaten werden von Handelsartikeldaten getrennt (was hergestellt wird gegenüber dem, was verkauft wird), und die ETIM-Klassifizierung wird auf internationaler Ebene optional, während weiterhin jedes Merkmal einer Klasse geliefert werden muss, sobald du klassifizierst. Hier steht, wie das Format aufgebaut ist, wie sein ETIM-Block Feld für Feld im Vergleich zu BMEcat aussieht, wer es heute annimmt und wie ETIM-Releases beeinflussen, was du schickst.

Warum ETIM nach BMEcat ein eigenes Austauschformat gebaut hat

Im Mai 2021 kündigte ETIM International an, ein neues internationales Austauschformat als Ersatz für ETIM BMEcat zu entwickeln. Die Gründe laut dieser Ankündigung: Das BMEcat-Basisformat war seit Jahren eingefroren, ohne Möglichkeit, Änderungen zu beantragen, also musste jede Erweiterung als benutzerdefinierte Erweiterung (die UDX.EDXF-Elemente) gebaut werden, damit die Dateien gültig bleiben, und das machte das Format unübersichtlich. ETIM BMEcat bekam ein letztes Update, den Leitfaden 5.0 im Juni 2021, und ETIM erklärte, dass keine weitere Version folgen würde. Unser BMEcat-Leitfaden erklärt dieses Format Element für Element.

Das neue Format dauerte länger als geplant. Ein erster Anlauf auf Basis des niederländischen DICO-Standards wurde 2022 neu gestartet, mit der European Master Data Guideline (EMDG) als Grundlage. Die EMDG wird von FEST herausgegeben, dem europäischen Verband der Sanitär- und Heizungsgroßhändler, und definiert die gemeinsamen Stammdatenattribute für Produkte. Laut dem Leitfaden zu ETIM xChange hat das Team außerdem, wo möglich, Inhalte aus ETIM BMEcat, DICO und dem französischen Format FAB-DIS harmonisiert.

Das Ergebnis hat drei Eigenschaften, die einem BMEcat-Nutzer zuerst auffallen. Es ist JSON mit einem JSON Schema zur Validierung, das ETIM außerdem als besser geeignet für Web- und API-Austausch positioniert als reines Datei-XML. Es steht unter der Apache License 2.0. Und eine Datei kann mehrere Lieferanten enthalten, was es laut ETIM besonders für Datenpools geeignet macht.

Von der Ankündigung bis xChange 2.0: die Release-Geschichte

Release-Geschichte von ETIM xChange

  1. Mai 2021

    Neues ETIM-Austauschformat angekündigt

    ETIM International beschließt, ETIM BMEcat durch ein eigenes Format zu ersetzen.

  2. Juni 2021

    ETIM-BMEcat-Leitfaden 5.0

    Letzte Version von ETIM BMEcat, nur mit den dringendsten Änderungen.

  3. 19. Februar 2024

    ETIM xChange 1.0

    Erstes offizielles Release, mit einer Mapping-Datei von xChange-Feldern zu ETIM-BMEcat-Feldern.

  4. 27. August 2024

    Version 1.1 und Validierungstool

    Patch-Release für imperiale und lokale Standardmerkmalscodes und die Länge des Zolltarifcodes. Für 1.0 erstellte Dateien validieren weiterhin.

  5. 27. November 2025

    ETIM xChange 2.0

    Ergänzt Umweltfelder (LCA/EPD), Daten zu Verpackungsmaterial, Unterstützung für Seriennummern und MDX-Codes für Anhänge.

  6. 6

    Dezember 2025

    Validierungstool unterstützt 2.0

    Das nur für Mitglieder verfügbare Validierungstool erkennt die Schema-Version einer hochgeladenen Datei.

Eine Falle bei der Recherche: Die Seite zum Austauschformat von ETIM International sagt noch „Currently, ETIM xChange 1.1 is applicable“, während der eigene News-Beitrag zum Release 2.0 und der Download-Bereich Version 2.0 führen. Baue gegen 2.0, solange dein Empfänger nichts anderes sagt. Der niederländische Datenpool 2BA zum Beispiel nimmt 1.0, 1.1 und 2.0 an, empfiehlt für neue Entwicklungen aber 2.0.

In einer xChange-Datei: Katalog, Lieferant, Produkt, Handelsartikel

Dateihierarchie von ETIM xChange

Diagramm wird geladen
Nur die Ebene Product ist Pflicht, Handelsartikel und Verpackungseinheiten kommen hinzu, wenn die Datei kommerzielle und logistische Daten enthält.

Die Wurzel der Datei ist der Katalog: SchemaVersion (2.0), CatalogueId, CatalogueType, Gültigkeitsdaten, Sprachen, Währung. Darunter steht ein Array von Lieferanten und unter jedem Lieferanten ein Array von Produkten. Die Beispieldatei 2.0 von ETIM zeigt die Ebenen, die eine vollständige Datenlieferung füllt:

  • Product (was hergestellt wird): ProductIdentification mit ManufacturerName und ManufacturerProductNumber (beide Pflicht), ProductGtin, BrandName und CountryOfOrigin; ProductDetails mit Status und Beschreibungen; ProductRelations; Legislation (RoHS, REACH, WEEE, Gefahrgut); LcaEnvironmental; ProductAttachments; EtimClassification; und OtherClassifications, wo Codes aus ECLASS, UNSPSC oder einer firmeneigenen Klassifikation neben ETIM mitreisen können (unser Vergleich ETIM vs. ECLASS erklärt, wann du beides brauchst).
  • TradeItem (was verkauft wird): ItemIdentification mit der Pflicht-SupplierItemNumber plus ItemGtin; ItemDetails; ItemLogisticDetails mit Nettomaßen und Gewicht; Ordering mit OrderUnit, MinimumOrderQuantity und OrderStepSize; Pricing mit PriceUnit, PriceQuantity, GrossListPrice und VAT.
  • PackagingUnit: Verpackungsartcode, Menge und Maße für jede Verpackungsebene eines Handelsartikels.

Für Großhandelsdaten ist diese Trennung wichtig. Das eigene Beispiel von ETIM ist ein Kabel, das du pro Meter, als 100-Meter-Karton oder als 1.000-Meter-Trommel kaufen kannst: ein Produkt, einmal klassifiziert, mit mehreren Handelsartikeln, die jeweils eigene Artikelnummer, eigenen Preis und eigene Bestelleinheit haben. In einer flachen Artikelliste ist jeder davon ein eigener Artikel, der die technischen Daten wiederholt. Wenn ein Hersteller keinen eigenen Code für das unverpackte technische Produkt hat, akzeptiert der Leitfaden, den kleinsten Handelsartikel auf Produktebene aufzuführen und seine Kennungen zu wiederholen.

Vollkataloge, Änderungskataloge und Produktstatus

Wo BMEcat drei Transaktionen nutzt, nutzt xChange ein Feld. CatalogueType FULL bedeutet einen vollständigen Katalog mit allen Produkten und Handelsartikeln, die dem Abnehmer angeboten werden. CatalogueType CHANGE bedeutet, dass die Datei nur neue, geänderte oder gelöschte Produkte enthält, und dann ist ChangeReferenceCatalogueVersion Pflicht: Es nennt die frühere Katalogversion, auf die sich die Änderungen beziehen. Kläre mit jedem Empfänger, wie oft er eine FULL-Datei zur Neusynchronisierung will, denn eine verpasste Änderungsdatei bringt seine Kopie genauso aus dem Takt wie ein verpasstes BMEcat-Update.

Der Lebenszyklus steckt in Statuscodes statt in der Transaktion. ProductStatus und ItemStatus nehmen PRE-LAUNCH, ACTIVE, ON HOLD, PLANNED WITHDRAWAL oder OBSOLETE an, sodass ein Großhändler sieht, dass ein Produkt noch auf Lager ist, aber nicht mehr hergestellt wird. Wenn dein Artikelstamm nur aktiv und inaktiv kennt, ist das ein Feld, das du vor der ersten xChange-Lieferung ergänzen solltest.

Formatregeln, an denen erste xChange-Dateien scheitern

  • Feldnamen sind exakt. PascalCase wie im Schema, und jedes Objekt ist mit additionalProperties false geschlossen, also scheitert ein Feld, das das Schema nicht definiert, an der Validierung.
  • Optional heißt weglassen, nicht leer lassen. Ein optionales Feld darfst du weglassen, aber wenn es in der Datei steht, muss es einen gültigen Wert haben. 2BA nennt leere optionale Arrays und fehlende Pflicht-Arrays unter seinen häufigen xChange-Fehlern.
  • Zahlen sind meist Strings mit einem Muster. GrossListPrice zum Beispiel ist ein String aus bis zu 11 Ziffern, einem Punkt und bis zu 4 Nachkommastellen. Kein Tausendertrennzeichen.
  • Codes, keine Wörter. OrderUnit nimmt einen Einheitencode wie C62, Sprachen sind Tags wie en-GB oder nl-NL, GTINs haben 8 bis 14 Stellen.
  • Anhänge sind Links. 2BA weist darauf hin, dass das Schema 2.0 keine physischen Dateien aufnehmen kann, nur URLs, also brauchen Bilder und Datenblätter stabile öffentliche Adressen.

ETIM-Merkmale in xChange neben ETIM BMEcat

Wenn du schon ETIM BMEcat lieferst, ist der größte Teil der Arbeit Mapping. ETIM veröffentlicht eine Mapping-Datei zwischen beiden, die Tabelle unten folgt deren Feldpaaren und den Felddefinitionen des Leitfadens 2.0.

ETIM BMEcat 5.0 im Vergleich zu ETIM xChange 2.0

ETIM-ReleaseREFERENCE_FEATURE_SYSTEM_NAME, z. B. ETIM-10.0EtimReleaseVersion, z. B. 10.0, oder DYNAMIC plus EtimDynamicReleaseDate
ETIM-KlasseREFERENCE_FEATURE_GROUP_ID (EC000042)EtimClassCode (EC000042), optional EtimClassVersion
MerkmalFNAME (EF000227)EtimFeatureCode (EF000227)
Alphanumerischer WertFVALUE mit einem EV-CodeEtimValueCode
Numerischer WertFVALUEEtimValueNumeric
BereichswertZwei FVALUE-ElementeEtimValueRangeLower und EtimValueRangeUpper
Logischer WertFVALUE true oder falseEtimValueLogical (JSON-Boolean)
Kein WertFVALUE - mit FVALUE_DETAILS NA, MV oder UNReasonNoValue NA, MV oder UN
Ist ETIM Pflicht?Merkmalsblock Pflicht für ETIM-klassifizierte ProdukteEtim-Teilbaum optional, ist eine Klasse angegeben, müssen alle ihre Merkmale gesendet werden
LieferantenartikelnummerSUPPLIER_PID, max. 32SupplierItemNumber, max. 35
HauptbeschreibungDESCRIPTION_SHORT, max. 150UniqueMainProductDescription, max. 255
Sehr kurze BeschreibungUDX.EDXF.DESCRIPTION_VERY_SHORT, max. 40MinimalProductDescription, max. 80, Pflicht
Voll- oder TeillieferungT_NEW_CATALOG, T_UPDATE_PRODUCTS, T_UPDATE_PRICESCatalogueType FULL oder CHANGE, plus ChangeReferenceCatalogueVersion
Länderspezifische DatenUDX.EDXF.PRODUCT_CHARACTERISTICSCountrySpecificFields und CountrySpecificExtensions
14 von 14 Zeilen
Der ETIM-Inhalt folgt demselben Modell. Was sich ändert, sind Typisierung (aus einem FVALUE-Feld werden typisierte Wertfelder), Längen und wie leere Merkmale begründet werden.

Zwei Zeilen verdienen Aufmerksamkeit. Erstens ist die ETIM-Klassifizierung auf internationaler Ebene von Pflicht zu optional gewechselt, ein Hersteller kann also xChange senden, bevor jedes Produkt klassifiziert ist. Das heißt nicht, dass Empfänger das akzeptieren: Jedes ETIM-Land kann optionale Felder zur Pflicht machen, und ein Datenpool, der klassifizierte Daten vertreibt, wird nach der Klasse fragen. Unser Schritt-für-Schritt-Leitfaden zur ETIM-Klassifizierung behandelt diesen Teil der Arbeit. Zweitens sind die Begründungscodes unverändert: NA (nicht zutreffend), MV (in dieser ETIM-Version gibt es keinen korrekten Wert) und UN (derzeit unbekannt). Wenn dein BMEcat-Export schon „-“ plus Begründungscode schreibt, lässt sich die Logik übernehmen.

Wer ETIM xChange heute annimmt

Die Verbreitung ist ungleich, und die ehrliche Antwort lautet „frag jeden Empfänger“. Was das Gremium und die Pools veröffentlichen:

  • Niederlande: 2BA unterstützt ETIM xChange 2.0 für Import und Export, einschließlich der LCA-Umweltelemente, und nimmt weiterhin 1.0 und 1.1 an. In seinen aktuellen Austauschformaten führt es xChange neben BMEcat 2005 ETIM 5.0 und den niederländischen Formaten.
  • Italien: Im Februar 2026 hat METEL, das die elektrotechnische Industrie innerhalb von ETIM Italien vertritt, einen hybriden Ansatz gewählt: strukturierte xChange-Daten nutzen, wo sie verfügbar sind, und Schritt für Schritt integrieren.
  • Österreich, Deutschland und Finnland sind die einzigen Länder mit länderspezifischen Vorgaben im Länderleitfaden von ETIM zu xChange 2.0 (Version 2.01, April 2026). Deutschland legt Textregeln für Beschreibungen fest, erwartet mindestens ein Hauptbild pro Handelsartikel und verlangt WEEE-Registrierungsnummern. Österreich macht Country AT, FullProductDescription und ProductKeyword zur Pflicht. Finnland begrenzt MinimalProductDescription auf 30 Zeichen. Die Niederlande und Belgien nennen keine zusätzlichen Vorgaben, obwohl 2BA niederländische Merkmale als länderspezifische Felder definiert.
  • Überall: ETIM International weist darauf hin, dass manche Länder neben oder statt xChange und ETIM BMEcat noch nationale Formate als Branchenstandard nutzen.

ETIM International beschreibt die Verbreitung von xChange als schnell wachsend. Nimm das als Sicht des Standardisierungsgremiums: Für deine eigene Planung zählen die zwei oder drei Großhändler oder Pools, die den Großteil deines Volumens abnehmen, und viele davon werden noch eine Weile ETIM BMEcat annehmen.

Was ETIM-Releases an einer xChange-Lieferung ändern

Jedes klassifizierte Produkt in einer xChange-Datei nennt sein ETIM-Release in EtimReleaseVersion, und der Klassencode gilt nur für dieses Release. Drei Regeln aus dem Leitfaden 2.0 sind wichtig, wenn sich Releases ändern:

  • Release und Klassenversion sind verschiedene Nummern. EtimClassVersion zählt Änderungen an einer Klasse, eine Klasse, die sich zwischen Releases nicht geändert hat, behält ihre Version. Sie ist optional, aber Pflicht, wenn du auch ETIM-MC-Daten (Modelling Class) schickst.
  • Das dynamische Release ist erlaubt. Statt 10.0 kannst du DYNAMIC schreiben, und dann wird EtimDynamicReleaseDate Pflicht. Prüfe, ob dein Empfänger Daten im dynamischen Release annimmt, bevor du es nutzt.
  • Die Klasse bestimmt die Merkmalsliste. Alle Merkmale der Klasse in diesem Release müssen gesendet werden, abgesehen von lokalen Standardmerkmalen (Codes wie EFUK0001). Ein neues Release kann einer Klasse Merkmale hinzufügen, sodass ein Produkt, das in 10.0 vollständig war, im nächsten Release neue Werte brauchen kann.

Das nächste große Release steht kurz bevor: ETIM International hat ETIM 11.0 für die finale Veröffentlichung am 1. Dezember 2026 geplant, nach einer Frist für Änderungsanträge am 30. Juni 2026. Empfänger wechseln nach ihrem eigenen Zeitplan auf ein neues Release, rechne also damit, eine Zeit lang an manche ETIM 10.0 und an andere 11.0 zu liefern, und führe das Release als explizite Einstellung pro Empfänger statt als „neueste“. Unser ETIM-Leitfaden erklärt das Modell aus Klasse, Merkmal und Wert hinter diesen Codes.

Deine Datenlieferung von ETIM BMEcat auf xChange umstellen

Checkliste für den Wechsel von BMEcat zu xChange

0 von 9 erledigt0%

Lass beide Formate mindestens einen vollen Zyklus parallel laufen. Das Importprotokoll eines Empfängers sagt dir mehr als eine gültige Schemaprüfung: Es zeigt, welche Felder er tatsächlich mappt und wo sein Datenmodell kürzer oder strenger ist als der Standard.

ETIM-Daten in WISEPIM vorbereiten, vor jedem xChange-Export

WISEPIM exportiert kein ETIM xChange. Was es abdeckt, sind die Inhalte, aus denen eine xChange-Datei gebaut wird. In der Produktklassifizierung übernimmst du ETIM-10.0-Klassen pro Produktfamilie, Produkte erben die Klasse, Merkmalswerte werden gegen die zulässigen Werte und Einheiten der Klasse geprüft, und ein ETIM-Konformitätswert zeigt pro Produkt, wie viele Klassenmerkmale gültig sind. Von dort schreibt der Feed Hub eine BMEcat-Datei mit ETIM-Merkmalen (einfaches BMEcat 2005, nicht das Profil des ETIM-Leitfadens 5.0), und ein CSV- oder XLSX-Export kann die ETIM-Merkmalsattribute als Spalten deiner Wahl enthalten, für einen Konverter oder einen Datenpool-Upload, der das JSON schreibt. Teste mit jedem Empfänger eine Datei, bevor du dich auf einen der beiden Wege verlässt.

Wenn du nicht sicher bist, ob deine Lieferantendateien für eines der Formate bereit sind: Beim kostenlosen Data Readiness Check geht eine Person eine Datei mit dir durch und zeigt, was ein Empfänger ablehnen würde.

Diego Nijboer

CTO und Mitgründer von WISEPIM. Ich baue AI-gestützte Lösungen, die das Produktdatenmanagement für E-Commerce-Unternehmen verändern. Über 10 Jahre Erfahrung im Lösen komplexer technischer Herausforderungen im E-Commerce und bei PIM-Systemen.

Häufig gestellte Fragen

Noch Fragen?

Keine passende Antwort gefunden? Melde dich bei unserem Team.

Support kontaktieren

ETIM xChange ist ein JSON-basiertes Austauschformat für Produktstammdaten, das ETIM International gehört und von ETIM International entwickelt wird. Es transportiert Katalog-, Lieferanten-, Produkt-, Handelsartikel- und Verpackungsdaten plus ETIM-Klassifizierung und Merkmale und bringt ein JSON Schema zur Validierung mit. Version 1.0 erschien im Februar 2024, Version 2.0 im November 2025. Es löst den ETIM-BMEcat-Leitfaden als empfohlenes Format von ETIM ab.

Es ersetzt den BMEcat-Leitfaden von ETIM, nicht BMEcat selbst. ETIM International hat seinen letzten ETIM-BMEcat-Leitfaden, Version 5.0, 2021 veröffentlicht und empfiehlt jetzt xChange. BMEcat bleibt ein Standard des deutschen Verbands BME, und viele Großhändler, Datenpools und Beschaffungsplattformen nehmen weiterhin ETIM-BMEcat-Dateien an. In der Praxis liefern Lieferanten oft beide Formate, bis jeder Empfänger bestätigt hat, dass er xChange importiert.

Nutze Version 2.0, solange ein Empfänger nichts anderes verlangt. Sie wurde am 27. November 2025 veröffentlicht, und das Validierungstool von ETIM unterstützt sie seit Dezember 2025. Version 1.1 war ein abwärtskompatibler Patch von 1.0, also validieren 1.0-Dateien gegen 1.1. Der niederländische Datenpool 2BA nimmt 1.0, 1.1 und 2.0 an, empfiehlt für neue Entwicklungen aber 2.0.

Auf internationaler Ebene nicht: Der Etim-Teilbaum und seine Merkmale sind optional, also lassen sich auch nicht klassifizierte Produkte austauschen. Sobald ein Produkt eine ETIM-Klasse trägt, müssen alle Merkmale dieser Klasse enthalten sein, mit ReasonNoValue NA, MV oder UN, wo kein Wert angegeben werden kann. Einzelne ETIM-Länder und Datenpools können optionale Felder zur Pflicht machen, prüfe also die Anforderungen jedes Empfängers.

Validiere sie gegen das JSON Schema im Dokumentationspaket von ETIM International, das kann jeder JSON-Schema-Validator. ETIM-Mitglieder können Dateien außerdem in das ETIM-xChange-Validierungstool hochladen, das das Schema und die referenzierte ETIM-Klassifizierung prüft, die Schema-Version erkennt und ein Validierungszertifikat ausstellen kann. Der Zugang läuft über den ETIM-CMT-Login deines lokalen ETIM-Büros.

Weiter entdecken

Handverlesene nächste Schritte, um tiefer einzusteigen.

Bessere Produktdaten, bessere Ergebnisse.Mehr Umsatz erzielen.

4,7