BMEcat-Datenimport

Um Produkte und die entsprechenden Artikel in den Produktpool zu integrieren, müssen die entsprechenden Daten in das “SYMBIOCOMMERCE - BMEcat-Format” gebracht werden.

Beispiel:

Ein Produkt wird mithilfe des Elements <PRODUCT> erfasst.

Jeder untergeordnete Artikel wird ebenfalls mit <PRODUCT> erstellt und bekommt mithilfe der Elemente <PRODUCT_REFERENCE type="base_product"><PROD_ID_TO>ID des Produkts</PROD_ID_TO></PRODUCT_REFERENCE> eine Referenz auf die ID des Produkts und wird so dem Produkt zugeordnet.

In der folgenden Übersicht zeigen wir, welche Elemente des BMEcat-Formats von SYMBIOCOMMERCE unterstützt werden. Nutzen Sie dabei die BMEcat-Beispieldatei, um sich zu orientieren.

Der BMEcat-Produktimport kann neben dem Import von Produkten auch für den Import von Kategorien genutzt werden. In dem Fall muss ein Kategoriebaum erfasst werden und alle Produkte einer Kategorie zugeordnet werden.

Erlaubte Medien-Dateiformate: png, jpg und jpeg für Bilder, pdf für Dokumente und YouTube-Links für Videos.

https://www.bme.de/initiativen/bmecat/download/

View file

name	produkt-import-beispieldatei-bmecat.xml

BMEcat Element

Attribut

Zulässiger Attributwert

Muss / Kann

Beispiel

Beschreibung

BMECAT

version

2005

Status

colour	Red
title	MUSS

Expand

title	Beschreibung

Dabei handelt es sich um die von SYMBIOCOMMERCE unterstützte BMEcat-Version.

HEADER - CATALOG - LANGUAGE

default

true

Status

colour	Red
title	MUSS

Expand

title	Beschreibung, zulässige Werte und maximale Feldlänge

Legen Sie die Standardsprache für den Katalog fest. Sie können nur eine einzige Sprache als Standardsprache definieren

Zulässige Werte

→ Dreistelliges Sprachkürzel nach ISO 639-2

Max. Feldlänge

→ 3

HEADER - CATALOG - LANGUAGE

Status

colour	Blue
title	Kann

Expand

title	Beschreibung, zulässige Werte und maximale Feldlänge

Sie können beliebig viele weitere Sprachen ergänzen, in die der Katalog übersetzt werden kann.

Zulässige Werte

→ Dreistelliges Sprachkürzel nach ISO 639-2

Max. Feldlänge

→ 3

HEADER - CATALOG - CATALOG_ID

Status

colour	Red
title	MUSS

<CATALOG_ID>123456</CATALOG_ID>

Expand

title	Beschreibung, maximale Feldlänge

Dabei handelt es sich um die ID des Katalogs.

Max. Feldlänge

→ 20

HEADER - CATALOG - CATALOG_VERSION

Status

colour	Red
title	MUSS

<CATALOG_VERSION>1.0</CATALOG_VERSION>

Expand

title	Beschreibung, maximale Feldlänge

Dabei handelt es sich um die Versionsnummer des Katalogs.

Formatierung

→ Mehrstellige Zeichenfolge, unterbrochen von einem Punkt.
→ Max. drei Zeichen vor dem Punkt

Max. Feldlänge

→ 7

HEADER - SUPPLIER - SUPPLIER_NAME

Status

colour	RedBlue
title	MUSSKann

<SUPPLIER_NAME>Lieferant Name</SUPPLIER_NAME>

Expand

title	Beschreibung, maximale Feldlänge

Dabei handelt es sich um den Namen des Lieferanten für den Katalog bzw. des Herstellers des Produkts.

Diese Beschreibung können Sie auch in den Produktdetails hinzufügen.

Max. Feldlänge

→ 50

T_NEW_CATALOG

Status

colour	Red
title	MUSS

<T_NEW_CATALOG>

Expand

title	Beschreibung

Beinhaltet Produkte und ggf. Kategorien sowie Produkt-Kategorie-Zuweisungen.

Kategorien

T_NEW_CATALOG - CATALOG_GROUP_SYSTEM - CATALOG_STRUCTURE

type

root

node

leaf

Status

colour	Blue
title	Kann

Status

colour	Blue
title	Kann

Status

colour	Blue
title	Kann

<CATALOG_STRUCTURE type="root">

<CATALOG_STRUCTURE type="node">

<CATALOG_STRUCTURE type="leaf">

Expand

title	Beschreibung

→ Die Kategoriewurzel “root” wird in den Katalogansichten nicht angezeigt. Es können keine Produkte zugeordnet werden.

→ Dem Kategorieknoten “node” können keine Produkte zugeordnet werden.

→ Dem Kategorieblatt “leaf” können Produkte zugeordnet werden.

T_NEW_CATALOG - CATALOG_GROUP_SYSTEM - CATALOG_STRUCTURE - GROUP_ID

Status

colour	Red
title	MUSS

<GROUP_ID>2</GROUP_ID>

Expand

title	Beschreibung, zulässige Werte und maximale Feldlänge

Es handelt sich um die ID der Kategorie. Diese wird referenziert von untergeordneten Kategorien und bei der Produktzuweisung.

Zulässige Werte

→ jeder Wert muss eindeutig sein

Zulässige Werte

→ Alphanumerisch (Buchstaben und Zahlen)
→ Dezimalzahlen erlaubt

Max. Feldlänge

→ 50

T_NEW_CATALOG - CATALOG_GROUP_SYSTEM - CATALOG_STRUCTURE - GROUP_NAME

lang

Dreistelliges Sprachkürzel nach ISO 639-2

Status

colour	Red
title	MUSS

<GROUP_NAME lang="deu">Kategorie 1</GROUP_NAME>

Expand

title	Beschreibung, maximale Feldlänge

Dabei handelt es sich um den Namen der Kategorie.

Zulässige Zeichen

→ Alphanumerisch (Buchstaben und Zahlen)

Max. Feldlänge

→ 50

T_NEW_CATALOG - CATALOG_GROUP_SYSTEM - CATALOG_STRUCTURE - GROUP_DESCRIPTION

lang

Dreistelliges Sprachkürzel nach ISO 639-2

Status

colour	Red
title	MUSS

<GROUP_DESCRIPTION lang="eng">Main Category</GROUP_DESCRIPTION>

Expand

title	Beschreibung, maximale Feldlänge

Tragen Sie eine Beschreibung der Kategorie ein.

Max. Feldlänge

→ 250

T_NEW_CATALOG - CATALOG_GROUP_SYSTEM - CATALOG_STRUCTURE - PARENT_ID

Status

colour	Red
title	MUSS

<PARENT_ID>1</PARENT_ID>

Expand

title	Beschreibung, zulässige Werte und maximale Feldlänge

Geben Sie die ID der übergeordneten Kategorie an.

Zulässige Zeichen

→ Alphanumerisch (Buchstaben und Zahlen)
→ Dezimalzahlen erlaubt

Zulässige Werte

→ Wert muss eindeutig sein
→ bei root Wert 0

Max. Feldlänge

→ 50

T_NEW_CATALOG - CATALOG_GROUP_SYSTEM - CATALOG_STRUCTURE - GROUP_ORDER

Status

colour	Blue
title	Kann

<GROUP_ORDER>1</GROUP_ORDER>

Expand

title	Beschreibung, zulässige Werte

Bestimmen Sie die Reihenfolge der Kategorien innerhalb der Hierarchie.

Zulässige Werte

→ nur Ganzzahlen erlaubt

Produkte

T_NEW_CATALOG - PRODUCT - SUPPLIER_PID type="supplier_specific"

type

supplier_specific

Status

colour	Red
title	MUSS

<SUPPLIER_PID type="supplier_specific">4711</SUPPLIER_PID>

Expand

title	Beschreibung, maximale Feldlänge

Geben Sie die SKU und den Namen des Herstellers an.

Zulässige Zeichen

→ Buchstaben, Symbole und Zahlen

Max. Feldlänge

→ 32

T_NEW_CATALOG - PRODUCT - PRODUCT_DETAILS - MANUFACTURER_NAME

<PRODUCT_DETAILS>
<MANUFACTURER_NAME>Manufacturer</MANUFACTURER_NAME>

Expand

title	Beschreibung, maximale Feldlänge

Geben Sie den Namen des Herstellers an.

Zulässige Zeichen

→ Buchstaben, Symbole und Zahlen

T_NEW_CATALOG - PRODUCT - PRODUCT_DETAILS - DESCRIPTION_SHORT

lang

Dreistelliges Sprachkürzel nach ISO 639-2

Status

colour	Red
title	MUSS

<DESCRIPTION_SHORT lang="deu">Rohrschelle 4711</DESCRIPTION_SHORT>

Expand

title	Beschreibung, maximale Feldlänge

Geben Sie den Namen des Produkts ein.

Zulässige Zeichen

→ Buchstaben, Symbole und Zahlen

Max. Feldlänge

→ 150

T_NEW_CATALOG - PRODUCT - PRODUCT_DETAILS - DESCRIPTION_LONG

lang

Dreistelliges Sprachkürzel nach ISO 639-2

Status

colour	Blue
title	Kann

<DESCRIPTION_LONG>Die Rohrschelle 4711 ist unglaublich gut</DESCRIPTION_LONG>
<DESCRIPTION_LONG lang="eng">The Pipe clamp 4711 is awesome</DESCRIPTION_LONG>

Expand

title	Beschreibung, zulässige Werte und maximale Feldlänge

Ergänzen Sie eine Beschreibung des Produkts.

Zulässige Werte

→ HTML-Formatierung möglich

Erlaubte HTML Tags: ul, li, div, p, br

Max. Feldlänge

→ 64000

T_NEW_CATALOG - PRODUCT - PRODUCT_DETAILS - INTERNATIONAL_PID

type

GTIN

Status

colour	Blue
title	Kann

<INTERNATIONAL_PID type="GTIN">012345678905</INTERNATIONAL_PID>

Expand

title	Beschreibung, maximale Feldlänge

Tragen Sie die Global Trade Item Number, früher als EAN bekannt, ein.

Zulässige Zeichen

→ Numerisch (Zahlen)

Einschränkungen

→ Muss eineindeutig sein
→ Muss eine gültige EAN-Nummer (bzw. GTIN-Nummer) sein. Weiterführende Informationen

Max. Feldlänge

→ 100

T_NEW_CATALOG - PRODUCT - PRODUCT_FEATURES - FEATURE - FNAME

lang

Dreistelliges Sprachkürzel nach ISO 639-2

Status

colour	Blue
title	Kann

<FNAME lang="deu">Länge</FNAME>

Expand

title	Beschreibung, maximale Feldlänge

Hierbei handelt es sich um den Namen des Produktmerkmals.

Zulässige Zeichen

→ Buchstaben, Symbole und Zahlen

Max. Feldlänge

→ 80

T_NEW_CATALOG - PRODUCT - PRODUCT_FEATURES - FEATURE - FVALUE

lang

Dreistelliges Sprachkürzel nach ISO 639-2

Status

colour	Blue
title	Kann

Expand

title	Beschreibung, maximale Feldlänge

Ergänzen Sie den Wert des Produktmerkmals

Max. Feldlänge

→ 60

T_NEW_CATALOG - PRODUCT - PRODUCT_FEATURES - FEATURE - FUNIT

Status

colour	Blue
title	Kann

Expand

title	Beschreibung, maximale Feldlänge

Nennen Sie die Einheit des Produktmerkmals.

Max. Feldlänge

→ 20

T_NEW_CATALOG - PRODUCT - PRODUCT_ORDER_DETAILS - ORDER_UNIT

Status

colour	Red
title	MUSS

<ORDER_UNIT>C62</ORDER_UNIT>

Expand

title	Beschreibung, zulässige Werte und maximale Feldlänge

Geben Sie eine Bestelleinheit an.

Zulässige Werte

→ UN/ECE Recommendation 20 / Package Units und ausgewählte physikalische Einheiten

Max. Feldlänge

→ 3

T_NEW_CATALOG - PRODUCT - PRODUCT_ORDER_DETAILS - PRICE_QUANTITY

Status

colour	Red
title	MUSS

<PRICE_QUANTITY>1</PRICE_QUANTITY>

Expand

title	Beschreibung, zulässige Werte

Geben Sie eine Bestellmenge je Preis an.

Zulässige Werte

→ nur Ganzzahlen erlaubt

T_NEW_CATALOG - PRODUCT - PRODUCT_ORDER_DETAILS - QUANTITY_MIN

Status

colour	Red
title	MUSS

<QUANTITY_MIN>1</QUANTITY_MIN>

Expand

title	Beschreibung, zulässige Werte

Nennen Sie eine Mindestbestellmenge.

Zulässige Werte

→ nur Ganzzahlen erlaubt

T_NEW_CATALOG - PRODUCT - PRODUCT_ORDER_DETAILS - QUANTITY_INTERVAL

Status

colour	Red
title	MUSS

<QUANTITY_INTERVAL>1</QUANTITY_INTERVAL>

Expand

title	Beschreibung, zulässige Werte und maximale Feldlänge

Geben Sie die Mengenstaffel an.

Zulässige Werte

→ nur Ganzzahlen erlaubt

T_NEW_CATALOG - PRODUCT - PRODUCT_PRICE_DETAILS - PRODUCT_PRICE

price_type

net_list

Status

colour	Red
title	MUSS

<PRODUCT_PRICE price_type="net_list"></PRODUCT_PRICE>

Expand

title	Beschreibung

Dabei handelt es sich um die Definition eines Preises zum Produkt.

T_NEW_CATALOG - PRODUCT - PRODUCT_PRICE_DETAILS - PRODUCT_PRICE - PRICE_AMOUNT

Status

colour	Red
title	MUSS

<PRICE_AMOUNT>15.80</PRICE_AMOUNT>

Expand

title	Beschreibung, zulässige Werte

Geben Sie den Preis des Produkts als reinen Zahlenwert an.

Zulässige Werte

→ Dezimaltrennzeichen ist der Punkt

T_NEW_CATALOG - PRODUCT - PRODUCT_PRICE_DETAILS - PRODUCT_PRICE - PRICE_CURRENCY

Status

colour	Red
title	MUSS

<PRICE_CURRENCY>EUR</PRICE_CURRENCY>

Expand

title	Beschreibung, zulässige Werte und maximale Feldlänge

Geben Sie die Währungseinheit für den Preis an.

Zulässige Werte

→ 3 Zeichen entsprechend ISO 4217 Währungscodes

Max. Feldlänge

→ 3

T_NEW_CATALOG - PRODUCT - MIME_INFO - MIME - MIME_TYPE

Status

colour	Blue
title	Kann

<MIME_TYPE>image/jpeg</MIME_TYPE>

oder

<MIME_TYPE>application/pdf</MIME_TYPE>

Expand

title	Beschreibung, zulässige Werte und maximale Feldlänge

Ergänzen Sie produktspezifische Zusatzdokumente wie Bilder, Datenblätter oder Webseiten.

Damit Bilder erkannt werden, muss der MIME-Typ “image” vor den Dateityp geschrieben werden. Für Dateien muss der MIME-Typ “application” verwendet werden. Bei YouTube-Links muss kein MIME-Typ angegeben werden.

So können Sie die unterstützten URL Formate kopieren:

1. via Adressleiste im Browser

2. rechtem Maus-Klick auf das Video

3. Klick auf Teilen → Einbetten

Zulässige Werte

→ image/jpg

→ image/jpeg

→ image/png

→ application/pdf

→ Die Mindestgrösse für den Bilder-Upload beträgt 3x3 Pixel.

→ unterstützte YouTube-Link -Formate:

https://youtu.be/QpUtAw_LTgs

https://www.youtube.com/watch?v=QpUtAw_LTgs

https://www.youtube.com/embed/QpUtAw_LTgs

Max. Feldlänge

→ 30

T_NEW_CATALOG - PRODUCT - MIME_INFO - MIME - MIME_SOURCE

Status

colour	Red
title	MUSS

<MIME_SOURCE>PC4711.jpg</MIME_SOURCE>

Expand

title	Beschreibung, maximale Feldlänge

Geben Sie den Dateinamen an.

Max. Feldlänge

→ 255

T_NEW_CATALOG - PRODUCT - MIME_INFO - MIME - MIME_DESCRIPTION

lang

Dreistelliges Sprachkürzel nach ISO 639-2

Status

colour	Blue
title	Kann

<MIME_DESCR lang="deu">Frontansicht</MIME_DESCR>

Expand

title	Beschreibung, maximale Feldlänge

Ergänzen Sie eine Beschreibung des Inhalts der Datei.

Max. Feldlänge

→ 250

T_NEW_CATALOG - PRODUCT - PRODUCT_REFERENCE type="base_product"

type

base_product

Status

colour	Blue
title	Kann

<PRODUCT_REFERENCE type="base_product">

Expand

title	Beschreibung

Weisen Sie den Artikel einem Produkt zu.

T_NEW_CATALOG - PRODUCT - PRODUCT_REFERENCE - PROD_ID_TO

Status

colour	Blue
title	Kann

<PROD_ID_TO>4712</PROD_ID_TO>

Expand

title	Beschreibung, maximale Feldlänge

Nennen Sie die ID des übergeordneten Produkts / der Produktfamilie.

Max. Feldlänge

→ 80

T_NEW_CATALOG - PRODUCT - PRODUCT_LOGISTIC_DETAILS - CUSTOMS_TARIFF_NUMBER - CUSTOMS_NUMBER

Status

colour	Blue
title	Kann

<CUSTOMS_NUMBER>84142100</CUSTOMS_NUMBER>

Expand

title	Beschreibung, maximale Feldlänge

Nennen Sie die Zollnummer des Produkts.

Max. Feldlänge

→ 60

T_NEW_CATALOG - PRODUCT - PRODUCT_LOGISTIC_DETAILS - COUNTRY_OF_ORIGIN

Status

colour	Blue
title	Kann

<COUNTRY_OF_ORIGIN>DE</COUNTRY_OF_ORIGIN>

Expand

title	Beschreibung, maximale Feldlänge

Geben Sie das Ursprungsland des Produkts an.

Max. Feldlänge

→ 6

T_NEW_CATALOG - PRODUCT - PRODUCT_LOGISTIC_DETAILS - PRODUCT_DIMENSIONS - WEIGHT

Status

colour	Blue
title	Kann

Expand

title	Beschreibung, maximale Feldlänge

Nennen Sie das Gewicht des Produkts in Kilogramm (kg).

Max. Feldlänge

→ 8 Vorkommastellen, 2 Nachkommastellen

Produktkategorie Zuweisungen

T_NEW_CATALOG - PRODUCT_TO_CATALOGGROUP_MAP - PROD_ID

Status

colour	Blue
title	Kann

<PROD_ID>4711</PROD_ID>

Expand

title	Beschreibung, maximale Feldlänge

Geben Sie die ID des Produkts an.

Max. Feldlänge

→ 32

T_NEW_CATALOG - PRODUCT_TO_CATALOGGROUP_MAP - CATALOG_GROUP_ID

Status

colour	Blue
title	Kann

<CATALOG_GROUP_ID>3</CATALOG_GROUP_ID>

Expand

title	Beschreibung, maximale Feldlänge

Geben Sie die ID der Kategorie an.

Max. Feldlänge

→ 50

Version	Old Version 13	New Version 14
Changes made by	Florian Schwabe (Unlicensed)	Florian Schwabe (Unlicensed)
Saved on	Mar 18, 2024	Mar 19, 2024

Versions Compared

Key

BMEcat-Datenimport

Content Comparison

Versions Compared

Key

BMEcat-Datenimport