Integracje

⌘K
  1. Strona główna
  2. Integracje
  3. Kurier – DHL
  4. Zakres integracji z DHL

Zakres integracji z DHL

Integracja xSale z DHL Parcel umożliwia przygotowanie przesyłek i pobieranie etykiet na podstawie danych zamówienia, ustawień konta kurierskiego i parametrów przesyłki. Obsługuje m.in. pobranie COD, ubezpieczenie oraz etykiety zwrotne. Nie jest to integracja z DHL Express.

W tym artykule znajdziesz

Dostępne usługi i opcje dodatkowe

Wariant standardowy oraz wariant z doręczeniem wieczornym korzystają z tych samych danych przesyłki. W wariancie wieczornym opcja doręczenia wieczornego jest włączana automatycznie. Dostępność usług dla konkretnego nadania zależy od warunków DHL, konta kurierskiego i danych przesyłki.

Obszar Obsługiwane dane i opcje
Paczka Rodzaj: list, paczka lub paleta; szerokość, wysokość i długość w cm; waga w kg; ilość paczek; przesyłka niestandardowa; data nadania.
Odbiorca Nazwa, kraj, kod pocztowy, miasto, ulica, numer domu i lokalu, osoba kontaktowa, telefon oraz e-mail.
Nadawca Dane nadawcy z konfiguracji konta kurierskiego, w tym nazwa, adres i dane kontaktowe.
Serwis Typ usługi: Krajowa, Krajowa 09 lub Krajowa 12; doręczenie wieczorne i doręczenie w sobotę.
Usługi dodatkowe Zwrot dokumentów i nazwa zwracanego dokumentu, potwierdzenie doręczenia, odbiór własny, informacja przed doręczeniem oraz informacja o przyjęciu przesyłki.
Rozliczenia Pobranie COD, kwota pobrania, ubezpieczenie i jego kwota oraz opcja opłacenia usługi kurierskiej gotówką przez odbiorcę.
Etykiety Pobieranie etykiety nadawczej oraz opcjonalnie etykiety zwrotnej.

Ustawienia domyślne ułatwiają przygotowanie przesyłki, ale jej parametry mogą zostać nadpisane podczas generowania lub edycji. Przed nadaniem sprawdź dane konkretnej przesyłki. Szczegóły konfiguracji znajdziesz we wpisie Dodanie integracji z kurierem DHL.

Szczegółowy zakres danych

Tabela pokazuje źródła danych w xSale oraz odpowiadające im pola na przykładowej etykiecie DHL. Kliknij numer, aby otworzyć właściwy zrzut. Numery odnoszą się do położenia pól; dane widoczne na obrazach są przykładami, a nie wartościami wymaganymi w konfiguracji.

Obszar xSale Pole xSale Nr xSale Obszar etykiety Pole na etykiecie Nr DHL Uwagi
Zamówienie → Zamawiający → Odbiorca Nazwa 1 Odbiorca Imię i nazwisko lub firma 1  
Zamówienie → Zamawiający → Odbiorca Nazwa – druga linia 2 Odbiorca Osoba kontaktowa 12 Osoba kontaktowa jest wybierana kolejno: imię i nazwisko osoby kontaktowej, druga nazwa odbiorcy, a jeśli ich brak – pierwsza nazwa odbiorcy.
Zamówienie → Zamawiający → Odbiorca Telefon 3 Odbiorca Telefon kontaktowy 4 W pierwszej kolejności przekazywany jest pierwszy numer telefonu odbiorcy; jeśli go nie ma, drugi numer.
Zamówienie → Zamawiający → Odbiorca Miasto 4 Odbiorca Miasto 3  
Zamówienie → Zamawiający → Odbiorca Ulica 5 Odbiorca Ulica 2  
Zamówienie → Zamawiający → Odbiorca Numer domu 6 Odbiorca Nr domu 2 Na widoku zamówienia jest prezentowany razem z ulicą (oznaczenia 5 i 6). Integracja korzysta z osobnego numeru budynku, a przy jego braku próbuje odczytać numer z ulicy.
Zamówienie → Zamawiający → Odbiorca Kod pocztowy 7 Odbiorca Kod pocztowy 3  
Zamówienie → Zamawiający → Odbiorca Kraj / Kraj ISO 8 Odbiorca Kraj 5 Pierwszeństwo ma kod Kraj ISO, np. PL. Jeśli go nie podano, integracja próbuje rozpoznać kraj na podstawie jego nazwy lub kodu.
Integracje → DHL → Ustawienia domyślne Referencja 22   Uwagi 9 Domyślnie komentarz na etykiecie jest przygotowywany z konfiguracji Referencja. Nie jest bezpośrednią kopią pola Uwagi klienta na zamówieniu. Dane przesyłki mogą zostać później zmienione. ForeignNumber oznacza Nr obcy z zamówienia; przy braku numeru wartość jest pomijana. Jak ustawić numer obcy w referencji.
Zamówienie → Informacje o przesyłce Ilość paczek 9   Ilość 21 Planowana liczba paczek przekazywana do tworzonej przesyłki. W DHL pusta wartość lub 0 są traktowane jako 1. Możliwość nadania kilku paczek zależy od wybranej usługi.
Zamówienie → Nagłówek Wartość zamówienia 12   COD – kwota 7 Przy rozpoznanej formie płatności COD kwota pobrania jest inicjalizowana z wartości dokumentu przekazanej do generowania przesyłki. Ostateczną kwotę sprawdź na przesyłce; może być zmieniona przed nadaniem.
Zamówienie → Płatność Forma płatności 13   COD 6 Pobranie jest włączane po dopasowaniu formy płatności zamówienia do listy Formy płatności przesyłek COD w konfiguracji DHL.
Zamówienie → Informacje o przesyłce Nr listu 11   Nr przesyłki 10 Numer przesyłki otrzymany po jej utworzeniu w DHL; nie jest daną wejściową potrzebną do nadania.
Integracje → DHL → Ustawienia domyślne Dane nadawcy – pierwsza nazwa 17 Nadawca (Płatnik) Nadawca nazwa 13  
Integracje → DHL → Ustawienia domyślne Dane nadawcy – druga nazwa 18 Nadawca (Płatnik) Nadawca nazwa 14  
Integracje → DHL → Ustawienia domyślne Dane nadawcy – miasto 15 Nadawca (Płatnik) Nadawca adres 16  
Integracje → DHL → Ustawienia domyślne Dane nadawcy – kod pocztowy 20 Nadawca (Płatnik) Nadawca adres 15  
Integracje → DHL → Ustawienia domyślne Dane nadawcy – pierwsza ulica 19 Nadawca (Płatnik) Nadawca adres 17  
Integracje → DHL → Ustawienia domyślne Dane nadawcy – nr budynku 14 Nadawca (Płatnik) Nadawca adres 18  
Integracje → DHL → Ustawienia domyślne Dane nadawcy – nr lokalu 16 Nadawca (Płatnik) Nadawca adres 19  
Integracje → DHL → Ustawienia domyślne Formy płatności przesyłek COD 21   COD 6 W integracji z kurierem definiujemy płatności zamówienia odpowiadające przesyłkom z COD.
Integracje → DHL → Ustawienia domyślne Referencja 22   Zawartość 8 Referencja może zawierać stały tekst lub odwołanie do wartości z konkretnego zamówienia np. Id, kod towaru, nazwa towaru. Zawartość jest też dodawana do pola „Uwagi” na etykiecie.  ForeignNumber oznacza Nr obcy z zamówienia; przy braku numeru wartość jest pomijana. Jak ustawić numer obcy w referencji.
Przesyłka → Data nadania Data nadania     Data nadania 20 Termin przekazywany do DHL podczas tworzenia przesyłki. Nie jest datą zakupu zamówienia.
        Data 11 Data prezentowana przez DHL na etykiecie.
Integracje → DHL → Ustawienia domyślne Etykieta Zwrotna 23       Sposób włączenia tej opcji opisano w sekcji „Pobranie, ubezpieczenie i etykiety zwrotne” poniżej.

Pobranie, ubezpieczenie i etykiety zwrotne

Pobranie COD dotyczy należności za zamówienie. W ustawieniach DHL wskaż odpowiadające mu nazwy form płatności, rozdzielając je średnikiem. Dla standardowych przesyłek connector przekazuje do DHL zwrot pobrania przelewem. Opcja Płaci odbiorca gotówką dotyczy natomiast opłaty za usługę kurierską i nie zastępuje włączenia COD.

Ubezpieczenie może korzystać z kwoty ustawionej domyślnie lub z kwoty pobrania, zależnie od konfiguracji. Przed nadaniem zweryfikuj kwotę na przesyłce, szczególnie przy wysyłce zagranicznej. Nie zakładaj, że będzie ona automatycznie przeliczona według aktualnego kursu waluty.

Referencja może zawierać stały tekst lub wartości związane z zamówieniem, np. numer dokumentu, numer zamówienia, kody albo nazwy towarów. Domyślnie przygotowana z niej treść trafia do zawartości i komentarza przesyłki. Nie należy utożsamiać jej z polem Uwagi klienta.

Etykieta Zwrotna jest osobną opcją od usługi zwrotu podpisanych dokumentów. Sposób jej włączenia, wymaganie formatu PDF i miejsce numeru listu zwrotnego opisuje wpis Etykieta zwrotna DHL.

Zrzuty xSale

Dane odbiorcy

Dane odbiorcy: oznaczenia 1–8

Zamówienie i informacje o przesyłce

Wartość i płatność zamówienia oraz numer listu i ilość paczek: oznaczenia 9, 11, 12 i 13

Ustawienia domyślne DHL

Ustawienia domyślne integracji DHL: oznaczenia 14–23

Zrzuty DHL

Przykładowa etykieta DHL z oznaczeniami pól

Czego brakuje w tym artykule?