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
Maart 2001
BMEcat 1.2
Gebruikt ARTICLE, SUPPLIER_AID en ARTICLE_FEATURES. Alleen een DTD, geen XML-schema.
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.
2005.1
BMEcat 2005.1 (advanced)
Alleen optionele uitbreidingsmodules, volledig achterwaarts compatibel met BMEcat 2005.
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
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) | 2005 | Ja | Root-element. De namespace bepaalt welk schema het bestand valideert: kaal BMEcat 2005 of het ETIM-richtlijnprofiel. | |
|---|---|---|---|---|
| HEADER > CATALOG > LANGUAGE | deu (standaard), dut | Ja | Sprache | Driecijferige ISO 639-2-codes, niet de of nl. |
| HEADER > CATALOG > CATALOG_ID | DEMO-SCHALT-2026 | Ja | Katalog-ID | Blijft gelijk over versies van dezelfde catalogus. |
| HEADER > CATALOG > CATALOG_VERSION | 001.004 | Ja | Katalogversion | Verhoog bij elke nieuwe volledige catalogus. |
| HEADER > SUPPLIER > SUPPLIER_NAME | Demo Schaltgeraete GmbH | Ja | Lieferant | In BMEcat 2005 mag je ook SUPPLIER_IDREF met een PARTY-blok gebruiken. |
| T_NEW_CATALOG > PRODUCT (mode new) | Ja | Produkt | ARTICLE is de 1.2-naam voor hetzelfde element en valideert nog steeds. | |
| PRODUCT > SUPPLIER_PID | DS-C16-1P | Ja | Artikelnummer des Lieferanten | Max. 32 tekens; de spec waarschuwt dat sommige systemen er maar 18 bewaren (SAP). |
| PRODUCT_DETAILS > DESCRIPTION_SHORT | Installatieautomaat 1P C16 6 kA | Ja | Kurzbeschreibung | Max. 150 tekens; maak de eerste 40 uniek, want SAP OCI en R/3 verwerken er maar 40. |
| PRODUCT_DETAILS > INTERNATIONAL_PID (type gtin) | 9506000134352 | Nee | Internationale Produktnummer | Optioneel in de basisstandaard; controleer het controlecijfer voor verzending. |
| PRODUCT_DETAILS > MANUFACTURER_PID | DS-C16-1P | Nee | Herstellerartikelnummer | Vaak gelijk aan SUPPLIER_PID in de eigen catalogus van een fabrikant. |
| PRODUCT_FEATURES > REFERENCE_FEATURE_SYSTEM_NAME | ETIM-10.0 | Ja (ETIM) | Merkmalsystem | Notatie ETIM-x.y voor een officiële release. |
| PRODUCT_FEATURES > REFERENCE_FEATURE_GROUP_ID | EC000042 | Ja (ETIM) | Merkmalgruppe | De ETIM-klasse. Moet bestaan in de genoemde release. |
| FEATURE: FNAME / FVALUE | EF000889 / EV000084 | Ja (ETIM) | Merkmal | Uitschakelkarakteristiek = C. Alfanumerieke kenmerken krijgen een EV-waardecode, niet de tekst C. |
| FEATURE: FNAME / FVALUE | EF000227 / 16 | Ja (ETIM) | Merkmal | Nominale stroom 16 A. Geen FUNIT: ETIM legt de eenheid per kenmerk vast. |
| FEATURE: FNAME / FVALUE / FVALUE | EF007515 / -25 / 55 | Ja (ETIM) | Merkmal | Omgevingstemperatuur tijdens bedrijf, een bereikkenmerk: twee FVALUE-elementen, eerst onder- dan bovengrens. |
| FEATURE: FNAME / FVALUE / FVALUE_DETAILS | EF000218 / - / UN | Ja (ETIM) | Merkmal | Inbouwdiepte nog onbekend: een minteken plus de redencode. |
| PRODUCT_ORDER_DETAILS > ORDER_UNIT | C62 | Ja | Bestelleinheit | Eenheidscode (C62 = stuk), niet st of stuks. Prijzen gelden voor deze eenheid. |
| PRODUCT_ORDER_DETAILS > CONTENT_UNIT | C62 | Ja | Inhaltseinheit | De eenheid binnen één besteleenheid. |
| PRODUCT_ORDER_DETAILS > NO_CU_PER_OU | 1 | Nee | Verpackungsmenge | Aantal inhoudseenheden per besteleenheid; standaard 1. |
| PRODUCT_PRICE_DETAILS > PRODUCT_PRICE (price_type net_list) > PRICE_AMOUNT | 7.85 | Ja | Produktpreis | Punt als decimaalteken, ook voor Nederlandse prijzen. PRICE_CURRENCY EUR staat ernaast. |
| MIME_INFO > MIME > MIME_SOURCE | ds-c16-1p.jpg | Nee | Multimediale Zusatzdaten | De ETIM-richtlijn verplaatst afbeeldingen naar UDX.EDXF.MIME_INFO met MD-codes. |
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.
- Verkeerde header. Namespace, schemalocatie of versie-attribuut passen niet bij het profiel waartegen de ontvanger valideert.
- Ontbrekende verplichte elementen, meestal ORDER_UNIT of CONTENT_UNIT, of een ontbrekend FEATURE-blok bij een ETIM-geclassificeerd artikel.
- 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.
- Lege optionele elementen, zoals een lege EAN- of KEYWORD-tag. Laat het element dan weg.
- Niet-geëscapete speciale tekens, vooral een losse ampersand in een omschrijving (Schakelaar & drukknop). Die moet als & in het bestand.
- Kapotte XML: een openingstag zonder sluittag of andersom, meestal na handmatige aanpassingen.
- Onvolledige kenmerksets: kenmerken weggelaten in plaats van aangeleverd als "-" met een redencode.
- Tekst in plaats van codes: C16 in een alfanumeriek kenmerk in plaats van EV000084, of st in plaats van C62 als besteleenheid.
- 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.
- Een gebroken updateketen: een T_UPDATE_PRODUCTS waarvan de prev_version er één overslaat, waardoor je een volledige nieuwe catalogus moet sturen.
- 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:
- 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.
- 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.
- 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.
- 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.
- Kort teksten in en maak ze schoon volgens de lengtes en landregels van de ontvanger.
- 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.
- 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
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.
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.

