> For the complete documentation index, see [llms.txt](https://docs.solutioo.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.solutioo.de/hermes/uberwachung-und-fehlerbehebung.md). # Überwachung und Fehlerbehebung Öffnen Sie **Hermes Sendungen** und prüfen Sie die betroffene Sendung anhand von **Belegnr.**, Hermes-IDs, **Status** und **Letzter Fehler**. Die Statuswerte **Entwurf**, **Angelegt**, **Label erstellt**, **Fehler** und **Retoure** beschreiben die Bearbeitung in der App. Sie zeigen keinen Live-Zustellstatus an. Wenn die Protokollierung aktiviert ist, öffnen Sie **Hermes API-Protokoll**. Prüfen Sie Zeitpunkt, Endpunkt, HTTP-Status, **Erfolgreich** und Fehlermeldung. Die Detailansicht enthält Anfrage und Antwort. Nicht jeder Fehler hinterlässt einen Protokolleintrag. Erfassen Sie deshalb zusätzlich die am Bildschirm angezeigte Meldung und den Zeitpunkt. | Symptom | Mögliche Ursache und nächster Schritt | | ----------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Vermittler-Secret fehlt** | Das Secret fehlt für die gewählte Umgebung. Lassen Sie es durch einen Hermes-Administrator hinterlegen und kontrollieren Sie den Status in der Einrichtung. | | Verbindungstest scheitert | Prüfen Sie Hermes-Umgebung, Kundensegment, Benutzer, Kundenpasswort und den vereinbarten OAuth-Grant. Lassen Sie die Kontofreischaltung klären. Wiederholen Sie nach der Korrektur zunächst nur den Verbindungstest. | | HTTP-Aufrufe sind blockiert | Lassen Sie **HttpClient-Anforderungen zulassen** in der Konfiguration der Erweiterung prüfen. | | Empfänger Nachname, Straße, PLZ oder Ort fehlt | Vervollständigen Sie Lieferadresse beziehungsweise Sendungsdaten. Prüfen Sie anschließend erneut die Angaben. | | Gewicht oder Selfservice-Volumen fehlt | Prüfen Sie ein Gewicht größer null und bei Selfservice Paketklasse und Volumen. | | `e010`: Paketklasse passt nicht zu Maßen oder Volumen | Prüfen Sie die Klasse anhand der Außenmaße und das Volumen in Dezilitern. Ermitteln Sie die Klasse nicht aus dem Gewicht. Korrigieren Sie den ausdrücklich abgelehnten Datensatz, bevor Sie erneut anfordern. | | Zugriff verweigert oder Tabellenrecht fehlt | Lassen Sie App-Rolle und Standardrechte prüfen. Geben Sie Aktion und Objekt der Meldung an Ihren Administrator. | | Hermes lehnt einen Service ab | Prüfen Sie Konto, Land, Werte und Servicekombination anhand der Antwort. Stimmen Sie die Freischaltung mit Hermes ab. | | Label fehlt trotz Antwort | Kontrollieren Sie **Label vorhanden**, Hermes-IDs und Antwortinhalt. Ein erneuter Download benötigt keine neue Labelerzeugung. | | Antwort oder Auftragsausgang ist unklar | Prüfen Sie gespeicherte Sendung und Protokoll und lassen Sie den Status mit den vorhandenen Referenzen klären. Starten Sie keine wiederholten Anfragen auf Verdacht. | ### Token-Cache und Wiederholung Bei einem begründeten Anmeldeproblem kann ein Administrator in **Hermes Einrichtung** die Aktion **Token-Cache leeren** verwenden. Anschließend wird eine neue Anmeldung benötigt. Prüfen Sie diese mit **Verbindung testen**. Bestimmte Antworten mit dem Hermes-Fehlercode `e058` werden intern wiederholt. Eine manuelle Wiederholung der gesamten Labelerzeugung kann trotzdem weitere Aufträge auslösen. Eine allgemeine Vermeidung doppelter Aufträge oder automatische Stornierung ist nicht zugesagt. Für die Eskalation folgen Sie den [Supportangaben](/hermes/support.md). Teilen Sie nur bereinigte Auszüge; Protokolle und Labels können personenbezogene Daten enthalten. ### Anmeldung scheitert nur mit einem Versandbenutzer Funktioniert die Anmeldung mit einem Administrator, prüfen Sie zusätzlich zur App-Rolle die BC-Basisrechte im verwendeten Mandanten. Fehlende Standardrechte können Microsoft-Systemtrigger beim Speichern blockieren. Lassen Sie die konkrete Rechtefehlermeldung prüfen und die benötigten Basisrechte zuweisen; für den Versand ist keine Hermes-Administratorrolle erforderlich. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.solutioo.de/hermes/uberwachung-und-fehlerbehebung.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.