Skip to main content

Integracja z DPD

Konfiguracja​

Dane autoryzacyjne do DPD Web Service są możliwe do wpisania w Ustawieniach Integracji z kurierami: (Parametry Produktów > Integracja z kurierami). Należy uzupełnić wszystkie puste pola - (Login, MasterFid, Hasło) Pola dotyczące adresów URL odpowiednich Web Service'ów powinny być uzupełnione. Zmiana adresów może być konieczna w przypadku testowania funkcjonalności. Odpowiednie adresy URL do Web Service'ów produkcyjnego i testowego można sprawdzić po najechaniu na ikonę informacyjną obok tytułu np. "DPD WSDL SERVICE URL:"

Integracja DPD - ustawienia

Tworzenie listu przewozowego / zlecenia odbioru​

List przewozowy oraz Zlecenie odbioru to z punktu widzenia użytkownika systemu podobne dokumenty. Dane potrzebne do ich utworzenia są bardzo podobne. Różnica odbywa się wewnątrz systemu, ponieważ List przewozowy jest generowany za pomocą innego Web Service'u niż Zlecenie odbioru.

  • List przewozowy - Web Service: DPD Service
  • Zlecenie odbioru - Web Service: DPD APP Service

Widok tworzenia nowego listu przewozowego / zlecenia odbioru jest dostępny z listy (/shipping/list) albo bezpośrednio przez link (/shipping/createWaybillDpd). Domyślnie z powyższych miejsc / linków przechodzimy do ekranu tworzenia Listu przewozowego. Aby utworzyć Zlecenie odbioru należy w URL użyć parametru option[shipment_type]=2 (/shipping/createWaybillDpd?option[shipment_type]=2)

Działają następujące parametry URL:

  • option[shipment_type] - wartości 1 lub 2 - Wysyłka (List przewozowy) / Odbiór (Zlecenie odbioru)
  • receiver[<field>] (gdzie <field> może przyjąć wartości: company_name, name, postal_code, city, address, phone, email, branch_id [adres filii] )
  • sender[<field>] (gdzie <field> może przyjąć wartości: company_name, name, postal_code, city, address, phone, email, branch_id [adres filii] )
  • commission_id - powiązany proces - na podstawie nazwy tego procesu ustawi się Treść pierwszej paczki w tworzonym liście przewozowym

Pola z kodami pocztowymi są walidowane za pomocą DPD Info Service Wymagane są wszystkie pola oznaczone gwiazdkami u Nadawcy i Odbiorcy, jedno z pól Imię i nazwisko / Firma oraz Waga i Treść dla każdej paczki Próba zapisania bez uzupełnienia wymaganych pól zakończy się niepowodzeniem oraz stosownym komunikatem o błędzie.

Tworzenie listu przewozowego DPD

Podgląd listu przewozowego / zlecenia odbioru​

Po uzupełnieniu wszystkich wymaganych pól i kliknięciu zapisz zacznie się proces generowania listu przewozowego / zlecenia odbioru. Obok nieaktywnego wówczas przycisku zapisz pojawi się spinner oraz komunikat ("Trwa generowanie listu przewozowego"). Tuż po utworzeniu listu przewozowego zostanie automatycznie pobrana etykieta przewozowa w formacie PDF (Uwaga! Dotyczy tylko listu przewozowego. Dla zlecenia odbioru taka etykieta nie jest pobierana ze względu na ograniczenia DPD APP Service). Po utworzeniu system przekieruje nas na podgląd, który jest bardzo podobny do widoku tworzenia. List przewozowy - Na górze znajduje się numer całego listu (nazewnictwo w DPD Service - SessionId - za pomocą tego identyfikatora pobierane są etykiety PDF). Zlecenie odbioru - Na górze znajduje się numer pierwszej z przesyłek (nazewnictwo w DPD APP Service - WaybillId). Nad pozycjami jest powiązanie z procesem [jeśli istnieje]. Na dole powiązany plik - etykieta PDF (dotyczy tylko Listu przewozowego).

Podgląd utworzonego listu przewozowego DPD

Pobieranie statusu przesyłki​

Powstał też proces integracji statusów przesyłek zapisany w tabeli "cron" - odpalany raz dziennie o godzinie 6 (domyślnie jest on nieaktywny). Pobiera numery przesyłek (shipping_position.position_header - w DPD Web Service jest to pole WaybillId) i sprawdza jakie jest dla nich ostatnie zdarzenie w systemie DPD Info. (przykłady zdarzeń - Odebrano paczkę, W doręczenie, Doręczona). Ostatni status dotyczący przesyłki jest wpisywany jako kod odpowiedzi z DPD do kolumny shipping_position.status. Jeżeli dana przesyłka jest starsza niż 30 dni lub osiągnęła już status "Doręczono" to status nie jest już pobierany.