Fulfillment-Anbieter verbinden

Hinweis: Die fett gesetzten Bezeichnungen entsprechen der deutschen Oberfläche. Ist die App auf Englisch eingestellt, erscheinen sie auf Englisch.

Fulfillment-Anbieter, auch 3PLs genannt, nehmen Ihre Lieferungen entgegen und melden Sendungsverfolgung, Artikel und Bestände zurück. Sie fügen diese Konten unter Einstellungen → Verbindungen hinzu. Dort erscheinen sie im Bereich Fulfillment-Anbieter.

Das Verbinden eines Kontos löst nie einen Versand aus. Das geschieht pro Standort in Fulfillment → Einrichtung und nur für Abläufe, die Sie auf Aktiv stellen.

Anbieter	Was Sie eingeben	Anleitung
JTL FFN	Ihre eigene JTL-App, danach eine Anmeldung bei JTL	JTL mit dem Hub verbinden
Magware	API-URL, Owner-Code und API-Schlüssel	Magware
Mintsoft	API-Schlüssel	Mintsoft
Logisoft (Asendia)	Kundenreferenz und API-Token; optional SFTP-Ablage für Rechnungen	Logisoft (Asendia)

Vorbereitung

• Halten Sie die Zugangsdaten des Anbieters bereit. Fordern Sie diese bei Bedarf beim Anbieter an.
• Geben Sie API-Schlüssel, Tokens und private Schlüssel nur im Formular des Hubs ein. Balta Labs speichert sie verschlüsselt und zeigt sie nie wieder an. Senden Sie sie niemals per E-Mail oder Chat.
• Sie benötigen im Workspace die Berechtigung Verbindungen.

Konto hinzufügen

1. Öffnen Sie Einstellungen → Verbindungen. Wählen Sie im Bereich Fulfillment-Anbieter die Schaltfläche Anbieter hinzufügen. Add account oben auf der Seite listet dieselben Anbieter.
2. Wählen Sie den Anbieter.
3. Geben Sie optional unter Verbindungsname einen Namen ein und füllen Sie dann die unten beschriebenen Felder aus.
4. Wählen Sie Konto speichern.
5. Wählen Sie Testen auf der Kontokarte. Korrigieren Sie die Werte, bis die Karte Funktioniert zeigt.
6. Wählen Sie Details, um Konto, Was der Hub kann und die Referenzlisten zu sehen, aus denen Sie beim Einrichten der Standorte wählen.

Um ein Konto später zu ändern, wählen Sie Bearbeiten auf seiner Karte. Lassen Sie ein Geheimnisfeld leer, um den gespeicherten Wert zu behalten. Wenn Sie Zugangsdaten oder Adressen ändern, wird der Zustand bis zum nächsten Test auf Nicht geprüft zurückgesetzt.

Magware

• API-URL: die Adresse der Magware-API, wie von Ihrem Lager angegeben, zum Beispiel https://wms.example.com/api/. Sie muss eine öffentliche Adresse ohne Benutzernamen, Abfrageparameter oder #-Teile sein. http:// funktioniert, wenn Ihr Magware-Server nichts anderes anbietet, verwenden Sie aber vorzugsweise https://.
• Owner-Code: Ihr Kundencode in Magware.
• API-Schlüssel: der Schlüssel für diesen Owner-Code.

Testen liest die Bestandsliste und ändert nichts in Magware. Antwortet die Adresse nicht wie die Magware-API, meldet der Test dies. Magware-Standorte benötigen keine Anbietereinstellungen.

Magware liefert jede Sendungsaktualisierung nur einmal. Der Hub liest diesen Feed nur bei aktivem Tracking; im Shadow-Modus wird er nicht abgefragt.

Mintsoft

• API-Schlüssel: der Mintsoft-API-Schlüssel Ihres Kundenkontos.

Testen listet die Lager und Versanddienste auf, die für den Schlüssel sichtbar sind, und Details zeigt sie mit ihren IDs. Geben Sie beim Hinzufügen des Standorts die Mintsoft-Lager-ID, die Kurierdienst-ID und die Prime-Kurierdienst-ID ein, die für Amazon-Prime-Bestellungen verwendet wird.

Logisoft (Asendia)

• Kundenreferenz: Ihre Kundennummer bei Logisoft.
• API-Token: Ihr Logisoft-API-Token.
• Erweiterte Einstellungen (optional): WSDL-URL des Core-Dienstes (Standard: https://soap.myasendia.it/LogisticService.svc?wsdl), WSDL-URL des Logistikdienstes (Standard: https://soap.myasendia.it/Service.svc?wsdl) und Timeout (Sekunden) (Standard: 120). Ändern Sie diese nur, wenn Logisoft Ihnen andere Dienstadressen genannt hat oder ein längeres Timeout verlangt. WSDL-URLs müssen https:// verwenden, und das Timeout kann 10 bis 300 Sekunden betragen.

Um Rechnungen hochzuladen, füllen Sie zusätzlich die SFTP-Ablage (optional) aus: SFTP-Host (nur der Hostname, ohne sftp://), SFTP-Port (standardmäßig 22), SFTP-Benutzername und Privater SFTP-Schlüssel (der vollständige Schlüssel einschließlich der BEGIN- und END-Zeilen, im Format OpenSSH, PEM oder PuTTY). Die SFTP-Ablage benötigt Host, Benutzername und privaten Schlüssel oder keine dieser Angaben.

Testen prüft das Token, listet Ihre Shops auf und stellt eine Verbindung zum Logistikdienst her. Mit der SFTP-Ablage meldet sich der Test zusätzlich an und prüft den Rechnungsordner. Beim ersten erfolgreichen Test fixiert der Hub den Schlüssel des SFTP-Servers. Die Karte zeigt dann SFTP-Hostschlüssel fixiert, und der Hub kommuniziert nur mit einem Server mit diesem Schlüssel. Wenn Sie den Host ändern, fixiert der nächste erfolgreiche Test den Schlüssel des neuen Servers. Meldet ein späterer Test einen anderen Schlüssel für denselben Host, lassen Sie sich von Asendia bestätigen, dass die Änderung erwartet ist, und wenden Sie sich dann an den Support.

Beim Hinzufügen des Standorts sind Versanddienstleister-Code und Shop-Code mit ASENDIA_IT und CUSTOM vorbelegt.

Was der Zustand bedeutet

Zustand	Bedeutung	Vorgehen
Funktioniert	Der letzte Test oder die letzte Anfrage an den Anbieter war erfolgreich.	Nichts.
Prüfung fehlgeschlagen	Der letzte Test oder die letzte Anfrage ist fehlgeschlagen. Die Karte zeigt die Meldung des Anbieters.	Beheben Sie die Ursache, etwa eine Adresse, das Netzwerk oder eine Einstellung, und wählen Sie dann Testen.
Neu verbinden nötig	Der Anbieter hat die Zugangsdaten oder die Autorisierung abgelehnt.	Wählen Sie Bearbeiten und geben Sie neue Zugangsdaten ein, oder verbinden Sie ein JTL-Konto mit Neu verbinden neu. Wählen Sie dann Testen.
Nicht geprüft	Das Konto ist neu, oder seine Zugangsdaten oder Adressen wurden geändert.	Wählen Sie Testen.

Die Karte zeigt auch, wann das Konto zuletzt geprüft wurde. Der Zustand ändert sich, wenn Sie Testen wählen und wenn der Hub mit dem Konto arbeitet. Er beschreibt das Konto, nicht einzelne Lieferungen: Diese prüfen Sie unter Fulfillment → Betrieb.

Lagerabläufe aktivieren

Fügen Sie unter Fulfillment → Setup ein Quellkonto und einen Standort hinzu, der dessen Lager mit einem Anbieter verbindet. Zeitpläne und manuelle Jobs finden Sie unter Sync. Bestellregeln und den Automatisierungsmodus des Kontos verwalten Sie unter Automatisierungen.

Prüfen Sie Entscheidungen im Modus Shadow und schalten Sie benötigte Abläufe dann auf Active. Wechsel zu oder von Active erfordern eine Bestätigung und werden protokolliert. Ergebnisse finden Sie unter Operations, Bestandsabweichungen und Artikelzuordnungen unter Inventory. Zum Pausieren wählen Sie Off oder Shadow und prüfen laufende Vorgänge unter Operations.

Für mehrere Standorte markieren Sie die Zeilen, wählen Workflow und Modus und dann Änderungen prüfen. Das Ergebnis nennt Standorte, deren Änderung fehlgeschlagen ist. Jedes Quellkonto hat eigene Regeln, gespeicherte Entwürfe und eine eigene Aktivierungshistorie.