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
- Szczegółowy zakres danych
- Pobranie, ubezpieczenie i etykiety zwrotne
- Zrzuty xSale
- Przykładowa etykieta DHL
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

Zamówienie i informacje o przesyłce

Ustawienia domyślne DHL

Zrzuty DHL


EN