EN
Integracja xSale z Ambro Express pozwala tworzyć przesyłki kurierskie dla zamówień, przekazywać do Ambro Express dane potrzebne do nadania paczki oraz pobierać etykietę przewozową w formacie PDF. Ambro Express jest przewoźnikiem wykorzystywanym m.in. przy przesyłkach gabarytowych, dłużycowych i meblowych.
W tym artykule znajdziesz:
- Co umożliwia integracja?
- Jakie dane są przekazywane do Ambro Express?
- Serwisy i rodzaje opakowań
- Wielopaki i parametry paczek
- Pobranie i ubezpieczenie
- Etykiety i usługi dodatkowe
- O czym warto pamiętać?
Co umożliwia integracja?
W ramach integracji xSale może:
- utworzyć przesyłkę w Ambro Express na podstawie danych zamówienia,
- przekazać dane nadawcy i odbiorcy,
- przekazać informacje o paczkach, w tym liczbę paczek, wymiary, wagę i rodzaj opakowania,
- obsłużyć wielopak, czyli przesyłkę składającą się z kilku paczek,
- przekazać pobranie, jeżeli forma płatności zamówienia jest skonfigurowana jako pobraniowa,
- przekazać wartość ubezpieczenia,
- pobrać etykietę przewozową dla utworzonej przesyłki.
Integracja korzysta z API Ambro Express. W konfiguracji konta kuriera podawane są dane dostępowe do Ambro Express oraz ustawienia domyślne, które xSale wykorzystuje przy tworzeniu przesyłek.
Jakie dane są przekazywane do Ambro Express?
Przy tworzeniu przesyłki xSale przekazuje do Ambro Express przede wszystkim:
- dane odbiorcy z adresu dostawy zamówienia: nazwę, adres, miejscowość, kod pocztowy, kraj, telefon, e-mail i osobę kontaktową,
- dane nadawcy zapisane w konfiguracji integracji kurierskiej,
- wybrany serwis Ambro Express,
- opis zawartości przesyłki i numer referencyjny, jeżeli zostały ustawione w konfiguracji,
- listę paczek z ich typem, wagą i wymiarami,
- wybrane usługi dodatkowe,
- dane pobrania i ubezpieczenia, jeżeli wynikają z konfiguracji i danych zamówienia.
Serwisy i rodzaje opakowań
W integracji wykorzystywany jest serwis wybrany dla sposobu dostawy w konfiguracji kurierskiej. Dla przesyłek standardowych xSale korzysta z domyślnych parametrów paczki standardowej, a dla pozostałych serwisów z domyślnych parametrów przesyłki meblowej.
Obsługiwane rodzaje opakowań przekazywane do Ambro Express to:
- Paczka,
- Paleta,
- Dłużyca,
- Gabaryt 20,
- Meble.
Rodzaj opakowania może wynikać z domyślnej konfiguracji integracji albo zostać zmieniony przy generowaniu przesyłki, jeżeli dane pole jest udostępnione w parametrach kuriera.
Wielopaki i parametry paczek
xSale obsługuje przesyłki składające się z jednej lub wielu paczek. Jeżeli na zamówieniu wskazana jest liczba paczek, xSale tworzy odpowiednią liczbę pozycji paczek w przesyłce.
Dla paczek mogą być przekazywane:
- wysokość,
- szerokość,
- głębokość / długość,
- waga,
- rodzaj opakowania.
Jeżeli w konfiguracji włączone jest przeliczanie wagi z dokumentu, xSale pobiera wagę całego zamówienia i dzieli ją przez liczbę paczek. Jeżeli waga zamówienia nie jest dostępna, używana jest waga domyślna z konfiguracji.
Parametry podane przy generowaniu przesyłki mogą nadpisać wartości domyślne. Dla wielopaku można przekazać parametry osobno dla kolejnych paczek. Jeżeli nie podano osobnych danych dla kolejnych paczek, xSale powiela parametry pierwszej paczki.
Pobranie i ubezpieczenie
Pobranie jest ustawiane wtedy, gdy forma płatności zamówienia pasuje do listy form płatności wskazanych w konfiguracji jako pobraniowe. W takiej sytuacji xSale przekazuje do Ambro Express kwotę pobrania z wartości dokumentu.
Waluta pobrania jest pobierana z zamówienia. Jeżeli zamówienie nie ma waluty, xSale używa domyślnej waluty pobrania ustawionej w konfiguracji integracji.
Ubezpieczenie może być ustawione jako wartość domyślna w konfiguracji. Jeżeli przesyłka jest za pobraniem, xSale ustawia ubezpieczenie co najmniej na wartość pobrania, jeżeli kwota pobrania jest wyższa niż domyślna wartość ubezpieczenia.
Etykiety i usługi dodatkowe
xSale pobiera etykietę dla przesyłki po numerze listu przewozowego zwróconym przez Ambro Express. Etykieta jest pobierana jako plik PDF. W konfiguracji lub parametrach przesyłki można wybrać format etykiety: standardowy PDF albo PDF A4.
Integracja obsługuje usługi dodatkowe przekazywane do Ambro Express jako kody usług:
- ZNI – zniesienie,
- SMS – serwis SMS,
- EMAIL – serwis e-mail,
- W – wniesienie w obsadzie dwuosobowej,
- M – montaż,
- R – rozpakowanie,
- Z – zabranie starego mebla,
- ROD – zwrot dokumentów.
Usługi dodatkowe mogą być ustawione domyślnie w konfiguracji albo wybrane przy generowaniu przesyłki, jeżeli są udostępnione jako parametry kuriera.
O czym warto pamiętać?
- Integracja tworzy przesyłkę i pobiera etykietę. W kodzie nie ma obsługi manifestu/raportu nadań ani wysyłki przesyłek z bufora dla Ambro Express.
- Jeżeli Ambro Express odrzuca przesyłkę, w pierwszej kolejności sprawdź kompletność danych odbiorcy, dane nadawcy w konfiguracji oraz parametry paczek: typ opakowania, wymiary i wagę.
- Dla przesyłek pobraniowych sprawdź, czy forma płatności z zamówienia jest wpisana w konfiguracji jako forma pobraniowa.
- Jeżeli przesyłka ma kilka paczek, sprawdź liczbę paczek oraz parametry każdej paczki. Gdy nie podasz osobnych parametrów dla kolejnych paczek, xSale użyje parametrów pierwszej paczki.