EN
Integracja z Pocztą Polską umożliwia generowanie etykiet dla przesyłek typu Paczka pocztowa. xSale przekazuje do Poczty Polskiej dane odbiorcy, parametry przesyłki oraz wybrane usługi dodatkowe, a po utworzeniu przesyłki zapisuje numer listu przewozowego na zamówieniu.
W tym artykule znajdziesz
- jak działa generowanie Paczki pocztowej
- jakie parametry i usługi są obsługiwane
- jak wybierany jest urząd nadania
- szczegółowy zakres danych widocznych na etykiecie
- o czym warto pamiętać
Jak działa generowanie Paczki pocztowej
Po uruchomieniu generowania etykiety xSale tworzy przesyłkę w buforze Poczty Polskiej. Dla typu Paczka pocztowa wykorzystywane są dane adresata z zamówienia oraz ustawienia z konfiguracji dostawy, między innymi kategoria, gabaryt i masa.
Po poprawnym utworzeniu przesyłki Poczta Polska zwraca numer nadania. xSale zapisuje go na zamówieniu jako numer listu przewozowego.
Dostępne parametry i usługi
Dla Paczki pocztowej obsługiwane są następujące parametry:
- Kategoria: ekonomiczna albo priorytetowa,
- Gabaryt: Gabaryt A albo Gabaryt B,
- Masa: przekazywana do Poczty Polskiej w gramach.
Obsługiwane są również:
- ilość potwierdzeń odbioru – wartość większa od zera oznacza skorzystanie z potwierdzenia odbioru,
- egzemplarz biblioteczny,
- dla ociemniałych.
Jeżeli kategoria nie zostanie określona, integracja nie utworzy poprawnej przesyłki. Jeżeli gabaryt nie zostanie ustawiony, kod przyjmuje domyślnie Gabaryt A. Masa jest przekazywana zawsze i powinna być większa od zera.
Sposób wybierania urzędu nadania
Przy wysyłaniu bufora xSale sprawdza konfigurację domyślnego urzędu nadania. Najpierw próbuje znaleźć urząd po nazwie zapisanej w konfiguracji. Jeżeli urząd o takiej nazwie nie zostanie znaleziony, a w konfiguracji wpisano liczbę, system potraktuje tę wartość jako identyfikator urzędu nadania.
Jeżeli nie uda się ustalić urzędu nadania ani po nazwie, ani po identyfikatorze, bufor jest wysyłany bez wskazania konkretnego urzędu.
Szczegółowy zakres danych dla Paczki pocztowej
Poniższa tabela prezentuje zakres danych wykorzystywanych przy generowaniu etykiety Paczki pocztowej. Numery w tabeli prowadzą do zrzutów ekranu z oznaczonymi polami.
| Obszar xSale | Pole xSale | nr | Obszar etykiety | Pole na etykiecie | nr | Uwagi |
| Formularz zamówienia > Formularz adresu > Odbiorca | Nazwa | 2 | Adresat | Nazwa | 2 | Jeżeli pole Nazwa 2 jest puste, na etykiecie wykorzystywana jest wartość z pola Nazwa. |
| Formularz zamówienia > Formularz adresu > Odbiorca | Miasto | 6 | Adresat | Miasto | 6 | |
| 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 do Poczty Polskiej w danych adresata. |
| Formularz zamówienia > Formularz adresu > Odbiorca | Telefon / Telefon komórkowy | 7 | Adresat | tel. | 7 | Integracja przekazuje telefon oraz telefon komórkowy z danych odbiorcy. Numery są oczyszczane z niedozwolonych znaków przed wysłaniem. |
| Formularz zamówienia > Formularz zamówienia | List przewozowy | 10 | Etykieta | List przewozowy | 10 | Numer nadania jest zwracany przez Pocztę Polską po utworzeniu przesyłki i zapisywany w xSale na zamówieniu. |
| ShipmentTask > Poczta Polska | Masa | 9 | Etykieta | Masa | 9 | Podawana w gramach. Pole jest przekazywane do Poczty Polskiej i powinno mieć wartość większą od zera. |
| ShipmentTask > Poczta Polska | Kategoria | 1 | Etykieta | Usługi dodatkowe / kategoria przesyłki | 1 | Obsługiwane wartości to Ekonomiczna i Priorytetowa. Brak kategorii powoduje błąd przy przygotowaniu danych przesyłki. |
| ShipmentTask > Poczta Polska | Rozmiar przesyłki | 8 | Etykieta | Gabaryt | 8 | Obsługiwane wartości to Gabaryt A i Gabaryt B. Jeżeli gabaryt nie zostanie określony, system przyjmuje domyślnie Gabaryt A. |
O czym warto pamiętać
- Konfiguracja integracji kurierskiej Poczty Polskiej jest wykonywana w panelu xSale V1.
- Dla Paczki pocztowej kluczowe są: kategoria, gabaryt i masa przesyłki.
- Masa jest przekazywana w gramach i powinna być większa od zera.
- Jeżeli kategoria nie zostanie określona, przesyłka nie zostanie poprawnie przygotowana.
- Po wygenerowaniu przesyłki numer nadania zwrócony przez Pocztę Polską trafia do pola listu przewozowego na zamówieniu.
- Przesyłka tworzona jest najpierw w buforze Poczty Polskiej. Przy wysyłaniu bufora system korzysta z urzędu nadania ustawionego w konfiguracji, jeśli może go jednoznacznie ustalić.
Zrzuty xSale
Zrzuty Poczta Polska
