Konfiguracja integracji kurierskiej InPost w interfejsie xSale V1
Przejście do konfiguracji integracji
W celu rozpoczęcia konfiguracji integracji między usługą InPost Kurier a systemem xSale należy zalogować się do panelu xSale w wersji V1.
Następnie należy przejść do sekcji:
Konfiguracja → Ogólne → Integracje,
a następnie otworzyć edycję pozycji ShipmentTask.
Na dole wyświetlonego ekranu należy wybrać opcję „Zapisz i przejść do instalatora”. Na tym etapie nie jest wymagane wprowadzanie żadnych zmian.
Dodawanie nowego konta kurierskiego
Po uruchomieniu instalatora wyświetlana jest lista dostępnych kont kurierskich. Mogą znajdować się tam już wcześniej dodane integracje. W celu dodania nowego konta należy użyć przycisku „Dodaj nowe konto” znajdującego się w prawym dolnym rogu ekranu.
Po wyświetleniu listy dostępnych integracji kurierskich należy wybrać opcję „InPost”, co spowoduje przejście do formularza konfiguracji.
Wymagane dane konfiguracyjne
W formularzu należy uzupełnić wymagane pola:
- Wewnętrzna nazwa konta – dowolna nazwa identyfikująca konto w panelu xSale,
- API Token – wartość pobrana od usługodawcy InPost,
- Numer organizacji – również pobierany od InPost.
Jeżeli wcześniej istniała już integracja z InPost, możliwe jest wykorzystanie tych samych danych.
Ustawienia metod wysyłki
W dalszej części formularza znajdują się pola umożliwiające przypisanie domyślnych metod wysyłki oraz usług kurierskich obsługiwanych przez InPost. Wartości te wybierane są z list rozwijalnych i będą wykorzystywane podczas rejestracji przesyłek.
Usługi InPost dostępne w konfiguracji dzielą się na dwa typy połączeń. W ramach integracji standardowej dostępne są ustawienia:
- „inpost_locker_standard” – usługa Paczkomaty przeznaczona dla zamówień z platform e‑commerce,
- „inpost_courier_standard” – usługa kurierska przeznaczona dla zamówień z platform e‑commerce.
- „inpost_letter_standard” – usługa MiniPaczka (koperta) przeznaczona dla zamówień z platform e‑commerce.
Dla integracji wykorzystywanej w połączeniu xSale z Allegro dostępne są ustawienia:
- „inpost_locker_allegro” – usługa Paczkomatowa dedykowana dla zamówień z platformy Allegro,
- „inpost_courier_allegro” – usługa kurierska dedykowana dla zamówień z platformy Allegro.
- „inpost_letter_allegro”– usługa MiniPaczka (koperta) przeznaczona dla zamówień z platformy Allegro.
Domyślne ustawienia przesyłki
W kolejnym kroku należy uzupełnić domyślne parametry przesyłki, takie jak:
- rozmiar paczki (długość, szerokość, wysokość),
- waga,
- wartość ubezpieczenia,
- referencja,
- typ etykiety,
- sposób nadania.
Dla każdej usługi kurierskiej można zdefiniować odrębne wymiary i wagę.
W przypadku podania tylko jednego wymiaru (np. szerokości), pozostałe wartości zostaną uzupełnione automatycznie na podstawie domyślnego rozmiaru paczki.
Konfiguracja płatności COD
W polu „Formy płatności przesyłek COD” należy wprowadzić dokładne nazwy form płatności występujących w zamówieniach z opcją płatności przy odbiorze. Wartości te muszą być zgodne z nazwami widocznymi w zamówieniach.
Dodatkowe ustawienia
- W polu „Pusty email” można zdefiniować adres e‑mail, który zostanie użyty w przypadku braku adresu w zamówieniu.
- Dostępna jest opcja automatycznego wyliczania wagi przesyłki na podstawie wag produktów znajdujących się w zamówieniu. Aby ją aktywować, należy ustawić pole „Wyliczaj wagę” na wartość tak.
Wprowadzone dane będą wykorzystywane zarówno przy automatycznym tworzeniu przesyłek, jak i podczas ręcznego generowania listów przewozowych (z możliwością edycji parametrów w pojedynczej przesyłce).
Zapis konfiguracji
Po uzupełnieniu wszystkich pól należy zapisać konfigurację, wybierając przycisk „Zapisz wszystkie dokonane zmiany”.
Informacja końcowa
Dodana integracja jest wykorzystywana podczas definiowania sposobów dostawy oraz ich mapowania w integracjach z kanałami sprzedaży. Czynności te realizowane są w interfejsie xSale V2.
