Konfiguracja integracji

Wpis opisuje konfigurację integracji Szybkie Zwroty InPost w xSale. Integracja służy do obsługi etykiety zwrotnej InPost dla zamówień realizowanych przez konto kurierskie InPost.

Konfiguracja składa się z dwóch części. Najpierw należy dodać integrację Szybkie Zwroty InPost w panelu V2, a następnie powiązać jej ID z głównym kontem InPost w konfiguracji V1.

W tym artykule znajdziesz:

• Jak przygotować dane z InPost?
• Jak dodać integrację Szybkie Zwroty InPost w xSale?
• Jak ustawić rozmiar paczki?
• Jak sprawdzić ID integracji zwrotów?
• Jak powiązać Szybkie Zwroty z kontem InPost w V1?
• Jak działa generowanie etykiety zwrotnej?
• O czym warto pamiętać?

Jak przygotować dane z InPost?

Przed rozpoczęciem konfiguracji skontaktuj się z opiekunem konta InPost i poproś o dane potrzebne do uruchomienia Szybkich Zwrotów:

• Client ID,
• Secret.

Poproś również o potwierdzenie, że po stronie InPost dla Twojego konta są dostępne pola labelUrl oraz trackingNumber. xSale wykorzystuje je podczas pobierania etykiety zwrotnej: labelUrl wskazuje adres pliku PDF etykiety, a trackingNumber jest numerem listu zwrotnego.

Uwaga: Client ID i Secret nie są tym samym, co login i hasło używane do logowania w panelu InPost.

Jak dodać integrację Szybkie Zwroty InPost w xSale?

W panelu xSale przejdź do Integracje → Integracje. W sekcji integracji kurierskich wybierz kafelek Szybkie Zwroty InPost.

W pierwszym kroku kreatora wpisz nazwę konta, Client ID oraz Secret otrzymane z InPost. Następnie przejdź dalej i zapisz konfigurację.

Jak ustawić rozmiar paczki?

W kolejnym kroku wybierz rozmiar paczki, który ma być przekazywany do InPost podczas tworzenia etykiety zwrotnej. Wartość z tego pola jest używana przy zgłoszeniu zwrotu do InPost Returns API.

Jak sprawdzić ID integracji zwrotów?

Po utworzeniu integracji otwórz ją ponownie w trybie edycji. ID integracji znajdziesz w adresie strony w przeglądarce. Ten numer będzie potrzebny w kolejnym kroku, podczas powiązania Szybkich Zwrotów z głównym kontem InPost.

Jak powiązać Szybkie Zwroty z kontem InPost w V1?

Sama integracja Szybkie Zwroty InPost jest tworzona w panelu V2, ale jej powiązanie z głównym kontem kurierskim InPost wykonuje się w konfiguracji V1.

Przejdź do panelu V1: https://online.xsale.ai/, a następnie wybierz Konfiguracja → Integracje → ShipmentTask → Edytuj.

Kliknij Zapisz i przejdź do instalatora.

Na liście kont kurierskich odszukaj główne konto InPost, które obsługuje wysyłkę zamówień, i wybierz jego edycję.

W polu Id integracji zwrotów wpisz ID integracji Szybkie Zwroty InPost utworzonej w panelu V2. Zapisz zmiany.

Jak działa generowanie etykiety zwrotnej?

Po poprawnej konfiguracji xSale może pobrać etykietę zwrotną InPost dla zamówienia obsługiwanego przez powiązane konto InPost.

Podczas tworzenia etykiety zwrotnej xSale przekazuje do InPost dane odbiorcy z zamówienia jako dane osoby nadającej zwrot:

• imię,
• nazwisko,
• numer telefonu,
• adres e-mail,
• rozmiar paczki ustawiony w konfiguracji integracji.

Jeżeli numer telefonu nie zawiera prefiksu kraju, xSale dodaje prefiks +48. Numer nadal musi być poprawny, ponieważ InPost wymaga numeru w formacie międzynarodowym.

W odpowiedzi z InPost xSale oczekuje numeru listu zwrotnego oraz adresu etykiety PDF. Numer listu zwrotnego jest zapisywany na zamówieniu w polu Nr listu zwrotnego, a etykieta jest pobierana jako plik PDF.

O czym warto pamiętać?

• Do wygenerowania etykiety zwrotnej potrzebne są poprawne dane klienta na zamówieniu, w szczególności telefon i e-mail.
• Jeżeli InPost nie zwróci pola labelUrl, xSale nie pobierze pliku etykiety.
• Jeżeli InPost nie zwróci pola trackingNumber, xSale nie zapisze numeru listu zwrotnego na zamówieniu.
• Jeżeli etykieta zwrotna ma być generowana razem z obsługą wysyłki przez InPost, ID integracji zwrotów musi być wpisane w konfiguracji głównego konta InPost w V1.