Zum Inhalt

Ersteinrichtung

Diese Anleitung führt Sie von der Installation bis zum ersten Testetikett. 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 ab Version 2.114 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-Anfragen 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 Konfiguriert
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 Etikett. Füllen Sie diese Felder nur, wenn auf dem Etikett bewusst eine abweichende Adresse erscheinen soll. Die Aktion Aus Mandant laden 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
Standard Predict aktiviert Bucht die Predict-Benachrichtigung für neue Etiketten mit — wirkt nur, wenn die Kontaktdaten-Regel die E-Mail-Adresse freigibt

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

  1. Öffnen Sie Versanddienstleister (Hub) — DPD Austria erscheint dort als DPDAT
  2. Öffnen Sie die Karte und schalten Sie Aktiviert ein
  3. 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 Etiketten 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 erstellt Sammelliste ausgeschaltet und stornieren Sie Testetiketten nach Möglichkeit wieder. Für den Produktivbetrieb schalten Sie den Testzugang aus und hinterlegen Ihre eigenen Zugangsdaten.

Noch ein Schritt nach dem Assistenten

Der Assistent deckt die DPD-AT-Einstellungen ab, nicht die Kontaktdaten-Regel des Hubs. Öffnen Sie danach die Versanddienstleister-Karte und entscheiden Sie Empfänger-E-Mail an Versanddienstleister und Empfänger-Telefon an Versanddienstleister — beide sind mit Nie vorbelegt. Ohne diese Entscheidung bleiben Predict und die telefonpflichtigen Sendungen wirkungslos. Siehe Kontaktdaten des Empfängers.

Nächste Schritte