Tradebyte Custom-Kanal

Der Tradebyte Custom-Kanal verbindet den Shop als eigenen Vertriebskanal mit Tradebyte. Die Seite bündelt Zugangsdaten, Aktivierung, Produktabgleich, Bestands- und Preisabrufe sowie die Bestell- und Meldungsübertragung.

Inhaltsverzeichnis

Voraussetzungen und Grundlogik

Der Bereich arbeitet nur sinnvoll, wenn das Tradebyte-Modul aktiv ist und die Tradebyte-Zugangsdaten vollständig hinterlegt sind. Die Bedienseite ist für Benutzer mit Tradebyte-Rechten gedacht. Fehlt das aktive Modul, blendet die Oberfläche statt der manuellen Abrufe einen Hinweis zur Aktivierung ein.

  • Custom-Kanal statt Standard-Marktplatz: Der Shop wird als Kanal an ein bestehendes Tradebyte-Konto angebunden. Produkte kommen aus Tradebyte in den Shop, Bestellungen gehen aus dem Shop zurück an Tradebyte.
  • Konfiguration vor Aktion: Die Zugangsdaten und Kanalwerte werden für alle Abrufe und Übertragungen verwendet. Fehlerhafte Werte wirken sich deshalb auf Produktimport, Bestand, Preis, Bestellübertragung und Meldungsabruf aus.
  • Aktivstatus beachten: Die Option 0_status steuert vor allem automatische Läufe und die Bestellübertragung. Manuelle Abrufe sind zusätzlich davon abhängig, dass das Tradebyte-Modul aktiv ist.
Die Seite enthält keine Datentabelle und keine Filteransicht. Die wichtigen Bedienelemente sind das Einstellungsformular und die manuellen Aktionsschaltflächen.

Einstellungsformular

Das Formular speichert alle Werte im Konfigurationsbereich tradebytecc. Beim Speichern werden nicht angehakte Kontrollkästchen automatisch auf inaktiv gesetzt; die Kundengruppenauswahl wird als Auswahlmenge gespeichert.

Zugang und Kanal

  • 4_haendler_id Händlernummer: Identifiziert den Händler gegenüber Tradebyte und wird beim Aufbau der Verbindung mitgegeben.
  • 1_api_user API User: Benutzername für die Tradebyte-Anmeldung.
  • 2_api_password API Passwort: Passwort für die Tradebyte-Anmeldung. Ohne gültige Kombination schlagen Abrufe und Übertragungen fehl.
  • 3_kanal_id Kanal-ID: Ordnet die Verbindung dem Tradebyte-Kanal zu.
  • 6_kanal_zeichen Kanal-Zeichen: Wird bei der Bestellübergabe in den Bestelldaten als Kanalzeichen ausgegeben.

Aktivierung und Automatik

  • 0_status Übertragung aktiv: Aktiviert die laufende Verarbeitung. Ist der Wert aus, beendet der automatische Lauf seine Arbeit und neue Bestellungen werden nicht an Tradebyte übertragen.
  • 11_cronjob autom. Übertragung aktivieren: Schaltet die regelmäßige Verarbeitung ein oder aus. Beim Ändern entfernt oder registriert das System den zugehörigen Cronjob neu.
  • last_full_update, last_stock_update, last_price_update: Technische Zeitmarker für den letzten Artikel-, Bestands- und Preisabruf. Diese Werte werden nicht direkt im Formular bearbeitet, steuern aber Delta-Abrufe und die angezeigten Zeitpunkte bei den Aktionsschaltflächen.

Artikel- und Bestelllogik

  • 5_add_firmname_artikel Herstellername vor den Artikelnamen anfügen: Beeinflusst die Artikelanlage aus Tradebyte, indem Herstellerinformationen beim Artikelnamen berücksichtigt werden können.
  • 7_status_bezahlt Bestellstatus bezahlt: Zielstatus für Tradebyte-Meldungen vom Typ bezahlt. Ist kein Status gewählt, ändert eine bezahlte Meldung den Bestellstatus nicht.
  • 8_custgroup_ids Kundengruppen: Mehrfachauswahl der Kundengruppen, deren Bestellungen an Tradebyte übertragen werden dürfen. Bestellungen aus nicht ausgewählten Kundengruppen bleiben unberührt.

Manuelle Abrufe

Die Aktionsschaltflächen starten direkte Abrufe gegen Tradebyte. Nach Produkt- oder Änderungsabrufen zeigt die Seite Zähler für neu angelegte Artikel, aktualisierte Artikel oder aktualisierte Datensätze an.

  • Vollimport der Artikel: Lädt alle Produktdaten aus Tradebyte. Produkte mit Löschkennzeichen werden übersprungen, alle anderen Datensätze werden als Artikel angelegt oder aktualisiert. Der Zeitmarker für den letzten Vollabruf wird erneuert.
  • Vollimport der Artikel seit letztem Abruf: Nutzt den gespeicherten Zeitmarker des letzten Artikelabrufs als Delta. Dadurch werden nur seitdem geänderte Produktdaten angefordert.
  • Bestandsänderungen laden: Ruft Bestandsdaten ab und aktualisiert die betroffenen Variantenbestände anhand der Artikelnummer.
  • Preisänderungen laden: Ruft Preisdaten ab und aktualisiert die betroffenen Variantenpreise anhand der Artikelnummer.
  • Bestellmeldungen laden: Holt Meldungen aus Tradebyte und verarbeitet sie an den passenden Shopbestellungen. Erfolgreich verarbeitete Meldungen werden anschließend bei Tradebyte als verarbeitet markiert.
Manuelle Abrufe wirken direkt auf Produkt-, Bestands-, Preis- oder Bestelldaten. Vor einem Vollimport sollten Zugangsdaten, Kanalwerte und Kundengruppenlogik geprüft sein, damit Daten nicht mit falscher Kanalzuordnung verarbeitet werden.

Automatischer Lauf

Ist die automatische Übertragung aktiv, registriert sich der Lauf regelmäßig erneut und arbeitet die nächsten sinnvollen Aufgaben ab. Der Aktivstatus 0_status ist dabei die zentrale Sperre: Ist er deaktiviert, beendet der Lauf die Verarbeitung sofort.

  1. Der Lauf prüft zuerst, ob ein Bestandsabruf fällig ist. Ein vorhandener Bestandszeitmarker muss dafür älter als fünf Minuten sein.
  2. Ist kein Bestandsabruf fällig, prüft der Lauf nach derselben Logik die Preisänderungen.
  3. Wenn weder Bestand noch Preis fällig sind, werden Bestellmeldungen von Tradebyte geladen.

Der automatische Lauf nutzt also keine lange Sammelverarbeitung, sondern arbeitet pro Durchlauf gezielt eine Aufgabe ab. Dadurch werden Bestände, Preise und Bestellmeldungen nacheinander nachgezogen.

Produkt-, Bestands- und Preisverarbeitung

  • Produkte: Produktdaten initialisieren oder aktualisieren Artikel, Hersteller, Suchbegriffe, Merkmale, Kategorien und Varianten. Danach werden Artikel gespeichert, Permalinks erzeugt und Verfügbarkeiten aktualisiert.
  • Bestände: Bestandssätze werden über die Artikelnummer einer Variante zugeordnet. Nur gefundene Artikel mit Variante werden aktualisiert.
  • Preise: Preissätze werden ebenfalls über die Artikelnummer einer Variante zugeordnet. Nach der Preisübernahme wird die Variante gespeichert.
  • Fehlerfälle: Schlägt ein Abruf fehl, liefert die Verbindung einen Fehlercode und eine Meldung. Die Aktion wird dann nicht stillschweigend als Erfolg behandelt.

Bestellübertragung an Tradebyte

Neue Bestellungen werden nur übertragen, wenn das Tradebyte-Modul aktiv ist, 0_status eingeschaltet ist und die Kundengruppe der Bestellung in 8_custgroup_ids enthalten ist. Zusätzlich werden nur Bestellungen aus Backend- oder Frontend-Erfassung berücksichtigt.

  • Übertragene Daten: Die Übergabe enthält Bestelldatum, Kanalzeichen, Shop-Bestellnummer, Rechnungs- und Lieferadresse, Versand-, Zahlungs- und Positionsdaten.
  • Erfolgreiche Übergabe: Die von Tradebyte zurückgegebene Kennung wird als externe Bestellnummer gespeichert und eine Bestellhistorie zur erfolgreichen Übertragung angelegt.
  • Fehlgeschlagene Übergabe: Die Bestellung bleibt im Shop bestehen und erhält einen Historieneintrag mit der Tradebyte-Fehlermeldung.

Bestellmeldungen aus Tradebyte

Der Meldungsabruf verarbeitet Tradebyte-Rückmeldungen an vorhandenen Shopbestellungen. Die Zuordnung erfolgt über die übermittelte Shop-Bestell-ID.

  • Storno- und Kundenstorno-Meldungen: Stornieren die betroffene Bestellposition.
  • Versandmeldung: Übergibt Versanddienst und Trackingnummer an die Versandverarbeitung und markiert die betroffene Position als versendet.
  • Bezahltmeldung: Setzt den in 7_status_bezahlt hinterlegten Bestellstatus, sofern ein Status gewählt ist.
  • Retourenmeldung: Wird erkannt, enthält in der geprüften Logik aber keine sichtbare Folgeaktion.
  • Unbekannte Meldungen: Werden nicht verarbeitet und zählen nicht als erfolgreiche Meldung.

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.