Einrichtung (Setup Card)
Die Hermes Setup Card ist die zentrale Konfigurationsseite für den Hermes Shipment Connector. Hier werden API-Zugangsdaten, Absenderadresse, Standardformate und Tracking-Optionen konfiguriert.
Seite öffnen
- Suche: Hermes Setup
- Alternativ: Über das merchantCENTRAL Shipment-Provider-Dashboard → Hermes → Setup
Felder
Gruppe: Allgemein
| Feld | Beschreibung |
|---|---|
| Umgebung | Wählt zwischen Sandbox (Test) und Production (Echtbetrieb). Die API-URL wird automatisch angepasst. |
| API Base URL | Die Basis-URL der Hermes API. Wird automatisch basierend auf der gewählten Umgebung gesetzt. Sandbox: https://api-sandbox.2mdc.de/, Produktion: https://api.2mdc.de/ |
| Partner ID | Ihre Hermes Partner-ID. Wird bei der Sendungserstellung als Absender-Identifikation übermittelt. |
| Aktiv | Aktiviert oder deaktiviert den Connector. Nur bei aktivem Connector werden Sendungen erstellt. Erfordert eine gültige Lizenz (Demo oder Voll). |
Gruppe: Zugangsdaten
| Feld | Beschreibung |
|---|---|
| Client ID | Die OAuth2 Client ID aus dem Hermes API-Portal. Klicken Sie auf das Feld, um den Wert einzugeben oder zu ändern. Status: Configured (grün) oder Not configured (rot). |
| Client Secret | Das OAuth2 Client Secret aus dem Hermes API-Portal. Klicken Sie auf das Feld, um den Wert einzugeben oder zu ändern. Der gespeicherte Wert wird nie im Klartext angezeigt. |
Sicherheit
Client ID und Client Secret werden verschlüsselt im Credential Store gespeichert (IsolatedStorage). Sie sind nicht in der Datenbank sichtbar und können nicht über RapidStart oder Konfigurationspakete exportiert werden.
Gruppe: Absenderadresse
Die Absenderadresse wird auf allen Versandlabels als Absender aufgedruckt.
| Feld | Beschreibung |
|---|---|
| Absendername | Name des Absenders (Firmenname). |
| Straße | Straßenname der Absenderadresse. |
| Hausnummer | Hausnummer der Absenderadresse. |
| PLZ | Postleitzahl des Absenders. |
| Ort | Stadt/Ort des Absenders. |
| Ländercode | ISO-Ländercode (z. B. DE für Deutschland). |
| E-Mail-Adresse für Benachrichtigungen. | |
| Telefon | Telefonnummer für Rückfragen. |
Gruppe: Standardeinstellungen
| Feld | Beschreibung |
|---|---|
| Standard-Paketklasse | Die voreingestellte Paketklasse für neue Sendungen (S, M, L, XL, XXL). Kann pro Sendung überschrieben werden. |
| Standard-Produkt | Das voreingestellte Produkt für neue Sendungen (PARCEL, PARCELSHOPDELIVERY, PROFIPAKET). |
| Labelformat | Das Standard-Druckformat für Versandlabels (z. B. PDF A6, ZPL 100×150mm). |
| Retoure-Labelformat | Das Druckformat für Retourenlabels. Kann vom Versandformat abweichen. |
| Dokumentformat | Das Dokumentformat für ausgehende Sendungen (PDF oder ZPL2). |
| Retoure-Dokumentformat | Das Dokumentformat für Retourenlabels. Kann vom Versandformat abweichen. |
Format-Kombination
Typische Konfiguration: Versandlabels als ZPL auf dem Thermodrucker (schnell, professionell) und Retourenlabels als PDF auf dem Laserdrucker (zum Beilegen ins Paket).
Gruppe: Tracking
| Feld | Beschreibung |
|---|---|
| Tracking aktiviert | Aktiviert die automatische Sendungsverfolgung. Wenn aktiv, werden offene Sendungen periodisch bei der Hermes API abgefragt. |
| Abfrageintervall (Min.) | Das Intervall in Minuten zwischen automatischen Tracking-Abfragen. Empfohlen: 60–120 Minuten. |
Gruppe: Lizenz
| Feld | Beschreibung |
|---|---|
| Lizenzstatus | Zeigt den aktuellen Lizenzstatus: Active (grün), Demo (gelb), Unregistered (rot), Expired (rot). |
Aktionen
Verarbeitung
| Aktion | Beschreibung |
|---|---|
| Verbindung testen | Testet die API-Verbindung mit den konfigurierten Zugangsdaten. Versucht einen OAuth2-Token abzurufen. Bei Erfolg: „Connection successful". Bei Fehler: „Connection failed" — prüfen Sie Client ID, Client Secret und Umgebung. |
Lizenz
| Aktion | Beschreibung |
|---|---|
| Demo registrieren | Startet den Demo-Registrierungswizard für eine kostenlose 30-Tage-Testlizenz. Es werden Unternehmensdaten erfasst. |
| Lizenz aktualisieren | Fragt den aktuellen Lizenzstatus vom Lizenzserver ab und aktualisiert die Anzeige. |
Hinweise
Umgebungswechsel
Beim Wechsel der Umgebung (Sandbox ↔ Production) werden die API-URL und die Zugangsdaten nicht automatisch übernommen. Stellen Sie sicher, dass Sie die korrekten Credentials für die jeweilige Umgebung hinterlegen.
Aktivierung
Der Connector kann nur aktiviert werden, wenn:
- Mindestens eine Demo-Lizenz registriert ist
- Client ID und Client Secret konfiguriert sind
- Die Absenderadresse vollständig ausgefüllt ist