Integracje

⌘K
  2. Strona główna
  4. Integracje
  6. Kurier – Poczta Polska
  8. Zakres integracji: Zagraniczna paczka do Unii Europejskiej

Zakres integracji: Zagraniczna paczka do Unii Europejskiej

Wpis opisuje zakres danych wykorzystywanych przy generowaniu etykiety Poczta Polska dla usługi Zagraniczna paczka do Unii Europejskiej.

Dla tej usługi xSale przekazuje do Poczty Polskiej dane adresata, kraj doręczenia, kategorię przesyłki, masę oraz ustawienia dotyczące zwrotu przesyłki. Po poprawnym wygenerowaniu etykiety numer listu przewozowego jest zapisywany przy zamówieniu w xSale.

W tym artykule znajdziesz

Jak działa zagraniczna paczka do UE?

Po wybraniu usługi zagranicznej paczki do Unii Europejskiej xSale tworzy w Poczcie Polskiej przesyłkę typu paczka zagraniczna. Do zgłoszenia trafiają dane odbiorcy, kraj doręczenia, masa, kategoria przesyłki oraz wybrane ustawienia dodatkowe.

Po poprawnym utworzeniu przesyłki Poczta Polska zwraca numer nadania. xSale zapisuje go na zamówieniu jako numer listu przewozowego.

Jakie ustawienia są przekazywane?

Dla tej usługi integracja obsługuje przede wszystkim:

  • kategorię przesyłki – Ekonomiczna albo Priorytetowa,
  • masę – przekazywaną do Poczty Polskiej w gramach,
  • kraj odbiorcy – pobierany z danych adresowych odbiorcy,
  • sposób zwrotu – lądowo-morski albo lotniczy,
  • traktowanie przesyłki jako porzuconej, jeżeli taka flaga została ustawiona,
  • zwrot po liczbie dni, jeżeli taka wartość została uzupełniona.

Jeżeli sposób zwrotu nie zostanie wskazany, kod integracji przyjmuje domyślnie sposób lądowo-morski.

Jak wybierany jest urząd nadania?

Podczas wysyłania przesyłek z bufora integracja może wskazać urząd nadania z konfiguracji. Jeżeli w konfiguracji podano nazwę urzędu, xSale próbuje znaleźć placówkę Poczty Polskiej o takiej nazwie. Jeżeli w konfiguracji podano wartość liczbową, system traktuje ją jako identyfikator placówki.

Jeżeli urząd nadania nie zostanie wskazany albo nie uda się go jednoznacznie znaleźć, przesyłka zostanie przekazana bez ręcznie wskazanego urzędu nadania.

Szczegółowy zakres danych

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

Obszar xSale Pole xSale nr Obszar etykiety Pole na etykiecie nr Uwagi
Formularz zamówienia > Formularz adresu > Odbiorca Nazwa 1 Adresat Nazwa 1 Jeżeli pole Nazwa 2 jest puste, na etykiecie wykorzystywana jest wartość z pola Nazwa.
Formularz zamówienia > Formularz adresu > Odbiorca Nazwa 2 2 Adresat Nazwa 2 2 Pole opcjonalne, przekazywane jako dalsza część nazwy odbiorcy.
Formularz zamówienia > Formularz adresu > Odbiorca Ulica 3 Adresat Ulica 3
Formularz zamówienia > Formularz adresu > Odbiorca Numer ulicy 4 Adresat Numer ulicy 4
Formularz zamówienia > Formularz adresu > Odbiorca Kod pocztowy 5 Adresat Kod pocztowy 5 Kod pocztowy jest przekazywany w danych adresowych odbiorcy.
Formularz zamówienia > Formularz adresu > Odbiorca Miasto 6 Adresat Miasto 6
Formularz zamówienia > Formularz adresu > Odbiorca Kraj 7 Adresat Kraj 7 Kraj jest pobierany z danych odbiorcy. Dla przesyłek zagranicznych powinien być uzupełniony zgodnie z krajem doręczenia.
Formularz zamówienia > Formularz adresu > Odbiorca Telefon 9 Adresat Telefon 9 Do Poczty Polskiej przekazywany jest telefon zapisany przy odbiorcy.
Formularz zamówienia > Formularz zamówienia List przewozowy 8 Etykieta Nr listu przewozowego 8 Numer jest zapisywany w xSale po poprawnym wygenerowaniu etykiety.
ShipmentTask > Edycja PP Kategoria 10 Etykieta Usługa 10 Obsługiwane wartości to Ekonomiczna i Priorytetowa. Brak kategorii powoduje błąd przygotowania danych przesyłki.
ShipmentTask > Edycja PP Urząd nadania 11 Etykieta Urząd pochodzenia 11 Urząd nadania może zostać wskazany na podstawie konfiguracji.
ShipmentTask > Edycja PP Masa 12 Etykieta Ogólna masa brutto paczki 12 Masa jest przekazywana w gramach. Wartość powinna być większa od zera.

O czym warto pamiętać?

  • Dla tej usługi kluczowe są kompletne dane odbiorcy, kraj doręczenia, kategoria i masa przesyłki.
  • Kategoria musi mieć wartość Ekonomiczna albo Priorytetowa.
  • Masa jest przekazywana do Poczty Polskiej w gramach.
  • Jeżeli sposób zwrotu nie zostanie uzupełniony, integracja przyjmuje domyślnie zwrot lądowo-morski.
  • Po wygenerowaniu etykiety numer listu przewozowego zostaje zapisany na zamówieniu w xSale.

Zrzuty xSale

Zrzuty Poczta Polska

Czego brakuje w tym artykule?