Zakres integracji z Świat Przesyłek

Integracja z kurierem Świat Przesyłek umożliwia tworzenie przesyłek dla zamówień w xSale, przekazywanie danych paczki do systemu przewoźnika oraz pobieranie etykiety kurierskiej.

Konfiguracja integracji jest dostępna w interfejsie xSale V1. Ogólny sposób dodania integracji kurierskiej opisuje wpis Konfiguracja integracji z kurierem.

W tym artykule znajdziesz:

• co umożliwia integracja ze Światem Przesyłek,
• jakie dane trzeba uzupełnić w konfiguracji,
• jakie dane trafiają na przesyłkę,
• o czym warto pamiętać podczas konfiguracji.

Co umożliwia integracja?

Po skonfigurowaniu integracji xSale może przygotować przesyłkę dla zamówienia i przekazać do Świata Przesyłek dane potrzebne do jej nadania. W xSale można zapisać paczkę do dalszej edycji albo od razu wysłać ją do przewoźnika i pobrać etykietę.

W formularzu przesyłki xSale obsługuje między innymi:

• dane odbiorcy, czyli nazwę, firmę, adres, kraj, telefon i adres e-mail,
• parametry paczki: wysokość, długość, szerokość, wagę i wartość,
• pobranie, kwotę pobrania, walutę i numer rachunku dla pobrań,
• zawartość paczki i komentarz do zamówienia,
• numer listu przewozowego po utworzeniu przesyłki,
• pobranie etykiety kurierskiej.

Dane autoryzacyjne i konfiguracja

Do poprawnego działania integracji potrzebne są dane dostępowe do systemu Świat Przesyłek:

• użytkownik,
• hasło,
• klucz API, czyli ApiKey.

W konfiguracji warto uzupełnić także ustawienia domyślne, których xSale użyje podczas tworzenia przesyłek:

• domyślne wymiary i waga paczki – wysokość, długość, szerokość i waga,
• domyślna wartość paczki,
• numer konta dla przesyłek pobraniowych,
• nazwa formy płatności dla pobrania – jeśli nazwa płatności na zamówieniu zawiera wskazaną wartość, xSale potraktuje przesyłkę jako pobraniową,
• dane nadawcy, między innymi nazwę, adres, kod pocztowy, kraj, telefon, e-mail i osobę kontaktową,
• referencję, czyli informację, która ma trafić na paczkę lub etykietę,
• wyliczanie wagi, jeśli xSale ma próbować wyliczyć wagę z pozycji zamówienia.

Jeśli włączysz opcję Wyliczaj wagę, xSale spróbuje pobrać wagę z zamówionych towarów. Jeżeli nie będzie to możliwe, zostanie użyta waga domyślna z konfiguracji integracji.

W polu Referencja możesz użyć zmiennych:

• DocumentNumber – numer dokumentu,
• Articles – kod towaru,
• ArticlesName – nazwa towaru,
• OrderNumber – numer zamówienia.

Jeśli chcesz użyć kilku zmiennych, wpisz je po średniku, na przykład DocumentNumber;Articles. Możesz też wpisać stałą treść, która ma zostać przekazana jako referencja.

Jakie dane trafiają na przesyłkę?

Podczas tworzenia przesyłki xSale wykorzystuje dane z zamówienia oraz dane zapisane w konfiguracji integracji. Dane odbiorcy pochodzą z zamówienia, a dane nadawcy, domyślne wymiary, domyślna waga, wartość paczki i ustawienia pobrania mogą zostać uzupełnione z konfiguracji.

W formularzu przesyłki można zweryfikować lub uzupełnić dane przed wysłaniem paczki do przewoźnika. Wymagane są między innymi wymiary, waga, wartość paczki, dane adresowe odbiorcy, kraj, telefon, e-mail i nazwa odbiorcy.

O czym warto pamiętać?

• Konfiguracja integracji ze Światem Przesyłek jest dostępna w xSale V1.
• Nazwa formy płatności dla pobrania musi odpowiadać nazwie używanej na zamówieniach. Dzięki temu xSale rozpozna, że przesyłka ma być pobraniowa.
• Jeśli waga nie zostanie wyliczona z towarów, xSale użyje wagi domyślnej z konfiguracji.
• Przed wysłaniem paczki sprawdź dane odbiorcy, wymiary, wagę, wartość paczki i ewentualne pobranie.
• Po wysłaniu przesyłki do przewoźnika xSale może pobrać etykietę kurierską.