DHL Express API
Globe Pickup Points integriert sich über die MyDHL API mit DHL Express und ermöglicht weltweiten Expressversand direkt aus Shopify. Mit dieser Integration können Sie:
- Bestellungen an DHL Express exportieren und sofort eine Sendungsnummer erhalten
- Versandlabels direkt in Shopify drucken
- An die Adresse des Kunden oder an einen DHL Express Service Point liefern
- Vollständige Zolldaten (HS-Codes, DDP- oder DAP-Bedingungen) bei internationalen Sendungen übermitteln
DHL Express wird auf Anfrage pro Shop freigeschaltet. Wenn Sie den Spediteur beim Hinzufügen eines neuen Spediteurkontos nicht sehen, kontaktieren Sie den Support, und wir aktivieren ihn für Ihren Shop.
DHL Express API-Integration aktivieren
Abschnitt betitelt „DHL Express API-Integration aktivieren“- Öffnen Sie in Ihrer Shopify-Verwaltung Globe Pickup Points und navigieren Sie zu Versandetiketten. Fügen Sie ein neues Spediteurkonto hinzu und wählen Sie DHL Express.
- Wählen Sie die Umgebung — Produktion für Live-Sendungen oder Entwicklung (Test) für die MyDHL-Testumgebung. Test- und Produktivzugangsdaten sind unterschiedlich.
- Geben Sie Benutzername und Passwort ein — Ihre DHL Express API-Zugangsdaten aus dem DHL Developer Portal oder von Ihrem DHL-Kundenbetreuer.
- Tragen Sie Ihre Kontonummer ein — das DHL Express-Konto, über das die Sendungen abgerechnet werden.
- Füllen Sie die Absenderdaten aus, die auf jedem Label als Versender erscheinen: Name des Absenders, Absenderadresse (Straße und Hausnummer), Stadt des Absenders, PLZ des Absenders, Land des Absenders, Telefon des Absenders und E-Mail des Absenders. In der Länderliste werden nur die von dieser Integration unterstützten Länder angeboten.
- Tragen Sie eine Standardbeschreibung des Sendungsinhalts ein — eine kurze Beschreibung des Sendungsinhalts für den Zoll (zum Beispiel
GoodsoderClothing). Diese Angabe ist Pflicht: Eine Bestellung ohne Beschreibung — weder als Standardwert noch pro Bestellung — wird nicht exportiert. - Optional können Sie unter den erweiterten Einstellungen einen Standard-HS-Code und ein Standardgewicht (kg) festlegen, die verwendet werden, wenn die Produkte keine eigenen Werte haben.
- Konfigurieren Sie nach Bedarf Bestellungen automatisch erfüllen, Bestellungen automatisch mit Sendungsverfolgungsnummer markieren und Benutzerdefiniertes Tag nach dem Export.
- Ordnen Sie Ihre Shopify-Versandmethoden den DHL Express-Services zu, die für Ihr Konto freigeschaltet sind.
Bestellungen exportieren und Labels drucken
Abschnitt betitelt „Bestellungen exportieren und Labels drucken“Sie können Bestellungen direkt aus Shopify an DHL Express exportieren und Versandlabels drucken — einzeln oder im Stapel. Den allgemeinen Workflow finden Sie unter Versandlabels erstellen.
Jede Bestellung wird als ein einzelnes Paket übermittelt. DHL liefert die Sendungsnummer und das Label-PDF in derselben Antwort, sodass die Labels unmittelbar nach dem Export druckbereit sind. Ist Bestellungen automatisch erfüllen aktiviert, wird das Fulfillment mit der Sendungsnummer und einem Link zur DHL-Sendungsverfolgung angelegt.
Eines leistet diese Integration nicht: Es wird keine Kurierabholung beauftragt. Sendungen werden ohne Abholanfrage erstellt — vereinbaren Sie die Abholung wie gewohnt mit DHL.
Servicetypen
Abschnitt betitelt „Servicetypen“| Service | Beschreibung |
|---|---|
| DHL Express Worldwide | Standard-Expresszustellung von Tür zu Tür |
| DHL Express Worldwide – Service Point (D2SVP) | Zustellung an einen DHL Express Service Point |
| DHL Express 12:00 | Termingarantierte Zustellung bis 12:00 |
| DHL Express 10:30 | Termingarantierte Zustellung bis 10:30 |
| DHL Express 9:00 | Termingarantierte Zustellung bis 09:00 |
| DHL Economy Select | Economy-Service |
Globe wählt anhand des von Ihnen gewählten Service den DHL-Produktcode, der zur Relation passt — inländisch, innereuropäisch oder weltweit. Der Service muss trotzdem für Ihr DHL-Konto aktiv sein; DHL lehnt Sendungen für Produkte ab, für die Sie keinen Vertrag haben.
Service Point vs. Heimlieferung
Abschnitt betitelt „Service Point vs. Heimlieferung“- Service Point (D2SVP) — Das Paket wird an den DHL Express Service Point zugestellt, den der Kunde im Checkout ausgewählt hat. Globe übermittelt die 6-stellige MyDHL-Facility-ID des Punktes zusammen mit dem DHL Service Point-Zusatzservice, sodass das Label die SPD-Kennzeichnung trägt. Der Service Point wird als Empfänger gesetzt und die Adresse des Kunden als Käufer übermittelt, was DHL für diesen Service verlangt.
- Heimlieferung — Alle anderen Services stellen an die Versandadresse des Kunden zu.
Ein Service-Point-Export benötigt einen echten DHL Express-Punkt aus der DHL Express-Abholpunktkarte (konfiguriert mit denselben MyDHL-Zugangsdaten — siehe Abholpunkt-Spediteure hinzufügen). Bestellungen ohne Abholpunkt oder mit einem Punkt aus dem Netz eines anderen Spediteurs werden beim Export abgelehnt.
Zoll und Abgaben
Abschnitt betitelt „Zoll und Abgaben“Sendungen, die eine Zollgrenze überschreiten — alles außer inländisch oder EU zu EU — werden mit einer vollständigen elektronischen Anmeldung exportiert, die aus den Positionen der Bestellung aufgebaut wird: Beschreibung, Menge, Stückpreis, Gewicht, HS-Code und Herstellungsland. Die HS-Codes stammen aus dem Zolltarifcode des Produkts in Shopify und greifen ersatzweise auf Ihren Standard-HS-Code zurück; das Herstellungsland stammt aus dem Ursprungsland des Produkts und greift ersatzweise auf Ihr Absenderland zurück.
Im Abschnitt Zoll & Abgaben der Einstellungen des Spediteurkontos:
| Einstellung | Wirkung |
|---|---|
| DDP-Länder | Zielländer, die zu DDP-Bedingungen versendet werden (Zölle und Steuern werden Ihnen berechnet). Für alle anderen gilt DAP. |
| Werte ohne MwSt. für Länder senden | Für die ausgewählten Zielländer wird der deklarierte Wert ohne MwSt. übermittelt. |
Pro Bestellung können Sie HS-Code und Inhaltsbeschreibung vor dem Export im Label-Dialog überschreiben.
Nachnahme (COD)
Abschnitt betitelt „Nachnahme (COD)“Nachnahme wird als Zusatzservice „Cash Collection“ an DHL übermittelt. Der Betrag entspricht dem offenen Betrag der Bestellung in der Bestellwährung und wird bar eingezogen. Nachnahme muss für Ihr DHL Express-Konto freigeschaltet und auf der Zielrelation verfügbar sein — DHL Express bietet sie nur in einer begrenzten Anzahl von Ländern an, klären Sie das also mit DHL, bevor Sie sie in Ihrem Checkout anbieten. Ist der Service nicht verfügbar, lehnt DHL die gesamte Sendung ab.
Lieferstatus
Abschnitt betitelt „Lieferstatus“Die Lieferstatus-Synchronisation ist für DHL Express nicht verfügbar — Status werden nicht nach Shopify zurückgeschrieben. Die Sendungsnummer und der Tracking-Link werden dem Fulfillment trotzdem beigefügt, sodass das Paket auf dhl.com verfolgt werden kann. Retourenlabels werden ebenfalls nicht unterstützt.
Labeldruck
Abschnitt betitelt „Labeldruck“Labels werden als PDF mit 300 DPI in den folgenden Formaten erzeugt:
| Format | Positionen pro Bogen |
|---|---|
| A6 | 1 |
| A6 auf A4 | 4 |
Beim Druck von A6 auf A4 können Sie eine Startposition auf dem Bogen wählen (Positionen 1–4), um teilweise verbrauchte Bögen weiterzuverwenden. Die Labels werden beim Export gespeichert, ein Nachdruck ruft DHL also nicht erneut auf.
Fehlerbehebung
Abschnitt betitelt „Fehlerbehebung“| Problem | Lösung |
|---|---|
| Authentifizierungsfehler | Prüfen Sie, ob Benutzername, Passwort und Kontonummer zur gewählten Umgebung passen — Testzugangsdaten funktionieren nicht in der Produktion. |
| Inhaltsbeschreibung ist erforderlich | Hinterlegen Sie eine Standardbeschreibung des Sendungsinhalts in den Einstellungen des Spediteurkontos oder füllen Sie Inhaltsbeschreibung auf der Bestellung aus. |
| Service Point: kein Abholpunkt ausgewählt | Die Bestellung nutzt den Service-Point-Service, enthält aber keinen Abholpunkt. Der Kunde hat im Checkout keinen ausgewählt. |
| Service Point: Abholpunkt muss eine 6-stellige Facility-ID sein | Der ausgewählte Punkt stammt nicht aus dem DHL Express-Netz. Der Kunde muss einen DHL Express Service Point auswählen. |
| Unbekannter Produkttyp | Die Versandmethode ist einem Service zugeordnet, den es nicht mehr gibt. Ordnen Sie die Versandmethode in den Einstellungen des Spediteurkontos neu zu. |
| Sendung von DHL abgelehnt | Die vollständige DHL-Fehlermeldung wird im Exportergebnis angezeigt — meist ein für Ihr Konto nicht freigeschaltetes Produkt, eine ungültige Postleitzahl oder eine fehlende Telefonnummer. |
| Beim Drucken wurden keine Labeldaten gefunden | Das gespeicherte Label fehlt für diese Bestellungen. Exportieren Sie die Bestellungen erneut, um neue Labels zu erzeugen. |