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.
Konto i domyślne parametry przesyłek ustawisz zgodnie z instrukcją konfiguracji integracji 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.
Do utworzenia przesyłki potrzebny jest kod punktu odbioru. xSale korzysta z punktu zapisanego na zamówieniu; jeśli przekazano atrybut PUNKT ODBIORU, ma on pierwszeństwo. Alternatywny punkt może być przekazany w atrybucie 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 → Zamawiający → Odbiorca | Nazwa | 12 | Odbiorca | Odbiorca | 21 | Do kuriera trafia nazwa odbiorcy z adresu dostawy. |
| Zamówienie → Informacje o przesyłce | Nr listu | 1 | Numer paczki | Numer paczki | 5 | Numer listu jest zapisywany w xSale po wysłaniu przesyłki do kuriera. |
| Edycja integracji ORLEN Paczka → Ustawienia domyślne | Wielkość paczki | 11 | Przesyłka | Gabaryt | 12 | Wartość jest przekazywana jako rozmiar paczki. |
| Edycja integracji ORLEN Paczka → Ustawienia domyślne | 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. |
| Edycja integracji ORLEN Paczka → Ustawienia domyślne | Pierwsza i druga nazwa | 5 | Nadawca | Nazwa sprzedającego | 16 | Do kuriera przekazywana jest nazwa nadawcy z konfiguracji konta kurierskiego. |
| Edycja integracji ORLEN Paczka → Ustawienia domyślne | Ulica, numer budynku, numer lokalu, kod pocztowy i miasto | 6, 7, 8, 9, 10 | Nadawca | Adres nadawcy | 16 | Dane pochodzą z ustawień nadawcy w integracji ORLEN Paczka. |
| Zamówienie → Informacje o przesyłce | Punkt dostawy | 2 | Punkt odbioru | POK | 10 | Kod punktu przekazywany jest do kuriera. Może zostać przekształcony zgodnie ze słownikiem punktów; numer POK na etykiecie nie musi mieć tego samego formatu co kod w zamówieniu. |
| Zamówienie → Zamawiający → Odbiorca | Telefon | 13 | — | — | — | Przekazywany jako telefon odbiorcy; nie jest oznaczony na pokazanej etykiecie. |
| Zamówienie → Zamawiający → Odbiorca | 14 | — | — | — | Przekazywany do kuriera jako e-mail odbiorcy; nie jest widoczny na pokazanej etykiecie. |
Pobranie i ubezpieczenie: pole Formy płatności przesyłek COD (nr 3) służy do rozpoznawania płatności za pobraniem. Jeśli wpisana konfiguracja zawiera nazwę formy płatności zamówienia, xSale ustawia pobranie w kwocie wartości dokumentu. Przy włączonym ubezpieczeniu jego kwota również odpowiada wartości dokumentu. Na pokazanej etykiecie informację o pobraniu oznaczono numerem 18. Na zrzucie zamówienia forma płatności ma numer 15, a wartość zamówienia numer 16.
Zrzuty ekranu
Zrzuty xSale
Zrzut ORLEN Paczka
O czym warto pamiętać?
- 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.

EN


