Zakres integracji z DPD

Wpis opisuje zakres danych wykorzystywanych przy generowaniu przesyłek DPD w xSale. Integracja umożliwia przygotowanie danych przesyłki, przekazanie ich do DPD, wygenerowanie numeru listu przewozowego oraz pobranie etykiety.

W tym artykule znajdziesz:

• jaki zakres obsługuje integracja DPD
• jakie dane i usługi są dostępne dla DPD Domestic
• jakie dane i usługi są dostępne dla DPD International
• jak korzystać z punktów DPD Pickup
• szczegółowy zakres mapowania pól
• o czym warto pamiętać
• zrzuty ekranów

Zakres integracji

Integracja DPD obsługuje przesyłki krajowe i międzynarodowe. Dane odbiorcy są pobierane z adresu dostawy na zamówieniu, a dane nadawcy z konfiguracji konta kurierskiego. Po wygenerowaniu przesyłki xSale zapisuje numer listu przewozowego i pobiera etykietę z DPD.

DPD Domestic

• Dane przesyłki: szerokość, wysokość, głębokość i waga.
• Usługi dodatkowe: serwis gwarancyjny, dostawa do 9:30, dostawa do 12:00 i dostawa w sobotę.
• Flagi i typy przesyłek: przesyłka zwrotna, dokumenty zwrotne, S, odbiór w DPD, dokumenty, opony, osoba prywatna i przesyłka paletowa.
• Podprzesyłki: można dodać kolejne paczki z własnymi parametrami szerokości, wysokości, głębokości, wagi oraz treści.

DPD International

• Dane przesyłki: szerokość, wysokość, głębokość i waga.
• Usługi dodatkowe: serwis gwarancyjny i gwarantowany dzień doręczenia.
• Flagi i typy przesyłek: opony, opony eksportowe, przesyłka zagraniczna lotnicza, dokumenty międzynarodowe, osoba prywatna i przesyłka paletowa.
• Odprawa celna: integracja obsługuje pola związane z usługą celną, jeżeli są dostępne w konfiguracji procesu.

DPD Pickup – odbiór w punkcie

Integracja umożliwia przekazanie do DPD identyfikatora punktu Pickup podczas tworzenia przesyłki. Punkt może pochodzić z danych zamówienia lub zostać wybrany na mapie w formularzu przesyłki DPD w panelu xSale.

Obsługa punktu jest dostępna w integracji dla typów dostawy DPD Domestic i DPD International. Nie oznacza to dostępności każdej usługi w każdym kraju i punkcie. Przyjęcie przesyłki, w tym połączenia Pickup z pobraniem lub innymi usługami, zależy od DPD i warunków obsługi konta.

Punkt dostawy na zamówieniu

W panelu xSale otwórz Zamówienia → wybrane zamówienie → Informacje o przesyłce. W tej sekcji znajduje się pole Punkt dostawy.

Automatyczne uzupełnienie punktu z kanału sprzedaży działa tylko dla zamówień pochodzących z integracji, z których xSale pobiera i zapisuje tę informację. Nie każda integracja przekazuje punkt dostawy. Przed wygenerowaniem etykiety sprawdź, czy pole zawiera właściwy kod punktu DPD.

Wybierz Sposób dostawy korzystający z integracji DPD, np. Kurier DPD pokazany na zrzucie. Przy poprawnie skonfigurowanej integracji DPD obsługa punktu nie wymaga uzupełniania dodatkowych ustawień w samej integracji.

1. W sekcji Informacje o przesyłce kliknij ikonę ołówka przy polu Punkt dostawy.
2. Wpisz kod właściwego punktu DPD, a nie jego adres lub opis, i zatwierdź zmianę. W ten sposób możesz także zmienić punkt zapisany wcześniej na zamówieniu.
3. Sprawdź sposób dostawy i pozostałe dane, a następnie wygeneruj etykietę.

Ważne: sama zmiana punktu na zamówieniu nie zmienia już utworzonej przesyłki ani wystawionej etykiety. Aby otrzymać etykietę z właściwym punktem, musi nastąpić jej wygenerowanie z poprawnymi danymi. Jeśli przesyłka została już poprawnie nadana w systemie kuriera, sprawdź jej status i zasady anulowania przed zleceniem kolejnej, aby nie utworzyć niepotrzebnej dodatkowej przesyłki.

Jak poprawić punkt w przesyłce z błędem?

Jeśli generowanie etykiety zakończyło się błędem, popraw dane istniejącej przesyłki z poziomu listy przesyłek. Przykładowy komunikat ERROR_EMPTY_PUDO – Błędny identyfikator punktu SP, widoczny na zrzucie, wskazuje na problem z identyfikatorem punktu.

1. Przejdź do Etykiety i kurierzy → Przesyłki, odszukaj przesyłkę DPD z błędem i otwórz jej edycję.
2. Sprawdź kraj odbiorcy oraz kwotę pobrania, jeżeli przesyłka ma być pobraniowa. Mapa korzysta z tych danych w chwili otwarcia.
3. W sekcji Punkt odbioru kliknij Wybierz na mapie.
4. Wybierz właściwy punkt. Jego identyfikator zostanie wpisany do formularza, a mapa się zamknie. Pole identyfikatora jest tylko do odczytu; aby zmienić punkt, ponownie otwórz mapę.
5. Sprawdź pozostałe dane przesyłki i kliknij Wyślij i pobierz, aby ponowić generowanie etykiety. Sam wybór punktu na mapie nie generuje etykiety.

Wybór punktu uzupełnia jego identyfikator, ale nie zastępuje danych odbiorcy. Nadal sprawdź imię i nazwisko, telefon, e-mail oraz adres i kraj wymagane do obsługi przesyłki.

Punkt zapisany na zamówieniu

Przy tworzeniu przesyłki xSale wykorzystuje identyfikator punktu dostawy zapisany na zamówieniu. Jeśli osobny identyfikator nie jest uzupełniony, może wykorzystać wartość pola punktu dostawy. Wartość powinna wskazywać identyfikator punktu DPD, a nie jego adres lub dowolny opis.

Jeżeli punkt nie został przekazany, xSale nie dołącza usługi Pickup do żądania. Dlatego przed wygenerowaniem przesyłki przeznaczonej do punktu sprawdź, czy właściwy punkt jest uzupełniony. Sama nazwa sposobu dostawy nie wystarcza.

Ograniczenia i obsługa błędów

• Identyfikator punktu może mieć maksymalnie 50 znaków. Spacje na początku i końcu są pomijane.
• Przy dodatniej kwocie pobrania mapa otrzymuje ustawienie wyszukiwania punktów obsługujących pobranie. Nie jest to gwarancja przyjęcia każdej przesyłki pobraniowej przez DPD.
• Jeżeli zmienisz kraj lub kwotę pobrania, ponownie otwórz mapę i sprawdź wybór punktu.
• Opcja Odbiór w DPD i wybór punktu Pickup są odrębnymi ustawieniami. Samo zaznaczenie tej opcji nie wskazuje punktu Pickup.
• Jeżeli DPD odrzuci przesyłkę, sprawdź komunikat, identyfikator punktu, kraj, typ dostawy i usługi dodatkowe. Popraw dane, a następnie ponów wysłanie przesyłki. Wątpliwości dotyczące dostępności usługi na koncie wyjaśnij z opiekunem DPD.

Szczegółowy zakres (mapowanie pól)

Poniższa tabela prezentuje zakres danych przesyłanych między xSale a DPD na przykładzie wygenerowanej etykiety.

Obszar xSale	Pole xSale	nr	Obszar etykiety	Pole na etykiecie	nr	Uwagi
Zamówienie > Zamawiający > Odbiorca	Nazwa	1	Adres doręczenia	Nazwa	1	Jeżeli Nazwa 2 jest pusta, to wartość pobierana jest tylko z pola Nazwa
Zamówienie > Zamawiający > Odbiorca	Telefon	2	Adres doręczenia	Telefon	2
Zamówienie > Zamawiający > Odbiorca	Miasto	5	Adres doręczenia	Miasto	5
Zamówienie > Zamawiający > Odbiorca	Ulica	3	Adres doręczenia	Ulica	3
Zamówienie > Zamawiający > Odbiorca	Kod pocztowy	4	Adres doręczenia	Kod pocztowy	4
Zamówienie > Zamawiający > Odbiorca	Kraj	21	Adres doręczenia	Kraj	21	Wyświetlany jest kod kraju. Nazwa kraju w danych Odbiorcy na zamówieniu w xSale powinna być podana w języku polskim.
Zamówienie > Płatność	Forma płatności	22	COD	Oznaczenie pobrania	22	Wynika z mapowania form płatności. Jeżeli na zamówieniu jest forma płatności zdefiniowana w integracji z kurierem jako forma COD, to na liście przewozowym jest zaznaczona opcja COD.
Zamówienie > Uwagi klienta	Uwagi klienta	15	Informacje dodatkowe	Uwagi	15	Są przenoszone z pola uwagi w zamówieniu.
Zamówienie > Informacje o przesyłce	Nr listu	19	Numer paczki	Nr listu przewozowego	19
Zamówienie > Pozycje zamówienia > Podsumowanie zamówienia	Suma	16	COD	Kwota pobrania	16	Jest to kwota z zamówienia w xSale. Uwaga dla DPD-DE: kwota pobrania jest przekazywana do kuriera jako liczba całkowita. Jeżeli zamówienie ma kwotę z częścią po przecinku, xSale ucina część dziesiętną. Przykład: 8,34 EUR zostanie przekazane jako 8 EUR. To ograniczenie dotyczy DPD-DE; dla GLS HU obowiązuje osobna zasada, że kwota pobrania musi być wielokrotnością 5 HUF.
Edytor integracji kurierskiej DPD > Ustawienia domyślne	Dane nadawcy – kod kraju	10	Nadawca	Kraj	10
Edytor integracji kurierskiej DPD > Ustawienia domyślne	Dane nadawcy – miasto	11	Nadawca	Miasto	11
Edytor integracji kurierskiej DPD > Ustawienia domyślne	Dane nadawcy – kod pocztowy	12	Nadawca	Kod pocztowy	12
Edytor integracji kurierskiej DPD > Ustawienia domyślne	Dane nadawcy – ulica	7	Nadawca	Ulica	7
Edytor integracji kurierskiej DPD > Ustawienia domyślne	Dane nadawcy – numer budynku / lokalu	8	Nadawca	Nr budynku	8
Edytor integracji kurierskiej DPD > Ustawienia domyślne	Dane nadawcy – imię	6	Nadawca	Nazwa / Imię	6
Edytor integracji kurierskiej DPD > Ustawienia domyślne	Dane nadawcy – telefon	13	Nadawca	Telefon	13
Edytor integracji kurierskiej DPD > Ustawienia domyślne	Waga paczki	18	Paczka	Waga	18
Edytor integracji kurierskiej DPD > Ustawienia domyślne	Referencja	14	Referencja	Referencja	14	Zawartość referencji w paczce. Dostępne opcje: „DocumentNumber” – nr dokumentu, „Articles” – kod towaru, „ArticlesName” – nazwa towaru, „OrderNumber” – nr zamówienia. Np: „DocumentNumber;Articles”, „OfferCodes” – kod oferty.(Jeżeli więcej niż jedna – wpisywać je po średniku.) Możesz również wpisać dowolną wartość którą chcesz umieścić na etykiecie.
Edytor integracji kurierskiej DPD > Ustawienia domyślne	Formy płatności przesyłek COD	20	COD	Oznaczenie pobrania	20	W integracji z kurierem definiujemy płatności zamówienia odpowiadające przesyłkom z COD.

O czym warto pamiętać?

• Dane odbiorcy na etykiecie są tworzone z adresu dostawy na zamówieniu.
• Kod pocztowy odbiorcy i nadawcy jest przekazywany do DPD bez myślnika.
• COD jest ustawiany na podstawie mapowania form płatności w integracji z kurierem.
• Waga może pochodzić z konfiguracji lub zostać wyliczona z wagi zamówienia, jeżeli w procesie włączono wyliczanie wagi.
• Przy większej liczbie paczek xSale tworzy podprzesyłki i przekazuje ich parametry do DPD.

Zrzuty ekranów