Integracja z DHL Parcel umożliwia tworzenie przesyłek i pobieranie etykiet DHL dla zamówień obsługiwanych w xSale. Wpis opisuje konfigurację konta DHL Parcel w starszej konfiguracji integracji kurierskich.
W tym artykule znajdziesz:
- Co przygotować przed konfiguracją?
- Jak dodać sposoby dostawy dla DHL?
- Jakie dane DHL są potrzebne?
- Jak uzupełnić formularz integracji DHL?
- Co sprawdzić po zapisaniu konfiguracji?
Co przygotować przed konfiguracją?
Jeżeli w ramach jednego konta DHL obsługujesz kilka numerów SAP, a wszystkie korzystają z tych samych danych API, dla każdego numeru SAP utwórz osobną integrację DHL w xSale. Dzięki temu każda konfiguracja może korzystać z właściwego numeru SAP podczas generowania przesyłek.
Przed dodaniem integracji przygotuj:
- dane API DHL Parcel,
- numer SAP, który ma być używany przy generowaniu przesyłek,
- sposoby dostawy w xSale, które będą powiązane z DHL,
- domyślne parametry paczek, na przykład wagę, wymiary, ubezpieczenie i ustawienia pobrania.
Jak dodać sposoby dostawy dla DHL?
Przed rozpoczęciem konfiguracji konta DHL dodaj w xSale sposoby dostawy, które będą używane na zamówieniach i podczas generowania etykiet.
W panelu xSale V2 przejdź do Integracje → Sposoby dostaw i dodaj odpowiednie sposoby dostawy, na przykład:
- Kurier DHL,
- Kurier DHL wieczór – jeżeli chcesz rozróżniać przesyłki wieczorne.
Następnie dodaj integrację kurierską zgodnie z ogólną instrukcją: Konfiguracja integracji z kurierem.
Jakie dane DHL są potrzebne?
Do konfiguracji DHL Parcel potrzebne są dane połączeniowe API. Dane te możesz uzyskać od opiekuna DHL albo w panelu DHL.
- Użytkownik APIV2 – tworzy się automatycznie po wygenerowaniu klucza APIV2.
- Hasło – tworzy się automatycznie po wygenerowaniu klucza APIV2.
- Nr SAP – znajdziesz go w panelu DHL w sekcji Moje dane → Podstawowe dane.

Jak uzupełnić formularz integracji DHL?
W formularzu integracji DHL uzupełnij dane dostępowe oraz domyślne parametry przesyłek. Po najechaniu na wybrane pole system pokazuje dodatkową podpowiedź dotyczącą danego ustawienia.
Domyślne ustawienia, takie jak waga i wymiary, będą podpowiadane przy tworzeniu nowych przesyłek. W kodzie integracji DHL widać również, że konfiguracja może wpływać między innymi na:
- pobranie COD na podstawie form płatności ustawionych w konfiguracji,
- wartość ubezpieczenia,
- produkt DHL dla przesyłek krajowych i zagranicznych,
- typ przesyłki, wagę, szerokość, wysokość i długość,
- usługi dodatkowe, na przykład potwierdzenie doręczenia, odbiór własny, preawizo, zwrot dokumentu albo etykietę zwrotną,
- obsługę punktu odbioru, jeżeli numer punktu jest przekazany w danych zamówienia.


Co sprawdzić po zapisaniu konfiguracji?
Po uzupełnieniu formularza zapisz konfigurację. Następnie wykonaj test praktyczny, generując paczkę w sekcji Dokumenty → Przesyłki.
Jeżeli etykieta nie zostanie wygenerowana, sprawdź w pierwszej kolejności:
- czy dane API DHL są poprawne,
- czy wpisano właściwy numer SAP,
- czy sposób dostawy na zamówieniu jest powiązany z integracją DHL,
- czy zamówienie ma komplet danych odbiorcy, w tym adres, kod pocztowy, miasto i numer telefonu,
- czy forma płatności dla przesyłek pobraniowych jest wpisana w konfiguracji tak samo, jak występuje na zamówieniach,
- czy uzupełniono wymagane parametry paczki i usługi DHL.
EN