Zum Inhalt

Fehlerbehebung & FAQ

Hier finden Sie Lösungen für häufige Probleme mit dem DPD Connector sowie Antworten auf wiederkehrende Fragen.

Verbindungsprobleme

„Test Connection" schlägt fehl

Fehlermeldung: Login failed oder Authentication error

Ursache: Falsche Delis-ID oder falsches Passwort.

Lösung:

  1. Prüfen Sie Ihre Delis-ID — Groß-/Kleinschreibung beachten
  2. Geben Sie das Passwort erneut ein (klicken Sie in das Feld und tippen Sie es neu)
  3. Testen Sie die gleichen Zugangsdaten im DPD MyDPD-Portal unter myDPD.dpd.com
  4. Wenn das MyDPD-Login funktioniert, aber der Connector nicht: Kontaktieren Sie Ihren DPD-Kundenberater — möglicherweise ist der API-Zugang nicht freigeschaltet
Fehlermeldung: Could not connect to DPD service oder Timeout

Ursache: Netzwerkproblem oder DPD-Server nicht erreichbar.

Lösung:

  1. Prüfen Sie die API Base URL:
    • Produktiv: https://public-ws.dpd.com/services/
    • Sandbox: https://public-ws-stage.dpd.com/services/
  2. Stellen Sie sicher, dass Ihr BC-Server die URL auf Port 443 (HTTPS) erreichen kann
  3. Prüfen Sie Firewall und Proxy-Einstellungen
  4. Testen Sie, ob die URL im Browser erreichbar ist (z. B. https://public-ws.dpd.com/services/LoginService/V2_0/)
  5. Bei BC Online/SaaS: DPD-URLs müssen in der Azure AD-Konfiguration als erlaubte Endpunkte eingetragen sein
Fehlermeldung: Sandbox mode is active

Ursache: Sie verwenden die Sandbox-URL, aber Ihre Zugangsdaten gelten nur für die Produktivumgebung (oder umgekehrt).

Lösung:

  1. Prüfen Sie den Sandbox Mode-Schalter im Setup
  2. Sandbox-Zugangsdaten funktionieren nur mit der Sandbox-URL
  3. Produktiv-Zugangsdaten funktionieren nur mit der Produktiv-URL
  4. Wenn Sie noch keine Sandbox-Zugangsdaten haben, fordern Sie diese bei Ihrem DPD-Kundenberater an

Label-Erstellung schlägt fehl

Allgemeine Fehler

Fehlermeldung: Shipper address is incomplete

Ursache: Die Absenderadresse im DPD Setup ist nicht vollständig.

Lösung:

  1. Öffnen Sie das DPD Shipment Setup
  2. Prüfen Sie im Bereich Shipper Address, ob alle Pflichtfelder ausgefüllt sind:
    • Shipper Name
    • Shipper Street
    • Shipper House No.
    • Shipper Post Code
    • Shipper City
    • Shipper Country Code
  3. Häufig vergessen: Hausnummer (Shipper House No.)
Fehlermeldung: Recipient address is incomplete

Ursache: Die Empfängeradresse im Label ist unvollständig.

Lösung:

Prüfen Sie folgende Pflichtfelder im Versandlabel:

  • Recipient Name
  • Recipient Street
  • Recipient House No.
  • Recipient Post Code
  • Recipient City
  • Recipient Country Code
Fehlermeldung: Weight must be greater than 0

Ursache: Kein Gewicht angegeben.

Lösung:

  1. Geben Sie im Label oder im Packstück ein Gewicht in Gramm ein
  2. Alternativ: Setzen Sie im DPD Setup ein Default Weight (g) > 0
Fehlermeldung: Delis ID is required oder Password is required

Ursache: API-Zugangsdaten fehlen oder wurden nicht gespeichert.

Lösung:

  1. Öffnen Sie das DPD Shipment Setup
  2. Tragen Sie Delis-ID und Passwort ein
  3. Klicken Sie auf Test Connection, um die Daten zu validieren

DPD-API-Fehler (SOAP Faults)

Fehlermeldung enthält SOAP Fault oder faultstring

Ursache: DPD hat die Sendung abgelehnt.

Lösung:

Die Fehlermeldung von DPD wird im Setup unter Last Error Message gespeichert. Häufige DPD-Fehler:

DPD-Fehler Bedeutung Lösung
Wrong postcode PLZ ungültig für das Zielland PLZ und Ländercode prüfen
Invalid product for destination Das gewählte Produkt ist für das Zielland nicht verfügbar Anderes Produkt wählen (z. B. IE2 statt CL für internationale Sendungen)
Weight exceeds limit Gewicht überschreitet das Maximum Gewicht auf max. 31,5 kg (31.500 g) begrenzen
Shipment already exists Sendung wurde bereits erstellt Referenznummer prüfen, ggf. neues Label erstellen
Customer not authorized for product Ihr DPD-Konto ist für das gewählte Produkt nicht freigeschaltet DPD-Kundenberater kontaktieren
Fehlermeldung: Order level error bei Bulk-Labels

Ursache: Eine oder mehrere Sendungen in einem Bulk-Aufruf sind fehlerhaft.

Lösung:

  1. Bei Bulk-Labels werden fehlerhafte Sendungen einzeln markiert
  2. Prüfen Sie in der Label-Liste, welche Sendungen den Status Error haben
  3. Korrigieren Sie die fehlerhaften Sendungen und erstellen Sie diese einzeln neu

Druck-Probleme

Label wird nicht gedruckt / ist unleserlich

Mögliche Ursachen und Lösungen:

Problem Lösung
PDF zu klein/groß Paper Format im DPD Setup prüfen (A4, A6, A7)
ZPL wird nicht erkannt Drucker unterstützt kein ZPL → auf PDF umstellen
Barcode nicht lesbar Druckauflösung prüfen (min. 200 dpi empfohlen)
Leeres PDF Label-Download prüfen, ggf. Label neu erstellen
Label als ZPL — Drucker druckt Klartext statt Label

Ursache: Der Drucker interpretiert den ZPL-Code nicht, sondern druckt ihn als Text.

Lösung:

  1. Stellen Sie sicher, dass Ihr Drucker ein Zebra-kompatibles Gerät ist
  2. Der Drucker muss über TCP/IP oder den Zebra-Treiber angesprochen werden
  3. Verwenden Sie den merchantCENTRAL Print Service für die ZPL-Ausgabe
  4. Alternative: Stellen Sie im DPD Setup auf PDF um

Internationale Versandfehler

Fehlermeldung: International data required

Ursache: Sie versenden in ein Nicht-EU-Land, aber es fehlen Zolldaten.

Lösung:

  1. Richten Sie das Incoterm-Mapping ein
  2. Oder setzen Sie Default-Werte im DPD Setup (Default Incoterm, Payment Term, Clearance)
  3. Stellen Sie sicher, dass Parcel Type und Reason for Export gesetzt sind
Fehlermeldung: Invalid incoterm for destination

Ursache: Der gewählte Incoterm ist für das Zielland nicht gültig.

Lösung:

Prüfen Sie das Incoterm-Mapping und passen Sie es für das Zielland an. Empfehlung:

  • Schweiz → DDP (Delivered Duty Paid) für B2C
  • UK → DAP (Delivered At Place) für B2B
  • USA → DAP als Standard

Status & Monitoring

Wo sehe ich den letzten Fehler?

Die letzte Fehlermeldung wird im DPD Shipment Setup im Bereich Status angezeigt:

Feld Beschreibung
Last Error Message Text der letzten DPD-Fehlermeldung (rot hervorgehoben)
Last Error DateTime Zeitpunkt des letzten Fehlers
Last Label Created Zeitpunkt des letzten erfolgreichen Labels
Labels Created Today Anzahl der heute erstellten Labels

Wo sehe ich die Label-Historie?

Alle erstellten Labels finden Sie in der Versandlabel-Liste:

  1. Öffnen Sie das merchantCENTRAL Dashboard
  2. Klicken Sie auf Versandlabels
  3. Filtern Sie nach Provider = DPD

Allgemeine FAQ

Kann ich DPD-Labels stornieren?

Nein, der DPD Connector unterstützt aktuell keine Labelstornierung über die API. Nicht genutzte Labels verfallen automatisch. Wenn Sie ein Label stornieren müssen, nutzen Sie das DPD MyDPD-Portal.

Gibt es einen Tagesabschluss bei DPD?

Nein, DPD benötigt im Gegensatz zu DHL keinen Tagesabschluss (End of Day / Manifest). Erstellte Labels werden sofort aktiv.

Welche Labelformate unterstützt der Connector?
  • PDF in den Formaten A4, A6 und A7
  • ZPL (Zebra Programming Language) für Thermodrucker
Wie oft wird das Auth-Token erneuert?

Bei jedem API-Aufruf wird ein frisches Auth-Token über den LoginService angefordert. Es gibt kein Token-Caching — das stellt sicher, dass die Authentifizierung immer aktuell ist.

Warum steht im Setup eine Customer UID und ein Depot?

Diese Werte werden beim Test Connection automatisch von DPD zurückgegeben und im Setup gespeichert. Sie identifizieren Ihr DPD-Kundenkonto und werden bei der Label-Erstellung verwendet.

Kann ich mehrere DPD-Konten nutzen?

Aktuell unterstützt der Connector ein DPD-Konto pro Mandant. Wenn Sie mehrere DPD-Konten benötigen, verwenden Sie separate BC-Mandanten.

Was bedeuten die Gewichtseinheiten?
  • In Business Central arbeiten Sie in Gramm (g)
  • An die DPD-API wird das Gewicht in Dekagramm (dag, ÷ 10) übermittelt
  • Die Umrechnung erfolgt automatisch
  • Beispiel: 5.000 g → 500 dag
Unterstützt der Connector DPD Predict (Zustellbenachrichtigungen)?

DPD Predict wird automatisch aktiviert, wenn Sie eine E-Mail-Adresse oder Telefonnummer des Empfängers angeben. Der Empfänger erhält dann eine Zustellbenachrichtigung von DPD.

Welche DPD-Webservice-Versionen werden verwendet?
  • LoginService: Version 2.0
  • ShipmentService: Version 4.5

Support kontaktieren

Wenn Sie ein Problem nicht selbst lösen können:

  1. Fehlermeldung notieren (aus dem DPD Setup → Last Error Message)
  2. Zeitpunkt notieren (Last Error DateTime)
  3. Screenshot der Setup-Seite erstellen
  4. Kontaktieren Sie den Support unter support@altenbrand.de

Diagnose-Infos sammeln

Folgende Informationen helfen bei der Fehlerdiagnose:

  • DPD Setup → Last Error Message + DateTime
  • Welches DPD-Produkt wurde verwendet?
  • Empfänger-Ländercode (DE, CH, UK, …)
  • Sandbox oder Produktiv?
  • BC-Version (unter Hilfe → Info über Business Central)