Wie richte ich DHL ein, damit PARITY.med meine Versandlabels erzeugt?

Wie richte ich DHL ein, damit PARITY.med meine Versandlabels erzeugt?

Schritt für Schritt

1. Versandarten öffnen — im Suite-Portal unter Einstellungen → Versandarten und rechts oben auf „Versandart anlegen" klicken.
2. DHL wählen — einen Anzeigenamen vergeben (z. B. „DHL Paket"), als Dienstleister „DHL" auswählen und Aktiv eingeschaltet lassen.
3. Vertragsdaten eintragen — Abrechnungsnummer (EKP), Produkt (für DHL Paket innerhalb Deutschlands V01PAK) und ein Standard-Paketgewicht in kg.
4. Zugangsdaten eintragen — Client-ID (API-Key) und Client-Secret aus dem DHL-Entwicklerportal sowie Geschäftskunden-Login und Passwort aus dem DHL-Geschäftskundenportal.
5. Absender eintragen — Name, Straße, PLZ, Ort und Land Deines Betriebs. Diese Anschrift steht als Absender auf jedem Label.
6. Speichern und Verbindung testen — auf „Speichern" klicken, die Versandart im Katalog über das Stift-Symbol erneut öffnen und „Verbindung testen" wählen. Der Test prüft die Zugangsdaten bei DHL, ohne eine Sendung zu erzeugen.
7. Label am Lieferschein erstellen — im Lieferschein über das Menü „…" → „Versandlabel erstellen". PARITY.med holt das Label bei DHL ab und übernimmt die Sendungsnummer.

Die Einrichtung machst Du einmal. Danach ist jedes DHL-Label zwei Klicks am Lieferschein entfernt — ohne Abtippen der Empfängeranschrift im DHL-Portal.

Überblick

Die DHL-Anbindung ist in der Modul-Lizenz Handel enthalten. Sie nutzt die DHL Parcel DE Shipping API (Geschäftskundenversand von Post & Paket Deutschland): PARITY.med schickt Empfänger, Absender, Gewicht und Lieferscheinnummer an DHL und bekommt das fertige Label als PDF und die Sendungsnummer zurück.

Das lohnt sich schon bei wenigen Paketen pro Woche. Du sparst das doppelte Erfassen der Anschrift im DHL-Portal, und die Sendungsnummer landet automatisch am Lieferschein und — wenn der Kunde eine E-Mail-Adresse hat — in seiner Versandbenachrichtigung.

Neben DHL stehen im selben Katalog weitere Versanddienstleister zur Auswahl (unter anderem GLS, DPD, UPS und trans-o-flex) sowie „Manueller Versand" für Sendungen ohne automatisches Label.

Voraussetzungen

• In PARITY.med: das Recht „Modul-Lizenzen des Mandanten verwalten" — standardmäßig in der Rolle „Administrator". Ohne dieses Recht erscheint „Versandarten" nicht in den Einstellungen, und Du kannst die Seite weder öffnen noch bearbeiten.
• Bei DHL: ein DHL-Geschäftskundenkonto mit Abrechnungsnummer (EKP) und Zugang zum Geschäftskundenportal.
• Im DHL-Entwicklerportal (developer.dhl.com): eine App, für die die API „Parcel DE Shipping" freigeschaltet ist. Aus dieser App stammen Client-ID und Client-Secret. Die Freischaltung für den Echtbetrieb prüft DHL laut eigener API-Dokumentation manuell — plane dafür etwas Vorlauf ein.
• Für jedes Label: eine vollständige Lieferanschrift des Kunden (Straße, PLZ, Ort).

Wo lege ich die DHL-Versandart an?

Unter Einstellungen → Versandarten. Die Seite zeigt oben die Karte „Label-Format" und darunter den Katalog aller Versandarten Deines Mandanten. Neue Einträge legst Du über „Versandart anlegen" rechts oben an.

Die Reihenfolge im Katalog bestimmt die Vorauswahl: Beim Erstellen eines Labels ist die oberste aktive Versandart vorbelegt. Mit den Pfeilen links verschiebst Du einen Eintrag nach oben oder unten. Die Spalte „Zugangsdaten" zeigt „Konfiguriert", sobald die DHL-Daten gespeichert sind.

Welche Angaben braucht die DHL-Versandart?

Nach der Auswahl „DHL" als Dienstleister erscheint im Dialog der Bereich „DHL-Zugangsdaten":

Client-Secret und Passwort zeigt PARITY.med nach dem Speichern nie wieder an. Die Zugangsdaten gelten für alle DHL-Versandarten Deines Mandanten. Willst Du sie ändern, gibst Du alle vier Zugangswerte (Client-ID, Client-Secret, Login, Passwort) erneut ein.

Wie prüfe ich, ob die Zugangsdaten stimmen?

Mit „Verbindung testen" im Bereich „DHL-Zugangsdaten". Der Test meldet sich mit den gespeicherten Daten bei DHL an und lässt eine Probesendung nur prüfen, nicht anlegen. So siehst Du in einem Schritt, ob die Anmeldung klappt und ob Deine App für die Versand-API freigeschaltet ist. Das Ergebnis nennt auch die geprüfte Umgebung (Sandbox oder Produktion).

Der Test arbeitet mit den gespeicherten Werten. Hast Du etwas geändert, speichere zuerst — sonst weist der Button darauf hin.

Wie erstelle ich ein DHL-Label am Lieferschein?

Öffne den Lieferschein und klicke rechts oben auf das Menü „…". Unter „Erzeugen" findest Du „Versandlabel erstellen":

Im folgenden Dialog wählst Du die Versandart (vorbelegt ist die oberste aktive) und klickst auf „Label erstellen". Danach passiert Folgendes:

• PARITY.med erzeugt die Sendung bei DHL und speichert das Label am Lieferschein.
• Die Sendungsnummer und der Link zur DHL-Sendungsverfolgung werden übernommen.
• Über „Versandlabel anzeigen" im selben Menü druckst Du das Label oder lädst es herunter.
• Bei „Als versendet markieren" sind Sendungsnummer und Link schon eingetragen. Ist beim Kunden eine E-Mail-Adresse hinterlegt, bekommt er eine Versandbenachrichtigung mit der Sendungsnummer.

Pro Lieferschein gibt es genau ein Label. Ein zweites lehnt PARITY.med ab, damit keine doppelte Sendung bei DHL entsteht.

Wie berechnet PARITY.med das Paketgewicht?

Aus den Artikeln: Gewicht je Artikel × Menge, über alle Positionen des Lieferscheins summiert. Ist an den Artikeln kein Gewicht gepflegt, nimmt PARITY.med das Standard-Paketgewicht aus der Versandart.

DHL Paket erlaubt höchstens 31,5 kg je Packstück. Ist der Lieferschein schwerer, meldet PARITY.med das vor dem Aufruf bei DHL — teile die Sendung dann auf mehrere Pakete auf (je Paket ein eigener Lieferschein).

FAQ

F: Kostet die DHL-Anbindung extra?

A: Nein, die Anbindung ist in der Modul-Lizenz Handel enthalten. Das Porto rechnet DHL wie bisher über Deinen Geschäftskundenvertrag ab.

F: Kann ich die Anbindung erst einmal ausprobieren?

A: Ja. Schalte „Sandbox (Test)" ein und trag die Testzugangsdaten aus dem DHL-Entwicklerportal ein. Labels aus der Sandbox sind keine gültigen Paketmarken. Für den Echtbetrieb schaltest Du die Sandbox aus und trägst Deine echten Zugangsdaten ein.

F: In welchem Format kommt das Label?

A: DHL liefert PDF. Ob PARITY.med Labels als PDF, ZPL oder im Originalformat ablegt, stellst Du einmal für alle Versandarten in der Karte „Label-Format" ein. Details: Wie stelle ich das Ausgabeformat für Versandlabels ein?

F: Warum meldet „Verbindung testen" einen Fehler, obwohl die Daten stimmen?

A: Häufige Ursachen: Die App im DHL-Entwicklerportal ist (noch) nicht für die Versand-API im Echtbetrieb freigeschaltet, der Sandbox-Schalter passt nicht zu den Zugangsdaten (Testdaten gegen Produktion oder umgekehrt), oder Du hast nach einer Änderung nicht gespeichert. Die Meldung nennt den Grund von DHL in Klartext.

F: Kann ich mit DHL ins Ausland versenden?

A: Das Produkt V01PAK gilt für Sendungen innerhalb Deutschlands. Für Auslandssendungen brauchst Du das passende DHL-Produkt aus Deinem Vertrag; frag dazu Deinen DHL-Ansprechpartner.

F: Was passiert, wenn DHL das Label ablehnt?

A: Dann legt PARITY.med nichts an und zeigt die Begründung von DHL als Hinweis — zum Beispiel eine unvollständige Lieferanschrift. Korrigiere die Angabe und erstelle das Label erneut.

Verwandte Themen

• Wie stelle ich das Ausgabeformat für Versandlabels ein? — PDF, ZPL oder Originalformat für alle Versandarten
• Wie liefere ich einen Auftrag aus und erstelle einen Lieferschein? — der Lieferschein, an dem das Label entsteht
• Wie hinterlege ich wiederkehrende Versandkosten? — Versandkosten im Beleg vorbelegen

Letzte Aktualisierung: 2026-10-04