Integracje

⌘K
  1. Strona główna
  2. Integracje
  3. Kurier – InPost Kurier
  4. Zakres integracji z InPost Kurier

Zakres integracji z InPost Kurier

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?

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

Zamówienie InPost Kurier z oznaczeniami danych odbiorcy, płatności i przesyłki
Ustawienia InPost Kurier z oznaczeniami pól

Zrzuty InPost

Etykieta InPost Kurier z oznaczeniami pól

Czego brakuje w tym artykule?