Przejdź do głównej zawartości

Integracja DPD Polska

Moduł DPD łączy śledzenie zamówień WooCommerce z DPD Polska. Zapisujesz dane dostępowe do DPD Web Service, wpisujesz numer listu przewozowego w zamówieniu, a wtyczka pobiera bieżący status paczki z DPD track and trace.

Ustawienia DPD należą do grupy wysyłkowej ustawień PRO (opcja polski_pro_shipping). Odczytuje się je i zapisuje przez trasę REST ustawień PRO, /wp-json/polski-pro/v1/settings, która wymaga uprawnienia manage_woocommerce. Osobny ekran ustawień wysyłki jest planowany, ale jeszcze nie powstał.

UstawienieKluczOpis
DPD włączonedpd_enabledWłącza obsługę DPD
Login DPDdpd_loginLogin do DPD Web Service API
Hasło DPDdpd_passwordHasło do DPD Web Service API
Master FIDdpd_master_fidNumer FID nadawcy (identyfikator klienta DPD)

Dane dostępowe uzyskasz z panelu klienta DPD lub od opiekuna handlowego. Odpytywanie statusu działa tylko wtedy, gdy dpd_enabled jest włączone oraz login i hasło są uzupełnione. Same dane nie są wysyłane w zapytaniu o status, informują wtyczkę, że przewoźnik jest skonfigurowany.

Zapisywane są jeszcze dwie wartości: tryb testowy DPD (dpd_sandbox) i rachunek bankowy dla pobrania (dpd_cod_bank_account). Obie należą do niepodłączonego jeszcze kodu etykiet (zobacz Czego jeszcze nie ma niżej), więc dziś niczego nie zmieniają.

Panel śledzenia, kolumna Śledzenie i e-maile o statusie pochodzą z modułu Fulfillment (klucz fulfillment w opcji polski_modules). Domyślnie jest wyłączony, więc włącz go, zanim zaczniesz szukać pól śledzenia.

  1. Otwórz zamówienie w WooCommerce > Zamówienia
  2. W bloku Śledzenie przesyłki pod adresem dostawy wybierz DPD w polu Przewoźnik
  3. Wklej numer listu przewozowego w pole Numer śledzenia
  4. Pole URL śledzenia zostaw puste, link do DPD track and trace powstanie z numeru przy zapisie zamówienia (uzupełnij je tylko wtedy, gdy potrzebujesz innego adresu)
  5. Zapisz zamówienie

Numer i link pojawią się w kolumnie Śledzenie na liście zamówień, w zamówieniu widocznym dla klienta w Moim koncie oraz w e-mailach do klienta.

Po zapisaniu numeru na ekranie zamówienia widać Podgląd na żywo ze statusem zamówienia oraz, jeśli DPD je zwróci, z bieżącym statusem paczki i historią przesyłki. Zapytanie trafia do publicznego endpointu DPD track and trace, a odpowiedź jest buforowana przez 10 minut.

Przycisk Odśwież śledzenie na żywo czyści ten bufor dla numeru z tego zamówienia i przeładowuje ekran. Użyj go, gdy paczka już się przemieściła, a panel nadal pokazuje poprzedni stan.

  • Akcję Śledź przesyłkę obok zamówienia w Moim koncie
  • Sekcję Śledzenie przesyłki na stronie szczegółów zamówienia
  • Ten sam blok śledzenia dołączony do e-maili z zamówieniem
  • E-mail z nazwą przewoźnika, numerem i linkiem, gdy zamówienie zmienia status na Spakowane, Wysłane lub Dostarczone

Te trzy statusy pochodzą z tego samego modułu. Można je ustawić dla wielu zamówień naraz z poziomu listy zamówień akcjami Zmień status na Spakowane, Zmień status na Wysłane i Zmień status na Dostarczone.

ObjawPrzyczynaRozwiązanie
Brak bloku Śledzenie przesyłki w zamówieniuModuł Fulfillment jest wyłączonyWłącz moduł fulfillment
Numer jest widoczny, ale brak statusu paczkiDPD nie jest włączone, dane dostępowe są puste albo DPD nie ma jeszcze danych dla tego numeruUzupełnij dane dostępowe i spróbuj ponownie, gdy DPD zeskanuje paczkę
Status wygląda na nieaktualnyOdpowiedź jest buforowana przez 10 minutKliknij Odśwież śledzenie na żywo
Brak linku do śledzeniaPole Przewoźnik zostało pusteWybierz DPD i zapisz zamówienie ponownie

Generowanie etykiet jest napisane, ale niepodłączone. Nie ma przycisku generowania etykiety, akcji masowej ani pobierania etykiet, więc numery listów przewozowych trzeba wziąć z panelu klienta DPD lub z własnej integracji i wkleić do zamówienia. Wyszukiwanie punktów DPD Pickup jest w tym samym stanie, kod istnieje, ale nic w zamówieniu ani w kasie go nie wywołuje. Moduł nie udostępnia też jeszcze żadnych filtrów ani akcji.