TB.One > Import & Export > Stammdatenimport via TB.Cat/XML > Stammdatenimport via XML - Dateien und Namenskonventionen

Stammdatenimport via XML - Dateien und Namenskonventionen

Der Tradebyte-Standard zur Übertragung von Produktdaten ist der so genannte TB.Cat. XML-Dateien müssen vor der Übertragung an TB.One auf ihre Schemaindividualität geprüft werden, unabhängig von der Schnittstelle, die du verwendest.

Die aktuell gültigen Schemadateien findest du unter den folgenden Links:

TB.Cat v. 1.2:

https://api.core.tradebyte.com/schema/all_in_one/tb-cat_1_2_import.xsd

TB.Cat v. 1.3:

https://api.core.tradebyte.com/schema/all_in_one/tb-cat_1_3_import.xsd

TB.Cat v. 1.4:

https://api.core.tradebyte.com/schema/all_in_one/tb-cat_1_4_import.xsd

 

Bezeichne die Importdateien für Produktdaten wie folgt:

TBCAT_{timestamp}.xml

TBCAT_

Kennzeichnung als Produktkatalog

{timestamp}

Zeitstempel
Die Definition des Zeitstempels ist frei, es wird jedoch empfohlen sich an folgenden Aufbau zu halten:
JahrMonatTag_StundeMinuteSekunde (z.B. "20200812_124501").

.xml

Dateiendung

 

ACHTUNG:
Dateien, die den Bestandteil "test" im Namen tragen, werden nicht importiert. Sie dienen ausschließlich der Verbindungsprüfung.

Um eine Überschneidung von Upload- und Importvorgängen zu vermeiden, müssen die Dateien zuerst mit der Dateiendung ".tmp" hochgeladen und dann nach einem erfolgreichen Upload umbenannt werden.

PREISINFORMATIONEN

Um lediglich die Preisinformationen zu aktualisieren, musst du keinen vollständigen TB.Cat liefern. Stattdessen genügt es, nur die  Artikelnummern und Preisinformationen im TB.Cat zu übertragen.

Die Namenskonvention der Preisdatei entspricht der eines regulären TB.Cat:

TBCAT_{timestamp}.xml

TBCAT_

Kennzeichnung als Produktkatalog

{timestamp}

Zeitstempel
Die Definition des Zeitstempels ist frei, es wird jedoch empfohlen sich an folgenden Aufbau zu halten:
JahrMonatTag_StundeMinuteSekunde (z.B. "20200812_124501").

.xml

Dateiendung

 

ACHTUNG:
Die Art und Weise, wie du die Preisdaten-XMLs strukturieren musst, hängt von der Version deines TB.Cat ab (siehe Tabelle unten).

 

TB.CAT VERSION

PREISINFORMATIONEN

1.2/1.3

Ob TB.One deine Preise kanal- oder preislistenspezifisch behandelt, hängt von dem Attribut "kanal" im Knoten <A_PRICE> ab. Wenn du für dieses Attribut ein Kanalkennzeichen angibst, sind die Preise kanalspezifisch. Gibst du einen Preislisten-key an, sind diese preislistenspezifisch.

TIPP:
Ob die Daten kanal- oder preislistenspezifisch sind, hängt vom Attribut "kanal" im Knoten <A_PRICE> ab:

<?xml version="1.0" encoding="UTF-8"?>

<TBCATALOG>

<ARTICLEDATA>

<ARTICLE>

<A_NR>FBUSB-4R/A_NR>

<A_PRICEDATA>

<A_PRICE channel="listone" currency="EUR">

<A_VK>8.99</A_VK>

<A_VK_OLD>15.99</A_VK_OLD>

<A_UVP>18.99</A_UVP>

<A_MWST>2</A_MWST>

</A_PRICE>

</A_PRICEDATA>

</ARTICLE>

</ARTICLEDATA>

</TBCATALOG>

Eine Beschreibung der einzelnen Knoten findest du unter <A_PRICEDATA> für TB.Cat 1.2.

1.4

TIPP:
Auf Preisdaten reduziert, ohne Preisliste:

<?xml version="1.0" encoding="UTF-8"?>

<TBCATALOG>

<ARTICLEDATA>

<ARTICLE>

<A_NR>FBUSB-4R/A_NR>

<A_PRICEDATA>

<A_PRICE channel="zade" currency="EUR">

<A_VK>8.99</A_VK>

<A_VK_OLD>15.99</A_VK_OLD>

<A_UVP>18.99</A_UVP>

<A_MWST>2</A_MWST>

</A_PRICE>

</A_PRICEDATA>

</ARTICLE>

</ARTICLEDATA>

</TBCATALOG>

TIPP:
Auf Preisdaten reduziert, mit Preisliste:

<?xml version="1.0" encoding="UTF-8"?>

<TBCATALOG>

<ARTICLEDATA>

<ARTICLE>

<A_NR>FBUSB-4R/A_NR>

<A_PRICEDATA>

<A_PRICELIST key="cutbtradi1">

<A_VK>9.99</A_VK>

<A_VK_OLD>12.99</A_VK_OLD>

<A_UVP>14.99</A_UVP>

<A_MWST>2</A_MWST>

</A_PRICELIST>

</A_PRICEDATA>

</ARTICLE>

</ARTICLEDATA>

</TBCATALOG>

Eine Beschreibung der einzelnen Knoten findest du unter <A_PRICEDATA> for TB.Cat 1.4.

 

BESTANDSINFORMATIONEN

Wenn du nur Bestandsinformationen aktualisieren möchtest, musst du keinen vollständigen TB.Cat liefern.  Stattdessen genügt es, nur die relevanten Informationen zu übertragen. Das aktuelle XML-Schema findest du hier:

https://api.core.tradebyte.com/schema/all_in_one/tb-stock_all_in_one.xsd

Namenskonvention für Bestandsdaten:

TBCAT_stock_{timestamp}.xml

TBCAT_stock

Kennzeichnung als Bestandskatalog

{timestamp}

Zeitstempel
Die Definition des Zeitstempels ist frei, es wird jedoch empfohlen sich an folgenden Aufbau zu halten:
JahrMonatTag_StundeMinuteSekunde (e.g. "20200812_124501").

.xml

Dateiendung

 

Beispiel-XML: Ein zentrales Lager (Referenzierung über A_NR)

<?xml version="1.0" encoding="UTF-8"?>

<TBSTOCK>

 <ARTICLE>

         <A_NR>3810blM</A_NR>

         <A_STOCK>15</A_STOCK>

 </ARTICLE>

</TBSTOCK>

 

Beispiel-XML: Ein zentrales Lager (Referenzierung über A_EAN)

<?xml version="1.0" encoding="UTF-8"?>

<TBSTOCK>

 <ARTICLE>

         <A_EAN>4003423414351</A_EAN>

         <A_STOCK>15</A_STOCK>

 </ARTICLE>

</TBSTOCK>

 

Beispiel- ML: Mehrere Lagerstätten (siehe auch "Lagerstätten")

<?xml version="1.0" encoding="UTF-8"?>

<TBSTOCK>

 <ARTICLE>

         <A_NR>3810blM</A_NR>                                        

         <A_STOCK identifier="key" key="Zentrallager">10</A_STOCK>

         <A_STOCK identifier="key" key="Außenlager 1">5</A_STOCK>

 </ARTICLE>

</TBSTOCK>

 

 

 

<!-- Alternative: <A_EAN>4003423414351</A_EAN> -->

Weiterführende Informationen:

•Stammdatenimport via XML - Überblick

•Beispiele: XML für TB.Cat 1.2 oder TB.Cat 1.4