# DHL-Versand einrichten<no value>

## Voraussetzung

- DHL Geschäftskundenvertrag (Paket DE)
- API-Zugangsdaten vom DHL Geschäftskundenportal
- VinoPro mit freigeschaltetem DHL-Modul

## Einrichtung

### 1. DHL API-Zugangsdaten beantragen

1. Im [DHL Geschäftskundenportal](https://geschaeftskunden.dhl.de) anmelden
2. Unter *Versenden → API-Zugang* die Zugangsdaten beantragen
3. Folgende Daten erhalten Sie:
   - **Benutzername** (API-User)
   - **Passwort** (API-Passwort)
   - **EKP-Nummer** (Kundennummer)

### 2. In VinoPro eintragen

1. *Verwaltung → DHL-Schnittstelle* öffnen
2. API-Benutzername und -Passwort eintragen
3. EKP-Nummer hinterlegen
4. Absenderadresse prüfen (wird auf dem Label gedruckt)

### 3. Verbindung testen

- Button *Verbindung testen* klicken
- Bei Erfolg erscheint eine Bestätigungsmeldung

## Labels erstellen

1. Auftrag öffnen → *Versand → DHL-Label erstellen*
2. Paketdaten prüfen (Gewicht, Maße — optional)
3. Label wird erstellt und gedruckt
4. Sendungsnummer wird automatisch am Auftrag gespeichert

## Druckoptionen

| Option | Beschreibung |
|--------|-------------|
| Labeldrucker | Direktdruck auf Thermodrucker (10×15 cm) |
| DIN A4 | Label auf A4-Papier drucken und aufkleben |

## Sendungsverfolgung

Nach der Label-Erstellung wird die Sendungsnummer am Auftrag hinterlegt. Über den Tracking-Link können Sie (und Ihre Kunden) den Sendungsstatus jederzeit prüfen.

## Fehlerbehebung

| Problem | Lösung |
|---------|--------|
| Authentifizierung fehlgeschlagen | API-Benutzername und Passwort prüfen |
| EKP ungültig | Nummer im Geschäftskundenportal verifizieren |
| Label-Druck fehlerhaft | Druckereinstellungen und Papierformat prüfen |
| Adresse ungültig | Empfängeradresse auf Vollständigkeit prüfen (PLZ, Ort) |

{{< callout context="note" title="Hinweis" >}}
Die DHL-API unterstützt ausschließlich Paketsendungen innerhalb Deutschlands und ins EU-Ausland. Für Sperrgut oder internationale Sendungen gelten ggf. Sonderregeln.
{{< /callout >}}