Wpis opisuje zakres danych wykorzystywanych przy generowaniu etykiety Poczta Polska dla usługi Pocztex 2.0 Kurier.
Dla tej usługi xSale przekazuje do Poczty Polskiej dane odbiorcy, masę, format przesyłki, zawartość, wybrane usługi dodatkowe oraz numer nadania zwrócony po poprawnym wygenerowaniu etykiety.
W tym artykule znajdziesz
- Jak działa Pocztex 2.0 Kurier?
- Jakie parametry przesyłki są przekazywane?
- Punkty nadania i odbioru
- Podprzesyłki i przesyłki Allegro
- Szczegółowy zakres danych
- O czym warto pamiętać?
Jak działa Pocztex 2.0 Kurier?
Po wybraniu usługi Pocztex 2.0 Kurier xSale tworzy w Poczcie Polskiej przesyłkę typu Pocztex 2021 Kurier. Do zgłoszenia trafiają dane adresowe odbiorcy, parametry paczki i usługi dodatkowe wybrane dla przesyłki.
Po poprawnym utworzeniu przesyłki Poczta Polska zwraca numer nadania. xSale zapisuje go na zamówieniu jako numer listu przewozowego.
Jakie parametry przesyłki są przekazywane?
Integracja obsługuje między innymi:
- format przesyłki – S, M, L, XL, XXL albo 2XL,
- masę – przekazywaną do Poczty Polskiej w gramach,
- zawartość – np. własna, owady, płyny lub gazy, przedmioty łatwo tłukące się i szkło, rzeczy łamliwe i kruche, żywe ptaki, żywe rośliny,
- ubezpieczenie, jeżeli wartość została uzupełniona,
- pobranie, jeżeli przesyłka jest pobraniowa,
- potwierdzenie doręczenia,
- potwierdzenie odbioru z wybranym sposobem przekazania,
- ostrożnie, sprawdzenie zawartości przez odbiorcę, do rąk własnych, odbiór w sobotę, koperta Pocztex,
- oczekiwany termin i godzina doręczenia, jeżeli zostały uzupełnione,
- zwrot dokumentów – Pocztex Kurier, list polecony ekonomiczny albo list polecony priorytetowy.
Punkty nadania i odbioru
Dla Pocztex 2.0 Kurier integracja może przekazać punkt nadania oraz punkt odbioru. Jeżeli w polu punktu zapisany jest identyfikator placówki, xSale przekazuje go bezpośrednio do Poczty Polskiej.
Jeżeli zapisano nazwę punktu, xSale wyszukuje placówkę po nazwie drukowanej. Gdy taka nazwa występuje w kilku miejscach, system próbuje doprecyzować punkt na podstawie kodu pocztowego i miejscowości. Jeżeli punktu nie da się jednoznacznie ustalić, etykieta nie zostanie wygenerowana i należy wybrać prawidłowy punkt.
Podprzesyłki i przesyłki Allegro
Usługa obsługuje podprzesyłki, czyli kilka paczek w ramach jednej przesyłki. W panelu V2 nie ma osobnego pola Ilość paczek na zamówieniu. Liczba paczek wynika z dodanych podpaczek/podprzesyłek. Jeżeli operator doda kolejne podpaczki, xSale przekaże je do Poczty Polskiej jako elementy jednej przesyłki. Dla każdej podprzesyłki xSale może przekazać format, masę, ostrożnie, ubezpieczenie i wartość.
Warianty Allegro tej usługi przekazują dodatkowe dane powiązania z Allegro, jeżeli przesyłka została utworzona dla odpowiedniego typu dostawy Allegro.
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 | 1 | Podstawowa nazwa odbiorcy. |
| 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 | Telefon / Telefon komórkowy | 7 | Adresat | Telefon | 7 | Do Poczty Polskiej przekazywany jest telefon zapisany przy odbiorcy. |
| Parametry przesyłki / podprzesyłki | Liczba paczek / podprzesyłki | Etykieta | Wielopak | 15 | W V2 liczba paczek nie jest osobnym polem na zamówieniu. Wynika z liczby dodanych podpaczek/podprzesyłek. Na etykiecie może być widoczna jako wielopak. | |
| Formularz zamówienia > Formularz zamówienia | List przewozowy | 13 | Etykieta | List przewozowy | 13 | Numer jest zapisywany w xSale po poprawnym wygenerowaniu etykiety. |
| ShipmentTask > Poczta Polska | Ostrożnie | 8 | Usługi dodatkowe | Ostrożnie | 8 | Usługa dodatkowa przekazywana do Poczty Polskiej, jeżeli została zaznaczona. |
| ShipmentTask > Poczta Polska | Wartość ubezpieczenia | 9 | Usługi dodatkowe | Ubezpieczenie | 9 | Przekazywana, jeżeli wartość została uzupełniona. |
| ShipmentTask > Poczta Polska | Referencja | 10 | Etykieta | Opis/Uwagi | 10 | W opisie może zostać przekazana referencja, np. identyfikator zamówienia z xSale. |
| ShipmentTask > Poczta Polska | Masa | 11 | Etykieta | Masa | 11 | Masa jest przekazywana w gramach. Wartość powinna być większa od zera. |
| ShipmentTask > Poczta Polska | Zawartość dla typu Pocztex 2.0 | 12 | Etykieta | Zawartość | 12 | Można wybrać wartość z listy albo przekazać własny opis zawartości. |
| ShipmentTask > Poczta Polska | Rozmiar przesyłki dla typu Pocztex 2.0 | 14 | Etykieta | Format | 14 | Obsługiwane wartości: S, M, L, XL, XXL albo 2XL. Jeżeli format nie jest wskazany, kod przyjmuje domyślnie S. |
O czym warto pamiętać?
- Dla Pocztex 2.0 Kurier kluczowe są kompletne dane odbiorcy, masa, format i zawartość przesyłki.
- Masa jest przekazywana do Poczty Polskiej w gramach.
- Jeżeli punkt nadania albo punkt odbioru jest zapisany jako nazwa, musi pozwalać na jednoznaczne wskazanie placówki Poczty Polskiej.
- Podprzesyłki pozwalają obsłużyć kilka paczek w ramach jednej przesyłki. W V2 to one określają liczbę paczek, zamiast osobnego pola Ilość paczek.
- Po wygenerowaniu etykiety numer listu przewozowego zostaje zapisany na zamówieniu w xSale.
EN


