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

• 1 Festlegen der Produkt- und Artikeldaten
  • 1.1 Hinweise
  • 1.2 Wichtig!
• 2 Produktdaten
• 3 Artikeldaten
  • 3.1 Artikelpreise
  • 3.2 Angaben zu Versandart und Maße
  • 3.3 TradeStat-Informationen
• 4 Beispiele zu Hilfsfunktionen

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 Verknüpfungstypen cross (Kombinationsmöglichkeiten)accessory (Zubehör zum Produkt)device (Produkt zum Zubehör)upselling (Empfehlung)alternative (Alternativangebot)	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	1	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) CM (Zentimeter) QM (Quadratmeter)
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>