Hermes-Schnittstelle in Billbee einrichten (HSI)
· 4 Minuten Lesezeit

Billbee verbindet Hermes über das Hermes Shipping Interface (HSI), die Auftragsschnittstelle von Hermes. Du brauchst dafür einen Geschäftskundenvertrag bei Hermes. Die Einrichtung startest du in Billbee unter „Einstellungen → Versandwege“ mit der Kachel „Hermes Shipping Interface“. Billbee leitet dich zu Hermes weiter, du meldest dich dort mit deinen Hermes-Zugangsdaten an und landest wieder in Billbee. Ein Passwort oder einen API-Schlüssel trägst du in Billbee nicht ein.
Was brauchst du für die Hermes-Schnittstelle?
Einen Geschäftskundenzugang bei Hermes mit Benutzername und Passwort. Laut Hermes giltst du bei myHermes Business ab 300 Paketen im Jahr als Geschäftskunde, eine deutsche Rechnungs- und Abholadresse ist Voraussetzung.
Ein privates myHermes-Konto reicht nicht, Billbee setzt den Geschäftskundenvertrag voraus. Bist du unsicher, ob dein Konto dafür freigeschaltet ist, frag deinen Hermes-Ansprechpartner, bevor du in Billbee anfängst.
Wie richtest du Hermes in Billbee ein?
- In Billbee „Einstellungen → Versandwege“ öffnen und auf „Versandweg hinzufügen“ klicken.
- Im Pop-up die Kachel „Hermes Shipping Interface“ wählen. Billbee leitet dich zu Hermes weiter.
- Bei Hermes Benutzername und Passwort eingeben. Danach geht es zurück zu Billbee.
- Im Reiter „Verbindung“ einen Namen für die Anbindung vergeben.
- Im Reiter „Allgemein“ die Absenderadresse ausfüllen, von Hand oder über „Adresse aus Benutzerkonto“. Das Feld „Vorname“ muss gefüllt sein, Hermes verlangt es.
- Speichern. Billbee bestätigt die Einrichtung, der Reiter „Produkte“ wird aktiv.
- Im Reiter „Produkte“ auf „Produkte abrufen“ klicken. Billbee lädt die Versandprodukte, die Hermes für dein Konto anbietet.
Über „Hinzufügen“ legst du ein Produkt auch einzeln an und gibst ihm einen eigenen Anzeigenamen. Lösch Produkte, die du nie nutzt, damit am Packtisch niemand daneben greift.
Welche Felder im Reiter „Allgemein“ zählen?
| Feld | Was es tut |
|---|---|
| Tracking-URL | setzt Billbee automatisch |
| Standardgewicht, Verpackungsgewicht | optionale Werte in Gramm für diese Anbindung |
| Ausgabe der Etiketten, Exportdokumente, Retourenlabels | legt die Dokumente direkt in einen angebundenen Cloudspeicher |
| Referenz | Text oder Platzhalter auf dem Label, höchstens 15 Zeichen |
| Absenderadresse | mit Vorname, sonst lehnt Hermes ab |
Die Grenze von 15 Zeichen bei der Referenz ist knapp. Eine Amazon-Bestellnummer wie 302-1234567-1234567 hat allein schon 19 Zeichen. Wie das Verpackungsgewicht mit den Artikelgewichten zusammenspielt, steht in Artikelgewicht in Billbee pflegen.
Kannst du Hermes-Retourenlabels über Billbee erstellen?
Nur als Großkunde. Billbee bietet die Retourenprodukte Retoure XS, S, M, L und XL an, jeweils optional mit dem Service FlexRetoure. Laut Billbee gibt Hermes die Retourenlabels über die Schnittstelle aber nur für Großkunden frei. Self-Service-Kunden können in Billbee keine Hermes-Retourenlabels erstellen.
Als kleiner Händler legst du Retouren deshalb weiter direkt bei Hermes an.
Mehrere Absenderadressen: geht das?
Ja, über eine zweite Anbindung. Billbee empfiehlt, „Hermes Shipping Interface“ ein zweites Mal als Versandweg anzulegen und dort die abweichende Absenderadresse einzutragen.
Welche Fehler sind typisch?
| Meldung | Ursache | Lösung |
|---|---|---|
| „Invalid refresh token“ | Hermes hat an der Anmeldung etwas geändert, die Verbindung ist abgelaufen | Anbindung in Billbee löschen und neu verbinden |
| „Die Eigenschaften [clientReference] entsprechen nicht den Anforderungen“ | Referenz länger als 15 Zeichen | Referenz kürzen |
| Hermes lehnt die Sendung ab | Vorname in der Absenderadresse fehlt | Vorname im Reiter „Allgemein“ eintragen |
| Retourenlabel wird nicht erstellt | kein Großkundenvertrag | Retoure direkt bei Hermes anlegen |
Nach „Invalid refresh token“ musst du auch die Versandprodukte neu abrufen, denn die neue Anbindung startet leer. Prüf danach Automatisierungen und Versandregeln, die auf die alte Anbindung zeigten.
Häufige Fragen
Brauche ich einen Hermes-Vertrag für Billbee?
Ja. Billbee setzt einen Geschäftskundenvertrag voraus, weil du für die Anbindung deine Hermes-Zugangsdaten brauchst.
Was mache ich, wenn die Hermes-Anbindung plötzlich nicht mehr geht?
Erscheint „Invalid refresh token“, ist die Verbindung abgelaufen. Laut Billbee löschst du die Anbindung und verbindest Hermes neu.
Wie lade ich ein Hermes-Label nachträglich herunter?
In der Bestellung im Reiter „Versand“. Kauf nicht einfach neu, sonst zahlst du doppelt. Mehr dazu in Versandlabel doppelt gekauft vermeiden, und was mit ungenutzten Labels passiert, in Versandlabel stornieren.
Welche anderen Versanddienste kann ich in Billbee anbinden?
DHL, Deutsche Post, DPD, GLS, UPS und weitere. Die Übersicht steht in Versanddienstleister in Billbee verbinden.
Packhummel, unsere Packtisch-App für Billbee am Mac, kauft Hermes-Labels über die Anbindung, die du in Billbee eingerichtet hast. Das Porto läuft weiter über deinen Hermes-Vertrag. Noch einmal verbinden musst du Hermes dafür nicht. So läuft Packhummel.