So verbinden Sie DHL24 mit easySales: eine vollständige Einrichtungsanleitung
Verbinden Sie DHL24 (DHL eCommerce Polen) mit easySales: WebAPI-Schlüssel und Kundennummer, Dienste, Nachnahme mit Versicherung, DHL-Punkte und die Meldungen, die DHL zurückgibt.
Was Ihnen die Verbindung mit DHL24 bringt
DHL24 ist der Paketdienst von DHL eCommerce in Polen, für Sendungen innerhalb Polens und in andere europäische Länder. Mit easySales verbunden, erstellt DHL24 das Etikett einer Bestellung aus der Bestellliste oder auf der Bestellseite, hinterlegt die Sendungsnummer von DHL an der Bestellung und übermittelt sie an den Marktplatz oder Shop, aus dem die Bestellung stammt.
DHL24 ist nicht DHL Express: DHL Express ist eine eigene Integration in easySales, mit eigener Karte.
Zwei Dinge sollten Sie vorab wissen:
- easySales verbindet sich mit einem DHL24-WebAPI-Schlüssel, nicht mit Ihrem Login für dhl24.com.pl. DHL stellt den WebAPI-Schlüssel und das zugehörige Passwort auf Anfrage aus. Außerdem benötigen Sie Ihre DHL-Kundennummer (SAP), die 7 Stellen hat.
- Eine Verbindung versendet mit einem DHL-Dienst. Jede Verbindung hat genau einen Wert unter Versanddienste, und er muss zur Bestellung passen — ein Inlandsdienst (innerhalb Polens) stellt nicht ins Ausland zu, und ein Paket an einen DHL-Punkt braucht den Punkt-Dienst. Legen Sie für jeden Dienst, den Sie nutzen, eine eigene Verbindung an.
Bevor Sie beginnen
Ein Vertrag mit DHL eCommerce Polen
Mit Ihrer 7-stelligen DHL-Kundennummer (SAP).
Zugang zur DHL24 WebAPI
Ein WebAPI-Schlüssel und ein Passwort, die DHL auf Anfrage ausstellt.
Eine Abholadresse in Polen
Die Adresse, an der DHL Ihre Pakete abholt.
Schritt 1 — WebAPI-Zugang bei DHL beantragen
- Beantragen Sie bei DHL eCommerce den Zugang zur DHL24 WebAPI über das Kontaktformular von DHL und wählen Sie die Kategorie WebAPI - uzyskanie dostępu (WebAPI – Zugang erhalten).
- DHL sendet Ihnen einen WebAPI-Schlüssel und das zugehörige Passwort. Benutzername und Passwort Ihres dhl24.com.pl-Kontos funktionieren hier nicht.
- Halten Sie Ihre DHL-Kundennummer (SAP) bereit: die 7-stellige Nummer Ihres Vertrags mit DHL.
Schritt 2 — DHL24 in easySales verbinden
Gehen Sie zu Integrationen → Kuriere, suchen Sie nach dhl24 und klicken Sie auf der DHL24-Karte auf Verbinden — oder auf Bearbeiten, wenn Sie DHL24 bereits verbunden haben.
Füllen Sie die Verbindungsdaten aus:
| Feld | Was Sie eintragen |
|---|---|
| Verbindungsname |
Ein Name, an dem Sie die Verbindung bei der Auswahl erkennen, zum Beispiel DHL24 Warsaw.
|
| API-Schlüssel | Der WebAPI-Schlüssel von DHL. |
| API-Passwort | Das WebAPI-Passwort von DHL. |
| DHL-Kundenkontonummer | Ihre 7-stellige DHL-Kundennummer (SAP). Sie ist der Zahler jedes Etiketts dieser Verbindung. |
Schritt 3 — Paket, Dienste und Absender
| Feld | Wozu es dient |
|---|---|
| Paketgröße | Was Sie üblicherweise versenden: Umschlag, Paket oder Palette. Die meisten Händler wählen Parcel. |
| Zusatzleistungen | Werden jedem Etikett dieser Verbindung hinzugefügt: Evening Delivery, Saturday Delivery, Saturday Shipment (Abholung am Samstag) und Insurance. Wählen Sie nur, was Ihr Vertrag mit DHL umfasst. |
| Versanddienste | Der DHL-Dienst jedes Etiketts dieser Verbindung — siehe die Liste unten. |
| AWB-Format | A4 für einen Bürodrucker, A6 für einen Etikettendrucker. |
| Versicherungswährung | Die Währung des Versicherungswerts, standardmäßig PLN. Der Versicherungswert ist die Bestellsumme. |
Die Dienste, die Sie unter Versanddienste wählen können:
| Dienst | Wofür Sie ihn nutzen |
|---|---|
| Domestic shipment | Standardzustellung innerhalb Polens. |
| Premium shipment | Die Premium-Zustellung von DHL innerhalb Polens. |
| Domestic 09 / Domestic 12 | Zustellung innerhalb Polens bis 9:00 / bis 12:00. |
| Evening delivery shipment | Abendzustellung innerhalb Polens. |
| Shipment delivered to point | Zustellung an einen Punkt DHL POP oder DHL BOX 24/7. |
| Connect shipment | Zustellung auf dem Straßenweg in andere europäische Länder. |
| Connect Plus shipment / Connect Plus Pallet shipment | Der Dienst Connect Plus von DHL für Pakete / für Paletten. |
| International shipment | Der internationale Paketdienst von DHL. |
Der Absender ist die Adresse, an der DHL Ihre Pakete abholt:
| Feld | Was Sie eintragen |
|---|---|
| Kontaktname | Die Person, die DHL an der Abholadresse kontaktiert. |
| Kontakttelefon | Deren Telefonnummer. |
| Adresse, Stadt, Postleitzahl | Die Abholadresse in Polen. |
Klicken Sie auf Speichern. Ein falscher WebAPI-Schlüssel oder ein falsches Passwort zeigt sich erst beim ersten Etikett: DHL lehnt es mit Nieprawidlowe dane autoryzacyjne ab.
Für einen anderen Dienst oder eine andere Abholadresse öffnen Sie die Verbindung und klicken Sie auf Klonen; geben Sie der Kopie dann einen eigenen Namen und ändern Sie, was abweicht.
Etiketten erstellen
- Die Schnellerstellung aus der Bestellliste verwendet alles, was in der Verbindung gespeichert ist. Das Gewicht ist das Gewicht der Produkte der Bestellung, aufgeteilt auf die Pakete.
- Auf der Bestellseite können Sie vor dem Erstellen des Etiketts das Gewicht, die Anzahl der Pakete und Umschläge, ihre Größen, den Nachnahmebetrag, den Versicherungswert und die Zusatzleistungen ändern.
Nachnahme wird hinzugefügt, wenn die Bestellung bei Lieferung bezahlt wird; der Betrag ist die Bestellsumme.
Wenn ein Etikett abgelehnt wird
Die Antwort von DHL wird an der Bestellung angezeigt, auf Polnisch. Am häufigsten sehen Sie:
| Meldung | Was zu tun ist |
|---|---|
| Nieprawidlowe dane autoryzacyjne | API-Schlüssel oder API-Passwort ist falsch — oft wurde statt des WebAPI-Schlüssels der Login für dhl24.com.pl eingetragen. Tragen Sie in der Verbindung die WebAPI-Daten von DHL ein und speichern Sie. |
| Błędy walidacji przesyłki: Usługa niedostępna dla danego kraju. | Der Dienst der Verbindung stellt nicht in das Land der Bestellung zu. Erstellen Sie das Etikett mit einer Verbindung, die einen internationalen Dienst nutzt, etwa Connect shipment oder International shipment. |
| Błędy walidacji przesyłki: Przy zwrocie pobrania wymagane jest ubezpieczenie przesyłki. | Ein Nachnahmepaket muss versichert sein. Wählen Sie in der Verbindung unter Zusatzleistungen die Option Insurance und erstellen Sie das Etikett erneut. |
| Błędy walidacji przesyłki: Podany numer punktu serwisowego jest błędny bądź niedostępny dla zadanych usług | Der DHL-Punkt der Bestellung ist falsch oder nimmt diesen Dienst nicht an. Wählen Sie auf der Bestellseite einen anderen Punkt und erstellen Sie das Etikett mit einer Verbindung Shipment delivered to point. |
| Błędy walidacji przesyłki: Zawartość pola Preawiz Odb Nr Tel musi być liczbą. | Die Telefonnummer des Kunden enthält andere Zeichen als Ziffern. Korrigieren Sie sie an der Bestellung, nur mit Ziffern. |
| Błędy walidacji przesyłki: Wartość w polu Telefon jest za krótka (minimalna liczba znaków to 8). | Die Telefonnummer des Kunden ist zu kurz. Korrigieren Sie sie an der Bestellung. |
| Błędy walidacji przesyłki: Niepoprawny kod pocztowy dla wybranego kraju. | Die Postleitzahl existiert im Lieferland nicht. Korrigieren Sie sie in der Lieferadresse der Bestellung. |