TradebyteAddProducts
Der Step TradebyteAddProducts erstellt einen XML-Produktkatalog entsprechend der Tradebyte-Spezifikation für z.B. den Upload auf den Tradebyte FTP Server. Da die maximale Dateigröße vom 100MB nicht überschritten werden darf, werden gegebenenfalls mehrere Dateien mit jeweils 5000 Zeilen erstellt.
Die Ausgabedatei(en) hat die folgende Dateinamenstruktur einschließlich eines Zeitstempels: TBCAT_yyyyMMdd_HHDatei-Index.xml
Festlegen der Produkt- und Artikeldaten
Name | Beispiel | Beschreibung | Pflichtfeld | Datentyp | Werte | Hinweise |
hasArticles | true | dieses Feld legt fest, ob diese Zeile Artikeldaten besitzt | ja | Text | true (hat Artikeldaten)false (hat keine Artikeldaten) | ist das Input-Spreadsheet im Format Parent-Variant oder Master-Child (aus Datastore) wird der Wert automatisch generiert und kann leer gelassen werden. Ist der Wert manuell gesetzt wird dieser genommen. |
isProduct | true | dieses Feld legt fest, ob diese Zeile ein Produkt ist | ja | Text | true (ist Produkt)false (ist Artikel) | ist das Input-Spreadsheet im Format Parent-Variant oder Master-Child (aus Datastore) wird der Wert automatisch generiert und kann leer gelassen werden. Ist der Wert manuell gesetzt wird dieser genommen. |
Hinweise
isProduct = true undhasArticles = true
Diese Zeile wird nur als Produkt behandelt. Aus den verknüpften Varianten oder Children werden Artikel erzeugt.
isProduct = false undhasArticles = true
Diese Zeile wird nur als Artikel behandelt.
isProduct = true undhasArticles = false
Diese Zeile wird als Produkt behandelt. Da keine Artikeldaten vorhanden sind wird automatisch ein Artikel aus dem Produkt erzeugt.
isProduct = false oderhasArticles = false
Wenn keine weiteren Artikeldaten (verknüpften Varianten oder Children) vorhanden sind und diese Zeile auch kein Produkt ist wird automatisch ein Artikel aus dieser Zeile erzeugt.
Grundsätzlich müssen in jeder Zeile immer die gewünschten Produkt- und Artikldaten zugewiesen werden. Ob diese Zeile als Produkt oder Artikel (oder beides) behandelt wird hängt ausschließlich von den beiden Schaltern isProduct und hasArticles ab.
Kommen die Daten aus einem Step der bereits eine Parent-Variant-Zuordnung hat, oder aus einem Datastore (Master-Child oder Parent-Variant) sollten beide Felder leer gelassen werden da in diesen Fällen die Zuweisung automatisch erfolgt.
Wichtig!
Die Produkt- und Artikelzuweisungen werden über die Produktnummer (P_NR) abgeglichen. Das heißt alle Artikel müssen die selbe Produktnummer haben wie das übergeordnete Produkt.
Produktdaten
Name | Beispiel | Beschreibung | Pflichtfeld | Datentyp | Werte | Hinweise | ||
---|---|---|---|---|---|---|---|---|
P_NR | 87 | Eindeutige Produkt-ID aus TB.One | ja | Ganzzahl | Die P_NR muss in jeder Zeile gesetzt werden, da über diese Nummer die Produkt-Artikel Zuweisung gesteuert wird. | |||
P_NR_EXTERNAL | 5986 | Produktnummer des Lieferanten. | nein | Text | ||||
P_NAME | Outdoor-Jacke Reinhold | Produktbezeichnung | nein | Text | Wird P_NAME genutzt, müssen P_NAME_PROPER und P_NAME_KEYWORD leer bleiben. | |||
P_NAME_PROPER | Outdoor-Jacke | Statt der Produktbezeichnung P_NAME, kann der Name auch in Gattungs- und Eigenname aufgeteilt sein (z.B. "Jacke Reinhold" vs. "Jacke"/"Reinhold") | nein | Text | Wird P_NAME_PROPER genutzt, muss P_NAME_KEYWORD gefüllt werden und P_NAME leer bleiben. | |||
P_NAME_KEYWORD | Reinhold | ja | Text | Wird P_NAME_KEYWORD genutzt, muss P_NAME_PROPER gefüllt werden und P_NAME leer bleiben. | ||||
P_SUPPLEMENT | Winterjacke | Werbliche Zusatzüberschrift zum Produkt | nein | Text | ||||
P_TEXT | Die Outdoorjacke "Reinhold" ist eine außergewöhnlich robuste und funktionale Jacke! | Produktbeschreibung (Fließtext) | nein | Text | ||||
P_BRAND | marke=Synesty | Marke | nein | Text | Schlüssel=Wert | Es kann nur eine Marke übergeben werden. Der Schlüssel wird automatisch im Tradebyte angelegt und sollte zur eindeutigen Zuordnung bei der selben Marke immer gleich sein. | ||
P_KEYWORDS | Kapuzenjacke;Anorak;Funktionskleidung | Keywords/Suchbegriffe für das Produkt | nein | Text | Wert;Wert;Wert | Die Werte müssen als Semikolon separierte Werte übergeben werden. | ||
P_COMPONENTDATA | Länge=110cm;Saison=Winter | Produktkomponenten | nein | Text | Schlüssel=Wert;Schlüssel=Wert | Die Werte müssen als Semikolon separierte Schlüssel-Wert-Paare übergeben werden. | ||
P_TAGS | Geschlecht=männlich,weiblich;Saison=Sommer,Winter | Produktattribute | nein | Text | Schlüssel=Wert;Schlüssel=Wert,Wert | Die Werte müssen als Semikolon separierte Schlüssel-Wert-Paare übergeben werden. Hier ist auch es möglich jedem Schlüssel mehrere Werte zuzuordnen. Diese Werte müssen dann mit Komma separiert werden. | ||
P_BULLETS | atmungsaktiv;wasserdicht;winddicht | Aufzählungspunkte | nein | Text | Wert;Wert;Wert | Die Werte müssen als Semikolon separierte Werte übergeben werden. | ||
P_MEDIADATA | image=http://img1.jpg;image=http://img2.jpg; typ2=http://img1.jpg;typ2=http://img2.jpg | Produktmedien | nein | Text | Medientyp=URL;Medientyp=URL | Standart-Medientyp ist image und muss, falls keine anderen Medientypen definiert sind, immer angegeben werden. Es ist aber auch möglich benutzerdefinierte Medientypen im Tradebyte anzulegen. Diese können dann mit dem jeweiligen Kürzel zusätzlich übergeben werden. Die Reihenfolge der URLs pro Medientyp legt außerdem die Sortierreihenfolge der Bilder im Tradebyte fest. | ||
P_CATEGORIES | Kategorie1;Kategorie2;Kategorie3 | Kategorienzuordnungen (Clusterattribute) | nein | Text | Wert;Wert;Wert | |||
P_LINKDATA | cross=1234;device=4894 | Verknüpfungen | nein | Text | Verknüpfungstyp=Produkt-ID;Verknüpfungstyp=Produkt-ID
| Die Werte müssen als Semikolon separierte Schlüssel-Wert-Paare übergeben werden. | ||
P_VARIANTFIELDS | Farbe;Größe;Länge | Bei Produkten mit Varianten die Definition der variantenbildenden Eigenschaften | nein | Text | Wert;Wert;Wert | Die Werte müssen als Semikolon separierte Werte übergeben werden. |
Artikeldaten
Name | Beispiel | Beschreibung | Pflichtfeld | Datentyp | Werte | Hinweise |
---|---|---|---|---|---|---|
A_NR | 3810blS | Artikelnummer. Diese kann sich grundsätzlich ändern. | ja | Text | ||
A_ID | 349 | Eindeutige Artikel-ID aus TB.One | nein | Ganzzahl | ||
A_ACTIVE |
| Aktiviert oder Deaktiviert den ganzen Artikel | nein | Ganzzahl | 1 (aktiv)0 (inaktiv) | |
A_ACTIVEDATA | otde=1;lmde=0 | Aktiviert (1) oder deaktviert (0) den Artikel den für den jeweiligen Kanal | nein | Text | Kanalkürzel=Wert;Kanalkürzel=Wert | muss für jeden vorhandenen Kanal in Tradebyte wie im Beispiel angegeben gesetzt werden |
A_EAN | 4234567891111 | EAN-Code des Artikels | nein | Text | Muss IMMER 13 Stellen haben | |
A_PROD_NR | 56894 | Herstellerartikelnummer | nein | Text | ||
A_NR2 | 381059 | Zusätzliche zweite Artikelnummer | nein | Text | ||
A_VARIANTDATA | Farbe=blau;Größe=XL | Variantenwerte | nein | Text | Schlüssel=Wert;Schlüsse=Wert | Die Werte müssen als Semikolon separierte Schlüssel-Wert-Paare übergeben werden. |
A_COMPONENTDATA | Motiv=Vogel; Anzahl pro Packung=10 | Artikelkomponenten | nein | Text | Schlüssel=Wert;Schlüsse=Wert | Die Werte müssen als Semikolon separierte Schlüssel-Wert-Paare übergeben werden. |
A_TAGS | Zielgruppe=alt; Saison=Sommer,Winter | Artikelattribute | nein | Text | Schlüssel=Wert;Schlüsse=Wert,Wert | Die Werte müssen als Semikolon separierte Schlüssel-Wert-Paare übergeben werden. Es ist möglich jedem Schlüssel mehere Werte zuzuordnen. Diese Werte müssen dann Komma separiert aufgelistet werden. |
A_BASEPRICE_QUANTITY | flasche1l=1000 | Füllmenge | nein | Text | Schlüssel=Wert | Hier ist nur ein Schlüssel-Wert-Paar möglich. |
A_MEDIADATA | image=http://img1.jpg; image=http://img2.jpg; typ2=http://img1.jpg; typ2=http://img2.jpg | Artikelmedien (Bilder) | nein | Text | Medientyp=URL;Medientyp=URL | Standart-Medientyp ist image und muss, falls keine anderen Medientypen definiert sind, immer angegeben werden. Es ist aber auch möglich benutzerdefinierte Medientypen im Tradebyte anzulegen. Diese können dann mit dem jeweiligen Kürzel zusätzlich übergeben werden. Die Reihenfolge der URLs pro Medientyp legt außerdem die Sortierreihenfolge der Bilder im Tradebyte fest. |
A_UNIT | ST | Einheit des Artikels | nein | Text | ST (Stück) | |
A_STOCK | 3 | Lagerbestand | nein | Ganzzahl | ||
A_DELIVERY_TIME | 5 | Lieferzeit in Werktagen | nein | Ganzzahl | ||
A_REPLACEMENT | 1 | Wiederbeschaffbarkeit | nein | Ganzzahl | 1 (wiederbeschaffbar)0 (nicht wiederbeschaffbar) | |
A_REPLACEMENT_TIME | 10 | Wiederbeschaffungszeit in Tagen | nein | Ganzzahl | ||
A_ORDER_MIN | 1 | Definition einer Mindestbestellmenge | nein | Ganzzahl | ||
A_ORDER_MAX | 20 | Definition einer maximalen Bestellmenge | nein | Ganzzahl | ||
A_ORDER_INTERVAL | 1 | Schrittweite bei der Eingabe einer Bestellmenge | nein | Ganzzahl | ||
A_DEPOT | Lager | Lagerstandort | nein | Text | ||
A_DEPOT_TEXT | Gesamtlager | Beschreibung des Laberstandortes | nein | Text |
Artikelpreise
Das Feld A_PRICEDATA ist optional.
Werden die Preisdaten leer gelassen wird auch die gesamten A_PRICEDATA-Daten nicht ausgegeben.
Es müssen wieder jeweils für alle Kanäle die Preise gesetzt werden.
Name | Beispiel | Beschreibung | Pflichtfeld | Datentyp | Werte | Hinweise |
---|---|---|---|---|---|---|
A_PRICE_CURRENCY | EUR otde=EUR;lmde=USD | Währungskennzeichen | ja | Text | Währung Kanalkürzel=Währung;Kanalkürzel=Währung | Bei Angabe eines Währungskürzels mit 3 Buchstaben wird die angegebene Währung wird automatisch für jeden Kanal gesetzt. Bei Angabe der Währungen mittels Schlüssel=Wert kann die Währung jedes Kanals explizig gesteuert werden. |
A_PRICE_VK | otde=25.0;lmde=26.12 | Brutto Verkaufspreis | ja | Text | Kanalkürzel=Preis;Kanalkürzel=Preis | Die Preise sind als 2-stellige Dezimalzahlen anzugeben. Die Preise müssen immer pro Kanal gesetzt werden. Währung, Bruttopreis und der Mehrwertsteuersatz muss immer angegeben werden wenn Preisdaten übermittelt werden sollen. |
A_PRICE_VK_OLD | otde=25.10;lmde=26.99 | Streichpreis (ehemaliger Preis) | nein | Text | Kanalkürzel=Preis;Kanalkürzel=Preis | |
A_PRICE_UVP | otde=20.0;lmde=21.12 | Unverbindliche Preisempfehlung | nein | Text | Kanalkürzel=Preis;Kanalkürzel=Preis | |
A_PRICE_EK | otde=20.0;lmde=21.12 | Einkaufspreis (netto) | nein | Text | Kanalkürzel=Preis;Kanalkürzel=Preis | |
A_PRICE_MWST | 2 | Mehrwertsteuersatz | ja | Ganzzahl | 1 (ermäßigter Steuersatz)2 (normaler Steuersatz)3 (Mehrwertsteuerbefreit) |
Alternativ oder ergänzend können auch Preislisten übergeben werden. Hierfür müssen aber die angesteuerten Preislisten vorher im Tradebyte Backend angelegt werden. Der festgelegte Schlüssel wird dann analog der kanalspezifischen Preise festgelegt.
Sollen Preislisten aktualisiert werden müssen wenigstens der A_PRICELIST_VK und A_PRICELIST_MWST gesetzt sein.
Name | Beispiel | Beschreibung | Pflichtfeld | Datentyp | Werte | Hinweise |
---|---|---|---|---|---|---|
A_PRICELIST_VK | liste1=25.0;liste2=26.12 | Preisliste Brutto Verkaufspreis | ja | Text | Schlüssel=Preis;Schlüssel=Preis | Die Preise sind als 2-stellige Dezimalzahlen anzugeben. Die Preise müssen immer pro Preislisten-Schlüssel gesetzt werden. Währung, Bruttopreis und der Mehrwertsteuersatz muss immer angegeben werden wenn Preisdaten übermittelt werden sollen. |
A_PRICELIST_VK_OLD | liste1=25.10;liste2=26.99 | Preisliste Streichpreis (ehemaliger Preis) | nein | Text | Schlüssel=Preis;Schlüssel=Preis | |
A_PRICELIST_UVP | liste1=20.0;liste2=21.12 | Preisliste Unverbindliche Preisempfehlung | nein | Text | Schlüssel=Preis;Schlüssel=Preis | |
A_PRICELIST_EK | liste1=20.0;liste2=21.12 | Preisliste Einkaufspreis (netto) | nein | Text | Schlüssel=Preis;Schlüssel=Preis | |
A_PRICELIST_MWST | liste1=2;liste2=1 | Preisliste Mehrwertsteuersatz | ja | Text | Schlüssel=MwSt-ID;Schlüssel=MwSt-ID 1 (ermäßigter Steuersatz)2 (normaler Steuersatz)3 (Mehrwertsteuerbefreit) |
Angaben zu Versandart und Maße
Das Feld A_PARCEL ist optional.
Falls eines dieser Felder leer ist werden für diesen Artikel alle anderen Felder ebenfalls verworfen, damit beim Import in Tradebyte keine Fehler auftreten und der Vorgang nicht abbricht.
Name | Beispiel | Beschreibung | Pflichtfeld | Datentyp | Werte | Hinweise |
---|---|---|---|---|---|---|
A_PARCEL_WIDTH | 100 | Breite aller Packstücke in cm | ja | Ganzzahl | ||
A_PARCEL_HEIGHT | 150 | Höhe aller Packstücke in cm | ja | Ganzzahl | ||
A_PARCEL_LENGTH | 200 | Länge aller Packstücke in cm | ja | Ganzzahl | ||
A_PARCEL_WEIGHT | 1.2 | Gewicht aller Packstücke in kg | ja | Dezimalzahl | ||
A_PARCEL_PIECES | 1 | Anzahl Packstücke (Mehrcollie) | ja | Ganzzahl | ||
A_PARCEL_TYPE | DHL | Versandart des Artikels | ja | Text | Die Versandart wird manuell festgelegt und ist dem Tradebyte-backend zu entnehmen. |
TradeStat-Informationen
Das Feld A_TRADESTAT ist optional.
Soll die Zolltarif-Nummer übermittelt werden, müssen alle betreffenden Felder gesetzt werden.
Name | Beispiel | Beschreibung | Pflichtfeld | Datentyp | Werte | Hinweise |
---|---|---|---|---|---|---|
A_TRADESTAT_COUNTRY | DE | ISO 3166-1 Alpha 2 Länder Code | ja | Text | Nähere Informationen zu den Alpha 2 Länder-Codes finden Sie hier. | |
A_TRADESTAT_NR | 12345678 | Zolltarifnummer | ja | Text | Die ZolltarifnummerMUSS 8-stellig sein. Beträgt die Länge der Nummer nicht exakt 8 Stellen werden für den Artikel keine Zolltarif-Daten übermittelt. |
Beispiele zu Hilfsfunktionen
Schlüssel-Wert-Paare generieren
(mit IMAGES = "url;url2;url3")
<#assign images=IMAGES!?split(';')>
<#assign types=['image', 'type2']>
<#list types as type>
<#list images as image>
${type}=${image}<#sup>;</#sup>
</#list>
<#sup>;</#sup>
</#list>
Inputs
Das sind die Optionen, mit denen man den Step konfigurieren kann.
Name | Datentyp | Beschreibung | Pflichtfeld | Werte | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Tradebyte TBCAT Input | SPREADSHEET | Input Spreadsheet to generate a XML file in TBCAT format. | Ja | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
mappingdefinition | STRING | The mapping definition JSON String | Ja | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Folgende Felder sind zu konfigurieren:
|
Outputs
Das sind die Ergebnisse des Steps, die von nachfolgenden Steps, nach der Ausführung verwendet werden können.
Name | Datentyp | Beschreibung | Pflichtfeld | Werte | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
TBCAT XML Files | FILELIST | Ja | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Failed Products and Articles | SPREADSHEET | Spreasheet with with P_NR or A_NR missing. | Ja | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Invalid Product or Article data | SPREADSHEET | Spreasheet with invalid data. | Ja | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Folgende Felder sind im Output enthalten:
|