Naar hoofdinhoud

BMEcat-bestand: het XML-catalogusformaat per element uitgelegd

BMEcat uitgelegd voor leveranciers en groothandels: een BMEcat 2005-bestand met ETIM-kenmerken per element, de drie transacties en elf afkeurredenen.

BMEcat-bestand: het XML-catalogusformaat per element uitgelegd

BMEcat is het XML-formaat voor het uitwisselen van B2B-productcatalogi, uitgegeven door de Duitse inkoopvereniging BME (Bundesverband Materialwirtschaft, Einkauf und Logistik). Eén BMEcat-bestand bevat een catalogusheader (wie stuurt het, welke catalogus, welke taal) en één transactie: een complete nieuwe catalogus, een productupdate of een prijsupdate. Elk artikel erin heeft het artikelnummer van de leverancier, een korte omschrijving, besteleenheden, prijzen en in de technische branche een blok ETIM-kenmerken.

De actuele versie is 2005.2, volgens de BMEcat-pagina van BME zelf. Maar als een elektrotechnische of installatiegroothandel om "een BMEcat" vraagt, bedoelt die bijna altijd BMEcat 2005, ingevuld volgens de ETIM BMEcat-richtlijn. Hieronder vind je een minimaal BMEcat-bestand met uitleg per element, de drie transactietypes, hoe je een bestand opbouwt uit artikelgegevens die je al hebt en de redenen waarom ontvangers bestanden echt afkeuren, uit de specificatie, de ETIM-richtlijn en de documentatie van 2BA.

Wat een BMEcat-bestand is en wie erom vraagt

BMEcat 1.0 verscheen in november 1999 als gemeenschappelijk formaat voor elektronische productcatalogi in de inkoop. De BMEcat 2005-specificatie is in de eerste plaats Duits. Daarom gebruiken veel importhandleidingen de Duitse elementlabels (Kopfbereich, Kurzbeschreibung, Bestelleinheit), ook als je vanuit Nederland of België aanlevert aan een Duitse afnemer.

Twee soorten ontvangers vragen er vandaag om:

  • Inkoopplatforms en inkoopsystemen van afnemers die gehoste catalogi inlezen, de tegenhanger van de live sessies uit onze gids over punchout-catalogi.
  • Technische groothandels en datapools in elektrotechniek, installatietechniek en sanitair, waar BMEcat de drager is voor ETIM-geclassificeerde artikelgegevens. 2BA importeert bijvoorbeeld BMEcat 2005-bestanden volgens ETIM-richtlijn 5.0, naast het nieuwere JSON-formaat ETIM xChange dat ETIM International nu aanbeveelt in plaats van BMEcat.

BMEcat is geen classificatie. Het is de envelop. ETIM of ECLASS leveren de klasse- en kenmerkcodes die erin gaan, en de ontvanger bepaalt welke hij verwacht.

BMEcat 1.2, 2005, 2005.1 en 2005.2: welke versie een ontvanger bedoelt

BMEcat-versies en de ETIM-richtlijn

  1. Maart 2001

    BMEcat 1.2

    Gebruikt ARTICLE, SUPPLIER_AID en ARTICLE_FEATURES. Alleen een DTD, geen XML-schema.

  2. November 2005

    BMEcat 2005

    Hernoemt ARTICLE naar PRODUCT en SUPPLIER_AID naar SUPPLIER_PID, voegt partijen en uitgebreidere kenmerksystemen toe. Elk geldig 1.2-document is ook geldig in 2005.

  3. 2005.1

    BMEcat 2005.1 (advanced)

    Alleen optionele uitbreidingsmodules, volledig achterwaarts compatibel met BMEcat 2005.

  4. Juni 2021

    ETIM BMEcat-richtlijn 5.0

    Het profiel van ETIM International op BMEcat 2005, met UDX.EDXF-uitbreidingen. Revisie 5.0.1 volgde in augustus 2021. ETIM noemde dit de laatste ETIM BMEcat-versie.

  5. 5

    Actueel

    BMEcat 2005.2

    De versie die BME op zijn BMEcat-pagina als actueel vermeldt.

De 2005-specificatie is duidelijk over compatibiliteit: BMEcat 2005 is volledig achterwaarts compatibel met 1.2, dus een 1.2-catalogus voldoet ook aan 2005. De oude ARTICLE-elementen blijven in het schema, maar zijn gemarkeerd om in een latere versie te vervallen. ECLASS voegt toe dat alle wijzigingen in 2005.1 optionele uitbreidingen zijn, dus een 2005-bestand blijft daar ook geldig.

In de praktijk gaat het niet om het versienummer, maar om het profiel. Een kaal BMEcat 2005-bestand gebruikt de namespace http://www.bmecat.org/bmecat/2005. Een bestand volgens ETIM BMEcat-richtlijn 5.0 declareert de eigen namespace en het schema van ETIM, zet afbeeldingen, merk, verpakkingsniveaus en wettelijke kenmerken in UDX.EDXF-uitbreidingselementen en wordt gecontroleerd met de certificeringstool van ETIM. ETIM International heeft 5.0 de laatste ETIM BMEcat-versie genoemd, maar die wordt nog dagelijks gebruikt. Vraag je ontvanger dus eerst tegen welk XSD hij valideert, voordat je iets bouwt.

Een minimale BMEcat 2005-catalogus, element voor element

De tabel loopt één catalogusdocument door in de volgorde van het bestand: eerst de header, dan één artikel binnen een T_NEW_CATALOG-transactie. Het artikel is een illustratieve eenpolige C16-installatieautomaat van een fictieve leverancier, geclassificeerd in ETIM 10.0-klasse EC000042 (Miniature circuit breaker). Klasse-, kenmerk- en waardecodes zijn de echte ETIM 10.0-codes; artikelnummer, prijs en de GS1-demonstratie-GTIN zijn voorbeelden.

BMEcat 2005-catalogus met één ETIM-geclassificeerd artikel

BMECAT (attribuut version)2005JaRoot-element. De namespace bepaalt welk schema het bestand valideert: kaal BMEcat 2005 of het ETIM-richtlijnprofiel.
HEADER > CATALOG > LANGUAGEdeu (standaard), dutJaSpracheDriecijferige ISO 639-2-codes, niet de of nl.
HEADER > CATALOG > CATALOG_IDDEMO-SCHALT-2026JaKatalog-IDBlijft gelijk over versies van dezelfde catalogus.
HEADER > CATALOG > CATALOG_VERSION001.004JaKatalogversionVerhoog bij elke nieuwe volledige catalogus.
HEADER > SUPPLIER > SUPPLIER_NAMEDemo Schaltgeraete GmbHJaLieferantIn BMEcat 2005 mag je ook SUPPLIER_IDREF met een PARTY-blok gebruiken.
T_NEW_CATALOG > PRODUCT (mode new)JaProduktARTICLE is de 1.2-naam voor hetzelfde element en valideert nog steeds.
PRODUCT > SUPPLIER_PIDDS-C16-1PJaArtikelnummer des LieferantenMax. 32 tekens; de spec waarschuwt dat sommige systemen er maar 18 bewaren (SAP).
PRODUCT_DETAILS > DESCRIPTION_SHORTInstallatieautomaat 1P C16 6 kAJaKurzbeschreibungMax. 150 tekens; maak de eerste 40 uniek, want SAP OCI en R/3 verwerken er maar 40.
PRODUCT_DETAILS > INTERNATIONAL_PID (type gtin)9506000134352NeeInternationale ProduktnummerOptioneel in de basisstandaard; controleer het controlecijfer voor verzending.
PRODUCT_DETAILS > MANUFACTURER_PIDDS-C16-1PNeeHerstellerartikelnummerVaak gelijk aan SUPPLIER_PID in de eigen catalogus van een fabrikant.
PRODUCT_FEATURES > REFERENCE_FEATURE_SYSTEM_NAMEETIM-10.0Ja (ETIM)MerkmalsystemNotatie ETIM-x.y voor een officiële release.
PRODUCT_FEATURES > REFERENCE_FEATURE_GROUP_IDEC000042Ja (ETIM)MerkmalgruppeDe ETIM-klasse. Moet bestaan in de genoemde release.
FEATURE: FNAME / FVALUEEF000889 / EV000084Ja (ETIM)MerkmalUitschakelkarakteristiek = C. Alfanumerieke kenmerken krijgen een EV-waardecode, niet de tekst C.
FEATURE: FNAME / FVALUEEF000227 / 16Ja (ETIM)MerkmalNominale stroom 16 A. Geen FUNIT: ETIM legt de eenheid per kenmerk vast.
FEATURE: FNAME / FVALUE / FVALUEEF007515 / -25 / 55Ja (ETIM)MerkmalOmgevingstemperatuur tijdens bedrijf, een bereikkenmerk: twee FVALUE-elementen, eerst onder- dan bovengrens.
FEATURE: FNAME / FVALUE / FVALUE_DETAILSEF000218 / - / UNJa (ETIM)MerkmalInbouwdiepte nog onbekend: een minteken plus de redencode.
PRODUCT_ORDER_DETAILS > ORDER_UNITC62JaBestelleinheitEenheidscode (C62 = stuk), niet st of stuks. Prijzen gelden voor deze eenheid.
PRODUCT_ORDER_DETAILS > CONTENT_UNITC62JaInhaltseinheitDe eenheid binnen één besteleenheid.
PRODUCT_ORDER_DETAILS > NO_CU_PER_OU1NeeVerpackungsmengeAantal inhoudseenheden per besteleenheid; standaard 1.
PRODUCT_PRICE_DETAILS > PRODUCT_PRICE (price_type net_list) > PRICE_AMOUNT7.85JaProduktpreisPunt als decimaalteken, ook voor Nederlandse prijzen. PRICE_CURRENCY EUR staat ernaast.
MIME_INFO > MIME > MIME_SOURCEds-c16-1p.jpgNeeMultimediale ZusatzdatenDe ETIM-richtlijn verplaatst afbeeldingen naar UDX.EDXF.MIME_INFO met MD-codes.
21 van 21 rijen
Illustratief voorbeeld: van boven naar beneden is dit de volgorde die de XML moet aanhouden; een juiste waarde op de verkeerde plek faalt nog steeds op de schemavalidatie.

Kijk hoe weinig de basisstandaard verplicht stelt: een catalogus-ID, versie en taal, een leverancier, en per artikel een artikelnummer, een korte omschrijving, een besteleenheid, een inhoudseenheid en één prijs. Alles waar een groothandel echt mee verkoopt, zoals GTIN, merk, afbeeldingen, verpakkingsniveaus en kenmerken, is optioneel in BMEcat zelf en wordt verplicht via de richtlijn van de ontvanger.

Zo schrijf je ETIM-kenmerkwaarden in een BMEcat-bestand

De ETIM BMEcat-richtlijn voegt regels toe die de basisstandaard niet heeft, en de meeste afkeuringen op kenmerkniveau komen daarvandaan:

  • Elk kenmerk van de klasse moet erin. Is een artikel aan een ETIM-klasse toegewezen, dan gaan alle kenmerken van die klasse mee, behalve lokale normkenmerken (codes als EFUK0001).
  • Geen waarde schrijf je als minteken. Lever FVALUE "-" en eventueel een reden in FVALUE_DETAILS: NA (niet van toepassing), MV (er bestaat geen juiste waarde in deze ETIM-versie) of UN (nu nog onbekend). Een bereikkenmerk zonder waarde krijgt één minteken, niet twee.
  • Waardetypes zijn strikt. Numerieke en bereikkenmerken krijgen getallen, logische kenmerken true of false, alfanumerieke kenmerken de EV-code uit de toegestane waardelijst van de klasse.
  • Eenheden laat je weg. Volgens de richtlijn is FUNIT bij ETIM-kenmerken niet nodig en meestal ongewenst, omdat de klasse de eenheid vastlegt. Reken dus eerst om naar die eenheid (in onze gids over meeteenheden lees je waarom mm en cm de klassieke fout zijn).

Nieuwe catalogus, productupdate of prijsupdate: de drie transacties

BMEcat kent drie transacties. Het transactie-element staat direct onder BMECAT, na de header:

  • T_NEW_CATALOG levert een complete catalogus. De ontvanger laadt hem als nieuw en neemt niets over uit eerdere versies. Elke ontvanger ondersteunt deze transactie.
  • T_UPDATE_PRODUCTS stuurt alleen nieuwe, gewijzigde of verwijderde artikelen, elk gemarkeerd met mode new, update of delete.
  • T_UPDATE_PRICES stuurt alleen prijsinformatie en vervangt alle opgeslagen prijzen van de artikelen in het bestand.

De updatetransacties hebben een attribuut prev_version dat de updates sinds de laatste volledige catalogus telt: 0 voor de eerste, 1 voor de tweede, enzovoort. De ETIM-richtlijn benoemt het gevolg: mist de ontvanger één update, dan is elke volgende update ongeldig en moet je een nieuwe volledige catalogus sturen. Of een ontvanger updates überhaupt accepteert, spreek je onderling af. ETIM heeft daarnaast een eigen lichte transactie, T_NEW_PRODUCTDATA, voor de belangrijkste gegevens van nieuwe artikelen; die hoort niet bij BMEcat zelf.

Waarom ontvangers BMEcat-bestanden afkeuren: elf oorzaken

Deze oorzaken komen uit de BMEcat 2005-specificatie, ETIM BMEcat-richtlijn 5.0 en de lijst met veelgemaakte fouten die 2BA publiceert voor BMEcat 2005 ETIM 5.0. De eerste zes zijn schemafouten die een validator in seconden vindt; de laatste vijf komen door het schema heen en stranden bij de ontvanger.

  1. Verkeerde header. Namespace, schemalocatie of versie-attribuut passen niet bij het profiel waartegen de ontvanger valideert.
  2. Ontbrekende verplichte elementen, meestal ORDER_UNIT of CONTENT_UNIT, of een ontbrekend FEATURE-blok bij een ETIM-geclassificeerd artikel.
  3. Elementen in de verkeerde volgorde. Het schema schrijft een volgorde voor (SUPPLIER_PID, details, kenmerken, bestelgegevens, prijzen, media). Generators die velden achteraan toevoegen, breken die.
  4. Lege optionele elementen, zoals een lege EAN- of KEYWORD-tag. Laat het element dan weg.
  5. Niet-geëscapete speciale tekens, vooral een losse ampersand in een omschrijving (Schakelaar & drukknop). Die moet als & in het bestand.
  6. Kapotte XML: een openingstag zonder sluittag of andersom, meestal na handmatige aanpassingen.
  7. Onvolledige kenmerksets: kenmerken weggelaten in plaats van aangeleverd als "-" met een redencode.
  8. Tekst in plaats van codes: C16 in een alfanumeriek kenmerk in plaats van EV000084, of st in plaats van C62 als besteleenheid.
  9. Waarden langer dan de ontvanger opslaat. BMEcat staat 150 tekens toe voor DESCRIPTION_SHORT; het datamodel van 2BA bewaart er 70. SUPPLIER_PID mag 32 tekens hebben; sommige ERP-systemen bewaren er 18.
  10. Een gebroken updateketen: een T_UPDATE_PRODUCTS waarvan de prev_version er één overslaat, waardoor je een volledige nieuwe catalogus moet sturen.
  11. Teksteisen per land. Voor Duitsland en Oostenrijk verbiedt de ETIM-richtlijn opmaak, puntkomma's, aanhalingstekens, lange streepjes en apostrofs in korte en lange omschrijvingen, woorden in hoofdletters en HTML (tenzij geëscapet), en vraagt ze om geen artikelnummers of fabrikantnamen te herhalen.

Een BMEcat-bestand opbouwen uit je eigen artikelgegevens

Of je nu een converter, een ERP-module of een PIM gebruikt, het werk is hetzelfde, en het meeste gebeurt voordat er XML bestaat:

  1. Vraag het profiel van de ontvanger op. Kaal BMEcat 2005 of ETIM-richtlijn 5.0, welke ETIM-release (bijvoorbeeld ETIM-10.0), welke talen, welk prijstype (net_list, net_customer, nrp) en welke optionele velden hij als verplicht behandelt.
  2. Zet eerst de identificatie recht. Eén uniek artikelnummer per artikel, geldige GTIN's (test ze met de EAN/GTIN-validator) en fabrikantnummers waar die afwijken.
  3. Classificeer elk artikel in een ETIM-klasse van die release (in onze stappen voor ETIM-classificatie lees je hoe) en vul de kenmerken, met "-" en NA, MV of UN waar een waarde niet bestaat of niet bekend is.
  4. Zet eenheden om naar codes. Besteleenheid, inhoudseenheid en aantal per besteleenheid als UN/ECE-codes (C62 voor stuk, PK voor pak), kenmerkwaarden omgerekend naar de eenheid die ETIM voorschrijft.
  5. Kort teksten in en maak ze schoon volgens de lengtes en landregels van de ontvanger.
  6. Genereer het bestand en valideer het tegen het XSD van de ontvanger. ETIM-leden kunnen de BMEcat-certificeringstool van ETIM International gebruiken; iedereen kan een algemene XSD-validator draaien.
  7. Stuur eerst een klein testbestand met een paar artikelen uit verschillende klassen, en vraag de ontvanger om het importlog, niet alleen om een ontvangstbevestiging.

BMEcat-controle voor verzending

0 van 8 klaar0%

Ontvang je BMEcat-bestanden in plaats van ze te versturen, dan werkt dezelfde lijst andersom als intakecontrole: een leveranciersbestand dat op punt 3, 4 of 8 faalt, faalt volgende maand weer, tenzij de brondata wordt gerepareerd. Wil je een tweede mening over één leveranciersbestand, dan loopt bij de gratis productdata-check een collega het samen met je door.

BMEcat 2005 met ETIM-kenmerken genereren uit WISEPIM

In WISEPIM is de export een kanaal in Feed Hub met de naam BMEcat 2005 (ETIM). Je vult de catalogusheader in (leveranciersnaam en -ID, catalogus-ID en versie, gebied, afnemer) en zet de ETIM-release voor die feed vast (in WISEPIM is nu ETIM 10.0 geladen). Artikelen krijgen hun ETIM-klasse via hun productfamilie in productclassificatie; een artikel waarvan de familie geen ETIM-klasse heeft, gaat niet mee in het bestand en wordt geteld als overgeslagen, omdat een artikel dat een kenmerksysteem noemt zonder klasse ongeldig is.

De kanaalkiezer van Feed Hub. Het kanaal BMEcat 2005 (ETIM) staat onder de tab Wholesale & trading partners, los van de retailkanalen die je hier ziet.

Wees duidelijk over wat het bestand is, want het is niet wat een ontvanger met ETIM-richtlijn 5.0 als schema verwacht. WISEPIM schrijft een T_NEW_CATALOG in de kale BMEcat 2005-namespace, met de elementnamen uit BMEcat 1.2 (ARTICLE, SUPPLIER_AID, ARTICLE_FEATURES) in plaats van de PRODUCT-namen uit 2005, met één prijs per artikel en besteleenheid, inhoudseenheid, minimale afname en verpakkingsgrootte uit attributen. Updatetransacties en de UDX.EDXF-uitbreidingen van de richtlijn schrijft het niet. Of een ontvanger dat bestand accepteert, hangt af van zijn importsoftware. Stuur dus eerst een klein testbestand en vraag om het importlog voordat je het hele assortiment aanlevert. Andersom geldt hetzelfde: de XML-import van Feed Hub leest de ETIM-kenmerkblokken van BMEcat-bestanden met ARTICLE-namen, maar niet van bestanden met de PRODUCT-namen uit 2005. Probeer dus eerst één leveranciersbestand voordat je je intake daarop inricht.

Welke tool de XML ook schrijft, het bestand is zo goed als het artikelrecord erachter: één artikelnummer, een geldige GTIN, een ETIM-klasse met elk kenmerk beantwoord, eenheidscodes in plaats van woorden. Repareer dat één keer in je productdata, en BMEcat-, CSV- of XLSX-exports per ontvanger worden een instelling in plaats van een project.

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

BMEcat 2005 hernoemde de ARTICLE-elementen uit versie 1.2 naar PRODUCT (SUPPLIER_AID werd SUPPLIER_PID, ARTICLE_FEATURES werd PRODUCT_FEATURES) en voegde partijen, uitgebreidere kenmerksystemen en meer prijs- en logistieke velden toe. De versie is volledig achterwaarts compatibel: een geldige 1.2-catalogus is ook een geldige 2005-catalogus. De oude namen vervallen in een toekomstige versie, dus gebruik in nieuwe bestanden de PRODUCT-namen, tenzij je ontvanger iets anders vraagt.

Nee. BMEcat is een XML-uitwisselingsformaat voor catalogusgegevens, uitgegeven door de Duitse vereniging BME. ETIM is een classificatiemodel voor technische producten, met klassecodes (EC), kenmerkcodes (EF), waardecodes (EV) en eenheidscodes (EU). Een ETIM BMEcat-bestand gebruikt BMEcat als envelop en ETIM om elk artikel te beschrijven in het PRODUCT_FEATURES-blok. ETIM International publiceerde richtlijnen voor BMEcat 2005 op die manier.

Valideer het tegen het XML-schema dat je ontvanger gebruikt. Voor kaal BMEcat 2005 is dat het BME-schema; voor bestanden volgens ETIM BMEcat-richtlijn 5.0 is dat het ETIM-XSD, en ETIM-leden kunnen bestanden uploaden in de BMEcat-certificeringstool van ETIM International. Schemavalidatie vindt volgorde, ontbrekende en lege elementen. Inhoudelijke fouten zoals ontbrekende kenmerkwaarden, verkeerde eenheden of tekst die een landregel breekt, controleer je apart.

BME noemt BMEcat 2005.2 de actuele versie. De meeste technische groothandels en datapools vragen nog steeds om BMEcat 2005 volgens ETIM BMEcat-richtlijn 5.0 uit juni 2021, die volgens ETIM International de laatste ETIM BMEcat-versie is. Voor nieuwe implementaties beveelt ETIM nu zijn JSON-formaat ETIM xChange aan, en sommige datapools accepteren beide.

Ja, met de transactie T_UPDATE_PRICES, als de ontvanger heeft afgesproken die te accepteren. Het bestand bevat alleen prijsinformatie voor de genoemde artikelen, en de ontvanger vervangt alle opgeslagen prijzen van die artikelen. Elke update heeft een prev_version-nummer dat de keten sinds de laatste volledige catalogus voortzet; mist de ontvanger één update, dan zijn de volgende ongeldig en is een nieuwe T_NEW_CATALOG nodig.

Verder ontdekken

Zorgvuldig gekozen vervolgstappen om dieper te gaan.

Betere productdata, betere resultaten.Verkoop meer producten.

4,7