Integracja InPost Kurier pozwala tworzyć przesyłki kurierskie do zamówień w xSale, pobierać etykiety i zapisywać numer listu zwrócony przez InPost. Dane przesyłki pochodzą z zamówienia i ustawień konta kurierskiego.
W tym artykule znajdziesz
- Jak działa generowanie etykiety
- Obsługiwane usługi
- Dane przekazywane do InPost
- Szczegółowy zakres danych
- Ważne zasady konfiguracji
- Zrzuty xSale
- Zrzuty InPost
Jak działa generowanie etykiety?
xSale przygotowuje dane odbiorcy i paczki, przekazuje je do InPost, a następnie pobiera numer listu i etykietę. Dane nadawcy pochodzą z konta InPost, nie z danych odbiorcy na zamówieniu.
Połączenie korzysta z tokenu API i numeru organizacji. Sama zmiana hasła do Managera Paczek nie wymaga zmiany konfiguracji xSale, jeśli token pozostaje ważny.
Obsługiwane usługi
- inpost_courier_standard – standardowa przesyłka kurierska InPost.
- inpost_courier_allegro – Allegro Kurier InPost.
Usługa wynika ze sposobu dostawy przypisanego do zamówienia i musi być dostępna na Twoim koncie InPost. Przesyłki paczkomatowe opisujemy osobno w zakresie integracji InPost Paczkomaty.
Dane przekazywane do InPost
- Dane odbiorcy: nazwa, telefon, e-mail, ulica i numer budynku/lokalu, kod pocztowy, miejscowość i kraj.
- Usługa kurierska, sposób nadania oraz punkt nadania, jeśli jest potrzebny.
- Parametry paczki: wymiary, waga, gabaryt i oznaczenie paczki niestandardowej.
- Dodatkowe paczki w ramach przesyłki kurierskiej, gdy liczba paczek jest większa niż 1.
- Pobranie, ubezpieczenie i referencja.
- Usługi dodatkowe, np. powiadomienia SMS i e-mail, doręczenie w sobotę, zwrot dokumentów lub doręczenie w określonych godzinach, jeśli wybrano je w danych przesyłki i InPost udostępnia je dla danego konta i usługi.
Wymiary w xSale podajesz w milimetrach, a wagę w kilogramach. Dla Allegro Kurier InPost, jeśli nie zastosowano własnych parametrów paczki, używany jest gabaryt C. Nie należy traktować gabarytów A/B/C jako jednakowo działających dla wszystkich usług InPost.
Szczegółowy zakres danych dla InPost Kurier
Tabela pokazuje pola xSale i ich odpowiedniki na przykładowej etykiecie kurierskiej. Numery otwierają właściwy zrzut. Ilustracje pokazują położenie pól; podane wartości nie są zalecanymi ustawieniami.
Nie każde pole przekazywane do InPost jest drukowane na etykiecie. Wymiary na pokazanym wydruku są ujęte w jednym bloku, oznaczonym numerem 17.
| Obszar xSale | Pole xSale | nr | Obszar etykiety |
Pole na etykiecie | nr | Uwagi |
| Zamówienie → Informacje o przesyłce | Nr listu | 11 | Numer paczki | Numer paczki | 1 | Numer jest nadawany przez InPost i zapisywany w xSale. Jest wynikiem utworzenia przesyłki, a nie numerem zamówienia wysyłanym do przewoźnika. |
| Zamówienie → Informacje o przesyłce | Ilość paczek | 9 | Ilość podprzesyłek | Nie pokazano na tej etykiecie | Dla usług kurierskich xSale przygotowuje dodatkowe paczki, gdy liczba paczek jest większa niż 1. Na pokazanej etykiecie liczba paczek nie ma osobnego oznaczenia. | |
| Zamówienie → Zamawiający → Odbiorca | Nazwa | 1, 2 | Odbiorca | Imię i Nazwisko | 2 | Dane nazwy odbiorcy są prezentowane w bieżącym widoku w jednym obszarze. Na etykiecie InPost mogą być częściowo zamaskowane. |
| Zamówienie → Zamawiający → Odbiorca | Ulica i numer budynku/lokalu | 5, 6 | Odbiorca | Ulica i numer budynku/lokalu | 3, 4 | |
| Zamówienie → Zamawiający → Odbiorca | Kod pocztowy | 7 | Odbiorca | Kod pocztowy | 5 | |
| Zamówienie → Zamawiający → Odbiorca | Miasto | 4 | Odbiorca | Miasto | 6 | |
| Zamówienie → Zamawiający → Odbiorca | Telefon | 3 | Odbiorca | Numer telefonu | 7 | |
| Zamówienie → Płatność | Forma płatności | 13 | Pobranie | POBRANIE: | 16 | Jeśli nazwa odpowiada formie COD skonfigurowanej dla konta, kwota pobrania jest przygotowywana z wartości zamówienia. Dane przesyłki mogą zostać później zmienione. |
| Zamówienie → Podsumowanie zamówienia | Wartość brutto | 12 | Wartość zamówienia służy do przygotowania kwoty pobrania. Ubezpieczenie przyjmuje kwotę pobrania, gdy jest ona dodatnia. | |||
| brak odpowiednika | Nadawca | 8 | Dane pobierane z ustawień konta InPost użytego do generowania przesyłki przez API | |||
| Integracje → konto InPost → Ustawienia domyślne | Referencja | 21 | Uwagi | Uwagi | 9 | Treść jest przygotowywana z ustawienia Referencja, np. OrderNumber, lub stałego tekstu. Nie jest automatyczną kopią uwag klienta. Może zostać zmieniona w danych przesyłki. ForeignNumber oznacza Nr obcy z zamówienia; przy braku numeru wartość jest pomijana. Jak ustawić numer obcy w referencji. |
| Integracje → konto InPost → Ustawienia domyślne | Wysokość (dla typu „inpost_courier_standard”) | 19 | Wysokość | Wysokość | 17 | W xSale wartość podajesz w milimetrach. Na przedstawionej etykiecie InPost wymiary są pokazane wspólnie w centymetrach (nr 17). Ustawienia usługi lub konkretnej przesyłki mogą zmienić wartość domyślną. |
| Integracje → konto InPost → Ustawienia domyślne | Długość (dla typu „inpost_courier_standard”) | 17 | Długość | Długość | 17 | W xSale wartość podajesz w milimetrach. Na przedstawionej etykiecie InPost wymiary są pokazane wspólnie w centymetrach (nr 17). Ustawienia usługi lub konkretnej przesyłki mogą zmienić wartość domyślną. |
| Integracje → konto InPost → Ustawienia domyślne | Szerokość (dla typu „inpost_courier_standard”) | 18 | Szerokość | Szerokość | 17 | W xSale wartość podajesz w milimetrach. Na przedstawionej etykiecie InPost wymiary są pokazane wspólnie w centymetrach (nr 17). Ustawienia usługi lub konkretnej przesyłki mogą zmienić wartość domyślną. |
| Integracje → konto InPost → Ustawienia domyślne | Waga (dla typu „inpost_courier_standard”) | 20 | Waga | Waga | 14 | Waga w kilogramach. Jeśli włączono Wyliczaj wagę, łączna waga zamówienia jest dzielona pomiędzy paczki; przy braku wagi lub wartości zero używana jest waga domyślna. |
| Integracje → konto InPost → Ustawienia domyślne | Wartość ubezpieczenia | 14 | Ubezpieczenie | brak widocznego pola na aktualnej etykiecie | Ubezpieczenie jest przekazywane jako parametr przesyłki. Przy dodatniej kwocie pobrania xSale przygotowuje ubezpieczenie równe tej kwocie; w pozostałych przypadkach korzysta z konfiguracji. Nie jest widoczne jako osobne pole na pokazanej etykiecie. | |
| Integracje → konto InPost → Ustawienia domyślne | 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. |
Ważne zasady konfiguracji
- Ustawienia znajdziesz w Integracje → konto InPost → Ustawienia domyślne. Parametry zapisane dla konkretnej usługi w Dodatkowej konfiguracji mają pierwszeństwo przed odpowiadającymi im wartościami domyślnymi. Dane przesyłki lub proces automatyczny mogą je następnie zmienić.
- Nazwy form płatności COD rozdzielaj średnikiem. Przy porównywaniu nazw system pomija wielkość liter oraz spacje na początku i końcu nazwy.
- Kwota pobrania jest przygotowywana z wartości zamówienia. Waluta pochodzi z zamówienia, a przy jej braku z konfiguracji. Przed nadaniem sprawdź ostateczną kwotę, walutę i ubezpieczenie.
- Zastępczy adres Pusty email może być użyty przy braku e-maila odbiorcy dla standardowego kuriera. Nie dotyczy usługi Allegro Kurier InPost.
- Opcja poprawiania telefonu usuwa wszystkie początkowe zera, ale nie weryfikuje poprawności numeru. Szczegóły opisujemy we wpisie Poprawianie numeru telefonu.
- Przy wyliczaniu wagi dla wielu paczek łączna waga jest dzielona pomiędzy paczki. Opcja nie uzupełnia brakujących wymiarów.
Instrukcję połączenia konta i ustawień znajdziesz we wpisie Konfiguracja integracji kurierskiej InPost. Jeśli nadanie się nie powiedzie, sprawdź komunikat błędu i popraw wskazane dane przesyłki przed ponowną próbą.
Zrzuty xSale


Zrzuty InPost


EN