# DHL

Mit dem DHL-Plugin erstellen Sie DHL-Versandlabels direkt in der Bestellung – mit einem Klick. Empfänger, Absender, Gewicht und Versandprodukt kommen automatisch aus der Bestellung und Ihren Einstellungen. Die Sendungsnummer landet an der Bestellung, der Kunde bekommt die Versandbestätigung mit Link zur Sendungsverfolgung. DHL ist ein **Premium-Plugin**: je nach Tarif enthalten oder einzeln bzw. im Paket freischaltbar (siehe [Plugins verwalten](doc:plugins-verwalten)).

## Welche Verbindung passt zu Ihnen?

Beim Einrichten fragt Plazello nur eines: **Haben Sie einen DHL-Geschäftskundenvertrag?**

| | DHL Online-Frankierung | DHL-Geschäftskonto |
|---|---|---|
| Für wen | kleinere Shops ohne Vertrag | Shops mit DHL-Geschäftskundenvertrag |
| Einrichtung | nichts einzutragen | Systembenutzer + Abrechnungsnummern |
| Bezahlen | jedes Label direkt bei DHL (PayPal, Karte …) | über Ihre monatliche DHL-Rechnung |
| Label erstellen | ein Klick → DHL-Kasse → Label kommt automatisch | ein Klick, Label sofort da |
| Preise | aktuelle DHL-Preisliste (wird angezeigt) | Ihre Vertragskonditionen |
| Stornieren | im DHL-Kundenkonto (Erstattung binnen 14 Tagen) | direkt in Plazello, bis zum Tagesabschluss |

Ohne Vertrag ist **Online-Frankierung** richtig. DHL erlaubt dabei keine automatische Zahlung über die Schnittstelle: Jedes Label wird in DHLs eigener Kasse bezahlt.

## DHL Online-Frankierung (ohne Vertrag)

1. **Einstellungen → Versand → Versanddienstleister → DHL → Einrichten**
2. **„Nein – DHL Online-Frankierung nutzen“** wählen. Fertig.

Ein Label erstellen Sie in der Bestellung unter **Sendungen** mit **Versandlabel erstellen (DHL)**:

- Plazello wählt das günstigste passende DHL-Produkt für Gewicht und Ziel (oder Ihr Standardprodukt) und öffnet die **DHL-Kasse in einem neuen Tab**.
- Sie bezahlen dort wie gewohnt.
- Die Plazello-Seite wartet und erkennt die Zahlung von selbst. Dann holt sie das Label (PDF) und einen **QR-Code** ab und markiert die Bestellung als versendet. Mit dem QR-Code druckt die Filiale oder Packstation das Label für Sie.
- Schließen Sie die Seite vorher, ist das kein Problem: Bezahlte Labels werden im Hintergrund abgeholt.

## DHL-Geschäftskonto (mit Vertrag)

Plazello nutzt die offizielle DHL-Schnittstelle für Geschäftskunden. Einmalig brauchen Sie:

1. **Systembenutzer:** Legen Sie im DHL-Geschäftskundenportal unter Benutzerverwaltung einen *Systembenutzer* an. Er kann sich nicht ins Portal einloggen und ist nur für Shop-Anbindungen gedacht.
2. **EKP:** Ihre 10-stellige Kundennummer – die ersten 10 Ziffern Ihrer Abrechnungsnummern.
3. **Abrechnungsnummern:** Tragen Sie je Produkt die letzten zwei Stellen der Abrechnungsnummer ein (die *Teilnahme*, meist „01“). Sie finden sie im Geschäftskundenportal unter Vertragsdaten. DHL bietet keine Abfrage dafür an. Produkte ohne Eintrag werden nicht angeboten.
4. **Speichern und Verbindung testen.** Plazello meldet sich bei DHL an und prüft jedes Produkt mit einem Probelauf, ohne ein Label zu kaufen. Jedes Produkt zeigt danach **freigeschaltet** oder den Grund, warum nicht (z. B. „nicht in Ihrem Vertrag“ oder „Abrechnungsnummer ungültig“).

Optional:
- **DHL Retoure** (Verfahren 07): Mit dieser Teilnahme kann jedem Paket ein Retourenlabel beiliegen.
- **Labelformat**: z. B. A4 oder 910-300-700 für Etikettendrucker.

Zum Ausprobieren ohne Vertrag gibt es im Testmodus **„Mit dem DHL-Testzugang ausprobieren“**. Plazello nutzt dann DHLs öffentlichen Sandbox-Zugang, und die Labels sind kostenlose Muster.

Passwort und Benutzername werden verschlüsselt gespeichert und nie wieder angezeigt. **Trennen** löscht sie, bereits erstellte Labels bleiben erhalten. Hat DHL das Passwort abgelaufen (Systembenutzer: alle 365 Tage), tragen Sie einfach ein neues ein.

## Voreinstellungen

Unter **Voreinstellungen für Labels** legen Sie fest, was bei einem Klick gilt:

- **Standardprodukt** (sonst automatisch passend zu Gewicht und Ziel)
- **Standardgewicht**, wenn Ihre Produkte kein Gewicht haben, und ein **Verpackungsgewicht**, das zu den Artikelgewichten addiert wird
- **Absender**: standardmäßig die Adresse aus Einstellungen → Rechtliches, auf Wunsch eine andere
- ob **E-Mail-Adresse** und **Telefonnummer** des Kunden an DHL gehen (für Paketankündigung und Wunschzustellung). E-Mail ist voreingestellt, Telefon nicht. DHL steht automatisch als Empfänger in Ihrer Datenschutzerklärung.

## In der Bestellung

- **Versandlabel erstellen (DHL)** erstellt das Label mit einem Klick.
- **Anpassen …** öffnet das Formular. Dort ändern Sie Produkt, Zusatzservices (Wunschnachbar, Wunschablageort, Alterssichtprüfung, Transportversicherung, Sperrgut, Retourenlabel …), Adressen, Gewicht, Maße und die Artikel im Paket. Fehler von DHL stehen direkt am betroffenen Feld, z. B. „Die Postleitzahl ist ungültig“.
- **Label**, **Retourenlabel**, **QR-Code** und **Zolldokument** lassen sich jederzeit wieder herunterladen.
- **Status aktualisieren** zeigt den aktuellen DHL-Status. Er wird außerdem alle paar Stunden automatisch abgefragt.
- **Stornieren** (Geschäftskonto) storniert das Label bei DHL, solange der Tagesabschluss noch nicht gelaufen ist. **Neu erstellen** ersetzt es, und die neue Sendungsnummer steht dann an der Bestellung.
- Sendungen außerhalb der EU (Paket International, Warenpost International) bekommen die Zolldaten automatisch aus der Bestellung.

## Testmodus

Unter **Umgebung** schalten Sie zwischen **Live** und **Testmodus (DHL-Sandbox)** um. Testmodus-Labels sind Muster ohne Kosten und an der Bestellung als **Test** markiert. Live- und Test-Zugang sind getrennt: Im Testmodus geht nichts an DHLs Live-System.