Integracja wysyłki kurierskiej przez Web Serwis z firmą DHL

Dodana została obsługa kuriera DHL dla przesyłek krajowych.

Komunikacja z serwisem DHL odbywa się przez WebService, więc serwer bazy danych musi mieć dostęp do internetu. W celach testowych firma DHL udostępnia konto testowe. Pod adresem https://sandbox.dhl24.com.pl/webapi2/provider/service.html?ws=1 istnieje możliwość utworzenia testowych przesyłek. Autoryzacja konta testowego odbywa się na podstawie użytkownika, hasła oraz numeru SAP. Odpowiednio są to: ASSECOBS/U3G2SUonkU2WH2/6000000. Szczegóły konfiguracji znajdują się w dokumentacji słownika Firmy kurierskie.

Podstawowe usługi, które zostały udostępnione:

  • AH-Standardowa – W ramach tej usługi można nadawać przesyłki kopertowe i paczki zawierające elementy do 31,5 kg (przesyłki ekspresowe) oraz przesyłki paletowe i paczki zawierające elementy od 31,5 kg do 1000 kg (przesyłki drobnicowe).
  • DHL DOMESTIC EXPRESS 9:00 – Wysyłka pilnych dokumentów i paczek na terenie Polski. Zintegrowana sieć krajowa umożliwia dostawę przesyłek do najważniejszych miast przed godziną 9:00 następnego dnia roboczego.
  • DHL DOMESTIC EXPRESS 12:00 – Dokumenty lub paczki, które muszą dotrzeć przed południem następnego dnia roboczego do dużych miast w Polsce.

Możliwe są następujące wydruki Web Serwis DHL:

  • Etykiet lub listu przewozowego, plik pobierany jest w formacie *.pdf lub *.zpl, natomiast list przewozowy w *.pdf.
  • Skan listu przewozowego – dostępny tylko dla środowiska produkcyjnego, plik pobierany jest w formacie *.gif.
  • Zbiorczy dokument nadania, inaczej zwany w systemie DHL raportem PNP (Potwierdzenie Nadania Przesyłek) – grupuje przesyłki z danego dnia, plik pobierany jest w formacie *.pdf.
  • Wydruk tego dokumentu powinien być wykonywany na koniec dnia, ponieważ grupuje on wszystkie przesyłki z danego dnia.

Integracja systemu oparta została o Web Serwis dostarczony przez firmę DHL.

Z kolejnymi etapami obsługi przesyłki powiązane są następujące statusy:

  • Status: Definiowana – Na tym etapie definiowane są paczki i listy przewozowe. Przeprowadzana jest ponadto wstępna walidacja poprawności parametrów.
  • Status: Gotowa – Przesyłka na tym etapie rejestrowana jest w systemie spedytora. Numery listów przewozowych zapisywane są w parametrach dowodu LPK w parametrze NUMPRZES. Brak numerów poszczególnych paczek, do komunikacji używany jest tylko numer przesyłki.
  • Status: Zaetykietowana – Na tym etapie następuje pobranie od spedytora etykiet na paczki lub dokumentu listu przewozowego.
  • Status: Zarejestrowana – Krok ten składa się z dwóch etapów. Pierwszy odpowiada za powiązanie i zgrupowanie przygotowanych listów przewozowych (LPK) w dowód NLPK (brak odpowiednika w systemie DHL). Ważne jest, że nie można mieszać przesyłek z różnych magazynów, jak również przesyłek różnych adresów nadania oraz dat nadania. Drugim krokiem jest wezwanie kuriera. Podczas tego żądania do web serwisu wysyłane jest zlecenie odbioru przesyłek, które zostały zgrupowane w pierwszym kroku. Jako właściwy czas odbioru przesyłki podawana jest data nadania oraz zakres godzinowy, który będzie pobrany z web serwisu, to jest czas określony (dostępny w danym momencie) przez system DHL. W odpowiedzi zostanie zwrócony numer zlecenia wezwania kuriera, który zostanie zapisany w parametrze NUMWEZW dowodu NLPK.
  • Status: W drodze – Po odebraniu paczek przez kuriera należy zmienić na kolejny dostępny status (tutaj żadna operacja nie jest wykonywana, status jest wyłącznie informacyjny).
  • Status: Dostarczona – przejście to wykona się automatycznie, gdy po uruchomieniu procedury Aktualizuj śledzenie paczek system DHL zwróci informację, że przesyłka została dostarczona.

Można również obserwować, w jakim statusie w systemie DHL znajduje się konkretna przesyłka. W słowniku Rejestr kurierskich listów przewozowych po uruchomieniu procedury Aktualizuj śledzenie paczek web serwis DHL zostanie odpytany o aktualny status przesyłki.  Wyniki można podejrzeć w szczególe Lista zdarzeń związanych z przesyłką.

integracja_wysylki_kuriereskiej

rys. Integracja wysyłki kurierskiej przez Web Serwis z firmą DHL – formularz wprowadzania parametrów przesyłki dla usługi Krajowa

integracja_wysylki_kuriereskiej_2

rys. Integracja wysyłki kurierskiej przez Web Serwis z firmą DHL – wydruk etykiety na paczkę 

integracja_wysylki_kuriereskiej_3

rys. Integracja wysyłki kurierskiej przez Web Serwis z firmą DHL – wydruk listu przewozowego

itegeacja_5 

rys. Integracja wysyłki kurierskiej przez Web Serwis z firmą DHL – wydruk PNP (protokołu nadania przesyłek)