Integracja z FedEx umożliwia tworzenie przesyłek i pobieranie etykiet kurierskich dla zamówień obsługiwanych w xSale. Wpis opisuje zakres danych przekazywanych z xSale do FedEx na potrzeby wygenerowania listu przewozowego.
Zakres danych zależy od konfiguracji konta kurierskiego, sposobu dostawy na zamówieniu oraz parametrów paczki. W przypadku standardowej integracji FedEx obsługiwane są przede wszystkim przesyłki krajowe. W kodzie integracji dostępna jest również osobna obsługa FedEx International, która korzysta z oddzielnego connectora i innych danych wymaganych dla przesyłek międzynarodowych.
W tym artykule znajdziesz:
- Co obsługuje integracja FedEx?
- Jakie parametry paczki można przekazać do FedEx?
- Jak działa pobranie, ubezpieczenie i referencja?
- Szczegółowy zakres danych przekazywanych do etykiety FedEx
- Zrzuty ekranu
Co obsługuje integracja FedEx?
W standardowym procesie xSale tworzy paczkę FedEx na podstawie danych zamówienia i konfiguracji konta kurierskiego. Do FedEx przekazywane są między innymi dane odbiorcy, dane nadawcy z konfiguracji, liczba paczek, waga, wymiary, wartość pobrania, ubezpieczenie oraz referencja.
Po poprawnym wygenerowaniu przesyłki xSale zapisuje numer listu przewozowego i umożliwia pobranie etykiety.
Jakie parametry paczki można przekazać do FedEx?
Dla paczki FedEx można przekazać podstawowe parametry wymiarowe:
- szerokość,
- wysokość,
- głębokość,
- wagę.
Wartości mogą pochodzić z konfiguracji konta kurierskiego albo z parametrów przekazanych na zamówieniu. Jeżeli włączone jest wyliczanie wagi, xSale może wyliczyć wagę paczki na podstawie łącznej wagi pozycji zamówienia. Przy wielu paczkach waga jest dzielona proporcjonalnie na podprzesyłki.
Dostępne są też opcje usługi FedEx, takie jak:
- dostawa do godziny 10:00,
- dostawa do godziny 12:00,
- dostawa w sobotę.
Jak działa pobranie, ubezpieczenie i referencja?
Przesyłka zostanie oznaczona jako pobraniowa wtedy, gdy forma płatności z zamówienia pasuje do form płatności COD ustawionych w konfiguracji FedEx. W takiej sytuacji xSale przekazuje do FedEx kwotę zamówienia jako kwotę pobrania.
Ubezpieczenie i referencja są pobierane z konfiguracji konta kurierskiego. Referencja może być stałym tekstem albo wartością zbudowaną na podstawie danych zamówienia, na przykład numeru dokumentu lub danych pozycji.
Szczegółowy zakres danych przekazywanych do etykiety FedEx
Poniższa tabela pokazuje, które pola z xSale i konfiguracji integracji są wykorzystywane na przykładowej etykiecie FedEx. Numery w tabeli odwołują się do oznaczeń na zrzutach ekranu pod tabelą.
| Obszar xSale | Pole xSale | nr | Obszar Etykiety | Pole na Etykiecie | nr | Uwagi |
| Formularz zamówienia > Formularz adresu > Odbiorca | Nazwa | 1 | Odbiorca | Imię | 6 | |
| Formularz zamówienia > Formularz adresu > Odbiorca | Nazwa 2 | 2 | Odbiorca | Nazwisko | 5 | Jeżeli pole Nazwa 2 jest puste, to pole Nazwisko na etykiecie uzupełnione znakiem . |
| Formularz zamówienia > Formularz adresu > Odbiorca | Telefon | 3 | Odbiorca | Telefon kontaktowy | 11 | |
| Formularz zamówienia > Formularz adresu > Odbiorca | Miasto | 4 | Odbiorca | Miasto | 10 | |
| Formularz zamówienia > Formularz adresu > Odbiorca | Ulica | 5 | Odbiorca | Ulica | 7 | |
| Formularz zamówienia > Formularz adresu > Odbiorca | Numer ulicy | 6 | Odbiorca | Nr domu | 8 | Jeżeli pole Numer ulicy na zamówieniu jest puste, to na etykiecie wypełnione znakiem . |
| Formularz zamówienia > Formularz adresu > Odbiorca | Kod pocztowy | 7 | Odbiorca | Kod pocztowy | 9 | |
| Formularz zamówienia > Ilość paczek | Ilość paczek | 9 | Ilość paczek | Ilość paczek | 15 | Ilość podprzesyłek |
| Formularz zamówienia > Lista przedmiotów | Suma | 12 | Pobranie | Pobranie: | 17 | Jeżeli na zamówieniu jest forma płatności zdefiniowana w integracji z kurierem jako forma COD, to na liście przewozowym podpowiada się kwota pobrania |
| Formularz zamówienia > List przewozowy | List przewozowy | 11 | Nr listu: | 19 | ||
| brak odpowiednika | brak odpowiednika | Nadawca | Nazwa i adres | 1 | Dane pobierane z ustawień konta FedEx użytego do generowania przesyłki przez API | |
| ShipmentTask > Edycja FedEx | Dane nadawcy – nr telefonu | 15 | Nadawca | Numer telefonu | 2 | |
| ShipmentTask > Edycja FedEx | Dane nadawcy – nazwisko | 14 | Nadawca | Nazwisko | 3 | |
| ShipmentTask > Edycja FedEx | Dane nadawcy – imię | 13 | Nadawca | Imię | 4 | |
| ShipmentTask > Edycja FedEx | Referencja | 19 | Opis | Opis | 12 | Referencja może zawierać stały tekst lub odwołanie do wartości z konkretnego zamówienia np. Id, kod towaru, nazwa towaru |
| ShipmentTask > Edycja FedEx | Wartość ubezpieczenia | 18 | Ubezpieczenie | Ubezpieczenie: | 18 | |
| ShipmentTask > Edycja FedEx | Waga paczki | 17 | Waga dekl. | 13 | Waga może być pobierana z ustawień integracji z kurierem lub wyliczana automatycznie. W przypadku większej liczby paczek do jednego zamówienia waga deklarowana na etykiecie jest proporcjonalna do ilości podprzesyłek. | |
| ShipmentTask > Edycja FedEx | Formy płatności | 16 | Typ płat. | 14 | ||
| Data nadania | 16 | Data pobrania etykiety |
Zrzuty ekranu
Zrzuty xSale


Zrzuty FedEx

EN