TradebyteAddMultilanguageProducts - Tradebyte

← Tradebyte Add-On Übersicht

Der TradebyteAddMultilanguageProducts erstellt einen XML-Produktkatalog entsprechend der Tradebyte-Spezifikation für z.B. den Upload auf den Tradebyte FTP Server. Dieser Step ist identisch mit dem TradebyteAddProducts Step. Es wurden nur die für die Mehrsprachigkeit notwendigen Felder angepasst. Daher wird hier nur auf diese Felder eingegangen und auf die Step Dokumentation des TradebyteAddProducts Steps verwiesen (TradebyteAddProducts).

Format

Hinweis

Zur Anlage mehrsprachiger Produkt- und Artikelbeschreibungen werden die ISO Codes nach ISO-639 benötigt.

Die Spalten, welche die Möglichkeit bieten mehrsprachige Daten anzugeben, müssen grundsätzlich in dieser Form entsprechen:

Schlüssel="isocode1=Wert1;isocode2=Wert2"

oder

isocode1="Wert1";isocode2="Wert2"

Es müssen hier, im Unterschied zu den “normalen” Spalten immer in Anführungszeichen gesetzt werden. Alle Werte ohne Anführungszeichen werden nicht in den TBCAT Produktkatalog übernommen.

Beispiele für die ISO-Codes sind:

de-DE; en-US; en-GB; ru-RU etc...

Produktdaten

Name	Beispiel	Beschreibung	Pflichtfeld	Datentyp	Werte	Hinweise
P_NAME	de-DE="Outdoor-Jacke Reinhold";en-US="Outdoor Jacket Reinhold"	mehrsprachige Produktbezeichnung	nein	Text	isocode="Wert";isocode="Wert"	Wird P_NAME genutzt, müssen P_NAME_PROPER und P_NAME_KEYWORD leer bleiben.
P_NAME_PROPER	de-DE="Outdoor-Jacke";en-US="Outdoor Jacket"	Statt der Produktbezeichnung P_NAME, kann der Name auch in Gattungs- und Eigenname aufgeteilt sein (z.B. "Jacke Reinhold" vs. "Jacke"/"Reinhold")	nein	Text	isocode="Wert";isocode="Wert"	Wird P_NAME_PROPER genutzt, muss P_NAME_KEYWORD gefüllt werden und P_NAME leer bleiben.
P_NAME_KEYWORD	de-DE="Reinhold DE";en-US="Reinhold US"		ja	Text	isocode="Wert";isocode="Wert"	Wird P_NAME_KEYWORD genutzt, muss P_NAME_PROPER gefüllt werden und P_NAME leer bleiben.
P_SUPPLEMENT	de-DE="Winterjacke";en-US="Winter Jacket"	mehrsprachige Werbliche Zusatzüberschrift zum Produkt	nein	Text	isocode="Wert";isocode="Wert"
P_TEXT	de-DE="Die Outdoorjacke Reinhold ist eine außergewöhnlich robuste und funktionale Jacke!";en-US="The outdoor jacket Reinhold is an exceptionally robust and functional jacket!"	mehrsprachige Produktbeschreibung (Fließtext)	nein	Text	isocode="Wert";isocode="Wert"
P_KEYWORDS	jacke="de-DE=Kapuzenjacke;en-US=Hooded Jacket";funktionskleidung="de-DE=Funktionskleidung;en-US=Functional Clothing"	mehrsprachige Keywords/Suchbegriffe für das Produkt	nein	Text	Schlüssel="isocode1=Wert;isocode2=Wert";Schlüssel="isocode1=Wert;isocode2=Wert"	Der Schlüssel dient nur der eindeutigen Zuordnung der Suchbegriffe und wird nicht in den TBCAT Produktkatalog geschrieben. Er ist nur für die interne Verarbeitung relevant.
P_COMPONENTDATA	Länge="de-DE=110cm;en-US=39in";Saison="de-DE=Winter;en-US=Winter"	mehrsprachige Produktkomponenten	nein	Text	Schlüssel="isocode1=Wert;isocode2=Wert";Schlüssel="isocode1=Wert;isocode2=Wert"	Der Schlüsselname ist wie im TradebyteAddProducts Step der im TradeByte Backend hinterlegte Komponenten-Schlüssel.
P_BULLETS	atmungsaktiv="de-DE=atmungsaktiv;en-US=breathable";wasserdicht="de-DE=wasserdicht;en-US=waterproof"	mehrsprachige Aufzählungspunkte	nein	Text	Schlüssel="isocode1=Wert;isocode2=Wert";Schlüssel="isocode1=Wert;isocode2=Wert"	Der Schlüssel dient nur der eindeutigen Zuordnung der Suchbegriffe und wird nicht in den TBCAT Produktkatalog geschrieben. Er ist nur für die interne Verarbeitung relevant.

Artikeldaten

Name	Beispiel	Beschreibung	Pflichtfeld	Datentyp	Werte	Hinweise
A_VARIANTDATA	farbe="de-DE=blau;en-US=blue";größe="de-DE=XL;en-US=extra large"	mehrsprachige Variantenwerte	nein	Text	Schlüssel="isocode1=Wert;isocode2=Wert";Schlüssel="isocode1=Wert;isocode2=Wert"	Der Schlüsselname ist wie im TradebyteAddProducts Step der im TradeByte Backend hinterlegte Komponenten-Schlüssel.
A_COMPONENTDATA	Motiv=Vogel; Anzahl="de-DE=10 Stück;en-US=10 pieces"	mehrsprachige Artikelkomponenten	nein	Text	Schlüssel="isocode1=Wert;isocode2=Wert";Schlüssel="isocode1=Wert;isocode2=Wert"	>Der Schlüsselname ist wie im TradebyteAddProducts Step der im TradeByte Backend hinterlegte Komponenten-Schlüssel.

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: Feld Datentyp Beschreibung Pflichtfeld Standardwert hasArticles SINGLE 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. Nein isProduct SINGLE 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. Nein P_NR SINGLE Eindeutige Produkt-ID aus TB.One Ja P_NAME MULTIPLEVALUE Mehrsprachige Produktbezeichnung (isocode="Wert";isocode="Wert") Nein P_NAME_PROPER SINGLE Statt der Produktbezeichnung P_NAME, kann der Name auch in Gattungs- und Eigenname aufgeteilt sein (z.B. "Jacke Reinhold" vs. "Jacke"/"Reinhold") (isocode="Wert";isocode="Wert") Nein P_NAME_KEYWORD SINGLE Statt der Produktbezeichnung P_NAME, kann der Name auch in Gattungs- und Eigenname aufgeteilt sein (z.B. "Jacke Reinhold" vs. "Jacke"/"Reinhold") (isocode="Wert";isocode="Wert") Nein P_SUPPLEMENT MULTIPLEVALUE Werbliche mehrsprachige Zusatzüberschrift zum Produkt (isocode="Wert";isocode="Wert") Nein P_TEXT MULTIPLEVALUE Mehrsprachige Produktbeschreibung (Fließtext) isocode="Wert";isocode="Wert" Nein P_KEYWORDS MULTIPLEVALUE Mehrsprachige Keywords/Suchbegriffe für das Produkt (Schlüssel="isocode=Wert,isocode=Wert"; Schlüssel="isocode=Wert,isocode=Wert") Nein P_COMPONENTDATA MAP Produktkomponenten (Schlüssel="Wert";Schlüssel="Wert") Nein P_BULLETS MULTIPLEVALUE Mehrsprachige Aufzählungspunkte (Schlüssel="isocode=Wert,isocode=Wert"; Schlüssel="isocode=Wert,isocode=Wert") Nein A_NR SINGLE Artikelnummer Ja A_VARIANTDATA MAP Variantenwerte (Schlüssel="isocode=Wert,isocode=Wert"; Schlüssel="isocode=Wert,isocode=Wert") Nein A_COMPONENTDATA MAP Mehrsprachige Artikelkomponenten (Schlüssel="isocode=Wert,isocode=Wert"; Schlüssel="isocode=Wert,isocode=Wert") Nein

Outputs

Das sind die Ergebnisse des Steps, die von nachfolgenden Steps, nach der Ausführung verwendet werden können.

Name	Datentyp	Beschreibung	Werte
TBCAT XML Files	FILELIST
Failed Products and Articles	SPREADSHEET	Spreasheet with with P_NR or A_NR missing.
Invalid Product or Article data	SPREADSHEET	Spreasheet with invalid data.
	Folgende Felder sind im Output enthalten: Feld Datentyp Beschreibung Standardwert hasArticles SINGLE isProduct SINGLE A_NR SINGLE A_ACTIVE SINGLE A_ACTIVEDATA SINGLE A_EAN SINGLE A_PROD_NR SINGLE A_NR2 SINGLE A_VARIANTDATA SINGLE A_COMPONENTDATA SINGLE A_TAGS SINGLE A_PRICE_CURRENCY SINGLE A_PRICE_VK SINGLE A_PRICE_VK_OLD SINGLE A_PRICE_UVP SINGLE A_PRICE_EK SINGLE A_PRICE_MWST SINGLE A_PRICELIST_VK SINGLE A_PRICELIST_VK_OLD SINGLE A_PRICELIST_UVP SINGLE A_PRICELIST_EK SINGLE A_PRICELIST_MWST SINGLE A_PRICE SINGLE A_PRICELIST SINGLE A_PRICEDATA SINGLE A_BASEPRICE_QUANTITY SINGLE A_PROVISIONDATA SINGLE A_MEDIADATA SINGLE A_UNIT SINGLE A_STOCK SINGLE A_DELIVERY_TIME SINGLE A_REPLACEMENT SINGLE A_REPLACEMENT_TIME SINGLE A_ORDER_MIN SINGLE A_ORDER_MAX SINGLE A_ORDER_INTERVAL SINGLE A_DEPOT SINGLE A_DEPOT_TEXT SINGLE A_PARCEL_WIDTH SINGLE A_PARCEL_HEIGHT SINGLE A_PARCEL_LENGTH SINGLE A_PARCEL_WEIGHT SINGLE A_PARCEL_PIECES SINGLE A_PARCEL_TYPE SINGLE A_PARCEL SINGLE A_TRADESTAT_COUNTRY SINGLE A_TRADESTAT SINGLE P_NR SINGLE P_NR_EXTERNAL SINGLE P_NAME SINGLE P_NAME_PROPER SINGLE P_NAME_KEYWORD SINGLE P_SUPPLEMENT SINGLE P_TEXT SINGLE P_BRAND SINGLE P_KEYWORDS SINGLE P_COMPONENTDATA SINGLE P_TAGS SINGLE P_BULLETS SINGLE P_MEDIADATA SINGLE P_CATEGORIES SINGLE P_LINKDATA SINGLE P_VARIANTFIELDS SINGLE InvalidData SINGLE identifier SINGLE parent_identifier SINGLE