Aller au contenu principal

ETIM xChange : le successeur JSON d'ETIM BMEcat expliqué

Ce qu'est ETIM xChange, sa structure JSON et ses champs ETIM face à ETIM BMEcat, les versions, qui l'accepte et comment passer de BMEcat à xChange.

Diego Nijboer

ETIM xChange : le successeur JSON d'ETIM BMEcat expliqué

ETIM xChange est le format JSON d'ETIM International pour échanger des données de référence produit entre fabricants, grossistes et data pools. Il remplace le guide ETIM BMEcat comme format d'échange recommandé par ETIM : la version 1.0 est sortie le 19 février 2024, et la version actuelle, la 2.0, a été publiée le 27 novembre 2025. Contrairement à BMEcat, un standard allemand des achats pour lequel ETIM a écrit un guide, xChange appartient à ETIM International et à sa communauté, qui le développent.

Pour un fournisseur, le changement concret tient en trois points : le fichier est en JSON avec un JSON Schema publié au lieu de XML, les données produit sont séparées des données d'article commercial (ce qui est fabriqué et ce qui est vendu), et la classification ETIM devient facultative au niveau international, alors que toutes les caractéristiques d'une classe doivent toujours être livrées dès que tu classes. Voici comment le format est construit, comment son bloc ETIM se compare à BMEcat champ par champ, qui l'accepte aujourd'hui, et comment les versions ETIM influent sur ce que tu envoies.

Pourquoi ETIM a créé son propre format d'échange après BMEcat

En mai 2021, ETIM International a annoncé développer un nouveau format d'échange international pour remplacer ETIM BMEcat. Ses raisons, selon cette annonce : le format BMEcat de base était figé depuis des années sans possibilité de demander des modifications, si bien que chaque extension devait être construite comme une extension définie par l'utilisateur (les éléments UDX.EDXF) pour garder des fichiers valides, ce qui rendait le format confus. ETIM BMEcat a reçu une dernière mise à jour, le guide 5.0 en juin 2021, et ETIM a indiqué qu'aucune autre version ne suivrait. Notre guide BMEcat détaille ce format élément par élément.

Le nouveau format a pris plus de temps que prévu. Une première tentative fondée sur le standard néerlandais DICO a été relancée en 2022 avec l'European Master Data Guideline (EMDG) comme base. L'EMDG est publiée par la FEST, la fédération européenne des grossistes en sanitaire et chauffage, et définit les attributs de données de référence communs aux produits. Le guide ETIM xChange précise que l'équipe a aussi harmonisé, quand c'était possible, des contenus d'ETIM BMEcat, de DICO et du format français FAB-DIS.

Le résultat a trois propriétés qu'un utilisateur de BMEcat remarque d'abord. C'est du JSON avec un JSON Schema pour la validation, qu'ETIM présente aussi comme mieux adapté aux échanges web et API qu'un XML limité aux fichiers. Il est publié sous licence Apache 2.0. Et un seul fichier peut contenir plusieurs fournisseurs, ce qui, selon ETIM, le rend particulièrement adapté aux data pools.

De l'annonce à xChange 2.0 : l'historique des versions

Historique des versions d'ETIM xChange

  1. Mai 2021

    Annonce d'un nouveau format d'échange ETIM

    ETIM International décide de remplacer ETIM BMEcat par son propre format.

  2. Juin 2021

    Guide ETIM BMEcat 5.0

    Dernière version d'ETIM BMEcat, avec seulement les changements les plus nécessaires.

  3. 19 février 2024

    ETIM xChange 1.0

    Première version officielle, avec un fichier de correspondance des champs xChange vers les champs ETIM BMEcat.

  4. 27 août 2024

    Version 1.1 et outil de validation

    Version corrective pour les codes des caractéristiques impériales et des caractéristiques standards locales et la longueur du code douanier. Les fichiers faits pour la 1.0 restent valides.

  5. 27 novembre 2025

    ETIM xChange 2.0

    Ajoute des champs environnementaux (ACV/EPD), des données sur les matériaux d'emballage, la prise en charge des numéros de série et des codes de pièces jointes MDX.

  6. 6

    Décembre 2025

    L'outil de validation prend en charge la 2.0

    L'outil de validation réservé aux membres détecte la version de schéma d'un fichier envoyé.

Un piège quand tu te renseignes : la page sur le format d'échange d'ETIM International indique encore « Currently, ETIM xChange 1.1 is applicable », alors que sa propre actualité sur la sortie de la 2.0 et la section téléchargements proposent la version 2.0. Travaille sur la 2.0 sauf si ton destinataire te dit autre chose ; le data pool néerlandais 2BA, par exemple, accepte 1.0, 1.1 et 2.0 mais recommande de baser les nouveaux développements sur la 2.0.

Dans un fichier xChange : catalogue, fournisseur, produit, article commercial

Hiérarchie d'un fichier ETIM xChange

Chargement du diagramme
Seul le niveau Product est obligatoire ; les articles commerciaux et les unités de conditionnement s'ajoutent quand le fichier transporte des données commerciales et logistiques.

La racine du fichier est le catalogue : SchemaVersion (2.0), CatalogueId, CatalogueType, dates de validité, langues, devise. En dessous se trouve un tableau de fournisseurs, et sous chaque fournisseur un tableau de produits. Le fichier d'exemple 2.0 d'ETIM montre les niveaux que remplit une livraison complète :

  • Product (ce qui est fabriqué) : ProductIdentification avec ManufacturerName et ManufacturerProductNumber (tous deux obligatoires), ProductGtin, BrandName et CountryOfOrigin ; ProductDetails avec statut et descriptions ; ProductRelations ; Legislation (RoHS, REACH, DEEE, marchandises dangereuses) ; LcaEnvironmental ; ProductAttachments ; EtimClassification ; et OtherClassifications, où des codes ECLASS, UNSPSC ou d'une classification interne peuvent voyager à côté d'ETIM (notre comparatif ETIM et ECLASS explique quand il te faut les deux).
  • TradeItem (ce qui est vendu) : ItemIdentification avec le SupplierItemNumber obligatoire et ItemGtin ; ItemDetails ; ItemLogisticDetails avec dimensions et poids nets ; Ordering avec OrderUnit, MinimumOrderQuantity et OrderStepSize ; Pricing avec PriceUnit, PriceQuantity, GrossListPrice et TVA.
  • PackagingUnit : code du type d'emballage, quantité et dimensions pour chaque niveau de conditionnement d'un article commercial.

Cette séparation compte pour les données du négoce. L'exemple d'ETIM est un câble que tu peux acheter au mètre, en carton de 100 mètres ou en touret de 1 000 mètres : un seul produit, classé une fois, avec plusieurs articles commerciaux qui ont chacun leur numéro d'article, leur prix et leur unité de commande. Dans une liste d'articles à plat, chacun est un article séparé qui répète les données techniques. Quand un fabricant n'a pas de code distinct pour le produit technique non conditionné, le guide accepte de lister le plus petit article commercial au niveau produit et d'en répéter les identifiants.

Catalogues complets, catalogues de modifications et statut produit

Là où BMEcat utilise trois transactions, xChange utilise un champ. CatalogueType FULL signifie un catalogue complet avec tous les produits et articles commerciaux proposés à l'acheteur. CatalogueType CHANGE signifie que le fichier ne contient que les produits nouveaux, modifiés ou supprimés, et ChangeReferenceCatalogueVersion devient alors obligatoire : il nomme la version antérieure du catalogue à laquelle s'appliquent les modifications. Mets-toi d'accord avec chaque destinataire sur la fréquence d'un fichier FULL pour resynchroniser, car un fichier de modifications manqué désynchronise sa copie, comme une mise à jour BMEcat manquée.

Le cycle de vie passe par des codes de statut plutôt que par la transaction. ProductStatus et ItemStatus prennent les valeurs PRE-LAUNCH, ACTIVE, ON HOLD, PLANNED WITHDRAWAL ou OBSOLETE, pour qu'un grossiste voie qu'un produit est encore en stock mais n'est plus fabriqué. Si ton item master ne connaît qu'actif et inactif, c'est un champ à ajouter avant la première livraison xChange.

Les règles de format qui piègent les premiers fichiers xChange

  • Les noms de champs sont exacts. En PascalCase comme dans le schéma, et chaque objet est fermé avec additionalProperties false : un champ que le schéma ne définit pas fait échouer la validation.
  • Facultatif veut dire absent, pas vide. Tu peux omettre un champ facultatif, mais s'il est dans le fichier, il doit contenir une valeur valide. 2BA cite les tableaux facultatifs vides et les tableaux obligatoires manquants parmi les erreurs xChange fréquentes.
  • Les nombres sont surtout des chaînes avec un motif. GrossListPrice, par exemple, est une chaîne de 11 chiffres au plus, un point et 4 décimales au plus. Pas de séparateur de milliers.
  • Des codes, pas des mots. OrderUnit prend un code d'unité comme C62 ; les langues sont des balises comme en-GB ou nl-NL ; les GTIN ont de 8 à 14 chiffres.
  • Les pièces jointes sont des liens. 2BA note que le schéma 2.0 ne permet pas d'inclure des fichiers physiques, seulement des URL : images et fiches techniques ont donc besoin d'adresses publiques stables.

Les caractéristiques ETIM dans xChange face à ETIM BMEcat

Si tu livres déjà de l'ETIM BMEcat, l'essentiel du travail est du mapping. ETIM publie un fichier de correspondance entre les deux ; le tableau ci-dessous suit ses paires de champs et les définitions de champs du guide 2.0.

ETIM BMEcat 5.0 face à ETIM xChange 2.0

Version ETIMREFERENCE_FEATURE_SYSTEM_NAME, par ex. ETIM-10.0EtimReleaseVersion, par ex. 10.0, ou DYNAMIC avec EtimDynamicReleaseDate
Classe ETIMREFERENCE_FEATURE_GROUP_ID (EC000042)EtimClassCode (EC000042), EtimClassVersion facultatif
CaractéristiqueFNAME (EF000227)EtimFeatureCode (EF000227)
Valeur alphanumériqueFVALUE avec un code EVEtimValueCode
Valeur numériqueFVALUEEtimValueNumeric
Valeur de plageDeux éléments FVALUEEtimValueRangeLower et EtimValueRangeUpper
Valeur logiqueFVALUE true ou falseEtimValueLogical (booléen JSON)
Pas de valeurFVALUE - avec FVALUE_DETAILS NA, MV ou UNReasonNoValue NA, MV ou UN
ETIM est-il obligatoire ?Bloc de caractéristiques obligatoire pour les produits classés ETIMSous-arbre Etim facultatif ; si une classe est donnée, toutes ses caractéristiques doivent être envoyées
Numéro d'article fournisseurSUPPLIER_PID, max. 32SupplierItemNumber, max. 35
Description principaleDESCRIPTION_SHORT, max. 150UniqueMainProductDescription, max. 255
Description très courteUDX.EDXF.DESCRIPTION_VERY_SHORT, max. 40MinimalProductDescription, max. 80, obligatoire
Livraison complète ou partielleT_NEW_CATALOG, T_UPDATE_PRODUCTS, T_UPDATE_PRICESCatalogueType FULL ou CHANGE, avec ChangeReferenceCatalogueVersion
Données propres à un paysUDX.EDXF.PRODUCT_CHARACTERISTICSCountrySpecificFields et CountrySpecificExtensions
14 lignes sur 14
Le contenu ETIM suit le même modèle ; ce qui change, c'est le typage (un champ FVALUE devient des champs de valeur typés), les longueurs et la façon de justifier une caractéristique vide.

Deux lignes méritent l'attention. D'abord, la classification ETIM est passée d'obligatoire à facultative au niveau international : un fabricant peut donc envoyer du xChange avant que chaque produit soit classé. Cela ne veut pas dire que les destinataires l'acceptent : chaque pays ETIM peut rendre obligatoires des champs facultatifs, et un data pool qui vend des données classées demandera la classe. Notre guide pas à pas de la classification ETIM couvre cette partie du travail. Ensuite, les codes de justification ne changent pas : NA (non applicable), MV (aucune valeur correcte n'existe dans cette version ETIM) et UN (inconnu pour l'instant). Si ton export BMEcat écrit déjà « - » avec un code de justification, la logique se transpose.

Qui accepte ETIM xChange aujourd'hui

L'adoption est inégale, et la réponse honnête est « demande à chaque destinataire ». Ce que publient l'organisme de normalisation et les pools :

  • Pays-Bas : 2BA prend en charge ETIM xChange 2.0 en import et en export, y compris les éléments environnementaux ACV, et accepte toujours 1.0 et 1.1. Il liste xChange à côté de BMEcat 2005 ETIM 5.0 et des formats néerlandais dans ses formats d'échange actuels.
  • Italie : en février 2026, METEL, qui représente l'industrie électrotechnique au sein d'ETIM Italie, a adopté une approche hybride : utiliser des données xChange structurées quand elles existent et intégrer étape par étape.
  • L'Autriche, l'Allemagne et la Finlande sont les seuls pays avec des règles propres dans le guide pays d'ETIM pour xChange 2.0 (version 2.01, avril 2026). L'Allemagne fixe des règles de texte pour les descriptions, attend au moins une image principale par article commercial et demande les numéros d'enregistrement DEEE ; l'Autriche rend obligatoires Country AT, FullProductDescription et ProductKeyword ; la Finlande limite MinimalProductDescription à 30 caractères. Les Pays-Bas et la Belgique ne listent aucune règle supplémentaire, même si 2BA définit des caractéristiques néerlandaises comme champs propres au pays.
  • Partout : ETIM International note que certains pays utilisent encore des formats nationaux comme standard sectoriel, à côté ou à la place de xChange et d'ETIM BMEcat.

ETIM International décrit l'adoption de xChange comme en croissance rapide. Prends-le comme le point de vue de l'organisme de normalisation : pour ta propre planification, les destinataires qui comptent sont les deux ou trois grossistes ou pools qui prennent l'essentiel de ton volume, et beaucoup continueront d'accepter ETIM BMEcat pendant un certain temps.

Ce que les versions ETIM changent dans une livraison xChange

Chaque produit classé dans un fichier xChange nomme sa version ETIM dans EtimReleaseVersion, et le code de classe n'est valable que pour cette version. Trois règles du guide 2.0 comptent quand les versions changent :

  • Version ETIM et version de classe sont deux numéros différents. EtimClassVersion compte les modifications d'une classe ; une classe qui n'a pas changé entre deux versions garde son numéro. Il est facultatif, mais obligatoire si tu envoies aussi des données ETIM MC (classe de modélisation).
  • La version dynamique est autorisée. Au lieu de 10.0, tu peux écrire DYNAMIC, et EtimDynamicReleaseDate devient alors obligatoire. Vérifie que ton destinataire accepte les données en version dynamique avant de l'utiliser.
  • La classe pilote la liste des caractéristiques. Toutes les caractéristiques de la classe dans cette version doivent être envoyées, sauf les caractéristiques standards locales (codes comme EFUK0001). Une nouvelle version peut ajouter des caractéristiques à une classe : un produit complet en 10.0 peut donc avoir besoin de nouvelles valeurs dans la version suivante.

La prochaine version majeure approche : ETIM International a prévu ETIM 11.0 pour une sortie définitive le 1er décembre 2026, après une date limite de demandes de modification fixée au 30 juin 2026. Les destinataires passent à une nouvelle version à leur propre rythme : attends-toi à livrer ETIM 10.0 aux uns et 11.0 aux autres pendant un moment, et garde la version comme un réglage explicite par destinataire plutôt que « la dernière ». Notre guide ETIM explique le modèle de classes, caractéristiques et valeurs derrière ces codes.

Passer une livraison fournisseur d'ETIM BMEcat à xChange

Checklist du passage de BMEcat à xChange

0 sur 9 terminés0%

Fais tourner les deux formats en parallèle pendant au moins un cycle complet. Le journal d'import d'un destinataire t'en apprend plus qu'un contrôle de schéma valide : il montre quels champs il mappe réellement, et où son modèle de données est plus court ou plus strict que le standard.

Préparer les données ETIM dans WISEPIM avant tout export xChange

WISEPIM n'exporte pas ETIM xChange. Ce qu'il couvre, c'est le contenu à partir duquel un fichier xChange est construit. Dans la classification produit, tu adoptes des classes ETIM 10.0 par famille de produits, les produits héritent de la classe, les valeurs de caractéristiques sont contrôlées par rapport aux valeurs autorisées et aux unités de la classe, et un score de conformité ETIM montre combien de caractéristiques de la classe sont valides par produit. À partir de là, Feed Hub écrit un fichier BMEcat avec les caractéristiques ETIM (BMEcat 2005 simple, pas le profil du guide ETIM 5.0), et un export CSV ou XLSX peut contenir les attributs de caractéristiques ETIM dans les colonnes que tu choisis, pour un convertisseur ou un envoi vers un data pool qui écrit le JSON. Teste un fichier avec chaque destinataire avant de compter sur l'une ou l'autre voie.

Si tu n'es pas sûr que tes fichiers fournisseurs soient prêts pour l'un ou l'autre format, le data readiness check gratuit, c'est une personne qui examine un fichier avec toi et te montre ce qu'un destinataire rejetterait.

Diego Nijboer

CTO et cofondateur de WISEPIM, je développe des solutions propulsées par l’AI qui transforment la gestion des données produit des entreprises e-commerce. Plus de 10 ans d’expérience dans la résolution de défis techniques complexes dans l’e-commerce et les systèmes PIM.

Questions fréquentes

Tu as encore des questions ?

Tu ne trouves pas la réponse que tu cherches ? Contacte notre équipe.

Contacter le support

ETIM xChange est un format d'échange basé sur JSON pour les données de référence produit, détenu et développé par ETIM International. Il transporte des données de catalogue, de fournisseur, de produit, d'article commercial et de conditionnement, ainsi que la classification et les caractéristiques ETIM, et s'accompagne d'un JSON Schema pour la validation. La version 1.0 est sortie en février 2024 et la version 2.0 en novembre 2025. Il remplace le guide ETIM BMEcat comme format recommandé par ETIM.

Il remplace le guide BMEcat d'ETIM, pas BMEcat lui-même. ETIM International a publié son dernier guide ETIM BMEcat, la version 5.0, en 2021 et recommande désormais xChange. BMEcat reste un standard de l'association allemande BME, et beaucoup de grossistes, de data pools et de plateformes d'achat acceptent encore les fichiers ETIM BMEcat. En pratique, les fournisseurs livrent souvent les deux formats jusqu'à ce que chaque destinataire confirme importer du xChange.

Utilise la version 2.0, sauf si un destinataire demande autre chose. Elle est sortie le 27 novembre 2025, et l'outil de validation d'ETIM la prend en charge depuis décembre 2025. La version 1.1 était un correctif rétrocompatible de la 1.0, donc les fichiers 1.0 sont valides en 1.1. Le data pool néerlandais 2BA accepte 1.0, 1.1 et 2.0 mais recommande de baser les nouveaux développements sur la 2.0.

Pas au niveau international : le sous-arbre Etim et ses caractéristiques sont facultatifs, donc des produits non classés peuvent quand même être échangés. Dès qu'un produit porte une classe ETIM, toutes les caractéristiques de cette classe doivent être incluses, avec ReasonNoValue NA, MV ou UN quand aucune valeur ne peut être donnée. Chaque pays ETIM et chaque data pool peut rendre obligatoires des champs facultatifs : vérifie les exigences de chaque destinataire.

Valide-le avec le JSON Schema du pack de documentation d'ETIM International ; n'importe quel validateur JSON Schema sait le faire. Les membres ETIM peuvent aussi envoyer leurs fichiers dans l'outil de validation ETIM xChange, qui contrôle le schéma et la classification ETIM référencée, détecte la version de schéma et peut délivrer un certificat de validation. L'accès se fait avec l'identifiant ETIM CMT fourni par ton bureau ETIM local.

Continue d'explorer

Une sélection d'étapes suivantes pour aller plus loin.

De meilleures données produit, de meilleurs résultats.Génère plus de ventes.

4,7