Tradebyte

Mit der Tradebyte-Schnittstelle werden Shopartikel an Tradebyte übergeben, dort auf angebundene Kanäle verteilt und Bestellungen aus Tradebyte in den Shop importiert.

Inhaltsverzeichnis

Grundprinzip

Der Datenaustausch läuft über XML-Reports und einen Dateiübertragungszugang. Der Shop erzeugt offene Reports für Produktdaten, Preisänderungen, Bestände und Bestellmeldungen. Beim Upload werden diese Reports an Tradebyte übertragen und anschließend lokal erledigt.

Beim Download liest der Shop Bestelldateien aus Tradebyte ein, archiviert verarbeitete Dateien in Tradebyte und entfernt die lokalen Arbeitsdateien nach der Verarbeitung.

Diese Seite beschreibt die klassische Tradebyte-Anbindung. Der separate Bereich Tradebyte Custom-Kanal wird eigenständig gepflegt und hat andere Import- und API-Funktionen.

Voraussetzungen

  • App aktiv: Ist die Tradebyte-App nicht aktiv, zeigt das Backend eine Fehlermeldung und die Seite kann nicht genutzt werden.
  • Berechtigung: Der Backend-Benutzer benötigt das Recht für den Marktbereich Tradebyte.
  • Zugangsdaten: Für den Dateiaustausch müssen Host, Benutzer, Passwort und Übertragungsart gepflegt sein.
  • Artikelmarkierung: Produkt-, Bestands- und Preisreports werden nur sinnvoll erzeugt, wenn Artikel für Tradebyte gekennzeichnet und gepflegt sind.

Einstellungen

Das Formular speichert die Konfiguration für den Tradebyte-Dateiaustausch, den Bestellimport und die Produktdaten-Ausgabe.

  • ftp_art / FTP Typ: Auswahl zwischen SFTP und FTP. Bei SFTP wird direkt im Tradebyte-Verzeichnis gearbeitet; bei FTP nutzt das Backend zusätzlich lokale Arbeitsdateien für den Upload.
  • ftp_host, ftp_user, ftp_passwort: Zugangsdaten für den Tradebyte-Dateiserver.
  • bestands_synchro: Aktiviert die automatische Bestandsübermittlung für Tradebyte-Artikel.
  • create_bill: Erstellt bei importierten, bezahlten Bestellungen automatisch eine Rechnung, markiert sie als bezahlt und erzeugt die Rechnungsdatei.
  • channel_ids: Kommagetrennte Tradebyte-Kanalkürzel für die Kanalzuordnung.
  • orderstatus_payed: Bestellstatus, den bezahlte importierte Bestellungen erhalten.
  • payment_modul: Zahlungsmodul, das importierten Tradebyte-Bestellungen zugewiesen wird.
  • namefeld: Datenquelle für den Artikeltitel, wahlweise Produktbezeichnung, Produktbezeichnung 2 oder ein Freitextfeld.
  • beschreibungsfeld: Datenquelle für die Artikelbeschreibung, wahlweise Beschreibung, Beschreibung 2 oder ein Freitextfeld.
  • wert_ursprungsland: Optionales Merkmal, dessen Wert als Ursprungsland übertragen wird.
  • wert_zolltarif: Optionales Merkmal, dessen Wert als Zolltarifnummer übertragen wird.
  • preise_create: Wenn aktiv, werden Preise nur beim Erstellen von Produkten übertragen; separate Preisupdates werden dann nicht erzeugt.
  • depot_ids: Mehrfachauswahl für Lager, aus denen der zu übertragende Bestand berechnet wird.
  • channel_custgroup: Ordnet Kanälen Kundengruppen zu. Das erwartete Format ist CHANNELID:KUNDENGRUPPENID; mehrere Werte werden per Leerzeichen getrennt.
  • channel_aktivation: Aktiviert Artikel kanalübergreifend, wenn am Produkt keine spezifischen Kanäle ausgewählt wurden.
  • auto_upload und auto_download: Steuern die automatischen Hintergrundläufe für Upload und Download.

Speichern und Automatik

Beim Speichern werden nicht gesetzte Checkboxen explizit als deaktiviert gespeichert. Die Lagerauswahl wird als Liste gesichert. Wenn sich die Automatikoptionen ändern, legt das Backend die zugehörigen Hintergrundläufe neu an oder entfernt sie.

  • Automatischer Upload: Steuert den regelmäßigen Upload offener Produkt-, Preis-, Bestands- und Nachrichtenreports.
  • Automatischer Download: Steuert den regelmäßigen Download und Import von Bestelldateien.
  • Erfolgsmeldung: Nach dem Speichern wird eine allgemeine Bestätigung angezeigt.

Produkt-, Preis- und Bestandsreports

Für neue oder aktualisierte Tradebyte-Artikel erzeugt der Shop Produktreports. Bestandsreports entstehen für Artikel, die als Tradebyte-Artikel markiert sind. Preisreports werden nur erzeugt, wenn die Einstellung preise_create separate Preisupdates nicht unterdrückt.

  • Produktdaten: Enthalten Artikelinformationen, den gewählten Titel, die gewählte Beschreibung und die kanalrelevanten Produktdaten.
  • Bestände: Werden optional auf ausgewählte Lager eingeschränkt.
  • Preise: Können separat aktualisiert oder nur bei Produkterstellung übertragen werden.
  • Bestellmeldungen: Versand- oder Stornomeldungen können als Messages an Tradebyte zurückgegeben werden.

Manueller Upload und Download

  • Manueller Upload: Überträgt offene Reports an Tradebyte. Dateien werden zuerst temporär hochgeladen und danach in XML-Dateien umbenannt.
  • Manueller Download: Holt Bestelldateien aus Tradebyte ab, archiviert sie dort und importiert die Bestellungen in den Shop.
  • Modulstatus: Sind die Voraussetzungen nicht erfüllt, sind die manuellen Aktionen nicht sinnvoll nutzbar beziehungsweise deaktiviert.

Bestellimport

Beim Import wird eine Tradebyte-Bestellung anhand der externen Tradebyte-Bestellnummer erkannt, damit sie nicht doppelt angelegt wird. Der Shop übernimmt Kundendaten, Rechnungs- und Lieferadresse, Positionen, Versanddaten, Zahlungsdaten, Kanalnummer und externe Bestellnummer.

Falls Länderangaben oder Artikelzuordnungen nicht erkannt werden, erzeugt das Backend eine Benachrichtigung zum Bestellimport. Externe PDF-Rechnungen aus dem Tradebyte-Abruf können als externes Dokument am Lieferschein gespeichert werden.

War diese Seite hilfreich?

Hilf uns, das Handbuch weiter zu verbessern. Wenn etwas fehlt oder unverständlich ist, kannst Du direkt einen kurzen Kommentar senden.