EN
Wpis opisuje zakres danych wykorzystywanych przy generowaniu etykiety Poczta Polska dla usługi Zagraniczna przesyłka polecona.
Dla tej usługi xSale przekazuje do Poczty Polskiej dane odbiorcy, kraj doręczenia, masę przesyłki oraz opcjonalną liczbę potwierdzeń odbioru. Po poprawnym wygenerowaniu etykiety numer nadania jest zapisywany przy zamówieniu w xSale.
W tym artykule znajdziesz
- Jak działa zagraniczna przesyłka polecona?
- Jakie dane są przekazywane?
- Jak wybierany jest urząd nadania?
- Szczegółowy zakres danych
- O czym warto pamiętać?
Jak działa zagraniczna przesyłka polecona?
Po wybraniu usługi zagranicznej przesyłki poleconej xSale tworzy w Poczcie Polskiej przesyłkę typu przesyłka polecona zagraniczna. Do zgłoszenia trafiają dane adresowe odbiorcy, masa przesyłki oraz dodatkowe ustawienia wymagane dla tej usługi.
Po poprawnym utworzeniu przesyłki Poczta Polska zwraca numer nadania. xSale zapisuje go na zamówieniu jako numer listu przewozowego.
Jakie dane są przekazywane?
W kodzie integracji dla tej usługi przekazywane są:
- dane odbiorcy – nazwa, ulica, numer domu, kod pocztowy, miejscowość, kraj i telefon,
- masa – przekazywana do Poczty Polskiej w gramach,
- liczba potwierdzeń odbioru – jeżeli została uzupełniona,
- Poste restante – jeżeli taka flaga została ustawiona.
Dla tej usługi integracja nie przekazuje kategorii jako osobnego wyboru użytkownika. Zagraniczna przesyłka polecona jest obsługiwana zgodnie z typem usługi Poczty Polskiej.
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 | Odbiorca | 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 | Odbiorca | Nazwa 2 | 2 | Pole opcjonalne, przekazywane jako dalsza część nazwy odbiorcy. |
| Formularz zamówienia > Formularz adresu > Odbiorca | Miasto | 3 | Odbiorca | Miasto | 3 | |
| Formularz zamówienia > Formularz adresu > Odbiorca | Ulica | 4 | Odbiorca | Ulica | 4 | |
| Formularz zamówienia > Formularz adresu > Odbiorca | Numer ulicy | 5 | Odbiorca | Numer ulicy | 5 | |
| Formularz zamówienia > Formularz adresu > Odbiorca | Kod pocztowy | 6 | Odbiorca | Kod pocztowy | 6 | Kod pocztowy jest przekazywany w danych adresowych odbiorcy. |
| Dane specyficzne > Formularz danych przesyłki | Kraj | 7 | Odbiorca | Kraj | 7 | Kraj jest przekazywany z danych przesyłki/odbiorcy. Na etykiecie może być widoczna pełna nazwa kraju. |
| Dane specyficzne > Formularz danych przesyłki > Usługi dodatkowe | Ilość potwierdzeń odbioru | 8 | Etykieta | A.R. | 8 | Jeżeli liczba potwierdzeń odbioru jest ustawiona, na liście przewozowym pojawia się oznaczenie A.R. |
| Dane specyficzne > Formularz danych przesyłki | Masa | 9 | Etykieta | Masa | 9 | Masa jest przekazywana w gramach. Wartość powinna być większa od zera. |
O czym warto pamiętać?
- Dla zagranicznej przesyłki poleconej kluczowe są kompletne dane odbiorcy, kraj doręczenia i masa przesyłki.
- Masa jest przekazywana do Poczty Polskiej w gramach.
- Potwierdzenie odbioru jest przekazywane tylko wtedy, gdy zostało uzupełnione w danych przesyłki.
- Po wygenerowaniu etykiety numer nadania zostaje zapisany na zamówieniu w xSale.
Zrzuty xSale
Zrzuty Poczta Polska
