EN
Wpis opisuje zakres integracji xSale z ORLEN Paczka. Integracja umożliwia przygotowanie przesyłki dla zamówienia, wysłanie jej do systemu kuriera, zapisanie numeru listu przewozowego oraz pobranie etykiety.
Technicznie w xSale integracja może być widoczna jako Paczka w Ruchu. Jest to nazwa connectora wykorzystywanego przez system do obsługi ORLEN Paczka.
W tym artykule znajdziesz:
- Co umożliwia integracja?
- Jakie usługi są obsługiwane?
- Jakie dane xSale przekazuje do ORLEN Paczka?
- Szczegółowy zakres danych
- Zrzuty ekranu
- O czym warto pamiętać?
Co umożliwia integracja?
Po poprawnej konfiguracji xSale może utworzyć przesyłkę ORLEN Paczka na podstawie danych zamówienia. Integracja obsługuje:
- przygotowanie przesyłki z danych zamówienia,
- przekazanie danych odbiorcy i nadawcy do systemu kuriera,
- przekazanie punktu odbioru, rozmiaru paczki i referencji,
- obsługę pobrania, jeżeli forma płatności jest skonfigurowana jako COD,
- obsługę ubezpieczenia, jeżeli jest włączone w konfiguracji,
- zapis numeru listu przewozowego po wysłaniu przesyłki,
- pobranie etykiety przewozowej po numerze listu,
- pobranie protokołu / raportu dla wskazanych przesyłek, jeżeli jest dostępny po stronie kuriera.
Jakie usługi są obsługiwane?
W konfiguracji dostępne są usługi:
- ORLEN Paczka – standard,
- ORLEN Paczka – standard Allegro.
Dla tych usług kluczowym parametrem przesyłki jest kod miejsca przeznaczenia, czyli kod punktu odbioru. xSale może pobrać go z danych zamówienia albo z atrybutu PUNKT ODBIORU. Obsługiwany jest również alternatywny punkt odbioru z atrybutu PUNKT ODBIORU ALT.
Jakie dane xSale przekazuje do ORLEN Paczka?
Podczas wysyłania przesyłki xSale przekazuje do usługi kurierskiej m.in.:
- kod punktu odbioru i opcjonalnie alternatywny punkt odbioru,
- rozmiar paczki,
- nazwę, telefon i e-mail odbiorcy,
- dane nadawcy z konfiguracji konta kurierskiego,
- referencję przesyłki,
- informację o pobraniu i kwotę pobrania, jeżeli przesyłka jest pobraniowa,
- informację o ubezpieczeniu i jego wartość, jeżeli ubezpieczenie jest włączone.
Referencja przekazywana do kuriera jest czyszczona z polskich i specjalnych znaków, ponieważ system kuriera nie przyjmuje ich w tym polu.
Szczegółowy zakres danych
Poniższa tabela prezentuje przykładowe pola używane przy tworzeniu przesyłki oraz ich odpowiedniki na etykiecie ORLEN Paczka. Numery pól odnoszą się do zrzutów ekranu umieszczonych pod tabelą.
| Obszar xSale | Pole xSale | nr | Obszar etykiety | Pole na etykiecie | nr | Uwagi |
| Zamówienie > Odbiorca | Nazwa i Nazwa 2 | 12 | Odbiorca | Odbiorca | 21 | Do kuriera trafia nazwa odbiorcy z adresu dostawy. |
| Zamówienie > Formularz zamówienia | List przewozowy | 1 | Numer paczki | Numer paczki | 5 | Numer listu jest zapisywany w xSale po wysłaniu przesyłki do kuriera. |
| ShipmentTask > Edycja Paczka w Ruchu | Wielkość paczki | 11 | Przesyłka | Gabaryt | 12 | Wartość jest przekazywana jako rozmiar paczki. |
| ShipmentTask > Edycja Paczka w Ruchu | Referencja | 4 | Przesyłka | Nr Zam. | 14 | Referencja może być budowana z konfiguracji, np. z numeru dokumentu, kodów lub nazw towarów. Przed wysłaniem xSale usuwa z niej polskie i specjalne znaki. |
| ShipmentTask > Dane nadawcy | Pierwsza i druga nazwa | 5 | Nadawca | Nazwa sprzedającego | 16 | Do kuriera przekazywana jest nazwa nadawcy z konfiguracji konta kurierskiego. |
| ShipmentTask > Dane nadawcy | Ulica, numer budynku, numer lokalu, kod pocztowy i miasto | 6, 7, 8, 9, 10 | Nadawca | Adres nadawcy | 16 | Dane nadawcy pochodzą z konfiguracji konta kurierskiego w ShipmentTask. |
| ShipmentTask > Edycja Paczka w Ruchu | Punkt odbioru | 11 | Punkt odbioru | Kod punktu | 21 | Kod punktu jest przekazywany jako miejsce przeznaczenia. Jeżeli kod jest w formacie PSD, xSale może zamienić go na kod akceptowany przez usługę kurierską. |
Zrzuty ekranu
Zrzuty xSale
Zrzut ORLEN Paczka
O czym warto pamiętać?
- W xSale nazwa techniczna integracji może nadal brzmieć Paczka w Ruchu.
- Do utworzenia przesyłki potrzebny jest poprawny punkt odbioru oraz dane kontaktowe odbiorcy.
- Dla przesyłek pobraniowych forma płatności z zamówienia musi być zgodna z konfiguracją COD.
- Etykieta jest pobierana po numerze listu przewozowego zapisanym po wysłaniu przesyłki.