EN
Integracja kurierska z Olza Logistic umożliwia tworzenie przesyłek z xSale przez API Olza Logistic oraz pobieranie etykiet dla utworzonych przesyłek. Integracja może być używana między innymi dla zamówień z własnego e-commerce oraz dla zamówień pochodzących z marketplace eMAG.
Warunkiem korzystania z integracji jest aktywna umowa z Olza Logistic oraz dane dostępowe do API. Integracja w xSale obsługuje przesyłki typu warehouse, czyli przesyłki, które w procesie logistycznym przechodzą przez magazyn Olza Logistic.
W tym artykule znajdziesz:
- Co umożliwia integracja?
- Jakie dane xSale przekazuje do Olza Logistic?
- Jakie metody wysyłki są dostępne?
- Jak działa obsługa zamówień z eMAG?
- O czym warto pamiętać?
Co umożliwia integracja?
Po poprawnej konfiguracji xSale może:
- utworzyć przesyłkę w Olza Logistic na podstawie danych z zamówienia,
- przekazać wybraną metodę wysyłki jako kod usługi Olza Logistic,
- obsłużyć przesyłkę za pobraniem, jeśli sposób płatności jest skonfigurowany jako pobraniowy,
- przekazać liczbę paczek, wagę i opis przesyłki,
- przekazać punkt odbioru, jeśli dana metoda dostawy tego wymaga,
- pobrać etykietę dla utworzonej przesyłki,
- zapisać numer przesyłki zwrócony przez Olza Logistic.
Integracja nie służy do importu zamówień z Olza Logistic. Zamówienie musi być już dostępne w xSale, a integracja kurierska odpowiada za etap nadania przesyłki.
Jakie dane xSale przekazuje do Olza Logistic?
Podczas tworzenia przesyłki xSale przekazuje do Olza Logistic między innymi:
- dane nadawcy: nazwę, adres, miasto, kod pocztowy, osobę kontaktową, e-mail i telefon,
- dane odbiorcy: imię, nazwisko, adres, miasto, kod pocztowy, województwo lub region, e-mail i telefon,
- kraj nadawcy i odbiorcy,
- kod usługi przewozowej, czyli metodę wysyłki wybraną w konfiguracji,
- typ przesyłki warehouse,
- punkt odbioru lub automat paczkowy, jeśli jest wymagany,
- liczbę paczek i wagę,
- opis przesyłki oraz numer referencyjny,
- dane pobrania, jeśli zamówienie ma formę płatności oznaczoną w konfiguracji jako pobranie,
- dodatkowe usługi, np. wybrane opcje dostawy, ubezpieczenia lub obsługi palety, jeśli są skonfigurowane.
Jeżeli w konfiguracji włączono przeliczanie wagi z dokumentu, xSale może ustawić wagę przesyłki na podstawie wagi towarów z zamówienia. Jeżeli wagi nie da się wyliczyć, używana jest wartość domyślna z konfiguracji.
Jakie metody wysyłki są dostępne?
W konfiguracji xSale dostępne są metody wysyłki odpowiadające kodom usług Olza Logistic. W kodzie integracji widoczne są między innymi:
- GLS home delivery,
- Zásilkovna / Packeta, w tym warianty dostawy do punktu, domu i kuriera,
- Cargus home delivery,
- Cargus pick-up point,
- FAN Courier home delivery,
- FAN Courier pick-up point,
- Poczta Czeska home delivery,
- Poczta Czeska post office,
- PPL home delivery,
- WE|DO home delivery,
- Poczta Węgierska home delivery,
- Sameday Easybox parcel locker,
- Econt home delivery, pick-up point i parcel locker,
- Speedy home delivery i pick-up point,
- Poczta Słowacka home delivery,
- ACS home delivery i pick-up point,
- Taxydromiki home delivery.
Dostępność konkretnej metody zależy od umowy i konfiguracji po stronie Olza Logistic. Jeżeli dana metoda nie jest dostępna dla konta klienta albo dla wybranego kraju, API Olza Logistic może zwrócić błąd podczas tworzenia przesyłki.
Jak działa obsługa zamówień z eMAG?
Integracja obsługuje także warianty wysyłki dla zamówień z eMAG. W konfiguracji dostępne są między innymi:
- eMAG – Cargus home delivery,
- eMAG – FAN Courier home delivery,
- eMAG – Sameday Easybox parcel locker,
- eMAG – Sameday home delivery.
Dla usług eMAG xSale przekazuje dodatkowo identyfikator zamówienia marketplace jako marketPlaceId. Jeżeli zamówienie eMAG nie ma kodu pocztowego, dla wybranych usług eMAG xSale może przekazać techniczną wartość zastępczą wymaganą przez integrację.
Szczegóły dotyczące pracy z zamówieniami eMAG opisuje wpis Tworzenie przesyłek dla zamówień z eMAG.
O czym warto pamiętać?
- Forma płatności za pobraniem musi być wskazana w konfiguracji. Wtedy xSale przekaże do Olza Logistic kwotę pobrania i referencję pobrania.
- Waluta pobrania musi być zgodna z walutą kraju odbiorcy. Jeżeli nie jest zgodna, integracja przerwie tworzenie przesyłki komunikatem błędu.
- Dla metod dostawy do punktu lub automatu paczkowego zamówienie musi zawierać poprawny punkt odbioru.
- Dla integracji z IdoSell można wykorzystać dodatkową konfigurację, która pomaga poprawnie pobrać z zamówienia dane punktu odbioru dla rumuńskich automatów Sameday obsługiwanych przez Olza Logistic.
- Błędy zwrócone przez API Olza Logistic są zapisywane przy przesyłce jako komunikat błędu. Najczęściej dotyczą brakujących danych, błędnej metody wysyłki, niezgodnej waluty pobrania albo problemu z pobraniem etykiety.