Hermes-Shipping-Interface (HSI) einrichten
Mit der von Hermes bereitgestellten Auftragsschnittstelle Hermes-Shipping-Interface (HSI) kannst du deine Bestellung ganz einfach durch eine Anbindung an deinen Billbee-Account versenden. Wie du die Hermes-Shipping-Interface (HSI) Schnittstelle an deinen Billbee-Account anbinden kannst, erfährst du in diesem Artikel.
In diesem Artikel
Schritt-für-Schritt Anleitung zur Einrichtung
Voraussetzungen
Um die Hermes HSI zu nutzen, benötigst du einen Geschäftskundenvertrag von Hermes, da du zur Anbindung die Zugangsdaten benötigst.
Anbindung
Um eine neue Versandanbindung bei Billbee einzurichten, klicke unter Einstellungen / Versandwege auf die Kachel "Versandweg hinzufügen".
Jetzt öffnet sich ein Pop-Up Fenster, in welchem du auf die Kachel "Hermes Shipping Interface" klickst. Anschließend wirst du direkt zu Hermes weitergeleitet, wo du deine Hermes Zugangsdaten eingeben musst.
Nach der Eingabe von deinem Benutzernamen und Passwort wirst du wieder zurück zu Billbee geleitet. Im Reiter "Verbindung" musst du einen Namen für deine Versandanbindung hinterlegen.
Im Reiter "Allgemein" kannst du alle weiteren Einstellungen vornehmen, wie bspw. deine Absenderadresse. Hier ist es wichtig, dass auf jeden Fall das Feld "Vorname" gefüllt ist, da dies von Hermes gefordert ist.
- 1
- Tracking URL: Die Tracking URL wird automatisch hinterlegt, wenn du die Anbindung vornimmst.
- 2
- Standardgewicht: Hinterlege hier ein Gewicht in Gramm, wenn du für die Versendung über diese Anbindung ein Standardgewicht nutzen möchtest.
- 3
- Verpackungsgewicht: Hinterlege hier ein Verpackungsgewicht in Gramm, wenn du für die Versendung über diese Anbindung ein Standardgewicht für deine Verpackungen nutzen möchtest.
- 4
- Ausgabe der Etiketten: Hast du einen externen Cloudspeicher an Billbee angebunden, kannst du diesen hier hinterlegen. Damit werden erstellte Versandlabel direkt im Cloudspeicher abgelegt.
- 5
- Ausgabe der Exportdokumente: Hast du einen externen Cloudspeicher an Billbee angebunden, kannst du diesen hier hinterlegen. Damit werden erstellte Exportdokumente direkt im Cloudspeicher abgelegt.
- 6
- Ausgabe der Retourenlabels: Hast du einen externen Cloudspeicher an Billbee angebunden, kannst du diesen hier hinterlegen. Damit werden erstellte Retourenlabels direkt im Cloudspeicher abgelegt.
- 7
- Referenz: Du kannst hier eine Information oder einen gewünschten Platzhalter eintragen. Diese Referenz wird dann auf deinen Versandlabels ausgegeben. Alle möglichen Platzhalter von Billbee findest du in unserem Hilfeartikel " Platzhalter ".
- 8
- Absenderadresse: Trage in den Adressdaten deine Absenderadresse ein. Alternativ kannst du auch einfach oben auf den Button "Adresse aus Benutzerkonto" übernehmen klicken, dann wird automatisch die Adresse deines Billbee Nutzerkonto eingefügt. Wichtig hierbei ist, dass das Feld "Vorname" gefüllt ist.
Hast du alle Informationen eingegeben, dann klicke unten auf den Button "Speichern". Ist die Konfiguration erfolgreich, erhältst du eine Benachrichtigung darüber und der Reiter "Produkte" wird aktiviert. Jetzt kannst du dort deine Versandprodukte anlegen. Das geht am einfachsten, wenn du im Reiter "Produkte" auf den Button "Produkte abrufen" klickst, denn so werden die von Hermes angebotenen Versandprodukte automatisch abgerufen und deiner Versandanbindung hinzugefügt. Über den Button "Hinzufügen" kannst du auch manuell über ein Dropdown-Menü ein Versandprodukt anlegen. Der Anzeigename kann dabei frei vergeben werden.
Retoure
Mit einer Anbindung an Hermes hast du in Billbee die Möglichkeit, Retourenlabels zu erstellen. Hierbei sind folgende Versandprodukte möglich:
- Retoure XS
- Retoure S
- Retoure M
- Retoure L
- Retoure XL
Als Zusatzleistung kannst du zu dem jeweiligen Versandprodukt den Service "FlexRetoure" auswählen.
Wichtig: Aktuell ermöglicht Hermes ausschließlich Großkunden die Erstellung von Retourenlabels über die API. Self-Service Kunden können keine Retourenlabels in Billbee erstellen.
Wichtig / zu beachten
Best Practice Tipp: Möchtest du verschiedene Absenderadressen nutzen, dann kannst du die Versandanbindung einfach ein zweites Mal anlegen und dort die abweichende Absenderadresse hinterlegen.
Labels erneut herunterladen
Wie und wo genau du Versandlabel erneut herunterladen oder speichern kannst, erklären wir Hier.
Mögliche Fehlercodes & ihre Bedeutung
| Fehlercode/-meldung | mögliche Bedeutung | Lösung |
| Invalid refresh token |
Durch eine Änderung bei Hermes kann es zu dieser Fehlermeldung kommen | Verbinde die Schnittstelle neu, indem du die alte Schnittstelle löschst und die Anbindung erneut vornimmst. |
| Die Eigenschaften [clientReference] entsprechen nicht den Anforderungen | Der übermittelte Wert im Feld "Referenz" ist zu lang | Der übermittelte Wert im Feld "Referenz" darf maximal 15 Zeichen lang sein. |