Sie möchten einen Fulfillment-Dienstleister in reybex anbinden z.B. Zen. Dann müssen Sie die Authentifizierungsdaten in reybex hinterlegen, damit die Schnittstelle zwischen den beiden Systemen hergestellt werden kann und somit eine Datenübertragung möglich ist.

Aktuell unterstütze Fulfillment Anbindungen:

• Zen
• Hive
• Channel Dock
• Mh Direkt
• Fiege

Um eine Fulfillment Anbindung in Reybex vorzunehmen, gehen Sie bitte wie folgt vor:

• Öffnen Sie die Transaktion der Prüftabellen [BAS01]
• Wechseln Sie in den Bereich Artikel
• Klicken Sie auf die Schaltfläche Fulfillment
• Klicken Sie auf den Button + Hinzufügen um einen neuen Eintrag zu erstellen bzw. auf den Button mit dem Stift vor einen bereits bestehenden Datensatz, um den entsprechenden Eintrag anzupassen.
• Füllen Sie die entsprechenden Felder aus.
  • Bezeichnung: Name des Fulfillmentdienstleisters
  • unterstützte Schnittstelle: z.B. Zen
  • API-Schlüssel
  • Geheimschlüssel = Passwort, falls von der Schnittstelle erforderlich 
  • Endpunkt-URL = Endpoint-Adresse
  • Benutzername, falls von der Schnittstelle erforderlich
  • Passwort, falls von der Schnittstelle erforderlich
  • Max. Anzahl an Übertragungen
  • Übertragungsintervall = Abstand zwischen 2 Übertragungen in Minuten
• Aktivieren bzw. deaktivieren Sie die entsprechenden Checkboxen
  • Aktiv – Mit Aktivierung der Checkbox, wird die Schnittstelle aktiv gesetzt
    
  • Standard – Mit Aktivierung der Checkbox, wird die Schnittstelle als Standard-Schnittstelle gekennzeichnet. Dadurch wird festgelegt, welcher Fulfillment-Anbieter als Standard verwendet wird, wenn mehrere Verbindungen vorhanden sind. In der Praxis wird die Zuordnung von Aufträgen hauptsächlich über die Lager- bzw. Positionszuordnung bestimmt. Dient lediglich als Fallback für die allgemeine Auswahl.
    
  • Auftrags-Export via Job – Mit Aktivierung der Checkbox, wir die Übertragung der Aufträge automatisch via Job vollzogen. Aktiviert oder deaktiviert lediglich den automatischen Auftragsexport über einen Hintergrundjob. Das Intervall selbst wird dadurch nicht konfiguriert.
    Der Auftragsexport läuft nach einem fest definierten Cron-Intervall:
    – Alle 15 Minuten (FulfillmentSendOrdersJob, Cron: 0 4/15 * * * ?) Dieses Intervall kann in der Fulfillment-Oberfläche nicht angepasst werden. Auch die weiteren Jobs verwenden feste Zeitpläne:

• Retouren pro Auftrag abrufen– Verarbeitete Retouren automatisch vom Fulfillment-Dienstleister abrufen und in reybex importieren.
  
• Aufrufen von Versandantworten pro Auftrag
  
• Lagerbestände automatisch korrigieren – aktiviert den automatischen Import der Lagerbestände vom Fulfillment-Dienstleister und gleicht anschließend die Bestände in Reybex ab.
  
• Chargenanzahlabweichung ignorieren – Versandrückmeldungen auch dann akzeptieren, wenn die Anzahl der Chargen nicht mit der Positionsmenge übereinstimmt.
  
• Verfügbaren Bestand lesen – Beim automatischen Lagerimport den verfügbaren Gesamtbestand ohne Chargeninformationen verwenden.
  – Aktiviert: Es wird ausschließlich der verfügbare Gesamtbestand ohne Chargeninformationen übernommen (z. B. bei Zen das Feld quantity_on_stock).
  – Deaktiviert: Falls der Fulfillment-Anbieter dies unterstützt, werden Lagerbestände inklusive Chargeninformationen importiert (z. B. separater Export mit Chargennummern bei Zen).
  
• Grüner + Button: können Sie die Lager Ihres Fulfillment-Dienstleisters den entsprechenden Lagern in reybex zuordnen. Wofür wird die Lagerzuordnung benötigt?
  – Viele Fulfillment-Dienstleister verwenden eigene Lagerbezeichnungen oder Lagercodes. Damit reybex Lagerbestände und Bewegungen korrekt dem richtigen Lager zuordnen kann, muss eine Zuordnung zwischen den externen Lagern und den reybex-Lagern eingerichtet werden. So funktioniert die Zuordnung
  – Für jedes Lager des Fulfillment-Dienstleisters hinterlegen Sie das entsprechende reybex-Lager sowie den externen Lagercode des Fulfillment-Anbieters.
  – Während eines Lagerimports gleicht reybex den vom Fulfillment-Dienstleister übermittelten Lagercode mit dieser Zuordnung ab und bucht die Bestände automatisch in das zugehörige reybex-Lager.
  – Ist keine explizite Zuordnung vorhanden, versucht reybex als Fallback, das Lager anhand des Lagercodes automatisch zu erkennen.
  – Hinweis: Eine korrekt eingerichtete Lagerzuordnung stellt sicher, dass Lagerbestände und Lagerbewegungen dem richtigen Lager in reybex zugeordnet werden. Insbesondere bei Fulfillment-Dienstleistern mit mehreren Lagern wird empfohlen, für jedes externe Lager eine eindeutige Zuordnung anzulegen.
  
• Wenn diese Konfigurationen im Hintergrund aktiviert sind, laufen unsere automatischen Jobs wie vorgesehen. Nach Abschluss der Anbindung stehen zudem entsprechende Schaltflächen zur Verfügung, über die die Daten eingelesen werden können.
• Klicken Sie abschließend auf speichern.

Hinweise zu Zen:

• Für Zen können keine Bestell-Updates, keine automatische Bestandskorrektur und keine Rückmeldungen zu Retouren abgerufen werden.
  Stattdessen sendet Zen diese Informationen über einen reybexApi-Call an uns. Dieser Call ist in der reybex.api zu finden.

Automatische Datenübertragung zwischen reybex und dem Fulfillment-Dienstleister

Das Ausfüllen der Verbindungsdaten (z. B. API-Endpunkt, API-Key oder Secret) bedeutet nicht, dass reybex automatisch alle Daten mit dem Fulfillment-Dienstleister austauscht.

Grundsätzlich gibt es zwei Arten der Kommunikation:

1. Daten von reybex zum Fulfillment-Dienstleister

Die hinterlegten Zugangsdaten werden benötigt, damit reybex:

• Aufträge an den Fulfillment-Dienstleister senden kann,
• Produktdaten übertragen kann,
• die Verbindung testen kann.

Wenn die Checkbox „Auftrags-Export via Job“ aktiviert ist, werden neue Aufträge automatisch an den Fulfillment-Dienstleister übertragen.

2. Daten vom Fulfillment-Dienstleister zu reybex

Ob reybex Daten automatisch vom Fulfillment-Dienstleister abruft, wird über die entsprechenden Checkboxen gesteuert, beispielsweise für:

• Versand- und Auftragsrückmeldungen
• Retouren
• Lagerbestände

Einige Fulfillment-Dienstleister stellen diese Informationen jedoch nicht zum Abruf bereit, sondern senden sie selbstständig an die reybex-API (Push-Verfahren).

Wichtiger Hinweis

Auch wenn Ihr Fulfillment-Dienstleister Daten aktiv an reybex sendet (Push-Verfahren), müssen die Verbindungsdaten trotzdem vollständig hinterlegt werden. Sie werden weiterhin benötigt, damit reybex Aufträge und Produktdaten an den Fulfillment-Dienstleister übertragen kann.

In diesem Fall sollten lediglich die Checkboxen für den automatischen Abruf (z. B. Versandrückmeldungen, Retouren oder Lagerbestände) deaktiviert werden, da die Informationen bereits automatisch an reybex übermittelt werden.

Beispiel: Der Fulfillment-Dienstleister Zen sendet Versandrückmeldungen, Retouren und Lagerbestände aktiv an die reybex-API. Daher bleiben die Verbindungsdaten eingerichtet, während die entsprechenden Checkboxen für den automatischen Abruf deaktiviert werden. Der automatische Auftrags-Export kann weiterhin aktiviert bleiben.

Hinweis zur Marktplatz-Synchronisation nach Lagerimporten

Nach jedem Lagerimport sowie nach jeder Lagerkorrektur stößt reybex automatisch die Verarbeitung zur Marktplatz-Synchronisation an. Hierbei werden Einträge in der Marketplace-Transfer-Warteschlange erzeugt. Berücksichtigt werden dabei ausschließlich Artikel, die:

• auf einem aktiven Marktplatz vorhanden sind und
• auf diesem Marktplatz aktiv geschaltet sind.

Die erzeugten Warteschlangeneinträge dienen anschließend als Grundlage für die weitere Verarbeitung und Synchronisation über OMP02.

Wichtig: Die Erstellung dieser Warteschlangeneinträge erfolgt automatisch und unabhängig von zusätzlichen Einstellungen im Fulfillment-Bereich.

Mögliche Ursachen für Probleme bei Order Updates

In manchen Fällen ist es nicht möglich, Order-Updates abzurufen. Dafür gibt es mehrere Ursachen:

1. Versandkonfiguration
Wenn reybex ein Order-Update erhält, wird anhand der in den Prüftabellen hinterlegten Versandregeln eine Versandkonfiguration ausgewählt.
Für diese ausgewählte Versandkonfiguration darf den Button “Erstelle Versand-Etikett” nicht aktiv sein, da der Versand in diesem Fall vom Fulfillment Center übernommen wird.

Ist der Button in der Versandkonfiguration aktiv, versucht Reybex ein Versandlabel über Versanddienstleister, wie z.B. DHL zu erstellen.
Wenn Sie keine entsprechende Konfiguration für Versanddienstleister wie DHL hinterlegt haben, kommt es zu einem Fehler und das Order-Update kann nicht verarbeitet werden. Ist eine solche Konfiguration vorhanden, entstehen Ihnen zusätzliche Versandkosten, obwohl der Versand bereits über das Fulfillment Center abgerechnet wurde.

2. Ursachen auf Seiten des Fulfillment Centers
Häufig liegen die Gründe auch beim Fulfillment Center, z. B. durch:

• nicht übereinstimmende Artikelnummern oder Positionsnummern eines Beleges
• fehlende oder unvollständige Pflichtdaten (z. B. Versanddienstleister- oder Trackinginformationen)

3. Auftragseinstellung „Teillieferung“
Wenn der Button “Teillieferung möglich“ aktiviert ist, kann das Fulfillment Center Order-Updates in mehreren Teilschritten senden. Ist diese Option im Auftrag nicht aktiviert, können die Updates nicht verarbeitet werden.

Datenübertragung an Fulfillment Center

Die Aufträge werden automatisch per Job an das Fulfillment Center übertragen.
Falls Sie die Übertragung manuell durchführen möchten, kann hierfür die Transaktion Liefervorschlag INV12 verwendet werden.

Für eine erfolgreiche Übertragung ist eine korrekte Lagerkonfiguration erforderlich, auch wenn die Übertragung über den automatischen Job erfolgt.
Ist im jeweiligen Lager nicht das entsprechende Fulfillment hinterlegt, tritt der Fehler „Fulfillment nicht gefunden“ auf. Außerdem werden Bestellungen positionsweise übertragen. Wenn in den einzelnen Positionen unterschiedliche Lager ausgewählt sind, können die Artikel entsprechend an verschiedene Fulfillment Center gesendet werden.

Zusätzlich müssen Artikelstammdaten an die Fulfillment Center übertragen werden. Die Übertragung muss manuell über den Artikelstamm BAS02 erfolgen und kann dort auch als Batch durchgeführt werden.

Auch Einkaufsbestellungen müssen manuell an die Fulfillment Center übertragen werden.
Die Übertragung ist ausschließlich über die Detailansicht der jeweiligen Einkaufsbestellung möglich; eine Batch-Übertragung wird hierfür nicht unterstützt.

Vorgehensweise bei Lagerbewegungen

Bestandskorrekturen werden von den Fulfillment Centern eingelesen und können dabei mehrere Lagerbewegungen auslösen. Wenn es Abweichungen zwischen den Beständen im Fulfillment Center und den in Reybex geführten Beständen gibt, sind mehrere Lagerbewegungen normal.

In diesem Fall wird zunächst eine gegenläufige Buchung auf den bestehenden Reybex-Bestand durchgeführt. Anschließend wird der vom Fulfillment Center gemeldete Bestand erneut eingebucht.