BMEcat est le format XML d'échange de catalogues produits B2B, publié par l'association allemande des achats BME (Bundesverband Materialwirtschaft, Einkauf und Logistik). Un fichier BMEcat contient un en-tête de catalogue (qui l'envoie, quel catalogue, quelle langue) et une transaction : un nouveau catalogue complet, une mise à jour de produits ou une mise à jour de prix. Chaque produit y porte la référence article du fournisseur, une description courte, des unités de commande, des prix et, dans les métiers techniques, un bloc de caractéristiques ETIM.
La version actuelle est la 2005.2, selon la page BMEcat de BME, mais quand un grossiste en matériel électrique ou en installation demande « du BMEcat », il veut presque toujours dire BMEcat 2005 rempli comme le décrit la directive ETIM BMEcat. Tu trouveras ci-dessous un fichier minimal annoté, les trois types de transactions, la manière de construire un fichier à partir des données que tu as déjà, et les raisons pour lesquelles les destinataires rejettent réellement des fichiers, tirées de la spécification, de la directive ETIM et du pool de données néerlandais 2BA.
Ce qu'est un fichier BMEcat, et qui en demande
BMEcat 1.0 est apparu en novembre 1999 comme format commun pour les catalogues produits électroniques dans les achats. La spécification BMEcat 2005 est d'abord rédigée en allemand, ce qui explique en partie qu'une grande part des recherches sur BMEcat, « BMEcat erstellen » et « BMEcat Format » vienne d'Allemagne, et que beaucoup de manuels d'import des destinataires utilisent les libellés allemands des éléments (Kopfbereich, Kurzbeschreibung, Bestelleinheit).
Deux groupes de destinataires le demandent aujourd'hui :
- Les plateformes d'achat et les systèmes acheteurs qui chargent des catalogues hébergés, l'équivalent des sessions en direct décrites dans notre guide du catalogue punchout.
- Les grossistes techniques et les pools de données dans les métiers de l'électricité, du génie climatique et de la plomberie, où BMEcat transporte les données articles classées selon ETIM. Le pool néerlandais 2BA, par exemple, importe des fichiers BMEcat 2005 rédigés selon la directive ETIM 5.0, à côté du format JSON plus récent ETIM xChange qu'ETIM International recommande désormais à la place de BMEcat.
BMEcat n'est pas une classification. C'est l'enveloppe. ETIM ou ECLASS fournissent les codes de classe et de caractéristique qui vont dedans, et c'est le destinataire qui décide lequel il attend.
BMEcat 1.2, 2005, 2005.1 et 2005.2 : de quelle version parle le destinataire
Les versions BMEcat et la directive ETIM
Mars 2001
BMEcat 1.2
Utilise ARTICLE, SUPPLIER_AID et ARTICLE_FEATURES. Défini uniquement par une DTD, sans schéma XML.
Novembre 2005
BMEcat 2005
Renomme ARTICLE en PRODUCT et SUPPLIER_AID en SUPPLIER_PID, ajoute les parties et des systèmes de caractéristiques plus riches. Tout document 1.2 valide est aussi valide en 2005.
2005.1
BMEcat 2005.1 (advanced)
Uniquement des modules d'extension optionnels, entièrement rétrocompatible avec BMEcat 2005.
Juin 2021
Directive ETIM BMEcat 5.0
Le profil BMEcat 2005 d'ETIM International avec les extensions UDX.EDXF. La révision 5.0.1 a suivi en août 2021. ETIM l'a présentée comme la dernière version ETIM BMEcat.
- 5
Actuelle
BMEcat 2005.2
La version que BME indique comme actuelle sur sa page BMEcat.
La spécification 2005 est explicite sur la compatibilité : BMEcat 2005 est entièrement rétrocompatible avec la 1.2, donc un document de catalogue 1.2 est aussi conforme à la 2005. Les anciens éléments ARTICLE restent dans le schéma mais sont marqués pour être supprimés dans une version ultérieure. ECLASS ajoute que les changements de la 2005.1 sont tous des extensions optionnelles, si bien qu'un fichier 2005 y reste valide lui aussi.
En pratique, la question n'est pas le numéro de version mais le profil. Un fichier BMEcat 2005 simple utilise l'espace de noms http://www.bmecat.org/bmecat/2005. Un fichier rédigé selon la directive ETIM BMEcat 5.0 déclare l'espace de noms et le schéma propres à ETIM, place les images, la marque, les niveaux d'emballage et les indicateurs réglementaires dans des éléments d'extension UDX.EDXF, et se contrôle avec l'outil de certification d'ETIM. ETIM International a indiqué que la 5.0 est la dernière version ETIM BMEcat, mais elle reste utilisée au quotidien. Demande à ton destinataire avec quel XSD il valide les fichiers avant de construire quoi que ce soit.
Un catalogue BMEcat 2005 minimal, annoté
Le tableau parcourt un document de catalogue dans l'ordre du fichier : l'en-tête, puis un produit dans une transaction T_NEW_CATALOG. Le produit est un disjoncteur modulaire 1 pôle C16 fictif d'un fournisseur imaginaire, classé dans la classe ETIM 10.0 EC000042 (Disjoncteur). Les codes de classe, de caractéristique et de valeur sont les vrais codes ETIM 10.0 ; la référence article, les prix et le GTIN de démonstration GS1 sont des exemples.
Catalogue BMEcat 2005 annoté avec un produit classé ETIM
| BMECAT (attribut version) | 2005 | Oui | Élément racine. Son espace de noms décide quel schéma valide le fichier : BMEcat 2005 simple ou le profil de la directive ETIM. | |
|---|---|---|---|---|
| HEADER > CATALOG > LANGUAGE | deu (par défaut), eng | Oui | Sprache | Codes ISO 639-2 à trois lettres, pas de ou en. |
| HEADER > CATALOG > CATALOG_ID | DEMO-SCHALT-2026 | Oui | Katalog-ID | Stable d'une version à l'autre du même catalogue. |
| HEADER > CATALOG > CATALOG_VERSION | 001.004 | Oui | Katalogversion | À augmenter à chaque nouveau catalogue complet. |
| HEADER > SUPPLIER > SUPPLIER_NAME | Demo Schaltgeraete GmbH | Oui | Lieferant | En BMEcat 2005, tu peux utiliser à la place SUPPLIER_IDREF avec un bloc PARTY. |
| T_NEW_CATALOG > PRODUCT (mode new) | Oui | Produkt | ARTICLE est le nom 1.2 du même élément et reste valide. | |
| PRODUCT > SUPPLIER_PID | DS-C16-1P | Oui | Artikelnummer des Lieferanten | 32 caractères maximum ; la spécification prévient que certains systèmes n'en gardent que 18 (SAP). |
| PRODUCT_DETAILS > DESCRIPTION_SHORT | Disjoncteur modulaire 1P C16 6 kA | Oui | Kurzbeschreibung | 150 caractères maximum ; rends les 40 premiers uniques, car SAP OCI et R/3 n'en traitent que 40. |
| PRODUCT_DETAILS > INTERNATIONAL_PID (type gtin) | 9506000134352 | Non | Internationale Produktnummer | Optionnel dans le standard de base ; vérifie la clé de contrôle avant l'envoi. |
| PRODUCT_DETAILS > MANUFACTURER_PID | DS-C16-1P | Non | Herstellerartikelnummer | Souvent identique à SUPPLIER_PID dans le catalogue d'un fabricant. |
| PRODUCT_FEATURES > REFERENCE_FEATURE_SYSTEM_NAME | ETIM-10.0 | Oui (ETIM) | Merkmalsystem | Notation ETIM-x.y pour une version officielle. |
| PRODUCT_FEATURES > REFERENCE_FEATURE_GROUP_ID | EC000042 | Oui (ETIM) | Merkmalgruppe | La classe ETIM. Elle doit exister dans la version indiquée au-dessus. |
| FEATURE: FNAME / FVALUE | EF000889 / EV000084 | Oui (ETIM) | Merkmal | Caractéristique de déclenchement = C. Les caractéristiques alphanumériques portent un code de valeur EV, pas le texte C. |
| FEATURE: FNAME / FVALUE | EF000227 / 16 | Oui (ETIM) | Merkmal | Courant nominal assigné 16 A. Pas de FUNIT : ETIM fixe l'unité par caractéristique. |
| FEATURE: FNAME / FVALUE / FVALUE | EF007515 / -25 / 55 | Oui (ETIM) | Merkmal | Température ambiante en fonctionnement, une caractéristique de plage : deux éléments FVALUE, la limite basse puis la haute. |
| FEATURE: FNAME / FVALUE / FVALUE_DETAILS | EF000218 / - / UN | Oui (ETIM) | Merkmal | Profondeur d'encastrement pas encore connue : un signe moins plus le code motif. |
| PRODUCT_ORDER_DETAILS > ORDER_UNIT | C62 | Oui | Bestelleinheit | Code d'unité (C62 = pièce), pas Stk ni pcs. Les prix se rapportent à cette unité. |
| PRODUCT_ORDER_DETAILS > CONTENT_UNIT | C62 | Oui | Inhaltseinheit | L'unité contenue dans une unité de commande. |
| PRODUCT_ORDER_DETAILS > NO_CU_PER_OU | 1 | Non | Verpackungsmenge | Unités de contenu par unité de commande ; 1 par défaut. |
| PRODUCT_PRICE_DETAILS > PRODUCT_PRICE (price_type net_list) > PRICE_AMOUNT | 7.85 | Oui | Produktpreis | Point comme séparateur décimal. PRICE_CURRENCY EUR se trouve juste à côté. |
| MIME_INFO > MIME > MIME_SOURCE | ds-c16-1p.jpg | Non | Multimediale Zusatzdaten | La directive ETIM déplace les images vers UDX.EDXF.MIME_INFO avec des codes MD. |
Remarque le peu d'éléments obligatoires dans le standard de base : un ID de catalogue, une version et une langue, un fournisseur, et par produit une référence article, une description courte, une unité de commande, une unité de contenu et un prix. Tout ce dont un grossiste a réellement besoin pour vendre, comme le GTIN, la marque, les images, les niveaux d'emballage et les caractéristiques, est optionnel dans BMEcat lui-même et rendu obligatoire par la directive du destinataire.
Comment les valeurs de caractéristiques ETIM s'écrivent dans un fichier BMEcat
La directive ETIM BMEcat ajoute des règles que le standard de base n'a pas, et la plupart des rejets au niveau des caractéristiques en viennent :
- Toutes les caractéristiques de la classe doivent être présentes. Si un produit est rattaché à une classe ETIM, toutes les caractéristiques de cette classe vont dans le fichier, à l'exception des caractéristiques standard locales (codes comme EFUK0001).
- L'absence de valeur s'écrit avec un signe moins. Livre FVALUE « - » et, en option, un motif dans FVALUE_DETAILS : NA (non applicable), MV (aucune valeur correcte n'existe dans cette version ETIM) ou UN (inconnue pour l'instant). Une caractéristique de plage sans valeur reçoit un seul signe moins, pas deux.
- Les types de valeurs sont stricts. Les caractéristiques numériques et de plage prennent des nombres, les caractéristiques logiques prennent true ou false, les caractéristiques alphanumériques prennent le code EV de la liste de valeurs autorisées de la classe.
- Les unités restent en dehors. La directive indique que FUNIT n'est pas nécessaire et en général pas souhaité pour les caractéristiques ETIM, car la définition de la classe fixe l'unité. Convertis dans cette unité avant d'écrire le nombre (consulte notre guide des unités de mesure pour comprendre pourquoi la confusion entre mm et cm est l'erreur classique).
Nouveau catalogue, mise à jour de produits ou de prix : les trois transactions
BMEcat définit trois transactions, et l'élément de transaction se place directement sous BMECAT, après l'en-tête :
- T_NEW_CATALOG transmet un catalogue complet. Le destinataire le charge comme nouveau et ne reprend rien des versions précédentes. Tous les destinataires le prennent en charge.
- T_UPDATE_PRODUCTS n'envoie que les produits nouveaux, modifiés ou supprimés, chacun marqué avec le mode new, update ou delete.
- T_UPDATE_PRICES n'envoie que les informations de prix et remplace tous les prix enregistrés pour les produits du fichier.
Les transactions de mise à jour portent un attribut prev_version qui compte les mises à jour depuis le dernier catalogue complet : 0 pour la première, 1 pour la deuxième, et ainsi de suite. La directive ETIM en tire la conséquence : si une mise à jour manque chez le destinataire, toutes les suivantes sont invalides et tu dois envoyer un nouveau catalogue complet. Qu'un destinataire accepte ou non les mises à jour relève d'un accord bilatéral. ETIM définit aussi sa propre transaction allégée, T_NEW_PRODUCTDATA, pour les données les plus importantes des nouveaux produits ; elle ne fait pas partie de BMEcat lui-même.
Pourquoi les destinataires rejettent des fichiers BMEcat : onze causes
Elles viennent de la spécification BMEcat 2005, de la directive ETIM BMEcat 5.0 et de la liste d'erreurs fréquentes que le pool de données néerlandais 2BA publie pour BMEcat 2005 ETIM 5.0. Les six premières sont des erreurs de schéma qu'un validateur détecte en quelques secondes ; les cinq dernières passent le schéma et échouent chez le destinataire.
- Mauvais en-tête. Espace de noms, emplacement du schéma ou attribut de version qui ne correspondent pas au profil avec lequel le destinataire valide les fichiers.
- Éléments obligatoires manquants, le plus souvent ORDER_UNIT ou CONTENT_UNIT, ou un bloc FEATURE absent pour un produit classé ETIM.
- Éléments dans le désordre. Le schéma définit une séquence (SUPPLIER_PID, détails, caractéristiques, détails de commande, prix, médias). Les générateurs qui ajoutent des champs à la fin la cassent.
- Éléments optionnels vides, comme une balise EAN ou KEYWORD vide. Omets plutôt l'élément.
- Caractères spéciaux non échappés, surtout une esperluette nue dans une description (Schalter & Taster). Elle doit s'écrire &.
- XML cassé : une balise ouvrante sans balise fermante ou l'inverse, en général après des retouches à la main.
- Jeux de caractéristiques incomplets : des caractéristiques omises au lieu d'être livrées avec « - » et un code motif.
- Du texte au lieu de codes : C16 écrit dans une caractéristique alphanumérique au lieu d'EV000084, ou Stk au lieu de C62 comme unité de commande.
- Des valeurs plus longues que ce que le destinataire stocke. BMEcat autorise 150 caractères pour DESCRIPTION_SHORT ; le modèle de données de 2BA en garde 70. SUPPLIER_PID en autorise 32 ; certains ERP en gardent 18.
- Une chaîne de mises à jour rompue : un T_UPDATE_PRODUCTS avec un prev_version qui en saute un, ce qui impose un nouveau catalogue complet.
- Règles de texte par pays. Pour l'Allemagne et l'Autriche, la directive ETIM interdit dans les descriptions courtes et longues la mise en forme de police, les points-virgules, les guillemets, les tirets longs et les apostrophes, les mots en majuscules et le HTML (sauf échappé), et demande de ne pas y répéter les références articles ni les noms de fabricants.
Construire un fichier BMEcat à partir de tes propres données produit
Que tu utilises un convertisseur, un module d'ERP ou un PIM, le travail est le même, et l'essentiel se fait avant qu'une ligne de XML n'existe :
- Obtiens le profil du destinataire. BMEcat 2005 simple ou directive ETIM 5.0, quelle version ETIM (par exemple ETIM-10.0), quelles langues, quel type de prix (net_list, net_customer, nrp) et quels champs optionnels il traite comme obligatoires.
- Fiabilise d'abord les identifiants. Une référence article fournisseur unique par produit, des GTIN valides (teste-les avec le validateur EAN/GTIN), des références fabricant quand elles diffèrent.
- Classe chaque produit dans une classe ETIM de cette version (notre guide de classification ETIM détaille cette étape pas à pas) et remplis ses caractéristiques, avec « - » et NA, MV ou UN quand une valeur n'existe pas ou n'est pas connue.
- Convertis les unités en codes. Unité de commande, unité de contenu et nombre de pièces par unité de commande en codes UN/ECE (C62 pour la pièce, PK pour le paquet), valeurs de caractéristiques converties dans l'unité prescrite par ETIM.
- Raccourcis et nettoie les textes selon les longueurs et les règles par pays du destinataire.
- Génère le fichier et valide-le avec le XSD du destinataire. Les membres ETIM peuvent utiliser l'outil de certification BMEcat d'ETIM International ; tout le monde peut lancer un validateur XSD générique.
- Envoie d'abord un petit fichier de test, avec quelques produits de classes différentes, et demande au destinataire son journal d'import, pas seulement un « reçu ».
Contrôle BMEcat avant envoi
Si tu reçois des fichiers BMEcat au lieu d'en envoyer, la même liste fonctionne à l'envers comme contrôle à la réception : un fichier fournisseur qui échoue aux points 3, 4 ou 8 échouera de nouveau le mois prochain si les données sources ne sont pas corrigées. Si tu veux un deuxième avis sur un fichier fournisseur, notre diagnostic de données produit gratuit, c'est une personne qui le passe en revue avec toi.
Générer du BMEcat 2005 avec caractéristiques ETIM depuis WISEPIM
Dans WISEPIM, l'export est un canal Feed Hub appelé BMEcat 2005 (ETIM). Tu remplis l'en-tête du catalogue (nom et ID du fournisseur, ID et version du catalogue, territoire, acheteur) et tu fixes la version ETIM de ce flux (ETIM 10.0 est la version chargée dans WISEPIM aujourd'hui). Les produits reçoivent leur classe ETIM par leur famille de produits dans la classification des produits ; un produit dont la famille n'a pas de classe ETIM est laissé hors du fichier et compté comme ignoré, car un article qui déclare un système de caractéristiques sans classe est invalide.
Sois clair sur ce qu'est ce fichier, car ce n'est pas ce qu'attend un destinataire qui valide selon la directive ETIM 5.0. WISEPIM écrit un T_NEW_CATALOG sous l'espace de noms BMEcat 2005 simple, avec les noms d'éléments de BMEcat 1.2 (ARTICLE, SUPPLIER_AID, ARTICLE_FEATURES) plutôt que les noms PRODUCT de la 2005, avec un prix par article, et l'unité de commande, l'unité de contenu, la quantité minimale et la taille d'emballage tirées d'attributs. Il n'écrit aucune transaction de mise à jour ni aucune des extensions UDX.EDXF de la directive. Qu'un destinataire accepte ce fichier dépend de son outil d'import : envoie donc un petit fichier de test et demande le journal d'import avant de livrer toute la gamme. Il en va de même dans l'autre sens : l'import XML de Feed Hub lit les blocs de caractéristiques ETIM des fichiers BMEcat qui utilisent les noms ARTICLE, mais pas ceux des fichiers écrits avec les noms PRODUCT de la 2005 ; teste donc un fichier fournisseur avant de bâtir une procédure de réception autour.
Quel que soit l'outil qui écrit le XML, le fichier ne vaut que ce que vaut la fiche article derrière : une référence article, un GTIN valide, une classe ETIM avec chaque caractéristique renseignée, des codes d'unité au lieu de mots. Corrige ces points une fois dans les données produit, et les exports BMEcat, CSV ou XLSX pour chaque destinataire deviennent un réglage plutôt qu'un projet.

