TB.One - Grundlagen Teil 4c - Stammdatenimport via TB.Cat 1.4 Version 1.6
←
→
Transkription von Seiteninhalten
Wenn Ihr Browser die Seite nicht korrekt rendert, bitte, lesen Sie den Inhalt der Seite unten
TB.One - Grundlagen Teil 4c
Stammdatenimport via TB.Cat 1.4
Version 1.6
3006DE1.6Änderungshistorie
Version Gültig ab Autor Änderungshinweise/Dokumentenhistorie
1.0 08.04.2019 Christine Czerwinski Ersterstellung (Anpassung Dok.3006_1.2v42)
1.1 03.04.2020 Manuel Mangold Anpassung: "P_COMPONENT", "P_TAG": CHAR(300)
1.2 06.05.2020 Sebastian Mathilaka- Medienupload: Link zum FAQ
thu
1.3 15.07.2020 Manuel Mangold Link zur Kurzdoku "Import: Archiv und Fehler" (Kap.6)
1.4 Okt. 2020 PRC Team Update aller Screenshots / neues UI
1.5 27.08.2021 Christa Weiß Ergänzung: A_PRICELIST, Preislisten-Kennzeichen, auf Preisdaten re-
duzierter Import
1.6 14.09.2021 Manuel Mangold Attribute "currency", "priority" und "sales price" aus dem Knoten
entfernt.
Copyright © Tradebyte Software GmbH. All Rights Reserved.
Dieses Dokument enthält geschützte Informationen von Tradebyte und darf außer in Übereinstimmung mit anwendbaren Vereinbarungen weder
offengelegt noch benutzt werden. Dieses Material ist durch Urheberrechtsgesetze geschützt. Ohne schriftliches Einverständnis von Tradebyte und
dem Besitzer dieses Materials darf dieses Material weder reproduziert, verteilt, noch geändert werden, es sei denn in Übereinstimmung mit an-
wendbaren Vereinbarungen, Verträgen oder Lizenzen.
Zur Genehmigung von Vervielfältigung oder Verteilung wenden Sie sich bitte an:
Tradebyte Software GmbH, Bahnhofsplatz 8, D-91522 Ansbach
E-Mail: Support@Tradebyte.com
http://www.tradebyte.com
Hinweis
Es wurden alle Anstrengungen unternommen, um sicherzustellen, dass die in diesem Dokument enthaltenen Informationen zum Zeitpunkt der
Veröffentlichung vollständig und richtig sind. Das Recht auf Änderungen der Informationen bleibt jedoch vorbehalten.
Die vorliegende Kundendokumentation beschreibt alle heute bekannten Funktionen. Es ist möglich, dass Funktionen beschrieben sind, die beim
Kunden nicht vorhanden sind. Der genaue Funktionsumfang ist abhängig von der gewählten Edition und dem aktuellen Release.
Warenzeichen
Microsoft, Windows und Excel sind eingetragene Warenzeichen der Microsoft Inc., USA.
Portable Document Format (PDF) und Postscript sind eingetragene Warenzeichen von Adobe Systems, Inc.
Alle anderen erwähnten Firmennamen und Logos sowie Marken- oder Produktnamen sind Warenzeichen oder eingetragene Warenzeichen ihrer
jeweiligen Eigentümer.
TB.One - Grundlagen Teil 4c © Tradebyte Software GmbH Seite 2 von 37Inhaltsverzeichnis
1 Ziel und Zweck des Dokuments .................................................................................................................................. 4
2 Voll- und Delta-Importe ............................................................................................................................................. 5
3 Dateien und Namenskonventionen ........................................................................................................................... 5
Preisinformationen ......................................................................................................................................................... 6
Bestandsinformationen .................................................................................................................................................. 6
4 Möglichkeiten der Feldzuordnung ............................................................................................................................. 7
Name............................................................................................................................................................................... 7
Key .................................................................................................................................................................................. 8
5 Mehrsprachenimport ................................................................................................................................................. 8
6 Import der Dateien ..................................................................................................................................................... 9
7 TB.CAT 1.4: XML-Aufbau und Felddefinition .............................................................................................................. 9
TBCATALOG ................................................................................................................................................................... 10
TBCATALOG / PRODUCTDATA ...................................................................................................................................... 11
TBCATALOG / PRODUCTDATA / PRODUCT ................................................................................................................... 11
TBCATALOG / PRODUCTDATA / PRODUCT / P_NAME .................................................................................................. 12
TBCATALOG / PRODUCTDATA / PRODUCT / P_SUPPLEMENT ...................................................................................... 13
TBCATALOG / PRODUCTDATA / PRODUCT / P_TEXT .................................................................................................... 13
TBCATALOG / PRODUCTDATA / PRODUCT / P_BRAND ................................................................................................ 14
TBCATALOG / PRODUCTDATA / PRODUCT / P_KEYWORDS ......................................................................................... 14
TBCATALOG / PRODUCTDATA / PRODUCT / P_COMPONENTDATA ............................................................................. 15
TBCATALOG / PRODUCTDATA / PRODUCT / P_TAGS ................................................................................................... 16
TBCATALOG / PRODUCTDATA / PRODUCT / P_BULLETS .............................................................................................. 17
TBCATALOG / PRODUCTDATA / PRODUCT / P_MEDIADATA ........................................................................................ 17
TBCATALOG / PRODUCTDATA / PRODUCT / P_LOGOS ................................................................................................. 19
TBCATALOG / PRODUCTDATA / PRODUCT / P_CATEGORIES........................................................................................ 19
TBCATALOG / PRODUCTDATA / PRODUCT / P_LINKDATA ............................................................................................ 20
TBCATALOG / PRODUCTDATA / PRODUCT / ARTICLEDATA .......................................................................................... 21
TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_ACTIVEDATA ...................................................................................... 22
TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_VARIANTDATA ................................................................................... 23
TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_COMPONENTDATA ............................................................................ 24
TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_TAGS .................................................................................................. 25
TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_PRICEDATA ......................................................................................... 26
TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_BASEPRICE_QUANTITY....................................................................... 27
TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_PROVISIONDATA ................................................................................ 28
TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_MEDIADATA ....................................................................................... 29
TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_STOCK ................................................................................................ 29
TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_PARCEL............................................................................................... 30
TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_TRADESTAT ........................................................................................ 30
8 Beispiele (key-based)................................................................................................................................................ 31
Produkt ohne Varianten, mehrsprachig ....................................................................................................................... 31
Produkt mit Varianten, einsprachig .............................................................................................................................. 34
TB.One - Grundlagen Teil 4c © Tradebyte Software GmbH Seite 3 von 371 Ziel und Zweck des Dokuments
Dieses Dokument richtet sich an Händler und definiert den Aufbau des TB.Cat zum Import von Produktdaten in
TB.One. Zu Begriffsdefinitionen, Datenaustauschoptionen und Importeinstellungen lesen Sie Teil 4. Insgesamt stehen
zu TB.One eine allgemeine Grundlagendokumentation sowie Manuals zu den verschiedenen Kanalspezifika zur Verfü-
gung. Die Grundlagendokumentation zu TB.One umfasst folgende Teile:
• Teil 1: Definitionen und Prozessübersicht
Dieses Dokument definiert die bei Tradebyte und in TB.One verwendeten Begrifflichkeiten und zeigt die Ab-
läufe und Möglichkeiten bei der Verwendung von TB.One auf.
• Teil 2: Vorüberlegungen
Dieses Dokument beschreibt Best Practice-Ansätze für Ihre Produktdaten in TB.One. Welche Daten verarbei-
tet TB.One, welche Daten können Sie liefern, wie "tickt" TB.One.
• Teil 3: Basiskonfiguration
Hier erfahren Sie wie und welche Einstellungen Sie in TB.One vornehmen müssen, bevor Sie Produkt- oder
Auftragsdaten mit TB.One verarbeiten können.
• Teil 4: Stammdaten in TB.One – Überblick
Dieser Teil der TB.One-Dokumentation zeigt die Möglichkeiten zur Stammdatenerfassung in TB.One und er-
läutert die für alle Schnittstellen relevanten Einstellungen.
• Teil 4a: Manuelle Stammdatenerfassung in TB.One
Ausführliche Anleitung zur manuellen Stammdatenerfassung anhand eines Beispielprodukts.
• Teil 4b: Stammdatenaustausch via CSV
Namenskonventionen und Feldbeschreibungen für Produkt- und Artikeldaten per CSV-Datei.
• Teil 4c: Stammdatenaustausch via XML
Namenskonventionen und Feldbeschreibungen für XML-Dateien im Tradebyte-Standard "TB.Cat".
• Teil 5: Wertemapping
Anleitung zur Zuordnung der in TB.One erfassten Stammdaten zu den Kanalanforderungen.
• Teil 6: Prüfung der Datenqualität
In diesem Kapitel stellen Sie nach dem Wertemapping mit Hilfe der Artikelliste sicher, dass Ihre Datenqualität
den Anforderungen genügt, arbeiten mit der Fehlerliste und den Fehler-/Statusmeldungen des Kanals und
erfahren mehr über regelmäßige "Wartungsarbeiten".
• Teil 7: Auftragsbearbeitung in TB.One – Überblick
Dieser Teil der TB.One-Dokumentation zeigt die Optionen zur Auftragsbearbeitung und zum Auftragsdaten-
austausch zwischen Händler und TB.One auf und erläutert die für alle Schnittstellen relevanten Einstellungen.
• Teil 7a: Auftragsbearbeitung in TB.One
Ausführliche Anleitung zur manuellen Auftragsbearbeitung in TB.One anhand eines Beispielauftrags.
• Teil 7b: Auftragsdatenaustausch via CSV
Namenskonventionen für CSV-Dateien, Feldbeschreibungen der Auftragsdaten sowie eine Anleitung
zur Übertragung von Meldungen (Lieferung, Storno, Retouren).
• Teil 7c: Auftragsdatenaustausch via XML
Namenskonventionen für XML-Dateien im Tradebyte-Standard "TB.Order", Feldbeschreibungen der
TB.Order sowie eine Anleitung zur Übertragung von Meldungen (Lieferung, Retoure, Storno).
• Teil 8: Statistik und Dashboard
Hier erfahren Sie, welche Auswertungen Sie mit TB.One durchführen können und wie Sie das Dashboard so
einstellen, dass Sie die wichtigsten Informationen auf einen Blick sehen.
Verweise auf einen dieser Dokumentteile innerhalb des nachfolgenden Textes lauten z.B. "T3-Kap.4.2" und bedeutet
in Kapitel 4.2 des Dokuments "Teil 3: Basiskonfiguration".
TB.One - Grundlagen Teil 4c © Tradebyte Software GmbH Seite 4 von 372 Voll- und Delta-Importe
Sie können in einer Import-Datei alle Produkte ("full") oder nur die geänderten Produkte ("delta") liefern.
Bitte beachten Sie, dass Sie dennoch in jedem Import komplette Daten pro Produkt (inkl. aller eventuell vor-
handenen Varianten) liefern sollten.
Um Artikel für alle Kanäle zu deaktivieren, liefern Sie am Artikel die Information 0
mit. Um Artikel für einen bestimmten Kanal zu deaktivieren, senden Sie 0. Nicht gelieferte Artikel werden nicht beeinflusst. Bitte beachten
Sie dabei, dass Sie bei Lieferung von Delta-Loads in TB.One die Checkbox "alle Artikel vor dem Import deakti-
vieren" unter "Admin > Import > Einstellungen" nicht aktivieren sollten (T4-Kap.4.1.6). Andernfalls würde das
dazu führen, dass ausschließlich die Artikel aktiv sind, die in der letzten Importdatei enthalten sind.
In TB.One kann eingestellt werden, ob nicht mehr im Import vorhandene Produktinformationen, wie z.B. gelöschte
Attribute oder Bilder in TB.One ebenfalls gelöscht werden. Das bedeutet nicht, dass nicht mehr enthaltene Produkte
gelöscht werden, sondern wirkt sich nur auf gelieferte Produkte aus.
Bei aktivierter Checkbox unter "Admin > Import > Einstellungen" gilt:
• Ein Produkt, das nicht geliefert wird, wird nicht beeinflusst.
• Um z.B. eine Komponente zu löschen, muss die Produktinformation den Knoten ent-
halten. In diesem müssen alle noch gültigen Komponenten enthalten sein.
Eine genaue Beschreibung der Einstellungen zum Import von Produktdaten finden Sie im übergeordneten Teil 4 der
Grundlagendokumentation. Den zu importierenden TB.Cat importieren Sie via FTP in das "in"-Verzeichnis.
3 Dateien und Namenskonventionen
Der von Tradebyte zur Verfügung gestellte Standard zur Übertragung von Produktdaten ist der TB.Cat. XML-Dateien
müssen vor der Übertragung an TB.One auf ihre Schemavalidität geprüft werden, unabhängig von der Schnittstelle,
die Sie verwenden. Die aktuell gültige Schemadatei finden Sie hier:
https://api.trade-server.net/schema/all_in_one/tb-cat_1_4_import.xsd (Schemadatei für TB.Cat v.1.4)
Importdateien für Produktdaten müssen wie folgt bezeichnet werden:
TBCAT_{timestamp}.xml
TBCAT_ Kennzeichnung als Produktkatalog
{timestamp} Zeitstempel
Die Definition des Zeitstempels ist frei, es wird jedoch empfohlen sich an folgenden Aufbau zu hal-
ten: JahrMonatTag_StundeMinuteSekunde (also z.B.: "20110812_124301")
.xml Dateiendung
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 Sie die Dateien zuerst mit der
Dateiendung ".tmp" hochladen und dann nach einem erfolgreichen Upload umbenennen.
TB.One - Grundlagen Teil 4c © Tradebyte Software GmbH Seite 5 von 37Preisinformationen
Um nur die Preise zu aktualisieren, ist es nicht notwendig, einen vollständigen TB.Cat zu liefern. Hier genügt es, nur die
relevanten Informationen im TB.Cat zu übertragen. Die Angabe einer Artikelnummer und des Kanalkennzeichens ist
Pflicht.
Beispiel-XML: Auf Preisdaten reduzierter Import; keine Preisliste
FBUSB-4R/A_NR>
8.99
15.99
18.99
2
Alternativ kannst du die Preise auch über Preislisten pflegen. Nutze in diesem Fall zusätzlich zur Artikelnummer den
Knoten und gib den Importschlüssel der Ziel-Preisliste an.
Beispiel-XML: Auf Preisdaten reduzierter Import; mit Preisliste
FBUSB-4R/A_NR>
9.99
12.99
14.99
2
Bestandsinformationen
Um nur die Bestände zu aktualisieren, ist es nicht notwendig, einen vollständigen TB.Cat zu liefern. Hier genügt es, die
relevanten Informationen zu übertragen. Die aktuell gültige Schemadatei finden Sie hier:
https://api.trade-server.net/schema/all_in_one/tb-stock_all_in_one.xsd
Namenskonvention:
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 hal-
ten: JahrMonatTag_StundeMinuteSekunde (also z.B: "20110812_124301")
TB.One - Grundlagen Teil 4c © Tradebyte Software GmbH Seite 6 von 37.xml Dateiendung
Beispiel-XML: Ein zentrales Lager (Referenzierung über A_NR)
3810blM
15
Beispiel-XML: Ein zentrales Lager (Referenzierung über A_EAN)
4003423414351
15
Beispiel-XML: Mehrere Lagerstätten
3810blM
10
5
4 Möglichkeiten der Feldzuordnung
Zur Zuordnung der Eigenschaften Komponente, Attribut, Marke und Logo zu bereits vorhandenen Einträgen gibt es
mehrere Möglichkeiten. Es wird zwischen "Name"- (oder Bezeichnung) und "Key"-basierten Zuordnungen unterschie-
den.
Die Kombination der Zuordnungsarten ist insofern möglich, als dass Sie z.B. Komponenten name-based referen-
zieren können und Attribute dann key-based. Es ist nicht möglich, die Zuordnungsart innerhalb eines Informati-
onsknotens zu wechseln. Sie können also NICHT die Komponente "Farbe" name-based und die Komponente
"Material" key-based übergeben!
Name
Sie können die Bezeichnungen der Eigenschaften direkt im Produkt übermitteln. Bitte beachten Sie hierbei, dass alle
Eigenschaften eine eindeutige Bezeichnung aufweisen müssen.
110 cm
In den Importeinstellungen kann definiert werden, dass alle neuen Eigenschaften während des Importvorgangs in
TB.One angelegt werden. Sie sollten den "name"-basierten Import nur wählen, wenn Sie keine Schlüsselkennzeichen
für die Eigenschaften zur Verfügung haben.
TB.One - Grundlagen Teil 4c © Tradebyte Software GmbH Seite 7 von 37Key
Der "key"-basierte Import ist der Referenzierung über den Namen vorzuziehen, da bei einer Änderung der Eigen-
schaftsbezeichnung die Referenz nicht verloren geht. Zudem können Sie über diese Form des Imports auch nur eine
kontrollierte Anzahl an Eigenschaften importieren (z.B. nur importieren, wenn ein entsprechender Schlüssel in TB.One
hinterlegt ist).
In TB.One können pro Eigenschaft Schlüssel definiert werden, über die während des Importvorgangs die Zuordnung
erfolgt. In den Importeinstellungen (T4-Kap.4.1.2) können Sie festlegen, dass die Importschlüssel aller neuen Cluster-
attribute, Marken, Komponenten, Service-Logos und Intrastat-Nummern beim Import automatisch angelegt werden
können.
110 cm
43.31 in
Insgesamt bevorzugt Tradebyte für den Datenimport eine keybasierte Referenzierung der Daten. Im Falle einer auto-
matischen Anlage wird der Schlüssel zusätzlich als Name angelegt, außer Sie übergeben zusätzlich zum "Key"-basier-
ten Import auch einen Namen. Bei einer automatisierten Anlage der Eigenschaften während des Imports werden dann
"key" und "name" übernommen. Sollten Sie nur auf bereits in TB.One vorhandene Eigenschaften referenzieren, ist die
Angabe des "name"-Attributes nicht notwendig.
110 cm
43.31 in
5 Mehrsprachenimport
Viele Informationen lassen sich in TB.One in mehreren Sprachen importieren. Auch die Beispiele in dieser Dokumenta-
tion zeigen in den meisten Fällen den Import in Deutsch und Englisch.
110 cm
43.31 in
Um mehrere Sprachen zu importieren, müssen die neben der Standardsprache gewünschten Sprachen zuerst in
TB.One unter "Artikel > Übersetzung > Sprachen" angelegt und mit einem Import-Key versehen werden.
Die Angabe im Tag "xml:lang=" für die weiteren Sprachen richtet sich nach dem von Ihnen vergebenen Import-Key, im
angeführten Textbeispiel ist dies "en-us".
TB.One - Grundlagen Teil 4c © Tradebyte Software GmbH Seite 8 von 37Bitte beachten Sie, dass der Import-Key mindestens dem Standard ISO-639 entsprechen, also mindestens 2 Zei-
chen lang sein muss.
6 Import der Dateien
Sie können Dateien über zwei Wege nach TB.One importieren. Einmal über die Benutzeroberfläche im Menü "Daten-
austausch > Verzeichnisse > Eingang" und zum anderen direkt über Ihren (S)FTP-Zugang.
Beim Upload über die Oberfläche steht Ihnen ein Validator für den Dateiinhalt zur Verfügung. Wählen Sie hierzu das
Menü "Datenaustausch > Validatoren > XML". Hier können Sie eine oder mehrere XML-Dateien zum Upload auswäh-
len und über "Hochladen & Validieren" auf ihre formale Richtigkeit überprüfen lassen. Sollte TB.One während der Ver-
arbeitung auf Probleme stoßen, wird eine entsprechende Fehlermeldung mit Hinweis auf die fehlerhafte Stelle ange-
zeigt.
Sind die Dateien korrekt, können sie von hier direkt in das Eingangsverzeichnis verschoben werden.
Bitte beachten Sie, dass die maximale Größe für einen Uploadvorgang 150 MB beträgt, auch wenn Sie meh-
rere Dateien gleichzeitig hochladen möchten. Wählen Sie also mehr als eine Datei gleichzeitig zum Upload
aus, darf die Größe aller Dateien gemeinsam die maximale Größe von 150 MB nicht überschreiten.
Wählen Sie in diesem Fall entweder weniger Dateien aus oder kopieren Sie die Dateien direkt in Ihr Ein-
gangsverzeichnis auf dem (S)FTP-Server.
Die Schaltfläche "Alle verarbeiten" ermöglicht den Import aller im Eingangsverzeichnis enthaltenen Dateien. Da derart
initiierte Importe mit der höchsten Priorisierung eingelastet werden, ist es notwendig, die Verwendung technisch ein-
zuschränken. Ein neuer Import-Job wird nur initiiert, wenn
• innerhalb der letzten 2 Stunden weniger als fünf andere Importe eingelastet wurden. Diese Standardeinstel-
lung kann nach Rücksprache angepasst werden. Ist dieses Limit bereits erreicht, erhalten Sie eine entspre-
chende Benachrichtigung am oberen Rand des Bildschirms.
• nicht bereits ein anderer Importauftrag auf seine Ausführung wartet.
Über die erfolgreiche Erstellung eines Import-Jobs werden Sie ebenfalls über die Nachrichtenzeile am oberen Bild-
schirmrand informiert. Manuell gestartete Importe erzeugen keine Folgejobs.
Beachten Sie zum Thema Import auch die Kurzdokumentation "Import: Archiv und Fehler".
7 TB.CAT 1.4: XML-Aufbau und Felddefinition
Bitte beachten Sie, dass sich sämtliche Angaben auf TB.One beziehen. Bei der Anbindung von Kanälen können die
Pflicht- oder optionalen Angaben von den hier gelisteten abweichen. Zudem können die in diesem Dokument an-
gegebenen Feldlängen kanalspezifisch abweichen. Dies führt zu zusätzlichen Pflichtfeldern, d.h. es gilt immer die
höchste Einschränkung. Kanalspezifische Knoten müssen je Kanal zusätzlich hinzugefügt werden.
Grau hinterlegte Felder sind nur der Vollständigkeit halber erwähnt und für den Import von Produktdaten nach
TB.One nicht relevant.
TB.One - Grundlagen Teil 4c © Tradebyte Software GmbH Seite 9 von 37TBCATALOG
Knoten Pflicht Datentyp Beschreibung
J XML Kodierung der Importdatei
Möglich Werte sind: UTF-8, ISO-8859-1
TBCATALOG J XML Rootknoten
version J XML Angabe der TB.Cat-Version, hier 1.4
creation N XML Zeitstempel der Katalogerstellung
SUPPLIER N XML In diesem Knoten können Informationen zum Daten-
lieferanten übertragen werden. Innerhalb des Kno-
tens ist nur der Name des Lieferanten ein Pflichtfeld.
CLASSIFICATION N XML Über diesen Knoten können bei Bedarf interne Kate-
gorien importiert werden (DokNr.3016).
PRODUCTDATA J XML Produktdaten
ARTICLEDATA J XML Artikeldaten
TB.One - Grundlagen Teil 4c © Tradebyte Software GmbH Seite 10 von 37TBCATALOG / PRODUCTDATA
Ein Produkt ist der Oberbegriff über eine oder mehrere Varianten einer Ware. Produkte selbst enthalten nur werbliche
Informationen und können selbst nicht bestellt werden.
Knoten Pflicht Datentyp Beschreibung
PRODUCTDATA J Produktdaten
PRODUCTDATA[type] N STRING Art der übertragenen Produktdaten. Mögliche Werte:
full = Komplettimport von Produktdaten
delta = Standardwert. Nur Änderungen werden geliefert. Je
nach Einstellung in TB.One werden nicht mehr gelieferte
Werte ignoriert oder gelöscht (siehe Kap.2)
PRODUCT N XML Daten zum Produkt
Beispiel-XML
...
...
TBCATALOG / PRODUCTDATA / PRODUCT
Knoten Pflicht Datentyp Beschreibung
P_NR J CHAR(50) Eindeutige Produktnummer
Falls keine Varianten vorhanden sind, können Artikelnummer
(A_NR) und Produktnummer (P_NR) identisch sein.
TB.One - Grundlagen Teil 4c © Tradebyte Software GmbH Seite 11 von 37Knoten Pflicht Datentyp Beschreibung
P_NAME N CHAR(255) Die Produktbezeichnung kann in einem Feld (P_NAME) ge-
pflegt oder auf die zwei Felder Gattungs- und Eigenname
(P_NAME_KEYWORD und P_NAME_PROPER) aufgeteilt wer-
P_NAME_KEYWORD J CHAR(255)
den.
P_NAME_PROPER N CHAR(255)
P_SUPPLEMENT N CHAR(255) Der Sondertext ist z.B. eine zweite werbliche Überschrift und
kann nicht von allen Kanälen verwertet werden.
P_TEXT J TEXT Die Produktbeschreibung ist als reiner Fließtext zu liefern. Der
Umgang mit Zeilenumbrüchen im HTML-Format ( oder
\n) kann über "Admin > Import > Einstellungen" konfiguriert
werden.
P_TEXT_INTERN N TEXT Interne Bemerkung
P_BRAND N XML Marke
P_KEYWORDS N XML Keywords/Suchbegriffe für das Produkt werden ausgespielt,
wenn der Empfänger diese Informationen unterstützt.
P_COMPONENTDATA N XML Produktkomponenten
P_TAGS N XML Produktattribute
P_BULLETS N XML Die Verwendung von besonderen Eigenschaften als Aufzäh-
lungsliste ist abhängig vom Vertriebskanal.
P_MEDIADATA N XML Produktmedien (Bilder, Dokumente, …)
P_LOGOS N XML Produktlogos (Pflegehinweise, …)
P_CATEGORIES N XML Kategorienzuordnungen und Clusterattribute
P_LINKDATA N XML Verknüpfungen (Cross-Selling, Zubehör, …)
ARTICLEDATA N XML Artikeldaten
TBCATALOG / PRODUCTDATA / PRODUCT / P_NAME
Die Produktbezeichnung kann in einem Feld (P_NAME) gepflegt oder auf die zwei Felder Gattungs- und Eigenname
(P_NAME_KEYWORD und P_NAME_PROPER) aufgeteilt werden. Diese Option wird in der Oberfläche von TB.One un-
ter "Admin > Systemeinstellungen > Oberfläche" aktiviert und wird von uns als Einstellung empfohlen. Wie bei vielen
anderen Feldern ist der Import in mehreren Sprachen möglich.
Knoten Pflicht Datentyp Beschreibung
P_NAME J TEXT Produktbezeichnung
oder ODER
TB.One - Grundlagen Teil 4c © Tradebyte Software GmbH Seite 12 von 37Knoten Pflicht Datentyp Beschreibung
P_NAME_KEYWORD J Gattungsname und
P_NAME_PROPER N Eigenname
VALUE xml:lang="Sprache" J TEXT Definition der Sprache mit entsprechendem Wert
Beispiel-XML
Outdoor-Jacke Reinhold
Outdoor-Jacket Reinhold
oder
Outdoor-Jacke
Outdoor-Jacket
Reinhold
Reinhold
TBCATALOG / PRODUCTDATA / PRODUCT / P_SUPPLEMENT
Knoten Pflicht Datentyp Beschreibung
P_SUPPLEMENT N TEXT Der Sondertext ist eine zweite werbliche Überschrift oder eine
Kurzbeschreibung und kann nicht von allen Kanälen verwertet
werden.
VALUE xml:lang="Sprache" J TEXT Definition der Sprache mit entsprechendem Wert
Beispiel-XML
Außergewöhnlich robust und funktional!
Exceptionally durable and functional!
TBCATALOG / PRODUCTDATA / PRODUCT / P_TEXT
TB.One - Grundlagen Teil 4c © Tradebyte Software GmbH Seite 13 von 37Knoten Pflicht Datentyp Beschreibung
P_TEXT J TEXT Produktbeschreibung als Fließtext ohne Eigenwerbung
VALUE xml:lang="Sprache" J TEXT Definition der Sprache mit entsprechendem Wert
Beispiel-XML
Die Outdoorjacke "Reinhold" ist eine außergewöhnlich robuste und funktionale
Jacke! Durch das innovative G-1000 Eco und G-1000 Heavy Duty-Material bietet sie
eine enorme Widerstandsfähigkeit und einen effektiven Schutz vor Wind und Witte-
rung, Kälte, Nässe und Sturm. Die Outdoorjacke "Reinhold" ist ein sehr anpas-
sungsfähiger Allrounder für das ganze Jahr, die Sie begeistern wird.
The outdoor jacket "Reinhold" is an exceptionally robust and functional
jacket! Through the innovative G-1000 Eco and G-1000 Heavy Duty-Material
offers you an enormous durability and an effective protection from wind and
weather, cold, wet and storm. The outdoor jacket "Reinhold" is a very
flexible all-rounder for the whole year, which will inspire you.
TBCATALOG / PRODUCTDATA / PRODUCT / P_BRAND
Knoten Pflicht Datentyp Beschreibung
P_BRAND N Marke des Produkts
P_BRAND[identifier] J Kennzeichen zur Referenzierung (key oder name)
P_BRAND[key] J CHAR(50) Wert zur in identifier hinterlegten Zuordnungsangabe
P_BRAND[name] N CHAR(100) Name zur in identifier hinterlegten Zuordnungsangabe
Beispiel-XML (key-based)
oder
TBCATALOG / PRODUCTDATA / PRODUCT / P_KEYWORDS
TB.One - Grundlagen Teil 4c © Tradebyte Software GmbH Seite 14 von 37Knoten Pflicht Datentyp Beschreibung
P_KEYWORDS N Suchbegriffe für das Produkt
P_KEYWORD J CHAR(255) Einzelner Suchbegriff
VALUE xml:lang="Sprache" N TEXT Definition der Sprache mit entsprechendem Wert
Beispiel-XML
Kapuzenjacke
Hoodie jacket
Anorak
Anorak
Funktionskleidung
Functional clothing
TBCATALOG / PRODUCTDATA / PRODUCT / P_COMPONENTDATA
Knoten Pflicht Datentyp Beschreibung
P_COMPONENTDATA N Produktkomponenten
P_COMPONENT J Text der Produktkomponente (ohne HTML-Formatierungen,
Zeilenumbrüche sind erlaubt)
P_COMPONENT[identifier] J Kennzeichen zur Referenzierung (key oder name)
P_COMPONENT[key] J CHAR(300) Wert zur in identifier hinterlegten Zuordnungsangabe
P_COMPONENT[name] N CHAR(300) Name zur in identifier hinterlegten Zuordnungsangabe
VALUE xml:lang="Sprache" J TEXT Definition der Sprache mit entsprechendem Wert
Beispiel-XML (key-based)
30 cm
30 cm
Grün
Green
TB.One - Grundlagen Teil 4c © Tradebyte Software GmbH Seite 15 von 37oder
30 cm
30 cm
Grün
Green
TBCATALOG / PRODUCTDATA / PRODUCT / P_TAGS
Knoten Pflicht Datentyp Beschreibung
P_TAGS N Produktattribute
P_TAG J Produktattribut
P_TAG[identifier] J Kennzeichen zur Referenzierung (key oder name)
P_TAG[key] J CHAR(300) Wert zur in identifier hinterlegten Zuordnungsangabe
P_TAG[name] N CHAR(300) Name zur in identifier hinterlegten Zuordnungsangabe
VALUES J Attributwerte
VALUE J Einzelner Attributwert
VALUE[identifier] J Kennzeichen zur Referenzierung (key oder name)
VALUE[key] J CHAR(50) Wert zur in identifier hinterlegten Zuordnungsangabe
VALUE[name] N CHAR(100) Name zur in identifier hinterlegten Zuordnungsangabe
Beispiel-XML (key-based)
oder
TB.One - Grundlagen Teil 4c © Tradebyte Software GmbH Seite 16 von 37TBCATALOG / PRODUCTDATA / PRODUCT / P_BULLETS
Zusätzlich zu Fließtexten und Komponenten können weitere Highlights von Produkten als Aufzählung übergeben wer-
den.
Knoten Pflicht Datentyp Beschreibung
P_BULLETS N Aufzählungspunkte
P_BULLET N Aufzählungspunkt
P_BULLET[sort] J INT Sortierung innerhalb der Aufzählungspunkte
VALUE xml:lang="Sprache" J CHAR(255) Definition der Sprache mit entsprechendem Wert
Beispiel-XML
atmungsaktiv
breathable
wasserdicht
waterproof
winddicht
windproof
TBCATALOG / PRODUCTDATA / PRODUCT / P_MEDIADATA
Da TB.One nicht nur Bilder, sondern auch andere Dateien behandeln kann, wird in diesem Zusammenhang allgemein
von Medien gesprochen. Medien werden üblicherweise per URL in der Importdatei angeliefert. TB.One lädt während
des Importvorgangs die Medien über die angegebene URL und speichert diese vorübergehend auf den Tradebyte-Ser-
vern ab. Die maximale Länge der URL für Produkt- und Artikelmedien darf 255 Zeichen nicht überschreiten.
Alternativ werden die Medien zip-komprimiert über FTP in das Eingangsverzeichnis "/in" hochgeladen (Dateiname:
media_*.zip; * üblicherweise Zeitstempel). Automatisch wird die gelieferte zip-Datei in den Ordner "sync/media" ent-
packt. Da dieser regelmäßig geleert wird, können Sie nicht überprüfen, welche Dateien von Ihnen geliefert wurden.
Dieses Tracking müssen Sie in Ihrem System führen. Unterverzeichnisse in der zip-Datei werden ignoriert. Die Ver-
knüpfung zu den Produkten und Artikeln erfolgt in den Medienknoten P_MEDIA bzw. A_MEDIA durch Angabe von
TB.One - Grundlagen Teil 4c © Tradebyte Software GmbH Seite 17 von 37"sync/media/Dateiname". Bitte liefern Sie Bilder der zip-Datei nur einmal und nicht mit jedem Upload! Im Regelfall
erfolgt dann die Weitergabe an die Vertriebskanäle mit einer Referenz auf die Tradebyte Server.
Jedem Medium muss im Import ein Medientyp mitgegeben werden. Wird kein Medientyp mitgegeben, wird vom Typ
"image" ausgegangen. Weitere Medientypen können bei Bedarf individuell in TB.One angelegt werden.
Medientyp Beschreibung Dateiformat
image Bild jpg, png
color Farbkachel jpg
manual Bedienungsanleitung pdf
energy Energieeffizienzinformationen pdf, jpg
Es wird generell zwischen Produkt und Artikelmedien unterschieden. Ein Produktmedium ist z.B. ein Bild von einem
Stapel T-Shirts in verschiedenen Farben. Ein Artikelmedium ist dann das explizite Bild zu einer Farbe (Variante).
Knoten Pflicht Datentyp Beschreibung
P_MEDIADATA N Produktmedien
P_MEDIA J CHAR(255) Referenz auf Produktmedium
P_MEDIA[type] J CHAR(50) Medientyp
P_MEDIA[sort] J INT Sortierung innerhalb der Produktmedien
P_MEDIA[origname] N CHAR(255) Originalname der Datei
Beispiel-XML
http://www.imageserver.tld/123.jpg
http://www.imageserver.tld/124.jpg
Bitte beachten Sie, dass für den Medienimport im Standard der komplette Pfad (URL) als Schlüssel verwendet wird,
d.h. ein Medium zu einer URL wird nur einmalig beim Import in Ihr TB.One abgerufen. Sollten sich bei Ihnen Medi-
eninformationen ändern, die URL aber die gleiche bleiben, wenden Sie sich bitte an Ihren Integrationsbetreuer.
Die Größenbegrenzung pro Datei liegt bei 10 MB. Bilder werden auf eine maximale Auflösung von 3000 x 3000 Pi-
xel reduziert. Bitte liefern Sie Ihre Bilder in der höchstmöglichen Auflösung. TB.One skaliert die Bilder kanalent-
sprechend auf die jeweils geforderte Auflösung "herunter".
Der Tradebyte-Server ist kein Bildserver, d.h. die Bilder werden hier nur zwischengespeichert. Der Kanal muss die
Bilder auf den eigenen Server übertragen und dort für eine adäquate Referenzierung und Verarbeitung sorgen.
TB.One - Grundlagen Teil 4c © Tradebyte Software GmbH Seite 18 von 37TBCATALOG / PRODUCTDATA / PRODUCT / P_LOGOS
Logos werden üblicherweise zur Darstellung von standardisierten Produktfeatures verwendet, z.B. Pflegesymbole
(30° Wäsche), Zertifizierungen (FSC) oder Ausstattungsmerkmale (Bluetooth).
Knoten Pflicht Datentyp Beschreibung
P_LOGOS N Produktlogos
P_LOGO J Produktlogo
P_LOGO[identifier] J Kennzeichen zur Referenzierung (key oder name)
P_LOGO[key] J CHAR(50) Wert zur in identifier hinterlegten Zuordnungsangabe
P_LOGO[name] N CHAR(100) Name zur in identifier hinterlegten Zuordnungsangabe
Beispiel-XML (key-based)
oder
TBCATALOG / PRODUCTDATA / PRODUCT / P_CATEGORIES
Knoten Pflicht Datentyp Beschreibung
P_CATEGORIES N Produktkategorien
P_CATEGORY J CHAR(200) Produktkategorie
P_CATEGORY[channel] N CHAR(12) Kanalkennzeichen (nur für primary und secondary)
P_CATEGORY[type] J ENUM Typ der Produktkategorie. Mögliche Werte:
internal = interne Kategorie
cluster = Clusterattribut
primary = Primäre Kanalkategorie
secondary = Sekundäre Kanalkategorie
P_CATEGORY[identifier] N Kennzeichen zur Referenzierung
P_CATEGORY[key] N CHAR(50) Wert zur in identifier hinterlegten Zuordnungsangabe
Beispiel-XML – Neuanlage (Cluster/interne Kategorie)
TB.One - Grundlagen Teil 4c © Tradebyte Software GmbH Seite 19 von 37Herren|Jacken|Freizeit
Herren|Jacken|Outdoor
Beispiel-XML – Zuordnung, wenn bereits vorhanden
TBCATALOG / PRODUCTDATA / PRODUCT / P_LINKDATA
Zur Angabe von Produktverknüpfungen ist die Produktnummer (P_NR) des Zielproduktes nötig.
Knoten Pflicht Datentyp Beschreibung
P_LINKDATA N Produktverknüpfungen (Cross-Selling, …)
P_LINK J CHAR(50) Verknüpfte Produktnummer
P_LINK[type] J ENUM Typ der Verknüpfung
Typ Beschreibung
cross Kombinationsmöglichkeiten / weitere Artikel
accessory Zubehör zum Produkt
device Produkt zum Zubehör
upselling Empfehlung
alternative Alternativangebot
family Produkt zu Produktfamilie
Beispiel-XML
75611
75595
TB.One - Grundlagen Teil 4c © Tradebyte Software GmbH Seite 20 von 37TBCATALOG / PRODUCTDATA / PRODUCT / ARTICLEDATA
Zu jedem Produkt muss mindestens ein Artikel übergeben werden. Sind mehrere Artikel pro Produkt vorhanden (Vari-
anten), so muss mindestens eine variantenbildende Komponente (A_VARIANTDATA) übergeben werden.
Knoten Pflicht Datentyp Beschreibung
A_NR J CHAR(50) Artikelnummer (mind. 4 Zeichen)
Um eine möglichst hohe Kompatibilität mit allen Vertriebska-
nälen zu gewährleisten, sollte die Artikelnummer keine Leer-
und Sonderzeichen enthalten und nicht mehr als 16 Zeichen
lang sein.
A_ACTIVEDATA N Kanalspezifische Artikelaktivierung
A_ACTIVE N INT(0/1) Artikel aktiv ja (=1)/nein (=0) (gilt kanalübergreifend)
A_EAN N INT(13) EAN-Code des Artikels
fixed (es dürfen nur EAN Nummern mit 13 Stellen geliefert werden)
A_PROD_NR N CHAR(50) Herstellerartikelnummer
A_NR2 N CHAR(50) Zusätzliche optionale Artikelnummer
A_SORT N INT Artikelsortierung innerhalb des Produkts
TB.One - Grundlagen Teil 4c © Tradebyte Software GmbH Seite 21 von 37Knoten Pflicht Datentyp Beschreibung
A_VARIANTDATA N Variantenwerte
A_COMPONENTDATA N Artikelkomponenten
A_TAGS N Artikelattribute
A_PRICEDATA N Preis- und Steuerangaben
A_BASEPRICE_QUANTITY N INT Bezugsdaten zur Grundpreisberechnung
A_PROVISIONDATA N Provisionsangaben für Kanäle
A_MEDIADATA N Artikelmedien (z.B. Bilder)
A_UNIT N Einheit des Artikels (Standardeinstellung ist "ST" für "Stück").
Mögliche Werte sind derzeit ST, CM und QM. Fließkommazah-
len werden in den Aufträgen/Beständen nicht unterstützt.
A_STOCK N INT Lagerbestand
A_DELIVERY_TIME N INT Lieferzeit in Tagen
A_REPLACEMENT N INT(1/0) Wiederbeschaffbar (1 = Artikel kann wiederbeschafft werden,
Verkauf auch mit Lagerbestand 0 möglich)
A_REPLACEMENT_TIME N INT Wiederbeschaffungszeit in Tagen
A_ORDER_MIN N INT Definition einer Mindestbestellmenge
A_ORDER_MAX N INT Definition einer maximalen Bestellmenge
A_ORDER_INTERVAL N INT Schrittweite bei der Eingabe einer Bestellmenge
A_DEPOT N CHAR(100) Lagerfach; Das Lagerfach kann auf Picklisten und Lieferschei-
nen angedruckt werden
A_DEPOT_TEXT N CHAR(255) Bemerkung zum Lagerfach
A_PARCEL N Angaben zu Versandtyp und Versandmaßen
A_TRADESTAT N Intrastat-Nummer zur Ausfuhr aus der EU und Ursprungsland
TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_ACTIVEDATA
Die Knoten und steuern, welcher Artikel an welchen Kanal exportiert und damit auf
diesen gelistet werden soll. Dies ermöglicht eine granulare Steuerung des Exports je Artikelvariante, ohne dass Varian-
tenprodukte in einzelne Produkte aufgesplittet werden müssen. So kann z.B. bei einem Größenbereich für Fashion von
XXS bis 5 XL gezielt ein Größenbereich an einen Kanal exportiert werden, ein anderer Größenbereich an einen anderen
Kanal, ohne dass dafür die Erstellung von zwei Produkten notwendig würde.
Knoten Pflicht Datentyp Beschreibung
A_ACTIVEDATA N Knoten für die kanalspezifische Artikelaktivierung
A_ACTIVE J INT(0/1) 0=deaktiviert, 1=aktiviert
A_ACTIVE[channel] J CHAR(12) Kanalkürzel, i.d.R. 4-stellig
A_ACTIVE N INT(0/1) Knoten für die kanalübergreifende Artikelaktivierung (0=deak-
tiviert, 1=aktiviert)
Beispiel-XML (key-based)
TB.One - Grundlagen Teil 4c © Tradebyte Software GmbH Seite 22 von 371
0
1
Um einen Artikel tatsächlich in den Export an einen Kanal zu integrieren, müssen beide -Knoten den
Wert 1 aufweisen.
Im Beispiel oben würde der Artikel an den mit "ch_1" angegebenen Kanal exportiert werden, nicht aber an ch_2.
Wäre der Wert des unteren -Knotens = 0, würde der Artikel an keinen der Kanäle exportiert.
TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_VARIANTDATA
Wird mehr als ein Artikel pro Produkt übergeben (Varianten), müssen mindestens eine Varianteneigenschaft und de-
ren Werte angegeben werden. Alle Varianten eines Produkts haben zwingend dieselbe Variantendimension. Werden
Varianten geliefert, müssen die Angaben zur jeweiligen Dimension in jedem Artikel des Produkts einen Wert aufwei-
sen.
Knoten Pflicht Datentyp Beschreibung
A_VARIANTDATA N Variantendimensionen
A_VARIANT J Variantendimension
A_VARIANT[identifier] J Kennzeichen zur Referenzierung (key oder name)
A_VARIANT[key] J CHAR(50) Wert zur in identifier hinterlegten Zuordnungsangabe
A_VARIANT[name] N CHAR(100) Name zur in identifier hinterlegten Zuordnungsangabe
VALUE xml:lang="Sprache" J TEXT Definition der Sprache mit entsprechendem Wert
Beispiel-XML (key-based)
Hellgrün
Light green
XL
XL
oder
Hellgrün
XL
TB.One - Grundlagen Teil 4c © Tradebyte Software GmbH Seite 23 von 37TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_COMPONENTDATA
Komponenten auf Artikelebene (siehe auch P_COMPONENTDATA) unterscheiden sich je Artikel, bilden aber dennoch
keine Varianten. Wenn Sie Artikelkomponenten übergeben, dann muss jeder Artikel auch einen Wert aufweisen.
Beispiel: Bei einem USB-Stick bildet die Speichergröße Varianten mit 32 GB und 64 GB. Je Speichergröße unter-
scheidet sich auch die Geschwindigkeit – 32 und 45 MB/s. Es gibt aber keinen Stick mit 32 GB und 45 MB/s und
keinen mit 64 GB und 32 MB/s. Die Zugriffsgeschwindigkeit könnte hier als Artikelkomponente erfasst werden.
Wenn Sie eine Komponente sowohl in A_VARIANTDATA (Variantendimension) als auch in A_COMPONENTDATA
(zusätzliche, informative Artikeleigenschaft) liefern, sollten Sie in jedem Fall vermeiden, in beiden Knoten die-
selbe Komponente zu referenzieren. In diesem Fall würde der Wert, den Sie in A_COMPONENTDATA liefern, als
Langtext der anzulegenden Variantendimension importiert (Oberfläche: Artikeldetailansicht, Reiter "Artikelei-
genschaften") statt als Artikelkomponente.
Der Standard ist aber, dass Sie nur den Kurztext (= Variantenwert) liefern wollen. Vermeiden Sie daher die dop-
pelte Referenzierung einer Komponente.
Knoten Pflicht Datentyp Beschreibung
A_COMPONENTDATA J Artikelkomponenten
A_COMPONENT N Definition der einzelnen Artikelkomponente
A_COMPONENT[identifier] N Kennzeichen zur Referenzierung (key oder name)
A_COMPONENT[key] N CHAR(50) Wert zur in identifier hinterlegten Zuordnungsangabe
A_COMPONENT[name] J CHAR(100) Name zur in identifier hinterlegten Zuordnungsangabe
VALUE xml:lang="Sprache" J TEXT Definition der Sprache mit entsprechendem Wert
Beispiel-XML (key-based)
V-Ausschnitt
V-neck
TB.One - Grundlagen Teil 4c © Tradebyte Software GmbH Seite 24 von 37oder
V-Ausschnitt
V-neck
TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_TAGS
Attribute auf Artikelebene (siehe auch P_TAGS).
Knoten Pflicht Datentyp Beschreibung
A_TAGS N Artikelattribute
A_TAG J Artikelattribut
A_TAG[identifier] J Kennzeichen zur Referenzierung (key oder name)
A_TAG[key] J CHAR(50) Wert zur in identifier hinterlegten Zuordnungsangabe
A_TAG[name] N CHAR(100) Name zur in identifier hinterlegten Zuordnungsangabe
VALUES J Attributwerte
VALUE J Einzelner Attributwert
VALUE[identifier] J Kennzeichen zur Referenzierung (key)
VALUE[key] J CHAR(50) Wert zur in identifier hinterlegten Zuordnungsangabe
Beispiel-XML (key-based)
TB.One - Grundlagen Teil 4c © Tradebyte Software GmbH Seite 25 von 37TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_PRICEDATA
Sie haben an dieser Stelle die Möglichkeit, einen globalen Netto-Einkaufspreis je Artikel zu überliefern. Dieser Ein-
kaufspreis dient rein zu internen Zwecken und wird von den Vertriebskanälen nicht weiterverarbeitet. Sonstige Preis-
angaben in Bezug auf das Tag "A_PRICE[channel]" sind nur für den angegebenen Vertriebskanal gültig. Neben Brutto-
verkaufspreisen können Sie an dieser Stelle kanalspezifische Netto-Einkaufspreise definieren. Diese Pflege ist bei be-
stimmten Vertriebskanälen im Rahmen der kanalspezifischen Datenaufbereitung verpflichtend.
Sie können die Preise entweder kanalspezifisch über den Knoten bereitstellen (sie werden dann zu den
Standardpreisen des Artikels für diesen Kanal), oder sie über den Knoten einer Preisliste zuordnen.
Über die Schemadatei ist definiert, dass nur 2 Nachkommastellen und als Dezimaltrennzeichen der Punkt erlaubt sind.
Knoten Pflicht Datentyp Beschreibung
A_PRICEDATA N Artikelpreise
A_EK N FLOAT Optionaler globaler Netto-Einkaufspreis des Artikels
A_PRICE J Preisangaben pro Kanal
A_PRICE[channel] J CHAR(12) Kanalkennzeichen, i.d.R. 4-stellig
A_PRICE[currency] N ENUM Währungskennzeichen
A_VK J FLOAT Brutto Verkaufspreis
A_VK_OLD N FLOAT Streichpreis (ehemaliger Preis)
A_UVP N FLOAT Unverbindliche Preisempfehlung
A_MWST N INT Kennzeichen für den Mehrwertsteuersatz
1 = ermäßigter Steuersatz
2 = normaler Steuersatz
3 = Mehrwertsteuerbefreit
A_EK N FLOAT Optionaler Netto-Einkaufspreis für einen Vertriebskanal
TB.One - Grundlagen Teil 4c © Tradebyte Software GmbH Seite 26 von 37Knoten Pflicht Datentyp Beschreibung
A_PRICELIST J Preisangabe pro Preisliste
A_PRICELIST[key] J CHAR(100) Importschlüssel der Preisliste
Beispiel-XML; Preisliste
9.99
12.99
14.99
2
Beispiel-XML; keine Preisliste
29.95
69.97
89.95
99.95
2
38.32
TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_BASEPRICE_QUANTITY
Angaben zu Füllmenge und Grundpreisbezug bei grundpreispflichtigen Artikeln.
Knoten Pflicht Datentyp Beschreibung
A_BASEPRICE_QUANTITY N FLOAT Füllmenge
A_BASEPRICE_QUANTITY[identifier] J Kennzeichen zur Referenzierung (key oder name)
A_BASEPRICE_QUANTITY[key] J CHAR(50) Wert zur in identifier hinterlegten Zuordnungsangabe
A_BASEPRICE_QUANTITY[name] N CHAR(100) Name zur in identifier hinterlegten Zuordnungsangabe
Beispiel-XML (key-based)
500
TB.One - Grundlagen Teil 4c © Tradebyte Software GmbH Seite 27 von 37TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_PROVISIONDATA
Je nach Abrechnungsmodell eines Vertriebskanals ist es teilweise erforderlich einen Prozentsatz oder ein entsprechen-
des Kennzeichen pro Artikel an die Plattform zu übertragen.
Die Provisionssätze müssen vor dem Import in TB.One angelegt und mit einem Import-Key versehen werden.
Knoten Pflicht Datentyp Beschreibung
A_PROVISIONDATA N Provisionsangaben
A_PROVISION J CHAR(50) Import-Key des Provisionssatzes aus TB.One
A_PROVISION[channel] J CHAR(12) Kanalkennzeichen
Beispiel-XML
Gruppe1
TB.One - Grundlagen Teil 4c © Tradebyte Software GmbH Seite 28 von 37TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_MEDIADATA
Medien auf Artikel-/Variantenebene. Hier handelt es sich üblicherweise um Medien mit einem direkten Artikelbezug
(z.B. Bild einer Farbvariante). Siehe auch P_MEDIADATA.
Knoten Pflicht Datentyp Beschreibung
A_MEDIADATA N Artikelmedien
A_MEDIA J CHAR(255) Referenz auf Artikelmedium. Gilt ein Bild für mehrere Varian-
ten, muss die Referenz je Variante wiederholt werden.
A_MEDIA[type] J CHAR(50) Medientyp (Tabelle)
A_MEDIA[sort] J INT Sortierung innerhalb der Artikelmedien
A_MEDIA[origname] N CHAR(255) Originalname der Datei
Beispiel-XML
http://www.imageserver.tld/123.jpg
http://www.imageserver.tld/124.jpg
Weitere Informationen zu diesem Thema finden Sie im Infocenter.
TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_STOCK
Bestände können in TB.One in ein zentrales Lager oder in mehrere Lagerstätten übertragen werden. Lager sind wiede-
rum mit den Vertriebskanälen verbunden.
Knoten Pflicht Datentyp Beschreibung
A_STOCK N INT Lagerbestand
A_STOCK[identifier] N CHAR(20) Nur bei mehreren Lagerstätten verwenden!
Muss immer "key" sein.
A_STOCK[key] N CHAR(50) Nur bei mehreren Lagerstätten verwenden!
Import-Key der Lagerstätte
Ein zentrales Lager
5
Mehrere Lagerstätten
10
5
TB.One - Grundlagen Teil 4c © Tradebyte Software GmbH Seite 29 von 37TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_PARCEL
Angaben zu Verkehrsträgern und Paketmaßen. Pakettypen und Versandarten legen Sie in TB.One im Menü "Basisda-
ten > Versand" an.
Knoten Pflicht Datentyp Beschreibung
A_PARCEL N Angaben zu Versandart und Maßen
A_PARCEL[type] N CHAR(50) Erforderliche Versandart (entsprechend der in TB.One angeleg-
ten Versandarten)
A_PIECES J INT Anzahl Packstücke (Mehrcollie)
A_WIDTH J INT Breite über alle Packstücke des Artikels in cm
A_HEIGHT J INT Höhe über alle Packstücke des Artikels in cm
A_LENGTH J INT Länge über alle Packstücke des Artikels in cm
A_WEIGHT J FLOAT Gewicht über alle Packstücke des Artikels in kg
Beispiel-XML
1
90
30
50
2.4
TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_TRADESTAT
Angaben zu Ursprungsland und IntraStat-Nummer (je nach Kanal erforderlich).
Knoten Pflicht Datentyp Beschreibung
A_TRADESTAT J Tradestat-Informationen
A_ORG_COUNTRY[alpha2] N CHAR(2) ISO 3166-1 Alpha 2 Code
A_TRADESTAT_NR J INT(8) Intrastat Nummer 8-stellig für die Ausfuhr aus der EU (Innerge-
meinschaftliche Handelsstatistik)
Beispiel-XML
94036090
TB.One - Grundlagen Teil 4c © Tradebyte Software GmbH Seite 30 von 378 Beispiele (key-based)
Produkt ohne Varianten, mehrsprachig
87
Outdoor-Jacke
Outdoor-Jacket
Reinhold
Reinhold
Die Outdoorjacke "Reinhold" ist eine außergewöhnlich robuste und funk-
tionale Jacke! Durch das innovative G-1000 Eco und G-1000 Heavy Duty-
Material bietet sie eine enorme Widerstandsfähigkeit und einen effek-
tiven Schutz vor Wind und Witterung, Kälte, Nässe und Sturm. Die
Outdoorjacke "Reinhold" ist ein sehr anpassungsfähiger Allrounder für
das ganze Jahr, die Sie begeistern wird.
The outdoor jacket "Reinhold" is an exceptionally robust and functio-
nal jacket! Through the innovative G-1000 Eco and G-1000 Heavy Duty-
Material offers you an enormous durability and an effective protection
from wind and weather, cold, wet and storm. The outdoor jacket "Rein-
hold" is a very flexible all-rounder for the whole year, which will
inspire you.
Kapuzenjacke
Hoodie
Anorak
Anorak
Funktionskleidung
Functional clothing
110 cm
110 cm
blau
TB.One - Grundlagen Teil 4c © Tradebyte Software GmbH Seite 31 von 37blue
atmungsaktiv
breathable
wasserdicht
waterproof
winddicht
windproof
http://foo.server/231.jpg
http://foo.server/232.jpg
Her-
ren|Jacken|Freizeit
Herren|Jacken|Out-
door
75611
75595
3810
1
0
1
4250372205442
56894
381059
V-Ausschnitt
V-neck
TB.One - Grundlagen Teil 4c © Tradebyte Software GmbH Seite 32 von 3729.95
87.99
109.95
120.00
2
59.90
97.99
109.95
120.00
2
http://foo.server/blau.jpg
http://foo.server/blaudetail.jpg
ST
2
3
1
5
1
2
1
1
90
30
50
2.4
94036090
TB.One - Grundlagen Teil 4c © Tradebyte Software GmbH Seite 33 von 37Produkt mit Varianten, einsprachig
87
Outdoor-Jacke
Reinhold
Die Outdoorjacke "Reinhold" ist eine außergewöhnlich robuste und funk-
tionale Jacke! Durch das innovative G-1000 Eco und G-1000 Heavy Duty-
Material bietet sie eine enorme Widerstandsfähigkeit und einen effek-
tiven Schutz vor Wind und Witterung, Kälte, Nässe und Sturm. Die
Outdoorjacke "Reinhold" ist ein sehr anpassungsfähiger Allrounder für
das ganze Jahr, die Sie begeistern wird.
Kapuzenjacke
Anorak
Funktionskleidung
110 cm
atmungsaktiv
wasserdicht
winddicht
TB.One - Grundlagen Teil 4c © Tradebyte Software GmbH Seite 34 von 37http://foo.server/231.jpg
http://foo.server/232.jpg
Herren | Jacken |
Freizeit
Herren | Jacken |
Outdoor
Herren | Jacken |
Funktion
Herren | Jacken |
Outdoor
75611
75595
3810blS
1
0
1
4250372205442
56894
381059
blau
S
V-Ausschnitt
29.95
87.99
109.95
120.00
2
59.90
TB.One - Grundlagen Teil 4c © Tradebyte Software GmbH Seite 35 von 3797.99
109.95
120.00
2
http://foo.server/blau.jpg
http://foo.server/blaudetail.jpg
ST
2
3
1
5
1
2
1
1
90
30
50
2.4
94036090
3810blM
0
1
1
4250372205452
56894
381060
blau
M
V-Ausschnitt
TB.One - Grundlagen Teil 4c © Tradebyte Software GmbH Seite 36 von 3729.95
87.99
109.95
120.00
2
59.90
97.99
109.95
120.00
2
http://foo.server/blau.jpg
ST
2
3
1
5
1
2
1
1
90
30
50
2.4
94036090
TB.One - Grundlagen Teil 4c © Tradebyte Software GmbH Seite 37 von 37Sie können auch lesen
