Einstellungen

Die Hermes-Einstellungen steuern den Zugang zur Hermes-Schnittstelle, die Standard-Paketgroesse, die Kontaktuebermittlung und den Labeldruck fuer Hermes-Sendungen.

Zweck und Aufruf

Die Einstellungsseite gehoert zum Hermes-Bereich im Versandbackend. Beim Aufruf prueft das Backend das Recht fuer Hermes-Versand, ob die Hermes-App aktiv ist, und legt fehlende Hermes-Konfigurationswerte an. Danach zeigt der Bereich die Tabs Einstellungen, erzeugte Labels der letzten 24 Stunden und Logs.

Sichtbare Formularfelder

• 10_username: Benutzername fuer den Hermes-Zugang. Der Wert wird beim Anmelden an der Hermes-Schnittstelle als Benutzername verwendet.
• 20_password: Passwort fuer den Hermes-Zugang. Das Backend nutzt den Wert zusammen mit 10_username, wenn kein gueltiger Zugriffstoken vorhanden ist oder der Refresh-Token abgelaufen ist.
• 50_paketgroesse: Standard-Paketgroesse fuer neue Hermes-Labels. Das Backend verwendet diesen Wert als Vorgabe fuer parcelClass, wenn im Versandformular keine abweichende Paketklasse gesetzt ist. Verfuegbare Werte sind XS, S, M, L und XL; der installierte Standardwert ist M.
• 60_use_notification: Radio-Auswahl fuer die Uebermittlung der Kundenbenachrichtigung. 1 uebermittelt die E-Mail-Adresse immer, 0 uebermittelt keine Kundenbenachrichtigung, 2 uebermittelt die E-Mail-Adresse nur bei vorhandener Zustimmung aus der Bestellung. Bei Paketshop-Zustellung erzwingt die Versandlogik die Benachrichtigung unabhaengig von dieser Auswahl.
• labeldruck: Checkbox fuer den Hermes-Labeldruck. Ist der Wert nicht aktiv, zeigt die Versandoption statt der Eingabefelder den Hinweis, dass der Hermes-Labeldruck deaktiviert ist. Beim Speichern setzt das Backend eine nicht uebermittelte Checkbox automatisch auf 0.

Nicht sichtbare Konfigurationswerte

Mehrere Hermes-Werte existieren in der Konfiguration, werden im Formular aber bewusst ausgeblendet:

• 30_client_id und 40_client_secret: technische Schnittstellenwerte, die im Formular nicht gepflegt werden.
• access_token, token_type und refresh_token: intern verwaltete OAuth-Werte. Erfolgreiche Anmeldungen aktualisieren diese Felder automatisch.
• access_expires und refresh_expires: Ablaufzeiten fuer Zugriffs- und Refresh-Token. Sind Werte leer oder abgelaufen, startet die Hermes-Klasse automatisch eine neue Anmeldung oder Refresh-Anfrage.

Auswirkung auf die Labelerstellung

• Beim Erzeugen eines Versandlabels uebertraegt das Backend Empfaengername, Lieferadresse, Bestellnummer, Paketgewicht und die gewaehlte Paketklasse an Hermes.
• Die globale Standard-Paketgroesse greift nur als Vorgabe. Im Versandformular kann pro Bestellung eine andere Paketgroesse gewaehlt werden.
• Wenn bulkGoodService im Versandformular aktiv ist, wird die Sendung als Sperrgut markiert.
• Wenn parcelShopDeliveryService aktiv ist, setzt das Backend die Paketshop-Zustellung nach Empfaengeradresse und uebermittelt dafuer eine Kundenbenachrichtigung.
• Retouren verwenden eine vorhandene Hermes-Trackingnummer als Ausgangssendung, sofern im Versandformular eine Retoure angefordert wird.
• Antworten von Hermes liefern die Sendungsnummer und das Label als PDF-Daten. Diese Werte werden als Versandlabel gespeichert.

Speichern und Rueckmeldung

1. Benutzername und Passwort fuer den Hermes-Zugang pflegen.
2. Standard-Paketgroesse und Kontaktuebermittlung passend zur Versandpraxis festlegen.
3. Labeldruck aktivieren, wenn Hermes-Labels im Versandprozess erstellt werden sollen.
4. Mit dem Standard-Speichern-Button sichern. Das Backend aktualisiert die Hermes-Konfiguration und oeffnet die Einstellungsseite anschliessend mit Erfolgsmeldung erneut.

Fehleranalyse

• Wenn die Hermes-App nicht aktiv ist, zeigt der Bereich keinen Einstellungsdialog, sondern einen Aktivierungshinweis.
• Wenn Zugangsdaten oder Token ungueltig sind, kann die Anmeldung fehlschlagen. Die Hermes-Klasse speichert die Fehlermeldung und leert betroffene Tokenwerte.
• API-Aufrufe fuer Anmeldung, Label und Retoure werden im Hermes-Log protokolliert und auf der Log-Unterseite maskiert angezeigt.