Ersteinrichtung DPD
Diese Anleitung führt Sie Schritt für Schritt durch die Ersteinrichtung des DPD Versand-Connectors in Business Central. Nach Abschluss können Sie direkt DPD-Versandlabels erstellen.
Voraussetzungen
Bevor Sie beginnen, stellen Sie sicher, dass Sie folgende Dinge haben:
- [x] DPD-Kundenkonto — Ein aktives Geschäftskundenkonto bei DPD
- [x] Delis-ID — Ihr DPD-Benutzername (erhalten Sie von Ihrem DPD-Kundenberater)
- [x] Passwort — Ihr DPD-Passwort
- [x] merchantCENTRAL Hub — Die merchantCENTRAL Hub-App muss installiert sein
- [x] DPD Connector — Die App „AD merchantCENTRAL Shipment DPD" muss installiert sein
Sandbox vs. Produktivzugang
DPD bietet einen Sandbox-Modus zum Testen. Aktivieren Sie diesen unbedingt zuerst, bevor Sie mit echten Sendungen arbeiten! Die Sandbox-URL ist automatisch hinterlegt, wenn Sie den Sandbox-Modus aktivieren.
Schritt 1: Setup-Seite öffnen
Es gibt drei Wege, die DPD-Einrichtungsseite zu öffnen:
Weg 1 — Über die Suche:
- Drücken Sie ++alt+q++ (oder das Suchfeld oben rechts)
- Geben Sie DPD Shipment Setup ein
- Klicken Sie auf das Suchergebnis
Weg 2 — Über das merchantCENTRAL Dashboard:
- Öffnen Sie das merchantCENTRAL Dashboard
- Navigieren Sie zu Versanddienstleister
- Klicken Sie auf DPD
Weg 3 — Über die Versanddienstleister-Liste:
- Öffnen Sie die Versanddienstleister-Liste
- Suchen Sie den Eintrag DPD
- Klicken Sie auf Setup öffnen in der Aktionsleiste
Automatische Erstanlage
Beim ersten Öffnen der Setup-Seite wird automatisch ein leerer Datensatz angelegt. Sie müssen nichts manuell erstellen.
Schritt 2: API-Zugangsdaten eintragen
Im Bereich API Credentials tragen Sie Ihre DPD-Zugangsdaten ein:
2.1 API Base URL
Die Standard-URLs sind:
| Umgebung | URL |
|---|---|
| Produktiv | https://public-ws.dpd.com/services/ |
| Sandbox | https://public-ws-stage.dpd.com/services/ |
Empfehlung: Mit Sandbox starten
Beginnen Sie immer mit der Sandbox-Umgebung. Aktivieren Sie dazu das Feld Sandbox Mode — die URL wird automatisch auf die Sandbox-Adresse gesetzt.
2.2 Zugangsdaten
| Feld | Was eintragen? | Beispiel |
|---|---|---|
| Delis ID | Ihre DPD Delis-ID / Benutzername | ALTENBRAND |
| Password | Ihr DPD-Passwort (wird maskiert angezeigt) | *** |
| Message Language | Sprache für API-Fehlermeldungen | de_DE |
Passwort-Sicherheit
Das Passwort wird verschlüsselt im Business Central IsolatedStorage gespeichert — nicht als Klartext in der Datenbank. Nach der Eingabe wird es nur noch als *** angezeigt.
Schritt 3: Verbindung testen
Bevor Sie fortfahren, testen Sie die Verbindung:
- Klicken Sie auf Test Connection in der Aktionsleiste
- Business Central sendet eine Authentifizierungsanfrage an den DPD LoginService
-
Bei Erfolg erscheint eine Meldung:
✅ Verbindung erfolgreich. Customer UID:
XXXXXX, Depot:0190 -
Die Felder Customer UID und Depot im Bereich Authentication Cache werden automatisch befüllt
Verbindung fehlgeschlagen?
Mögliche Ursachen:
- Falsche Delis-ID oder Passwort — Prüfen Sie Ihre Zugangsdaten
- Falsche URL — Stellen Sie sicher, dass die API Base URL korrekt ist
- Firewall/Proxy — Der BC-Server muss
public-ws.dpd.com(Port 443) erreichen können - Konto gesperrt — Wenden Sie sich an Ihren DPD-Kundenberater
→ Weitere Hilfe: Fehlerbehebung
Schritt 4: Absenderadresse eintragen
Im Bereich Shipper Address hinterlegen Sie Ihre Absenderadresse. Diese wird auf jedem DPD-Label als Absender gedruckt.
| Feld | Beschreibung | Beispiel |
|---|---|---|
| Shipper Name | Firmenname (Zeile 1) | ALTENBRAND Datentechnik GmbH |
| Shipper Name 2 | Zusatz (Zeile 2, optional) | Abt. Versand |
| Shipper Street | Straße | Am Brunnenfeld |
| Shipper House No. | Hausnummer | 1 |
| Shipper Post Code | Postleitzahl | 86511 |
| Shipper City | Stadt | Schmiechen |
| Shipper Country Code | Ländercode (ISO-2) | DE |
| Shipper Contact Name | Ansprechpartner | Max Mustermann |
| Shipper Email | E-Mail-Adresse | versand@altenbrand.de |
| Shipper Phone | Telefonnummer | +49 8206 96200 |
Pflichtfelder
Die Felder Shipper Name, Shipper Street, Shipper House No., Shipper Post Code, Shipper City und Shipper Country Code sind zwingend erforderlich. Ohne diese Angaben kann kein Label erstellt werden.
Schritt 5: Standardeinstellungen festlegen
Im Bereich Default Settings legen Sie Standardwerte fest, die bei jeder neuen Sendung vorbelegt werden:
5.1 Standard-Produkt
| Produkt | Kürzel | Wann verwenden? |
|---|---|---|
| DPD Classic | CL |
Standardversand national (1–2 Werktage) |
| DPD Express 8:30 | E830 |
Zustellung garantiert bis 8:30 Uhr am nächsten Werktag |
| DPD Express 12:00 | E12 |
Zustellung garantiert bis 12:00 Uhr am nächsten Werktag |
| DPD Express 18:00 | E18 |
Zustellung garantiert bis 18:00 Uhr am nächsten Werktag |
| DPD International Express | IE2 |
Internationaler Expressversand |
| DPD PaketShop | PL |
Zustellung an einen DPD PaketShop |
| DPD Mail | MAIL |
Briefsendungen |
| DPD MAX | MAX |
Großpakete bis 31,5 kg |
Empfehlung
Für die meisten Geschäftskunden ist DPD Classic (CL) die richtige Wahl. Dieses Produkt wird standardmäßig vorgeschlagen.
5.2 Papierformat
| Format | Beschreibung |
|---|---|
| A4 | Standard-Druckerpapier — Label wird auf einem DIN-A4-Blatt gedruckt |
| A6 | Halbseitig — geeignet für Thermodrucker oder spezielle Etikettenhalter |
| A7 | Kleines Format — für kompakte Labeldrucker |
5.3 Ausgabeformat
| Format | Beschreibung | Verwendung |
|---|---|---|
| Standard-PDF-Datei | Standard-Laserdrucker oder PDF-Betrachter | |
| ZPL | Zebra Programming Language | Zebra-Thermodrucker (direkt über TCP/IP oder USB) |
Welches Format?
Wenn Sie einen normalen Bürodrucker verwenden → PDF wählen. Wenn Sie einen Zebra-Thermodrucker haben → ZPL wählen.
5.4 Standardgewicht
Geben Sie ein Standardgewicht in Gramm ein, das bei neuen Sendungen vorbelegt wird (z. B. 1000 für 1 kg). Dieses Gewicht wird nur verwendet, wenn kein Gewicht am Artikel hinterlegt ist.
Schritt 6: Tracking-URL konfigurieren
Im Bereich Tracking ist eine Standard-URL für die Sendungsverfolgung hinterlegt:
https://tracking.dpd.de/status/%1
Der Platzhalter %1 wird automatisch durch die DPD-Paketnummer ersetzt. Diese URL wird in den Versandbestätigungen an den Kunden verwendet.
Anpassung normalerweise nicht nötig
Die Standard-URL funktioniert für alle DPD-Sendungen in Deutschland. Nur wenn Sie einen eigenen Tracking-Service nutzen, müssen Sie die URL anpassen.
Schritt 7: Incoterm-Mapping einrichten (nur für internationalen Versand)
Wenn Sie international versenden, richten Sie das Incoterm-Mapping ein:
- Klicken Sie auf Incoterm Mapping in der Aktionsleiste
- Es öffnet sich eine Liste, in der Sie jedem BC-Lieferbedingungscode (Shipment Method) DPD-spezifische Zollwerte zuordnen
| Feld | Beschreibung |
|---|---|
| Shipment Method Code | BC Lieferbedingungscode (z. B. DAP, DDP) |
| Description | Automatisch aus der Lieferbedingungstabelle |
| DPD Incoterm | DPD-Incoterm (DAP, DDP, EXW) |
| DPD Payment Term | Zoll-Zahlungsbedingung |
| DPD Clearance Cleared | Zollabfertigungsstatus |
→ Details: Internationale Sendungen
Nur für internationalen Versand
Wenn Sie ausschließlich innerhalb Deutschlands versenden, können Sie diesen Schritt überspringen.
Einrichtung abgeschlossen ✓
Nach diesen Schritten ist Ihr DPD Connector einsatzbereit. Sie können jetzt:
- Labels erstellen — Einzelne oder mehrere Versandlabels erzeugen
- Retourenlabels erstellen — Rücksende-Etiketten für Kunden generieren
Checkliste
Nutzen Sie diese Checkliste, um sicherzustellen, dass alles korrekt eingerichtet ist:
- [ ] Delis-ID und Passwort eingetragen
- [ ] Test Connection erfolgreich (Customer UID + Depot angezeigt)
- [ ] Absenderadresse vollständig (Name, Straße, PLZ, Stadt, Land)
- [ ] Standard-Produkt gewählt (z. B. CL für DPD Classic)
- [ ] Papierformat gewählt (A4, A6 oder A7)
- [ ] Ausgabeformat gewählt (PDF oder ZPL)
- [ ] Standardgewicht eingetragen
- [ ] Optional: Incoterm-Mapping für internationalen Versand eingerichtet