Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

« Previous Version 42 Next »

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.

Der Download der BMEcat-Datei kann eine Weile in Anspruch nehmen, wir informieren Sie über das Benachrichtigungssystem in SYMBIOCOMMERCE, wenn alles fertig ist.

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

Bilder, Dokumente und Video-Links vom Produkt werden auf die entsprechenden Artikel vererbt.

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

Unterstützte Version: BMEcat 2005.2

Herstellerangabe

Sie können den Hersteller eines Produkts angeben, wofür wir Ihnen drei Optionen anbieten:

  • Eine Angabe für alle Artikel,

  • eine Angabe für alle Artikel und mit verschiedenen Herstellern,

  • Herstellerangaben je einzelnes Produkt.

In der Beschreibung taucht deshalb das entsprechende BMEcat Element an zwei unterschiedlichen Stellen auf. Sie können die drei Optionen gleichzeitig nutzen, beachten Sie dabei aber die in der Beschreibung aufgezeigte Priorisierung.

Unterscheidung “FEATURE” und “PROPERTY”

Attribute können in der BMEcat-Datei in zwei Typen unterschieden werden: “FEATURE” / “PROPERTY”.
Ein Attribut wird als “FEATURE” angelegt, wenn

  • die Artikelvarianten von einem Produkt das gleiche Attribut haben;

  • die Attributwerte von diesem Attribut bei allen Artikelvarianten unterschiedlich sind;

  • Attributeinheiten definiert wurden und diese bei allen Artikelvarianten gleich sind.

In allen anderen Fälle handelt es sich um ein “PROPERTY”.

BMEcat Element

Attribut

Zulässiger Attributwert

Muss / Kann

Beispiel

Beschreibung

BMECAT

version

2005

MUSS

<BMECAT version="2005">

 Beschreibung

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

HEADER - CATALOG - LANGUAGE

default

true

MUSS

<LANGUAGE default="true">deu</LANGUAGE>

 Beschreibung, zulässige Werte und maximale Feldlänge

Legen Sie die Standardsprache für die Verkaufsgruppe 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

 

 

KANN

<LANGUAGE>eng</LANGUAGE>

 Beschreibung, zulässige Werte und maximale Feldlänge

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

Zulässige Werte

→ Dreistelliges Sprachkürzel nach ISO 639-2

Max. Feldlänge

→ 3

HEADER - CATALOG - CATALOG_ID

 

 

MUSS

<CATALOG_ID>123456</CATALOG_ID>

 Beschreibung, maximale Feldlänge

Dabei handelt es sich um die ID der Verkaufsgruppe.

Max. Feldlänge

→ 20

HEADER - CATALOG - CATALOG_VERSION

 

 

MUSS

<CATALOG_VERSION>1.0</CATALOG_VERSION>

 Beschreibung, Formatierung und maximale Feldlänge

Dabei handelt es sich um die Versionsnummer der Verkaufsgruppe.

Formatierung

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

Max. Feldlänge

→ 7

HEADER - SUPPLIER - SUPPLIER_NAME

 

 

MUSS

<SUPPLIER_NAME>Lieferant Name</SUPPLIER_NAME>

 Beschreibung, maximale Feldlänge

Dabei handelt es sich um den Namen des Lieferanten für die Verkaufsgruppe.

Max. Feldlänge

→ 50

HEADER - PARTIES - PARTY -PARTY_ROLE

Oder:

HEADER - PARTIES - PARTY -
PARTY_ID - PARTY_ROLE

MUSS (BEDINGT)

<PARTY_ROLE>manufacturer</PARTY_ROLE>
<ADDRESS>
<NAME>Default manufacturer</NAME>

Oder:

<PARTY_ID>1</PARTY_ID>
<PARTY_ROLE>manufacturer</PARTY_ROLE>
<ADDRESS>
<NAME>Manufacturer 1</NAME>
</ADDRESS>
</PARTY>

 Beschreibung

Geben Sie den Namen des Herstellers der Produkte an. Dafür stehen Ihnen an dieser Stelle zwei Optionen zur Verfügung:

Option 1: Definieren Sie einen Hersteller, der automatisch bei allen Artikeln verwendet wird.

Option 2: Definieren Sie einen oder mehrere Hersteller, auf die Sie dann in den Artikeln mit der PARTY_ID Bezug nehmen.

Eine dritte Option finden Sie unten bei den PRODUCT_DETAILS, welche höher priorisiert ist als Option 1 und 2.

Beachten Sie, dass Option 1 bedeutet, dass es einen Standardhersteller für alle Produkte gibt.

Einschränkungen

Wenn Sie von den Optionen 1, 2 oder 3 keine angeben, verursacht das einen Validierungsfehler.

T_NEW_CATALOG

 

 

MUSS

<T_NEW_CATALOG>

 Beschreibung

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

Kategorien

T_NEW_CATALOG - CATALOG_GROUP_SYSTEM - CATALOG_STRUCTURE

type

root

node

leaf

KANN

KANN

KANN

<CATALOG_STRUCTURE type="root">

<CATALOG_STRUCTURE type="node">

<CATALOG_STRUCTURE type="leaf">

 Beschreibung

→ Die Kategoriewurzel “root” wird in der Ansicht der Verkaufsgruppe 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

 

 

MUSS

<GROUP_ID>2</GROUP_ID>

 Beschreibung, zulässige Werte, zulässige Zeichen 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 Zeichen

→ 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

MUSS

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

 Beschreibung, zulässige Zeichen und 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

KANN

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

 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

 

 

MUSS

<PARENT_ID>1</PARENT_ID>

 Beschreibung, zulässige Zeichen, 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

 

 

KANN

<GROUP_ORDER>1</GROUP_ORDER>

 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

MUSS

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

 Beschreibung, zulässige Zeichen und 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 - SUPPLIER_PID - PRODUCT_DETAILS - MANUFACTURER_IDREF

MUSS (BEDINGT)

<MANUFACTURER_IDREF>2</MANUFACTURER_IDREF>
</PRODUCT_DETAILS>

 Beschreibung

An dieser Stelle geben Sie die PARTY_ID des Herstellers an (siehe oben, Option 2, Angabe mehrerer Hersteller von Produkten).

T_NEW_CATALOG - PRODUCT - PRODUCT_DETAILS - MANUFACTURER_NAME

MUSS (BEDINGT)

<PRODUCT_DETAILS>
<MANUFACTURER_NAME>Manufacturer</MANUFACTURER_NAME>

 Beschreibung, zulässige Zeichen

Geben Sie den Namen des Herstellers an. Hierbei handelt es sich um die dritte Optionen der Herstellerangabe. Sie legen den Herstellername direkt im Artikel an. Wenn Sie bisher noch keinen Herstellernamen angegeben haben, tun Sie dies hier.

Zulässige Zeichen

→ Buchstaben, Symbole und Zahlen

Einschränkungen

→ Wenn Sie von den Optionen 1, 2 oder 3 keine angeben, verursacht das einen Validierungsfehler.

T_NEW_CATALOG - PRODUCT - PRODUCT_DETAILS - DESCRIPTION_SHORT

lang

Dreistelliges Sprachkürzel nach ISO 639-2

MUSS

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

 Beschreibung, zulässige Zeichen und 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

KANN

<DESCRIPTION_LONG>Die Rohrschelle 4711 ist unglaublich gut</DESCRIPTION_LONG>
oder

<DESCRIPTION_LONG lang="eng">The Pipe clamp 4711 is awesome</DESCRIPTION_LONG>

 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

KANN

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

 Beschreibung, zulässige Zeichen, Einschränkungen und maximale Feldlänge

Tragen Sie die Global Trade Item Number (GTIN). GTIN ersetzt die bis 2005 gebräuchliche European Article Number (EAN).

Zulässige Zeichen

→ Numerisch (Zahlen)

Einschränkungen

→ Muss eineindeutig sein
→ Muss eine gültige GTIN-Nummer (bzw. EAN-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

KANN

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

 Beschreibung, zulässige Zeichen und 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

KANN

<FVALUE lang="deu">30.3</FVALUE>

 Beschreibung, maximale Feldlänge

Ergänzen Sie den Wert des Produktmerkmals

Max. Feldlänge

→ 60

T_NEW_CATALOG - PRODUCT - PRODUCT_FEATURES - FEATURE - FUNIT

 

 

KANN

<FUNIT>cm</FUNIT>

 Beschreibung, maximale Feldlänge

Nennen Sie die Einheit des Produktmerkmals. Die Attributeinheit wird als standardisierter UN/CEFACT-Rec20 Code spezifiziert. Der Code kann aus einer von SYMBIOCOMMERCE unterstützten reduzierten Excel-Liste ausgewählt werden.

Max. Feldlänge

→ 20

T_NEW_CATALOG - PRODUCT - PRODUCT_ORDER_DETAILS - ORDER_UNIT

 

 

MUSS

<ORDER_UNIT>C62</ORDER_UNIT>

 Beschreibung, zulässige Werte und maximale Feldlänge

Geben Sie eine Bestelleinheit an.

Zulässige Werte

→ UNECE Recommendation 20

Max. Feldlänge

→ 3

T_NEW_CATALOG - PRODUCT - PRODUCT_ORDER_DETAILS - PRICE_QUANTITY

 

 

MUSS

<PRICE_QUANTITY>1</PRICE_QUANTITY>

 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

 

 

MUSS

<QUANTITY_MIN>1</QUANTITY_MIN>

 Beschreibung, zulässige Werte

Nennen Sie eine Mindestbestellmenge.

Zulässige Werte

→ nur Ganzzahlen erlaubt

T_NEW_CATALOG - PRODUCT - PRODUCT_ORDER_DETAILS - QUANTITY_INTERVAL

 

 

MUSS

<QUANTITY_INTERVAL>1</QUANTITY_INTERVAL>

 Beschreibung, zulässige Werte und maximale Feldlänge

Geben Sie die Mengenstaffel an.

Zulässige Werte

→ nur Ganzzahlen erlaubt

T_NEW_CATALOG - PRODUCT - PRODUCT_ORDER_DETAILS - PACKING_UNITS

KANN

<PACKING_UNITS>PK</PACKING_UNITS>

 Beschreibung, zulässige Werte und maximale Feldlänge

Geben Sie die Verpackungseinheiten an. Dafür nutzen Sie den international gebräuchlichen UNECE REC 20 Standard.

Zulässige Werte

→ Buchstaben und Zahlen

Ressourcen

In der nachfolgenden Tabelle finden Sie eine Liste der bei SYMBIOCOMMERCE unterstützten Verpackungseinheiten:

T_NEW_CATALOG - PRODUCT - PRODUCT_PRICE_DETAILS - PRODUCT_PRICE

price_type

net_list

MUSS

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

 Beschreibung

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

T_NEW_CATALOG - PRODUCT - PRODUCT_PRICE_DETAILS - PRODUCT_PRICE - PRICE_AMOUNT

 

 

MUSS

<PRICE_AMOUNT>15.80</PRICE_AMOUNT>

 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

 

 

MUSS

<PRICE_CURRENCY>EUR</PRICE_CURRENCY>

 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

 

 

KANN

<MIME_TYPE>image/jpeg</MIME_TYPE>

oder

<MIME_TYPE>application/pdf</MIME_TYPE>

 Beschreibung, zulässige Werte

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.

Zulässige Werte

→ image/jpeg

→ image/png

→ application/pdf

T_NEW_CATALOG - PRODUCT - MIME_INFO - MIME - MIME_SOURCE

 

 

MUSS

<MIME_SOURCE>PC4711.jpeg</MIME_SOURCE>

 Beschreibung, zulässige Werte, maximale Feldlänge

Geben Sie den Dateinamen an.

Youtube

So können Sie die URL Formate kopieren:

  1. via Adressleiste im Browser

  2. rechtem Maus-Klick auf das Video

  3. Klick auf Teilen → Einbetten

Unterstützte YouTube-URL-Formate:

  • https://youtu.be/QpUtAw_LTgs

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

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

Zulässige Werte

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

Max. Feldlänge

→ 255

T_NEW_CATALOG - PRODUCT - MIME_INFO - MIME - MIME_DESCRIPTION

lang

Dreistelliges Sprachkürzel nach ISO 639-2

KANN

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

 Beschreibung, maximale Feldlänge

Ergänzen Sie eine Beschreibung des Inhalts der Datei, etwa eine Bildbeschreibung.

Max. Feldlänge

→ 250

T_NEW_CATALOG - PRODUCT - PRODUCT_REFERENCE type="base_product"

type

base_product

KANN

<PRODUCT_REFERENCE type="base_product">

 Beschreibung

Weisen Sie den Artikel einem Produkt zu.

T_NEW_CATALOG - PRODUCT - PRODUCT_REFERENCE - PROD_ID_TO

 

 

KANN

<PROD_ID_TO>4712</PROD_ID_TO>

 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

 

 

KANN

<CUSTOMS_NUMBER>84142100</CUSTOMS_NUMBER>

 Beschreibung, maximale Feldlänge

Pflicht, wenn Sie oder Ihr Partner den Verkaufskanal SYMBIO Shop verwenden möchten

Nennen Sie die Zollnummer des Produkts.

Max. Feldlänge

→ 60

T_NEW_CATALOG - PRODUCT - PRODUCT_LOGISTIC_DETAILS - COUNTRY_OF_ORIGIN

 

 

KANN

<COUNTRY_OF_ORIGIN>DE</COUNTRY_OF_ORIGIN>

 Beschreibung, maximale Feldlänge

Pflicht, wenn Sie oder Ihr Partner den Verkaufskanal SYMBIO Shop verwenden möchten

Geben Sie das Ursprungsland des Produkts an.

Max. Feldlänge

→ 6

Ressourcen

In der nachfolgenden Tabelle finden Sie eine Liste der bei SYMBIOCOMMERCE unterstützten Ländercodes:

T_NEW_CATALOG - PRODUCT - PRODUCT_LOGISTIC_DETAILS - PRODUCT_DIMENSIONS - WEIGHT

 

 

KANN

<WEIGHT>0.2</WEIGHT>

 Beschreibung, maximale Feldlänge

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

Produktkategorie Zuweisungen (Ein Artikel kann nur einer Produktkategorie zugewiesen werden. Im BMEcat Schema kann ein Artikel mehreren Kategorien zugeordnet werden)

T_NEW_CATALOG - PRODUCT_TO_CATALOGGROUP_MAP - PROD_ID

 

 

KANN

<PROD_ID>4711</PROD_ID>

 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

 

 

KANN

<CATALOG_GROUP_ID>3</CATALOG_GROUP_ID>

 Beschreibung, maximale Feldlänge

Geben Sie die ID der Kategorie an.

Max. Feldlänge

→ 50

  • No labels