TB.ONE - GRUNDLAGEN TEIL 4C - Tradebyte Software ...

Die Seite wird erstellt Vera Seifert
 
WEITER LESEN
TB.ONE -
GRUNDLAGEN TEIL 4C
STAMMDATENIMPORT VIA TB.CAT 1.2

Seite 2                           TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

ÄNDERUNGSHISTORIE

        VERSION   DATUM        AUTOR          ÄNDERUNGSHINWEISE

        3.0       19.02.2014   Christine      Pfade auf neues Menü
                               Czerwinski

        4.0       16.07.2018   Christine      IntraStat für Ausfuhr
                               Czerwinski

        4.1       27.11.2018   Christine      Einschränkungen für manuelle Importe (Kap.6    17
                                                                                                  )   17

                               Czerwinski

        4.2       13.03.2019   Christine      Maximale Dateigröße bei manuellem Import: 150 MB
                               Czerwinski     (Kap.6   17
                                                            )

        4.3       06.04.2020   Christine      Anpassung: Datentyp von "P_COMPONENT ", "P_TAG":
                               Czerwinski     CHAR(300)

        4.4       06.05.2020   Sebastian      Medienupload: Link zum FAQ
                               Mathilakathu

        4.5       15.07.2020   Manuel         Link zur Kurzdoku "Import: Archiv und Fehler" (Kap.6          17
                                                                                                                 )
                               Mangold

        4.6       Okt. 2020    PRC Team       Update aller Screenshots / neues UI

        4.7       26.08.2021   Christa Weiß   Ergänzung: Preislisten-Kennzeichen, auf Preisdaten
                                              reduzierter Import

        4.8       04.01.2022   Lea            Anpassung neues Design
                               Daxelmüller
4.8.0

Seite 3                                                                                  TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

© 2022 Tradebyte Software GmbH

Alle Rechte vorbehalten. 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 anwendbaren 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

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 zum Veröffentlichungszeitpunkt 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.

Seite 4                                                                                                            TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

INHALTSVERZEICHNIS
1. ZIEL UND ZWECK DES DOKUMENTS ....................................................................................... 7
2. VOLL- UND DELTA-IMPORTE ...................................................................................................... 9
3. DATEIEN UND NAMENSKONVENTIONEN ........................................................................... 10
    3.1 PREISINFORMATIONEN ...................................................................................................................................... 11
    3.2 BESTANDSINFORMATIONEN ............................................................................................................................ 12
4. MÖGLICHKEITEN DER FELDZUORDNUNG ........................................................................... 14
    4.1 NAME ..................................................................................................................................................................... 14
    4.2 KEY ......................................................................................................................................................................... 15
5. MEHRSPRACHENIMPORT ......................................................................................................... 16
6. IMPORT DER DATEIEN ............................................................................................................... 17
7. TB.CAT 1.2: XML-AUFBAU UND FELDDEFINITION ............................................................. 18
    7.1 TBCATALOG ......................................................................................................................................................... 18
    7.2 TBCATALOG / PRODUCTDATA ......................................................................................................................... 19
    7.3 TBCATALOG / PRODUCTDATA / PRODUCT ................................................................................................... 20
    7.4 TBCATALOG / PRODUCTDATA / PRODUCT / P_ACTIVEDATA ................................................................... 23
    7.5 TBCATALOG / PRODUCTDATA / PRODUCT / P_NAME ................................................................................ 23
    7.6 TBCATALOG / PRODUCTDATA / PRODUCT / P_SUPPLEMENT ................................................................... 26
    7.7 TBCATALOG / PRODUCTDATA / PRODUCT / P_TEXT .................................................................................. 27
    7.8 TBCATALOG / PRODUCTDATA / PRODUCT / P_BRAND .............................................................................. 28
    7.9 TBCATALOG / PRODUCTDATA / PRODUCT / P_KEYWORDS ...................................................................... 29
    7.10 TBCATALOG / PRODUCTDATA / PRODUCT / P_COMPONENTDATA ..................................................... 30
    7.11 TBCATALOG / PRODUCTDATA / PRODUCT / P_TAGS ............................................................................... 32
    7.12 TBCATALOG / PRODUCTDATA / PRODUCT / P_BULLETS ......................................................................... 34
    7.13 TBCATALOG / PRODUCTDATA / PRODUCT / P_MEDIADATA .................................................................. 36
    7.14 TBCATALOG / PRODUCTDATA / PRODUCT / P_LOGOS ............................................................................ 38
    7.15 TBCATALOG / PRODUCTDATA / PRODUCT / P_CATEGORIES ................................................................. 39
    7.16 TBCATALOG / PRODUCTDATA / PRODUCT / P_LINKDATA ...................................................................... 41
    7.17 TBCATALOG / PRODUCTDATA / PRODUCT / ARTICLEDATA ................................................................... 42
    7.18 TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_VARIANTDATA ............................................................. 45
    7.19 TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_COMPONENTDATA .................................................... 47
    7.20 TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_TAGS .............................................................................. 49
    7.21 TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_PRICEDATA ................................................................... 50
    7.22 TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_BASEPRICE_QUANTITY .............................................. 52
    7.23 TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_PROVISIONDATA ......................................................... 53
    7.24 TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_MEDIADATA ................................................................. 54
    7.25 TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_STOCK ........................................................................... 54
    7.26 TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_PARCEL .......................................................................... 55
    7.27 TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_TRADESTAT .................................................................. 56
8. BEISPIELE (KEY-BASED) ............................................................................................................. 58
    8.1 PRODUKT OHNE VARIANTEN, MEHRSPRACHIG ............................................................................................ 58
    8.2 PRODUKT MIT VARIANTEN, EINSPRACHIG ..................................................................................................... 63

Seite 5                                                                                                                                                        TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

Seite 6   TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

1. ZIEL UND ZWECK DES DOKUMENTS

                     Die folgenden Kapitel von Teil 4c der Grundlagendokumentation informieren wir dich
                     über die Stammdatenaustausch über XML (TB.Cat 1.2/TB.Cat 1.4).

Dieses Handbuch richtet sich an Händler*innen, die TB.One nutzen möchten. Es unterstützt dich bei den
ersten Schritten und Überlegungen, bevor du deine Stammdaten in TB.One anlegst oder importierst.
Insgesamt stehen dir zu TB.One neben dieser Grundlagendokumentation verschiedene kanalspezifische
Handbücher zur Verfügung. Die Grundlagendokumentation ist in folgende Teile gegliedert:

TEIL 1: DEFINITIONEN UND PROZESSÜBERSICHT
Dieses Dokument definiert die bei Tradebyte und in TB.One verwendeten Begrifflichkeiten und zeigt die
Abläufe und Möglichkeiten bei der Verwendung von TB.One.

TEIL 2: VORÜBERLEGUNGEN UND BEST PRACTICE
Dieses Dokument beschreibt Best-practice für deine Produktdaten in TB.One. Welche Daten verarbeitet
TB.One, wie "tickt" TB.One, welche Daten kannst du liefern?

TEIL 3: BASISKONFIGURATION
Hier erfährst du, wie und welche Einstellungen du in TB.One vornehmen solltest, damit du Produkt- oder
Auftragsdaten mit TB.One verarbeiten kannst.

TEIL 4: STAMMDATEN IN TB.ONE – ÜBERBLICK
Dieser Teil der TB.One-Dokumentation zeigt die Möglichkeiten zur Stammdatenerfassung in TB.One und
erlä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 (TB.CAT 1.2/TB.CAT 1.4)

    Namenskonventionen und Feldbeschreibungen für XML-Dateien per "TB.Cat".

TEIL 5: WERTEMAPPING
Anleitung zur Zuordnung der in TB.One erfassten Stammdaten zu den Kanalanforderungen.

TEIL 6: PRÜFUNG DER DATENQUALITÄT
Mit Hilfe dieses Kapitels stellst du nach dem Wertemapping sicher, dass die Datenqualität den
Anforderungen genügt. Du arbeitest mit der Fehlerliste im SolutionCenter und erfährst mehr über
regelmäßige "Wartungsarbeiten".

Seite 7                                                                                         TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

TEIL 7: AUFTRAGSBEARBEITUNG IN TB.ONE – ÜBERBLICK
Dieser Teil der TB.One-Dokumentation zeigt die Optionen zur Auftragsbearbeitung und zum
Auftragsdatenaustausch zwischen Händlern und TB.One auf und erläutert die für alle Schnittstellen relevanten
Einstellungen.

   TEIL 7A: MANUELLE 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, Storno, Retouren).

TEIL 8: STATISTIK UND DASHBOARD
Informiere dich, welche Auswertungen du mit TB.One durchführen kannst, und wie du das Dashboard so
einstellst, dass die wichtigsten Informationen auf einem Blick erkennbar sind.

Seite 8                                                                                       TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

2. VOLL- UND DELTA-IMPORTE
In der Import-Datei lieferst du entweder alle Produkte ("full") oder nur die geänderten Produkte ("delta").

                    Du solltest in jedem Import komplette Daten pro Produkt liefern (inkl. aller eventuell
                    vorhandenen Varianten).
                    Um Artikel zu deaktivieren, liefere am Artikel die Information
                    0 mit. Nicht gelieferte Artikel werden nicht beeinflusst. Bitte
                    beachte dabei, dass du bei Lieferung von Delta-Loads in TB.One die Checkbox "alle
                    Artikel vor dem Import deaktivieren" unter "Admin > Import > Einstellungen" nicht
                    aktivieren solltest (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
                       enthalten. In diesem müssen alle noch gültigen
                      Komponenten enthalten sein.

                    Eine genaue Beschreibung der Einstellungen zum Import von Produktdaten findest du
                    im übergeordneten Teil 4 der Grundlagendokumentation. Den zu importierenden
                    TB.Cat importierst du via FTP in das "in"-Verzeichnis.

Seite 9                                                                                             TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

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 du verwendest.

Die aktuell gültige Schemadatei findest du hier:

           http://api.trade-server.net/schema/all_in_one/tb-cat_1_2_import.xsd (Schemadatei für TB.Cat v.1.2)

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 halten: 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
                      die Dateien zuerst mit der Dateiendung ".tmp" hochgeladen und dann nach einem
                      erfolgreichen Upload umbenannt werden.

Seite 10                                                                                                TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

3.1 PREISINFORMATIONEN

                     Du musst keinen vollständigen TB.Cat liefern, wenn du nur die Preise aktualisieren
                     möchtest. Hier genügt es, nur die relevanten Informationen im TB.Cat zu übertragen.

                     Pflichtinformationen:
                     § die Artikelnummer (Knoten ) und das Kanalkennzeichen

                     § oder der Importschlüssel der Preisliste (Attribut "channel" im Knoten )

BEISPIEL-XML: AUF PREISDATEN REDUZIERTER IMPORT

                           FBUSB-4R/A_NR>

                                           8.99

                                           15.99

                                           18.99

                                           2

Seite 11                                                                                         TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

3.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 findest du hier:

 http://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 halten: JahrMonatTag_StundeMinuteSekunde
                                        (also z.B: "20110812_124301")

 .xml                                   Dateiendung

BEISPIEL-XML: EIN ZENTRALES LAGER (REFERENZIERUNG ÜBER A_NR)

                  3810blM

                  15

Seite 12                                                                                            TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

BEISPIEL-XML: EIN ZENTRALES LAGER (REFERENZIERUNG ÜBER A_EAN)

                  4003423414351

                  15

BEISPIEL-XML: MEHRERE LAGERSTÄTTEN

                  3810blM                   

                  10

                  5

Seite 13                                                                                       TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

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 unterschieden.

                      Die Kombination der Zuordnungsarten ist insofern möglich, als dass du z.B.
                      Komponenten name-based referenzieren kannst und Attribute dann key-based. Es ist
                      nicht möglich, die Zuordnungsart innerhalb eines Informationsknotens zu wechseln. Du
                      kannst also NICHT die Komponente "Farbe" name-based und die Komponente
                      "Material" key-based übergeben!

4.1 NAME
Die Bezeichnungen der Eigenschaften können direkt im Produkt übermittelt werden. Dabei ist zu beachten,
dass alle Eigenschaften eine eindeutige Bezeichnung aufweisen müssen.

           110cm

In den Importeinstellungen kann definiert werden, dass alle neuen Eigenschaften während des
Importvorgangs in TB.One angelegt werden. Du solltest den "name"-basierten Import nur wählen, wenn du
keine Schlüsselkennzeichen für die Eigenschaften zur Verfügung hast.

Seite 14                                                                                           TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

4.2 KEY
Der "key"-basierte Import ist der Referenzierung über den Namen vorzuziehen, da bei einer Änderung der
Eigenschaftsbezeichnung die Referenz nicht verloren geht. Zudem kannst du ü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   42
                                                                   ) kannst du festlegen, dass die
Importschlüssel aller neuen Clusterattribute, 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 automatischen Anlage wird der Schlüssel zusätzlich als Name angelegt, außer du übergibst zusätzlich
zum "Key"-basierten Import auch einen Namen. Bei einer automatisierten Anlage der Eigenschaften während
des Imports werden dann "key" und "name" übernommen. Solltest du nur auf bereits in TB.One vorhandene
Eigenschaften referenzieren, ist die Angabe des "name"-Attributes nicht notwendig.

           110 cm

           43.31 in

Seite 15                                                                                             TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

5. MEHRSPRACHENIMPORT
Viele Informationen lassen sich in TB.One in mehreren Sprachen importieren. Auch die Beispiele in dieser
Dokumentation 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 dir vergebenen Import-
Key, im angeführten Textbeispiel ist dies "en-us".

                      Bitte beachte, dass der Import-Key mindestens dem Standard ISO-639 entsprechen,
                      also mindestens 2 Zeichen lang sein muss.

Seite 16                                                                                      TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

6. IMPORT DER DATEIEN
Du kannst Dateien über zwei Wege nach TB.One importieren:
§ Über die Benutzeroberfläche im Menü "Datenaustausch > Verzeichnisse > Eingang", oder

§ direkt über deinen (S)FTP-Zugang.

Beim Upload über die Oberfläche steht dir ein Validator für den Dateiinhalt zur Verfügung. Rufe zunächst das
Menü "Datenaustausch > Validatoren > XML" auf. Hier kannst du eine oder mehrere XML-Dateien zum Upload
auswählen und über "Hochladen & Validieren" auf ihre formale Richtigkeit überprüfen lassen. Sollte TB.One
während der Verarbeitung auf Probleme stoßen, wird eine entsprechende Fehlermeldung mit Hinweis auf die
fehlerhafte Stelle angezeigt.
Sind die Dateien korrekt, können sie von hier direkt in das Eingangsverzeichnis verschoben werden.

                    Die maximale Größe für einen Uploadvorgang beträgt 150 MB, auch wenn du mehrere
                    Dateien gleichzeitig hochladen möchtest. Wählst du 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ähle in diesem Fall entweder weniger Dateien aus oder kopiere die Dateien direkt in
                    dein Eingangsverzeichnis 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 einzuschränken. Ein neuer Import-Job wird nur initiiert, wenn
§ innerhalb der letzten 2 Stunden weniger als fünf andere Importe eingelastet wurden. Diese
  Standardeinstellung kann nach Rücksprache angepasst werden. Ist dieses Limit bereits erreicht, erhältst du
  eine entsprechende Benachrichtigung am oberen Rand des Bildschirms.
§ nicht bereits ein anderer Importauftrag auf seine Ausführung wartet.

Über die erfolgreiche Erstellung eines Import-Jobs wirst du ebenfalls über die Nachrichtenzeile am oberen
Bildschirmrand informiert. Manuell gestartete Importe erzeugen keine Folgejobs.

                    Beachte zum Thema Import auch die Kurzdokumentation "Import: Archiv und Fehler".

Seite 17                                                                                         TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

7. TB.CAT 1.2: XML-AUFBAU UND FELDDEFINITION

                   Sämtliche Angaben beziehen sich auf TB.One. 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 angegebenen 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.

7.1 TBCATALOG

 KNOTEN                       PFLICHT        DATENTYP         BESCHREIBUNG

                                            Möglich Werte sind: UTF-8, ISO-8859-1

 TBCATALOG                    J              XML              Rootknoten

 Version                      J              XML              Angabe der TB.Cat-Version, hier 1.2

 SUPPLIER                     N              XML              In diesem Knoten können Informationen zum
                                                              Datenlieferanten übertragen werden.
                                                              Innerhalb des Knotens ist nur der Name des
                                                              Lieferanten ein Pflichtfeld.

Seite 18                                                                                        TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

 KNOTEN                     PFLICHT            DATENTYP       BESCHREIBUNG

 CLASSIFICATION             N                  XML            Über diesen Knoten können bei Bedarf
                                                              interne Kategorien importiert werden
                                                              (DokNr.3016).

 PRODUCTDATA          19
                            J                  XML            Produktdaten

 ARTICLEDATA     42
                            J                  XML            Artikeldaten

7.2 TBCATALOG / 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    DATENTY        BESCHREIBUNG
                                           P

 PRODUCTDATA                    J                         Produktdaten

 PRODUCTDATA[type]              N          ENUM           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 "Voll- und Delta-Importe   9
                                                                                                ")

 PRODUCT    20
                                N          XML            Daten zum Produkt

Seite 19                                                                                             TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

BEISPIEL-XML

           ...

           ...

7.3 TBCATALOG / PRODUCTDATA / PRODUCT

Seite 20                                TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

 KNOTEN                                  PFLICHT   DATENTYP    BESCHREIBUNG

 P_NR                                    J         CHAR(50)    Eindeutige Produktnummer
                                                               Falls keine Varianten vorhanden sind, kann
                                                               auch die Artikelnummer (A_NR) als
                                                               Produktnummer verwendet werden

 P_ACTIVEDATA         23
                                         N         XML         Aktivierungskennzeichen des gesamten
                                                               Produkts für verschiedene Kanäle

 P_NAME     23
                                         N         CHAR(255)   Produktbezeichnung. Du kannst die
                                                               Produktbezeichnung in einem Feld (P_NAME)
 P_NAME_KEYWORD                     23
                                         J         CHAR(255)   pflegen oder die Bezeichnung auf die zwei
                                                               Felder Gattungs- und Eigenname
                                                               (P_NAME_KEYWORD und P_NAME_PROPER)
 P_NAME_PROPER                 23
                                         N         CHAR(255)
                                                               aufteilen. Diese Option wird von uns als
                                                               Einstellung empfohlen.
                                                               Zur Anzeige in TB.One aktivierst du diese in
                                                               der Oberfläche unter "Admin >
                                                               Systemeinstellungen > Oberfläche".

 P_SUPPLEMENT             26
                                         N         CHAR(255)   Der Sondertext ist z.B. eine zweite werbliche
                                                               Überschrift und kann nicht von allen Kanälen
                                                               verwertet werden.
                                                               Bei eBay kann der Sondertext als Untertitel
                                                               exportiert werden (u.U. kostenpflichtig).

 P_TEXT    27
                                         J         TEXT        Produktbeschreibung
                                                               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        28
                                         N         XML         Marke

 P_KEYWORDS          29
                                         N         XML         Keywords/Suchbegriffe für das Produkt. Diese
                                                               werden ausgespielt, wenn der Empfänger
                                                               diese Informationen unterstützt.

Seite 21                                                                                          TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

 KNOTEN                         PFLICHT   DATENTYP   BESCHREIBUNG

 P_COMPONENTDATA                N         XML        Produktkomponenten
   30

 P_TAGS    32
                                N         XML        Produktattribute

 P_BULLETS       34
                                N         XML        Besondere Features (Aufzählungszeichen);
                                                     die Verwendung ist abhängig vom
                                                     Vertriebskanal.

 P_MEDIADATA               36
                                N         XML        Produktmedien (Bilder, Dokumente, …)

 P_LOGOS        38
                                N         XML        Produktlogos (Pflegehinweise, …)

 P_CATEGORIES              39
                                N         XML        Kategorienzuordnungen und Clusterattribute

 P_LINKDATA           41
                                N         XML        Verknüpfungen (Cross-Selling, Zubehör, …)

 ARTICLEDATA           42
                                N         XML        Artikeldaten

Seite 22                                                                            TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

7.4 TBCATALOG / PRODUCTDATA / PRODUCT / P_ACTIVEDATA
Aktivierung von Produkten pro Vertriebskanal.

 KNOTEN                       PFLICHT        DATENTYP       BESCHREIBUNG

 P_ACTIVE                     J              INT(1/0)       0 = Inaktiv
                                                            1 = Aktiv

 P_ACTIVE[channel]            J              CHAR(12)       Kanalschlüssel (meist ein Kürzel mit 4
                                                            Buchstaben), den dein*e Solution Delivery
                                                            Manager*in dir mitteilt.

BEISPIEL-XML

           1

           0

7.5 TBCATALOG / PRODUCTDATA / PRODUCT / P_NAME
Du kannst die Produktbezeichnung in einem Feld (P_NAME) pflegen oder die Bezeichnung auf die zwei
Felder Gattungs- und Eigenname (P_NAME_KEYWORD und P_NAME_PROPER) aufteilen. Diese Option wird in
der Oberfläche von TB.One unter "Admin > Systemeinstellungen > Oberfläche" aktiviert und wird von uns als
Einstellung empfohlen.
Wie bei vielen anderen Felder ist der Import in mehreren Sprachen möglich.

Seite 23                                                                                      TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

                                       .

 KNOTEN               PFLICHT   DATENTYP   BESCHREIBUNG

 P_NAME               J         TEXT       Produktbezeichnung
 oder                                      ODER
 P_NAME_KEYWORD       J                    Gattungsname und
 P_NAME_PROPER        N
                                           Eigenname

 VALUE                J         TEXT       Definition der Sprache mit entsprechender
 xml:lang="Sprache"                        Übersetzung

Seite 24                                                                   TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

BEISPIEL-XML

           Outdoor-Jacke Reinhold

           Outdoor-Jacket Reinhold

oder

           Outdoor-Jacke

           Reinhold

Seite 25                                                                TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

7.6 TBCATALOG / PRODUCTDATA / PRODUCT / P_SUPPLEMENT

 KNOTEN                         OPTIONAL        DATENTYP        BESCHREIBUNG

 P_SUPPLEMENT                   N               TEXT            Der Sondertext ist eine zweite werbliche
                                                                Überschrift und kann nicht von allen Kanälen
                                                                verwertet werden. Bei eBay kann der
                                                                Sondertext als Untertitel exportiert werden
                                                                (u.U. kostenpflichtig).

 VALUE                          J               TEXT            Definition der Sprache mit entsprechender
 xml:lang="Sprache"                                             Übersetzung

BEISPIEL-XML

           Außergewöhnlich robust und funktional!

           Exceptionally durable and functional!

Seite 26                                                                                          TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

7.7 TBCATALOG / PRODUCTDATA / PRODUCT / P_TEXT

 KNOTEN                          PFLICHT            DATENTYP          BESCHREIBUNG

 P_TEXT                          J                  TEXT              Produktbeschreibung als Fließtext ohne
                                                                      Eigenwerbung

 VALUE                           J                  TEXT              Definition der Sprache mit entsprechender
 xml:lang="Sprache"                                                   Übersetzung

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.

Seite 27                                                                                              TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

7.8 TBCATALOG / PRODUCTDATA / PRODUCT / P_BRAND

 KNOTEN                      PFLICHT           DATENTYP      BESCHREIBUNG

 P_BRAND                     N                 -leer-        Marke des Produkts

 P_BRAND[identifier]         J                 ENUM          Kennzeichen zur Referenzierung        14
                                                                                                         (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

Seite 28                                                                                           TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

7.9 TBCATALOG / PRODUCTDATA / PRODUCT / P_KEYWORDS

 KNOTEN                      PFLICHT         DATENTYP         BESCHREIBUNG

 P_KEYWORDS                  N               -leer-           Suchbegriffe für das Produkt

 P_KEYWORD                   J               CHAR(255)        Einzelner Suchbegriff

 VALUE                       N               TEXT             Definition der Sprache mit entsprechender
 xml:lang="Sprache"                                           Übersetzung

BEISPIEL-XML

                 Kapuzenjacke

                 hoodie jacket

                 Anorak

                 Anorak

                 Funktionskleidung

                 functional clothing

Seite 29                                                                                      TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

7.10 TBCATALOG / PRODUCTDATA / PRODUCT / P_COMPONENTDATA

 KNOTEN                   PFLICHT   DATENTYP    BESCHREIBUNG

 P_COMPONENTDATA          N         XML         Produktkomponenten

 P_COMPONENT              J         TEXT        Text der Produktkomponente (ohne HTML-
                                                Formatierungen, Zeilenumbrüche sind
                                                erlaubt)

 P_COMPONENT[identifie    J         ENUM        Kennzeichen zur Referenzierung        12
                                                                                           (key
 r]                                             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

Seite 30                                                                          TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

 KNOTEN                          PFLICHT        DATENTYP        BESCHREIBUNG

 VALUE                           J              TEXT            Definition der Sprache mit entsprechender
 xml:lang="Sprache"                                             Übersetzung

BEISPIEL-XML (KEY-BASED)

                  30cm

                  30cm

                  Grün

                  Green

oder

                  30cm

                  30cm

                  Grün

                  Green

Seite 31                                                                                       TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

7.11 TBCATALOG / PRODUCTDATA / PRODUCT / P_TAGS

 KNOTEN              PFLICHT   DATENTYP    BESCHREIBUNG

 P_TAGS              N         XML         Produktattribute

 P_TAG               J         XML         Produktattribut

 P_TAG[identifier]   J         ENUM        Kennzeichen zur Referenzierung        14
                                                                                       (key oder
                                           name)

 P_TAG[key]          J         CHAR(50)    Wert zur in identifier hinterlegten
                                           Zuordnungsangabe

 P_TAG[name]         N         CHAR(100)   Name zur in identifier hinterlegten
                                           Zuordnungsangabe

 VALUES              J         XML         Attributwerte

 VALUE               J         XML         Einzelner Attributwert

 VALUE[identifier]   J         ENUM        Kennzeichen zur Referenzierung        12
                                                                                       (key)

 VALUE[key]          J         CHAR(50)    Wert zur in identifier hinterlegten
                                           Zuordnungsangabe

Seite 32                                                                         TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

BEISPIEL-XML (KEY-BASED)

oder

Seite 33                                                             TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

7.12 TBCATALOG / PRODUCTDATA / PRODUCT / P_BULLETS
Zusätzlich zu Fließtexten und Komponenten können weitere Highlights von Produkten als Aufzählung
übergeben werden.

 KNOTEN                    PFLICHT         DATENTYP        BESCHREIBUNG

 P_BULLETS                 N               XML             Aufzählungspunkte

 P_BULLET                  N               CHAR(255)       Aufzählungspunkt

 P_BULLET[sort]            J               INT             Sortierung innerhalb der Aufzählungspunkte

 VALUE                     J               TEXT            Definition der Sprache mit entsprechender
 xml:lang="Sprache"                                        Übersetzung

Seite 34                                                                                   TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

BEISPIEL-XML

                  atmungsaktiv

                  breathable

                  wasserdicht

                  waterproof

                  winddicht

                  windproof

Seite 35                                                             TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

7.13 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 Servern ab. Die maximale Länge der URL für Produkt- und Artikelmedien
darf 255 Zeichen nicht überschreiten.
Alternativ lädst du deine Medien zip-komprimiert über FTP in das Eingangsverzeichnis "/in" hoch (Dateiname:
media_*.zip; * üblicherweise Zeitstempel). Automatisch wird die gelieferte zip-Datei in den Ordner
"sync/media" entpackt. Da dieser regelmäßig geleert wird, kannst du nicht überprüfen, welche Dateien von
dir geliefert wurden. Dieses Tracking musst du in deinem System führen. Unterverzeichnisse in der zip-Datei
werden ignoriert. Die Verknüpfung zu den Produkten und Artikeln erfolgt in den Medienknoten P_MEDIA bzw.
A_MEDIA durch Angabe von "sync/media/Dateiname". Bitte liefere die 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                                              Energieefizienzinformatio    pdf, jpg
                                                     nen

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).

Seite 36                                                                                       TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

 KNOTEN                        PFLICHT          DATENTYP         BESCHREIBUNG

 P_MEDIADATA                   N                XML              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 beachte, 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 TB.One abgerufen. Sollten sich deine Medieninformationen ändern, die URL aber die
                      gleiche bleiben, wende dich bitte an deine*n Solution Delivery Manager*in.
                      Die Größenbegrenzung pro Datei liegt bei 10 MB. Bilder werden auf eine maximale
                      Auflösung von 3000 x 3000 Pixel reduziert. Bitte liefere deine Bilder in der
                      höchstmöglichen Auflösung. TB.One skaliert die Bilder kanalentsprechend 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.

Seite 37                                                                                             TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

7.14 TBCATALOG / 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                 XML             Produktlogos

 P_LOGO                          J                 -leer-          Produktlogo

 P_LOGO[identifier]              J                 ENUM            Kennzeichen zur Referenzierung        12
                                                                                                               (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

Seite 38                                                                                                 TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

7.15 TBCATALOG / PRODUCTDATA / PRODUCT / P_CATEGORIES

 KNOTEN                   PFLICHT   DATENTYP    BESCHREIBUNG

 P_CATEGORIES             N         XML         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         ENUM        Kennzeichen zur Referenzierung        12

 P_CATEGORY[key]          N         CHAR(50)    Wert zur in identifier hinterlegten
                                                Zuordnungsangabe

Seite 39                                                                              TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

BEISPIEL-XML – NEUANLAGE

                   Herren|Jacken|Freizeit

                   Herren|Jacken|Outdoor

BEISPIEL-XML – ZUORDNUNG, WENN BEREITS VORHANDEN

Seite 40                                                                                       TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

7.16 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öglichkeit
                                                                            en / weitere Artikel

                                                             accessory      Zubehör zum Produkt

                                                             device         Produkt zum Zubehör

                                                             upselling      Empfehlung

                                                             alternative    Alternativangebot

                                                             family         Produkt zu Produktfamilie

BEISPIEL-XML

           75611

           75595

Seite 41                                                                                    TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

7.17 TBCATALOG / PRODUCTDATA / PRODUCT / ARTICLEDATA
Zu jedem Produkt muss mindestens ein Artikel übergeben werden. Sind mehrere Artikel pro Produkt
vorhanden (Varianten), so muss mindestens eine variantenbildende Komponente (A_VARIANTDATA)
übergeben werden.

Seite 42                                                                                  TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

 KNOTEN                         PFLICHT   DATENTYP        BESCHREIBUNG

 A_NR                           J         CHAR(50)        Artikelnummer (mind. 4 Zeichen)
                                                          Um eine möglichst hohe Kompatibilität mit
                                                          allen Vertriebskanälen zu gewährleisten,
                                                          sollte die Artikelnummer keine Leer- und
                                                          Sonderzeichen enthalten und nicht mehr als
                                                          16 Zeichen lang sein.

 A_ACTIVE                       N         INT(0/1)        Artikel aktiv ja (=1)/nein (=0) (gilt für alle
                                                          Kanäle)

 A_EAN                          N         INT(13) fixed   EAN-Code des Artikels
                                                          (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

 A_VARIANTDATA        45
                                N         XML             Variantenwerte

 A_COMPONENTDATA                N         XML             Artikelkomponenten
   47

 A_TAGS    49
                                N         XML             Artikelattribute

 A_PRICEDATA    50
                                N         XML             Preis- und Steuerangaben

 A_BASEPRICE_QUANTIT            N         INT             Bezugsdaten zur Grundpreisberechnung
 Y   52

 A_PROVISIONDATA           53
                                N         XML             Provisionsangaben für Kanäle

 A_MEDIADATA     54
                                N         XML             Artikelmedien (z.B. Bilder)

 A_UNIT                         N         ENUM            Einheit des Artikels (Standardeinstellung ist
                                                          "ST" für "Stück"). Mögliche Werte sind derzeit
                                                          ST, CM und QM. Fließkommazahlen werden

Seite 43                                                                                       TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

 KNOTEN                PFLICHT   DATENTYP    BESCHREIBUNG

                                             in den Aufträgen/Beständen nicht
                                             unterstützt.

 A_STOCK    54
                       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 Lieferscheinen angedruckt werden

 A_DEPOT_TEXT          N         CHAR(255)   Bemerkung zum Lagerfach

 A_PARCEL    55
                       N         XML         Angaben zu Versandtyp und Versandmaßen

 A_TRADESTAT      56
                       N         XML         Intrastat-Nummer zur Ausfuhr aus der EU
                                             und Ursprungsland

Seite 44                                                                     TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

7.18 TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_VARIANTDATA
Wird mehr als ein Artikel pro Produkt übergeben (Varianten), müssen mindestens eine Varianteneigenschaft
und deren 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 aufweisen. Die Varianteneigenschaften beziehen sich auf die
Komponentenliste.

 KNOTEN                     PFLICHTEN       DATENTYP        BESCHREIBUNG

 A_VARIANTDATA              N               XML             Variantendimensionen

 A_VARIANT                  J               CHAR(255)       Wert der Variantendimension

 A_VARIANT[identifier]      J               ENUM            Kennzeichen zur Referenzierung        12
                                                                                                        (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                      J               TEXT            Definition der Sprache mit entsprechender
 xml:lang="Sprache"                                         Übersetzung

Seite 45                                                                                          TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

BEISPIEL-XML (KEY-BASED)

                   Hellgrün

                   Light green

                   XL

                   XL

oder

                   Hellgrün

                   XL

Seite 46                                                           TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

7.19 TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_COMPONENTDATA
Komponenten auf Artikelebene (siehe auch P_COMPONENTDATA          30
                                                                       ) unterscheiden sich je Artikel, bilden
aber dennoch keine Varianten. Artikelkomponenten werden nur von sehr wenigen Kanälen unterstützt. Wenn
du Artikelkomponenten übergibst, dann muss jeder Artikel auch einen Wert aufweisen.

                   Beispiel: Bei einem USB-Stick bildet die Speichergröße Varianten mit 32GB und 64GB.
                   Je Speichergröße unterscheidet sich auch die Geschwindigkeit - 32 und 45MB/s. Es
                   gibt aber keinen Stick mit 32 GB und 45MB/s und keinen mit 64GB und 32MB/s. Die
                   Zugriffsgeschwindigkeit könnte hier als Artikelkomponente erfasst werden.

                   Wenndu im Artikel eine Komponente sowohl in A_VARIANTDATA (Variantendimension)
                   als auch in A_COMPONENTDATA (zusätzliche, informative Artikeleigenschaft) lieferst,
                   solltest du in jedem Fall vermeiden, in beiden Knoten dieselbe Komponente zu
                   referenzieren.
                   In diesem Fall würde der Wert, der in A_COMPONENTDATA geliefert wird, als Langtext
                   der anzulegenden Variantendimension importiert (Oberfläche: Artikeldetailansicht,
                   Reiter "Artikeleigenschaften").
                   Der Standard ist aber, dass du nur den Kurztext (= Variantenwert) liefern musst. daher
                   die doppelte Referenzierung einer Komponente.

 KNOTEN                     PFLICHT          DATENTYP        BESCHREIBUNG

 A_COMPONENTDATA            J                XML             Artikelkomponenten

Seite 47                                                                                          TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

 KNOTEN                        PFLICHT         DATENTYP        BESCHREIBUNG

 A_COMPONENT                   N               CHAR(255)       Definition der einzelnen Artikelkomponente

 A_COMPONENT[identif           N               ENUM            Kennzeichen zur Referenzierung        12
                                                                                                           (key oder
 ier]                                                          name)

 A_COMPONENT[key]              N               CHAR(300)       Wert zur in identifier hinterlegten
                                                               Zuordnungsangabe

 A_COMPONENT[name]             J               CHAR(300)       Name zur in identifier hinterlegten
                                                               Zuordnungsangabe

 VALUE                         J               TEXT            Definition der Sprache mit entsprechender
 xml:lang="Sprache"                                            Übersetzung

BEISPIEL-XML (KEY-BASED)

                  V-Ausschnitt

                  V-neck

oder

                  V-Ausschnitt

                  V-neck

Seite 48                                                                                             TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

7.20 TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_TAGS
Attribute auf Artikelebene (siehe auch P_TAGS   32
                                                     ).

 KNOTEN                     PFLICHT         DATENTYP      BESCHREIBUNG

 A_TAGS                     N               XML           Artikelattribute

 A_TAG                      J               XML           Artikelattribut

 A_TAG[identifier]          J               ENUM          Kennzeichen zur Referenzierung        12
                                                                                                      (key oder
                                                          name)

 A_TAG[key]                 J               CHAR(300)     Wert zur in identifier hinterlegten
                                                          Zuordnungsangabe

 A_TAG[name]                N               CHAR(300)     Name zur in identifier hinterlegten
                                                          Zuordnungsangabe

 VALUES                     J               XML           Attributwerte

 VALUE                      J               XML           Einzelner Attributwert

 VALUE[identifier]          J               ENUM          Kennzeichen zur Referenzierung        12
                                                                                                      (key)

 VALUE[key]                 J               CHAR(50)      Wert zur in identifier hinterlegten
                                                          Zuordnungsangabe

Seite 49                                                                                        TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

BEISPIEL-XML (KEY-BASED)

7.21 TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_PRICEDATA
An dieser Stelle kannst du einen globalen Netto-Einkaufspreis je Artikel zu liefern. Dieser Einkaufspreis dient
rein zu internen Zwecken und wird von den Vertriebskanälen nicht weiterverarbeitet. Sonstige Preisangaben in
Bezug auf das Tag "A_PRICE[channel]" sind nur für den angegebenen Vertriebskanal oder die angegebene
Preisliste gültig. Neben Bruttoverkaufspreisen kannst du an dieser Stelle kanal-/preislistenspezifische Netto-
Einkaufspreise definieren. Diese Pflege ist bei bestimmten Vertriebskanälen im Rahmen der kanalspezifischen
Datenaufbereitung verpflichtend.
Über die Schemadatei ist definiert, dass nur 2 Nachkommastellen und als Dezimaltrennzeichen der Punkt
erlaubt sind.

Seite 50                                                                                          TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

 KNOTEN              PFLICHT   DATENTYP   BESCHREIBUNG

 A_PRICEDATA         N                    Artikelpreise

 A_EK                N         FLOAT      Optionaler globaler Netto-Einkaufspreis des
                                          Artikels

 A_PRICE             J                    Preisangaben pro Kanal oder für eine
                                          Preisliste

 A_PRICE[channel]    J         CHAR(12)   Kanalkennzeichen oder Importschlüssel der
                                          Preisliste

 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

Seite 51                                                                    TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

 KNOTEN                         PFLICHT        DATENTYP      BESCHREIBUNG

 A_EK                           N              FLOAT         Optionaler Einkaufspreis für einen
                                                             Vertriebskanal. Dieser ist Netto anzugeben.

BEISPIEL-XML

           29.95

                  69.97

                  89.95

                  99.95

                  2

                  38.32

7.22 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[ide            J               ENUM        Kennzeichen zur Referenzierung       12
                                                                                                            (key
 ntifier]                                                        oder name)

Seite 52                                                                                      TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

 KNOTEN                             PFLICHT       DATENTYP       BESCHREIBUNG

 A_BASEPRICE_QUANTITY[key]          J             CHAR(50)       Wert zur in identifier hinterlegten
                                                                 Zuordnungsangabe

 A_BASEPRICE_QUANTITY[na            N             CHAR(100)      Name zur in identifier hinterlegten
 me]                                                             Zuordnungsangabe

BEISPIEL-XML (KEY-BASED)

 500

7.23 TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_PROVISIONDATA
Je nach Abrechnungsmodell eines Vertriebskanals ist es teilweise erforderlich einen Prozentsatz oder ein
entsprechendes 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

Seite 53                                                                                       TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

7.24 TBCATALOG / ... / 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     36
                                                                             .

 KNOTEN                        PFLICHT          DATENTYP        BESCHREIBUNG

 A_MEDIADATA                   N                XML             Artikelmedien

 A_MEDIA                       J                CHAR(255)       Referenz auf Artikelmedium. Gilt ein Bild für
                                                                mehrere Varianten, muss die Referenz je
                                                                Variante wiederholt werden.

 A_MEDIA[type]                 J                CHAR(50)        Medientyp (Tabelle   36
                                                                                          )

 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 findest du im Infocenter.

7.25 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 wiederum mit den Vertriebskanälen verbunden.

Seite 54                                                                                          TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

 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(20)         Nur bei mehreren Lagerstätten verwenden!
                                                             Import-Key der Lagerstätte

EIN ZENTRALES LAGER

 5

MEHRERE LAGERSTÄTTEN

 10

 5

7.26 TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_PARCEL
Angaben zu Verkehrsträgern und Paketmaßen. Pakettypen und Versandarten legst du in TB.One unter
"Basisdaten > Versand" an.

Seite 55                                                                                    TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

 KNOTEN                        PFLICH    DATE       BESCHREIBUNG
                               T         NTYP

 A_PARCEL                      N         XML        Angaben zu Versandart und Maßen

 A_PARCEL[type]                N         XML        Erforderliche Versandart (entsprechend der in
                                                    TB.One angelegten 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

7.27 TBCATALOG / ... / ARTICLEDATA / ARTICLE / A_TRADESTAT
Angaben zu Ursprungsland und IntraStat-Nummer (je nach Kanal erforderlich).

Seite 56                                                                                     TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

 KNOTEN                      PFLICHT       DATENTYP    BESCHREIBUNG

 A_TRADESTAT                 J             XML         Tradestat-Informationen

 A_ORG_COUNTRY[alph          N             CHAR(2)     ISO 3166-1 Alpha 2 Code
 a2]

 A_TRADESTAT_NR              J             INT(8)      Intrastat Nummer 8-stellig für die Ausfuhr aus
                                                       der EU (Innergemeinschaftliche
                                                       Handelsstatistik)

BEISPIEL-XML

           94036090

Seite 57                                                                                 TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

8. BEISPIELE (KEY-BASED)

8.1 PRODUKT OHNE VARIANTEN, MEHRSPRACHIG
 
                         87

                                1

                                1

                                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-

Seite 58                                                                                            TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

                           hold" is a very flexible all-rounder for the whole year, which will
                           inspire you.

                           Kapuzenjacke

                           hoodie jacket

                           Anorak

                           Anorak

                           Funktionskleidung

                           functional clothing

                           110cm

                           110cm

                           blau

                           blue

Seite 59                                                                                   TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

                                    atmungsaktiv

                                    breathable

                                    wasserdicht

                                    waterproof

                                    winddicht

                                    windproof

                            http://foo.server/231.jpg

                            http://foo.server/232.jpg

                            Herren|Jacken|
 Freizeit

                            Herren|Jacken|
 Outdoor

Seite 60                                                                                     TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

                 75611

                 75595

                           3810

                           1

                           4250372205442

                           56894

                           381059

                                           V-Ausschnitt

                                           V-neck

                                 29.95

                                           87.99

                                           109.95

                                           120.00

                                           2

                                           59.90

Seite 61                                                                           TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

                                                           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

Seite 62                                                                                      TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

8.2 PRODUKT MIT VARIANTEN, EINSPRACHIG
 
                         87

                                1

                                1

                                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.

Seite 63                                                                                           TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

                           Kapuzenjacke

                           Anorak

                           Funktionskleidung

                           110cm

                           atmungsaktiv

                           wasserdicht

Seite 64                                                                           TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

                                     winddicht

                            http://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

                                     4250372205442

                                     56894

                                     381059

Seite 65                                                                                       TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

                           blau

                           S

                           V-Ausschnitt

                 29.95

                           87.99

                           109.95

                           120.00

                           2

                           59.90

                           97.99

                           109.95

Seite 66                                                           TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

                                                           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

Seite 67                                                                                   TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

           1

           4250372205452

           56894

           381060

                           blau

                           M

                           V-Ausschnitt

                 29.95

                           87.99

                           109.95

                           120.00

                           2

Seite 68                                                           TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

                                                        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

Seite 69                                                                                TRADEBYTE.COM
3006DE4.8.0 // Stand 01 / 22

Seite 70                                   TRADEBYTE.COM
Sie können auch lesen