Ersteinrichtung
Diese Anleitung führt Sie von der Installation bis zum ersten Testlabel. Die Einrichtung dauert mit vorliegenden Zugangsdaten etwa 10 Minuten — mit dem eingebauten Testzugang sogar nur zwei.
Voraussetzungen
| Voraussetzung | Details |
|---|---|
| merchantCENTRAL Hub | Die App „AD merchantCENTRAL" muss installiert und eingerichtet sein — der DPD-AT-Assistent leitet Sie andernfalls zuerst zur Hub-Einrichtung |
| HttpClient-Berechtigung | In der Erweiterungsverwaltung muss für den Connector „HttpClient-Anforderungen zulassen" aktiviert sein |
| DPD-AT-Zugangsdaten | Benutzername, Mandant und MD5-Passwort von der IT-Kundenberatung — oder Sie starten mit dem Testzugang |
Was ist das MD5-Passwort?
DPD AT authentifiziert Anfragen nicht mit Ihrem Klartext-Passwort, sondern mit dessen MD5-Hash (32 Zeichen, z. B. e51524d2…). Genau diesen Wert erhalten Sie zusammen mit Ihren Zugangsdaten von der IT-Kundenberatung. Der Connector speichert ausschließlich diesen Hash — verschlüsselt im merchantCENTRAL Credential Store, niemals in Tabellenfeldern.
Der Einrichtungsassistent
Öffnen Sie die Suche (++alt+q++) → Unterstützte Einrichtung → merchantCENTRAL: DPD Austria einrichten. Alternativ: DPD Austria Dashboard → Aktion Einrichtungsassistent.
Schritt 1 — Willkommen
Überblick über die Voraussetzungen. Halten Sie Ihre Zugangsdaten bereit und klicken Sie auf Weiter.
Schritt 2 — Authentifizierung
| Feld | Eingabe |
|---|---|
| Testzugang verwenden | Nur für Tests — befüllt alle Zugangsdaten automatisch (siehe unten) |
| Benutzername | Ihr 9-stelliger DPD-AT-Benutzername |
| Mandant | Ihre Mandantennummer (meist 1) |
| MD5-Passwort | Klicken Sie auf das Feld und geben Sie den 32-stelligen MD5-Wert ein — die Anzeige wechselt auf Configured |
| API-Basis-URL | Vorbelegt mit dem WEB.Service-Endpunkt — nur auf Anweisung ändern |
Schritt 3 — Verbindungstest
Klicken Sie auf Verbindung testen. Der Connector ruft die getStatus-Funktion des WEB.Service auf und zeigt die Statusliste aller DPD-AT-Dienste:
Verbindung erfolgreich! DPD AT Servicestatus:
WEB.Service: Im Betrieb
Return.Paketomat: Im Betrieb
…
Schlägt der Test fehl, prüfen Sie Benutzername, Mandant und MD5-Passwort — siehe Fehlerbehebung.
Schritt 4 — Absenderadresse (optional)
In der Regel leer lassen
DPD AT druckt standardmäßig die in Ihrem DPD-Konto hinterlegte Absenderadresse auf das Label. Füllen Sie diese Felder nur, wenn auf dem Label bewusst eine abweichende Adresse erscheinen soll. Die Aktion Aus Firmendaten übernehmen befüllt die Felder aus der Firmeninformation.
Schritt 5 — Standardeinstellungen
| Feld | Empfehlung |
|---|---|
| Standard-Pakettyp | DPD (B2B) für Geschäftskunden-, B2C für Endkundenversand |
| Standardprodukt | Automatisch (nach Gewicht) — wählt bis 3 kg Kleinpaket, darüber Normalpaket |
| Standard-Ausgabeformat | PDF für Laserdrucker, ZPL für Zebra-Thermodrucker |
| Standardgewicht (g) | Wird verwendet, wenn die Sendung kein Gewicht mitbringt |
Alle weiteren Einstellungen (Retouren-Optionen, Sammeldruck, Selbstbucherliste) erreichen Sie später über die Einrichtungsseite.
Schritt 6 — Abschluss
Klicken Sie auf Fertigstellen. Die Einstellungen werden gespeichert und der Anbieterstatus im Hub aktualisiert sich automatisch.
Anbieter aktivieren & Lizenz
- Öffnen Sie Versandanbieter (Hub) — DPD Austria erscheint dort als DPDAT
- Öffnen Sie die Karte und schalten Sie Aktiviert ein
- Ohne Lizenz startet die Aktivierung den Demo-Zeitraum — den Lizenzstatus sehen Sie in der Lizenz-Infobox der Karte, dort finden Sie auch Demo registrieren und Lizenz aktualisieren
Option: Testzugang
Für Tests ohne eigene Zugangsdaten aktivieren Sie in Schritt 2 den Schalter Testzugang verwenden:
- Benutzername, Mandant und MD5-Passwort des öffentlichen DPD-AT-Integrationstestzugangs werden automatisch eingetragen
- Das Dashboard zeigt dauerhaft den Hinweis „TESTZUGANG AKTIV"
Regeln für den Testzugang
Der Testzugang erstellt Labels auf dem echten Testsystem von DPD AT. Verwenden Sie deshalb ausschließlich fiktive Empfängerdaten (z. B. „Testfirma Mustermann, Teststraße 1, 1090 Wien") — das ist eine Vorgabe von DPD Austria. Lassen Sie außerdem den Schalter Manifest führt Tagesabschluss durch ausgeschaltet und stornieren Sie Testlabels nach Möglichkeit wieder. Für den Produktivbetrieb schalten Sie den Testzugang aus und hinterlegen Ihre eigenen Zugangsdaten.