Zum Inhalt

Ersteinrichtung

Diese Anleitung führt Sie Schritt für Schritt durch die vollständige Einrichtung des Hermes Shipment Connectors.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass:

  • [x] AD merchantCENTRAL Hub installiert und aktiv ist
  • [x] Sie Ihre Hermes API-Zugangsdaten haben (Partner ID, Client ID, Client Secret)
  • [x] Die Absenderadresse Ihres Unternehmens bekannt ist

API-Zugangsdaten

Die Zugangsdaten erhalten Sie von Ihrem Hermes-Ansprechpartner oder über das Hermes Business-Portal. Für Tests können Sie zunächst Sandbox-Credentials anfordern.

Schritt 1: Setup öffnen

  1. Öffnen Sie die Suche (Alt+Q) in Business Central
  2. Geben Sie Hermes Setup ein
  3. Wählen Sie Hermes Setup Card aus den Ergebnissen

Schritt 2: Umgebung wählen

Umgebung Wann verwenden
Sandbox Zum Testen — keine echten Sendungen, keine Kosten
Production Für den Echtbetrieb — echte Labels, echte Sendungen

Empfehlung

Beginnen Sie immer mit der Sandbox-Umgebung. Erst wenn alle Tests erfolgreich sind, wechseln Sie auf Production.

  1. Setzen Sie das Feld Umgebung auf Sandbox
  2. Die API Base URL wird automatisch auf https://api-sandbox.2mdc.de/ gesetzt

Schritt 3: Partner ID eingeben

  1. Tragen Sie Ihre Partner ID im gleichnamigen Feld ein
  2. Die Partner ID identifiziert Sie als Versender gegenüber Hermes

Schritt 4: Zugangsdaten konfigurieren

Client ID eingeben

  1. Klicken Sie auf das Feld Client ID (zeigt „Not configured" in rot)
  2. Im Eingabedialog: Geben Sie Ihre OAuth2 Client ID ein
  3. Klicken Sie OK
  4. Das Feld zeigt nun „Configured" in grün

Client Secret eingeben

  1. Klicken Sie auf das Feld Client Secret (zeigt „Not configured" in rot)
  2. Im Eingabedialog: Geben Sie Ihr OAuth2 Client Secret ein
  3. Klicken Sie OK
  4. Das Feld zeigt nun „Configured" in grün

Sicherheitshinweis

Die Zugangsdaten werden verschlüsselt gespeichert und sind nach der Eingabe nicht mehr im Klartext einsehbar. Bei Verlust müssen Sie neue Credentials bei Hermes anfordern.

Schritt 5: Verbindung testen

  1. Klicken Sie auf die Aktion Verbindung testen (im Menüband unter „Verarbeitung")
  2. Bei Erfolg: Meldung „Connection successful" ✓
  3. Bei Fehler: Prüfen Sie Client ID, Client Secret und die gewählte Umgebung

Fehlerdiagnose

Häufige Fehlerursachen:

  • 401 Unauthorized: Client ID oder Client Secret sind falsch
  • 403 Forbidden: Die Credentials haben keine Berechtigung für die gewählte Umgebung
  • Timeout: Netzwerkproblem oder API nicht erreichbar

Schritt 6: Absenderadresse ausfüllen

Füllen Sie alle Felder der Absenderadresse aus:

Feld Beispiel
Absendername Mustermann GmbH
Straße Industriestraße
Hausnummer 42
PLZ 90402
Ort Nürnberg
Ländercode DE
E-Mail versand@mustermann.de
Telefon +49 911 1234567

Schritt 7: Standardformate konfigurieren

Paketklasse & Produkt

Einstellung Empfehlung
Standard-Paketklasse Wählen Sie die Größe, die Sie am häufigsten versenden
Standard-Produkt PARCEL für Standard-Haustürzustellung

Label- & Dokumentformate

Einstellung Thermodrucker Laserdrucker
Labelformat ZPL 100×150mm PDF A6
Dokumentformat ZPL2 PDF
Retoure-Labelformat PDF A6 PDF A6
Retoure-Dokumentformat PDF PDF

Schritt 8: Tracking aktivieren (optional)

  1. Setzen Sie Tracking aktiviert auf Ja
  2. Legen Sie das Abfrageintervall fest (empfohlen: 60 Minuten)

Das System fragt nun automatisch den Status offener Sendungen bei Hermes ab.

Schritt 9: Lizenz registrieren

  1. Klicken Sie auf Demo registrieren im Menüband
  2. Füllen Sie den Registrierungswizard aus (Firmendaten, Ansprechpartner)
  3. Nach erfolgreicher Registrierung zeigt der Lizenzstatus Demo (gelb)

Schritt 10: Connector aktivieren

  1. Setzen Sie das Feld Aktiv auf Ja
  2. Der Connector ist jetzt einsatzbereit

Checkliste vor Aktivierung

Stellen Sie sicher, dass alle Punkte erfüllt sind:

  • ✅ Verbindungstest erfolgreich
  • ✅ Absenderadresse vollständig
  • ✅ Labelformate konfiguriert
  • ✅ Lizenz registriert (mindestens Demo)

Nächste Schritte

Nach der Einrichtung können Sie: