Zum Inhalt springen

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.


  1. Ö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.
  2. Wählen Sie die UmgebungProduktion für Live-Sendungen oder Entwicklung (Test) für die MyDHL-Testumgebung. Test- und Produktivzugangsdaten sind unterschiedlich.
  3. Geben Sie Benutzername und Passwort ein — Ihre DHL Express API-Zugangsdaten aus dem DHL Developer Portal oder von Ihrem DHL-Kundenbetreuer.
  4. Tragen Sie Ihre Kontonummer ein — das DHL Express-Konto, über das die Sendungen abgerechnet werden.
  5. 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.
  6. Tragen Sie eine Standardbeschreibung des Sendungsinhalts ein — eine kurze Beschreibung des Sendungsinhalts für den Zoll (zum Beispiel Goods oder Clothing). Diese Angabe ist Pflicht: Eine Bestellung ohne Beschreibung — weder als Standardwert noch pro Bestellung — wird nicht exportiert.
  7. 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.
  8. Konfigurieren Sie nach Bedarf Bestellungen automatisch erfüllen, Bestellungen automatisch mit Sendungsverfolgungsnummer markieren und Benutzerdefiniertes Tag nach dem Export.
  9. Ordnen Sie Ihre Shopify-Versandmethoden den DHL Express-Services zu, die für Ihr Konto freigeschaltet sind.

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.


ServiceBeschreibung
DHL Express WorldwideStandard-Expresszustellung von Tür zu Tür
DHL Express Worldwide – Service Point (D2SVP)Zustellung an einen DHL Express Service Point
DHL Express 12:00Termingarantierte Zustellung bis 12:00
DHL Express 10:30Termingarantierte Zustellung bis 10:30
DHL Express 9:00Termingarantierte Zustellung bis 09:00
DHL Economy SelectEconomy-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 (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.


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:

EinstellungWirkung
DDP-LänderZiellä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 sendenFü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 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.


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.


Labels werden als PDF mit 300 DPI in den folgenden Formaten erzeugt:

FormatPositionen pro Bogen
A61
A6 auf A44

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.


ProblemLösung
AuthentifizierungsfehlerPrüfen Sie, ob Benutzername, Passwort und Kontonummer zur gewählten Umgebung passen — Testzugangsdaten funktionieren nicht in der Produktion.
Inhaltsbeschreibung ist erforderlichHinterlegen Sie eine Standardbeschreibung des Sendungsinhalts in den Einstellungen des Spediteurkontos oder füllen Sie Inhaltsbeschreibung auf der Bestellung aus.
Service Point: kein Abholpunkt ausgewähltDie 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 seinDer ausgewählte Punkt stammt nicht aus dem DHL Express-Netz. Der Kunde muss einen DHL Express Service Point auswählen.
Unbekannter ProdukttypDie Versandmethode ist einem Service zugeordnet, den es nicht mehr gibt. Ordnen Sie die Versandmethode in den Einstellungen des Spediteurkontos neu zu.
Sendung von DHL abgelehntDie 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 gefundenDas gespeicherte Label fehlt für diese Bestellungen. Exportieren Sie die Bestellungen erneut, um neue Labels zu erzeugen.