Hermes einrichten
Verbinde deinen Hermes-Geschäftskundenvertrag, damit Flowkom Versandlabels direkt bei Hermes kauft. Zu finden unter Einstellungen → Integrationen → Hermes.
Wo du sie findest: Unter Einstellungen → Integrationen erscheint die Karte Hermes, sobald etwas eingerichtet ist — mit dem Stand Verbunden, Fehler (letzter Test fehlgeschlagen) oder Einrichten (noch nie getestet). Ist noch nichts hinterlegt, findest du sie über Integration hinzufügen in der Gruppe Versand; der Klick auf die Karte führt direkt hierher.
Eine grüne Verbindung versendet noch nichts. Erst eine Versandart mit Carrier Hermes sorgt dafür, dass Aufträge tatsächlich über Hermes laufen. Das ist der Schritt, der am häufigsten übersehen wird.
Voraussetzungen
- Ein Hermes-Geschäftskundenvertrag
- Die API-Zugangsdaten von Hermes: Client-ID und Client-Secret
- Die Rolle Administrator in Flowkom
Hermes verschickt die Zugangsdaten über einen Einmal-Abruf-Link. Der Link lässt sich nur einmal öffnen. Öffne ihn erst, wenn du Client-ID und Client-Secret direkt danach in Flowkom eintragen kannst — ein zweiter Aufruf zeigt nichts mehr an. Fordere in dem Fall bei Hermes einen neuen Link an; der alte lässt sich nicht reaktivieren.
Verbinden
| Feld | Was einzutragen ist |
|---|---|
| Client-ID | Aus dem Einmal-Abruf-Link |
| Client-Secret | Aus demselben Link |
Klicke Zugangsdaten speichern und danach Verbindung testen. Der Test meldet sich nur bei Hermes an — er kauft kein Etikett und kostet nichts. Bei Erfolg meldet Flowkom „Hermes-Verbindung erfolgreich getestet!“, und die Karte steht auf Verbunden. Schlägt der Test fehl, steht sie auf Fehler und zeigt die Fehlermeldung im Testergebnis.
Gespeicherte Secrets zeigt Flowkom nicht erneut an — das Feld bleibt leer und behält den gespeicherten Wert, solange du nichts einträgst. Speicherst du ein neues Secret, steht die Verbindung wieder auf Nicht getestet; teste dann erneut.
Verbindung trennen löscht nach einer Rückfrage die hinterlegten Zugangsdaten. Versandarten mit Carrier Hermes bleiben bestehen, erzeugen aber keine Labels mehr, bis wieder Zugangsdaten hinterlegt sind.
Versandart anlegen
Der wichtigste Schritt nach dem Verbinden: Ohne eigene Versandart mit Carrier Hermes läuft kein Auftrag über Hermes — auch dann nicht, wenn der Test erfolgreich war. Nach einem erfolgreichen Test zeigt die Karte deshalb den Hinweis Verbindung steht mit dem Knopf Versandart anlegen.
Unter Einstellungen → Versand, Tab Versandarten, legst du über Versandart hinzufügen eine neue Versandart an (oder bearbeitest eine bestehende) und wählst als Carrier Hermes. Danach erscheint die Hermes-Produktkonfiguration:
| Feld | Wert |
|---|---|
| Produktart | Paket (PARCEL) im Normalfall; ohne Auswahl sendet Flowkom als Paket. Sack (BAG), Fahrradkurier (BIKE) und Sperrgut (LARGE_ITEM) nur nach Absprache mit Hermes. |
| Etikettenformat | PDF, ZPL 203 dpi oder ZPL 300 dpi — siehe Etikettenformat |
Über Hermes läuft ein Auftrag, sobald ihm diese Versandart zugeordnet ist — direkt im Auftrag, über die Versandart seiner Artikel samt Priorität oder per Workflow. Beim Versand kauft Flowkom dann automatisch das Hermes-Label. Als Gewicht meldet Flowkom die Summe der Artikelgewichte mal Menge; ist bei keinem Artikel ein Gewicht hinterlegt, sind es 100 g.
Etikettenformat
- PDF — für normale Drucker
- ZPL 203 dpi oder ZPL 300 dpi — für Etikettendrucker (Zebra und kompatible); welche Auflösung passt, richtet sich nach dem Druckermodell
Ein gewähltes Format gilt immer. Ohne Auswahl (angezeigt als Standard (PDF)) richtet sich Flowkom nach dem Drucker, der der Versandart an der Workstation zugewiesen ist: Ist er auf ZPL eingestellt, kommt das Label als ZPL mit 203 dpi, sonst als PDF.
Retouren
Hermes-Retourenlabels kauft Flowkom automatisch beim Versand von Otto-Bestellungen, wenn bei der Otto-Integration Hermes als Retouren-Versanddienstleister gewählt ist — siehe Otto-Retouren. Ein Hermes-Retourenlabel von Hand gibt es nicht: Der Knopf Retoure in den Auftragsdetails erzeugt Retourenlabels von DHL und der Deutschen Post.
Das Format der Hermes-Retoure legt die Versandart des Auftrags fest:
- Retoure als QR-Code an — Hermes liefert einen QR-Code. Damit druckt der Kunde das Etikett im Hermes ParcelShop aus und braucht keinen eigenen Drucker. Den QR-Code gibt es bei Hermes nur für Retouren aus Deutschland; kommt die Retoure aus dem Ausland, liefert Flowkom ein PDF-Etikett. Der Schalter erscheint, sobald Retourenlabel erlauben an ist.
- Retoure als QR-Code aus — Hermes liefert ein PDF-Etikett, auch wenn das Versandlabel als ZPL kommt.
Geht eine Otto-Bestellung mit DHL oder der Deutschen Post hinaus, kommt die Hermes-Retoure immer als PDF.
Für einen Auftrag kauft Flowkom höchstens ein Hermes-Retourenlabel. Liegt bereits ein Kauf vor, wird kein zweites gekauft — auch nicht bei einem erneuten Versuch.
Otto-Retouren
Otto verlangt für jede Paketsendung ein Retourenlabel. Bei der jeweiligen Otto-Integration wählst du unter Retouren-Versanddienstleister, wer es liefert — DHL oder Hermes. Das darf vom Versand abweichen: Eine Bestellung kann mit DHL hinausgehen und mit Hermes zurückkommen.
Mit Hermes kauft Flowkom beim Versand jeder Otto-Bestellung über DHL, Deutsche Post oder Hermes ein Hermes-Retourenlabel, solange dort Retourenlabel automatisch beim Versand erzeugen an ist (Standard). Voraussetzung sind hinterlegte Hermes-Zugangsdaten; eine Hermes-Versandart oder eine Abrechnungsnummer brauchst du dafür nicht. Fehlen die Zugangsdaten, wird der Versand nicht blockiert; die Versandbestätigung meldet dann das fehlende Retourenlabel.
Wenn etwas nicht klappt
Schlägt der Label-Kauf fehl, bleibt der Auftrag unversendet, und der Fehler steht mit dem Grund unter Versandfehler. Flowkom versucht es nicht automatisch erneut — den nächsten Versuch startest du selbst.
„Hermes-Zugangsdaten wurden abgelehnt“ Client-ID oder Client-Secret stimmen nicht, meist ein Kopierfehler. Trage beide Werte neu ein, speichere und teste erneut. Hast du die Werte nicht mehr, fordere bei Hermes einen neuen Link an. Möglich ist auch, dass der Zugang bei Hermes noch nicht freigeschaltet ist.
„Hermes hat den Zugriff abgelehnt“, obwohl der Test grün war Der Verbindungstest prüft nur die Anmeldung, nicht den Etikettenkauf. Dem Zugang fehlt dann bei Hermes eine Berechtigung — das klärt nur Hermes.
„Hermes hat den Auftrag abgelehnt“ Dahinter steht der Grund von Hermes, häufig die Adresse. Hermes verlangt Straße und Hausnummer getrennt; Flowkom trennt sie am Ende der Straßenzeile. Die häufigste Ursache: Dort fehlt die Hausnummer, weil sie in einer anderen Adresszeile steht oder — wie bei Adressen aus Frankreich oder Großbritannien — vor dem Straßennamen. Korrigiere die Lieferadresse so, dass die Hausnummer am Ende der Straßenzeile steht, und versende erneut.
„Hermes nicht erreichbar“ oder ein Serverfehler Dann liegt die Störung bei Hermes, nicht an deinen Eingaben — warte und versuche es erneut. Brach die Verbindung mitten im Kauf ab, kann Hermes die Sendung trotzdem angelegt haben. Sieh vor dem nächsten Versuch im Hermes-Portal nach, damit du kein zweites Etikett kaufst.
Häufige Fragen
„Hermes ist für diesen Workspace nicht verbunden“ beim Versenden. Es sind keine Zugangsdaten hinterlegt — noch nie gespeichert oder mit Verbindung trennen gelöscht. Ein fehlender oder fehlgeschlagener Verbindungstest löst diese Meldung nicht aus.
Ich habe den Einmal-Abruf-Link schon geöffnet, aber die Zugangsdaten nicht kopiert. Der Link ist verbraucht und lässt sich kein zweites Mal öffnen. Fordere bei Hermes einen neuen Link an.
Warum läuft trotz grüner Verbindung nichts über Hermes? Es fehlt eine Versandart mit Carrier Hermes, oder kein Auftrag ist ihr zugeordnet. Siehe Versandart anlegen.
Ich brauche ein zweites Label zum selben Auftrag. Flowkom kauft je Auftrag ein Hermes-Label; ein erneuter Versand verwendet das vorhandene. Zusätzliches Label legt bei Hermes nur einen weiteren Versandauftrag ohne Etikett an — das zweite Etikett erstellst du im Hermes-Portal.
Kann ich ein Hermes-Label stornieren? Nicht aus Flowkom heraus. Das läuft über Hermes.
Warum sehe ich keine Hermes-Einstellungen? Integrationen richtet nur die Rolle Administrator ein. Ist Hermes noch nicht eingerichtet, steht es nicht als Karte unter Einstellungen → Integrationen, sondern unter Integration hinzufügen in der Gruppe Versand.