EN
Integracja z InPost Kurier umożliwia generowanie etykiet kurierskich do zamówień obsługiwanych w xSale. Podczas tworzenia przesyłki xSale pobiera dane z zamówienia oraz z konfiguracji integracji, przekazuje je do InPost przez API ShipX, a następnie zapisuje numer listu przewozowego zwrócony przez InPost.
Wpis opisuje zakres danych wykorzystywanych przy generowaniu etykiety InPost. Zrzuty ekranu pozostają bez zmian i pokazują przykładowe pola z wcześniejszego widoku xSale.
W tym artykule znajdziesz
- jak działa generowanie etykiety InPost Kurier
- jakie usługi InPost są obsługiwane
- jakie dane xSale przekazuje do InPost
- szczegółowy zakres danych na przykładzie etykiety
- o czym warto pamiętać przy konfiguracji
Jak działa generowanie etykiety InPost Kurier?
Po uruchomieniu generowania etykiety xSale tworzy przesyłkę w InPost na podstawie danych zamówienia i ustawień integracji kurierskiej. Do InPost przekazywane są przede wszystkim dane odbiorcy, parametry paczki, metoda usługi, sposób nadania, pobranie COD, ubezpieczenie, usługi dodatkowe oraz referencja.
Dane nadawcy nie są ręcznie przekazywane z formularza zamówienia xSale. W kodzie generowania przesyłki nadawca jest pomijany w requestcie do InPost, a dane nadawcy są pobierane po stronie konta InPost używanego do wygenerowania przesyłki.
Zmiana hasła w Managerze Paczek InPost nie wymaga zmiany konfiguracji integracji kurierskiej w xSale, ponieważ integracja InPost Kurier w xSale nie zapisuje hasła do Managera Paczek jako danych używanych przy generowaniu etykiety.
Jakie usługi InPost są obsługiwane?
Integracja obsługuje następujące typy usług InPost:
- inpost_locker_standard – standardowa przesyłka do Paczkomatu,
- inpost_courier_standard – standardowa przesyłka kurierska,
- inpost_locker_allegro – przesyłka Allegro do Paczkomatu,
- inpost_letter_allegro – MiniPaczka Allegro InPost,
- inpost_courier_allegro – przesyłka Allegro Kurier InPost.
Typ usługi zależy od sposobu dostawy przypisanego do zamówienia. Dla każdej metody można ustawić odpowiedni sposób nadania i punkt nadania, jeśli dana usługa tego wymaga.
Jakie dane xSale przekazuje do InPost?
Przy generowaniu przesyłki xSale może przekazać do InPost:
- dane odbiorcy: imię i nazwisko lub nazwę, e-mail, telefon oraz adres,
- usługę InPost, np. inpost_courier_standard,
- sposób nadania i punkt nadania, jeśli są ustawione w konfiguracji,
- punkt odbioru dla przesyłek paczkomatowych,
- parametry paczki: gabaryt, długość, szerokość, wysokość, wagę i oznaczenie paczki niestandardowej,
- podpaczki, jeśli w przesyłce dodano więcej niż jedną paczkę,
- pobranie COD, gdy forma płatności z zamówienia odpowiada formie COD ustawionej w konfiguracji,
- ubezpieczenie przesyłki,
- usługi dodatkowe, m.in. SMS, e-mail, dostawę w sobotę, zwrot dokumentów oraz wybrane usługi godzinowe, jeśli są ustawione i dostępne dla danej usługi InPost,
- referencję widoczną na etykiecie jako uwagi.
Gabaryty A, B i C są mapowane na wartości InPost small, medium i large. Dla MiniPaczki Allegro xSale przekłada je na odpowiednie typy letter_a, letter_b i letter_c. Wymiary są przekazywane do InPost w milimetrach, a waga w kilogramach.
Szczegółowy zakres danych dla InPost Kurier
Poniższa tabela prezentuje zakres danych widocznych w xSale i na przykładowej etykiecie InPost. Numer w tabeli prowadzi do zrzutu ekranu z oznaczonym polem.
Nie każde pole przekazywane do InPost jest widoczne na aktualnym wydruku etykiety. Część danych służy do utworzenia przesyłki albo określenia jej parametrów, ale InPost nie drukuje ich jako osobnego pola na etykiecie.
| Obszar xSale | Pole xSale | nr | Obszar etykiety |
Pole na etykiecie | nr | Uwagi |
| Formularz zamówienia > Numer listu | Numer listu | 11 | Numer paczki | Numer paczki | 1 | |
| Formularz zamówienia > Ilość paczek | Ilość paczek | 9 | Ilość podprzesyłek | 10 | ||
| Formularz zamówienia > Formularz adresu > Odbiorca | Nazwa | 1 | Odbiorca | Imię i Nazwisko | 2 | |
| Formularz zamówienia > Formularz adresu > Odbiorca | Nazwa 2 | 2 | Odbiorca | Imię i Nazwisko | 2 | |
| Formularz zamówienia > Formularz adresu > Odbiorca | Ulica | 5 | Odbiorca | Ulica | 3 | |
| Formularz zamówienia > Formularz adresu > Odbiorca | Numer Ulicy | 6 | Odbiorca | Nr domu | 4 | |
| Formularz zamówienia > Formularz adresu > Odbiorca | Kod pocztowy | 7 | Odbiorca | Kod pocztowy | 5 | |
| Formularz zamówienia > Formularz adresu > Odbiorca | Miasto | 4 | Odbiorca | Miasto | 6 | |
| Formularz zamówienia > Formularz adresu > Odbiorca | Telefon | 3 | Odbiorca | Numer telefonu | 7 | |
| Formularz zamówienia > Płatność | Płatność | 13 | Pobranie | POBRANIE: | 16 | Jeżeli forma płatności na zamówieniu odpowiada formie COD ustawionej w konfiguracji integracji, xSale przekazuje do InPost kwotę pobrania z wartości zamówienia. |
| Formularz zamówienia > Suma | Suma | 12 | Wartość zamówienia jest używana m.in. przy przesyłce pobraniowej i ubezpieczeniu COD. | |||
| brak odpowiednika | Nadawca | 8 | Dane pobierane z ustawień konta InPost użytego do generowania przesyłki przez API | |||
| ShipmentTask > Edycja InPost | Referencja | 21 | Uwagi | Uwagi | 9 | Referencja może zawierać stały tekst lub odwołanie do wartości z konkretnego zamówienia np. ID zamówienia, kod towaru, nazwa towaru, kod oferty. |
| ShipmentTask > Edycja InPost | Wysokość (dla typu „inpost_courier_standard”) | 19 | Wysokość | Wysokość | 11 | |
| ShipmentTask > Edycja InPost | Długość (dla typu „inpost_courier_standard”) | 17 | Długość | Długość | 12 | |
| ShipmentTask > Edycja InPost | Szerokość (dla typu „inpost_courier_standard”) | 18 | Szerokość | Szerokość | 13 | |
| ShipmentTask > Edycja InPost | Waga (dla typu „inpost_courier_standard”) | 20 | Waga | Waga | 14 | |
| ShipmentTask > Edycja InPost | Wartość ubezpieczenia | 14 | Ubezpieczenie | brak widocznego pola na aktualnej etykiecie | xSale przekazuje ubezpieczenie do InPost jako parametr przesyłki. Dla przesyłki pobraniowej xSale ustawia ubezpieczenie na kwotę pobrania. Dla przesyłki bez pobrania może zostać użyta wartość ubezpieczenia z konfiguracji. Aktualna etykieta InPost nie pokazuje tej wartości jako osobnego pola. | |
| ShipmentTask > Edycja InPost | Sposób nadania – „inpost_courier_standard” | 15 | Sposób nadania | brak widocznego pola na aktualnej etykiecie | Informacja wynika ze sposobu nadania ustawionego w konfiguracji integracji dla danej metody InPost. xSale przekazuje ten parametr do InPost, ale aktualna etykieta nie pokazuje go jako osobnego pola. |
O czym warto pamiętać?
- Forma płatności COD musi być wpisana w konfiguracji dokładnie tak, jak występuje na zamówieniu. Jeśli jest kilka nazw, należy rozdzielić je średnikiem.
- Dla przesyłki pobraniowej xSale przekazuje kwotę pobrania z wartości zamówienia i ustawia ubezpieczenie na kwotę pobrania.
- Jeżeli włączone jest poprawianie numeru telefonu, xSale usuwa początkowe zero z numeru odbiorcy przed wysłaniem danych do InPost.
- Jeżeli na zamówieniu brakuje e-maila odbiorcy, może zostać użyty adres domyślny z konfiguracji integracji, osobno dla przesyłek paczkomatowych i kurierskich.
- Jeżeli InPost zwróci błąd dotyczący punktu odbioru, należy sprawdzić, czy na zamówieniu jest prawidłowy punkt odbioru/paczkomat i czy dana usługa InPost go obsługuje.
- Po wygenerowaniu przesyłki xSale odpytuje InPost o numer listu przewozowego. Numer zwrócony przez InPost jest zapisywany na zamówieniu.
Zrzuty xSale
Zrzuty InPost
