Skonfiguruj UPS Unlock
- Skontaktuj się z wsparciem Zonos - Przed włączeniem UPS Unlock skontaktuj się z Wsparciem Zonos, aby upewnić się, że Twoje konto UPS jest prawidłowo skonfigurowane. Ten proces zwykle trwa 24-48 godzin.
- Włącz UPS Unlock w Dashboard - Przejdź do Zonos Dashboard → Settings → Rates → UPS i przełącz UPS Unlock na Enable
- Skonfiguruj numery referencyjne - Co najmniej jeden numer referencyjny musi zaczynać się od
zxlubzx-. Tak długo, jak co najmniej jeden numer zaczyna się odzx(nawet jeśli wartość to tylkozx), Zonos będzie skanować wszystkie numery referencyjne w poszukiwaniu pasującego numeru zamówienia Zonos lub numeru zamówienia konta.- Przykłady:
zxORDER123lubzx-ORDER123(format połączony z numerem zamówienia handlowca)zxorder_0jy1vh6gygckslubzx-order_0jy1vh6gygcks(format połączony z numerem zamówienia Zonos)- Referencja 1:
zx, Referencja 2:ORDER123(podzielone na dwa pola referencyjne)
- Przykłady:
Jak to działa
Po skonfigurowaniu UPS Unlock przesyłki UPS będą odwoływać się do danych zamówienia Zonos. Oto jak wygląda ten proces:
- UPS automatycznie wywoła Zonos, aby sprawdzić zamówienie z podanymi polami referencyjnymi
- Zonos sprawdza i zwraca zaktualizowane szczegóły celne do UPS - Zonos sprawdza, że przesyłka odpowiada oryginalnej wycenie, poprzez sprawdzenie:
- Pozycje w przesyłce odpowiadają pozycjom w wycenie
- Ilości są mniejsze lub równe szacowanym kwotom
- Numery części pasują do identyfikatorów produktów lub jednostek magazynowych z wyceny
- Szczegóły docelowe (kraj/prowincja) pasują do wyceny
- UPS przetwarza Twoją przesyłkę z informacjami o zgodności
- UPS wywoła Zonos, aby utworzyć rekord przesyłki z numerem śledzenia
- Zonos zapisuje przesyłkę w zamówieniu
Dopasowanie referencji
Gdy UPS wywoła Zonos z referencją taką jak zx-ORDER123, Zonos usuwa prefiks i szuka zamówienia. Wartość po prefiksie (ORDER123 w tym przykładzie) jest porównywana z trzema polami w zamówieniu Zonos:
| Pole↕ | Opis↕ | Przykład↕ |
|---|---|---|
| Order ID | UUID zamówienia Zonos | order_0jy1vh6gygcks |
| Account order number | Twój numer zamówienia handlowca | ORD-12345, #1001 |
| Zonos order ID | Krótki identyfikator Zonos | zo-1232423 |
Zonos zwraca ostatnio pasujące zamówienie. Jeśli nie znaleziono żadnego dopasowania, zwracany jest błąd.
Wymagania
Aby UPS Unlock powiódł się, zamówienie musi spełniać następujące wymagania:
- Gwarancja kosztów przylądkowych (LCG) - Zamówienie musiało zostać utworzone poprzez przepływ kasy Zonos z gwarantowanym kosztem przylądkowym. Zamówienia utworzone poza Zonos nie mogą być używane z UPS Unlock.
- Dopasowanie pochodzenia/przeznaczenia - Kraje wysyłki i docelowe muszą odpowiadać oryginalnej wycenie. Dla przesyłek do Kanady lub Brazylii prowincja również musi się zgadzać.
- Dopasowanie produktów - Numery części muszą odpowiadać identyfikatorom produktów lub jednostkom magazynowym z wyceny, a ilości nie mogą przekroczyć szacowanych ilości.
Kody błędów
Jeśli walidacja nie powiedzie się, UPS otrzymuje odpowiedź o błędzie od Zonos. Typowe kody błędów obejmują:
| Kod↕ | Wiadomość↕ | Przyczyna↕ |
|---|---|---|
| 10001 | Shipper number not found | Numer nadawcy UPS nie jest zarejestrowany w Zonos |
| 10002 | No Zonos order found for any of the provided reference IDs | Żadne zamówienie nie pasuje do żadnej referencji (po usunięciu prefiksu) |
| 10003 | Invalid reference IDs. No prefix of zx- found | Żaden z numerów referencyjnych nie ma prefiksu zx lub zx- |
| 10006 | The requested order is not guaranteed | Zamówienie istnieje, ale nie ma gwarancji kosztów przylądkowych |
| 10010 | ShipFrom.CountryCode mismatch | Kraj wysyłki nie odpowiada szacowanemu pochodzeniu |
| 10011 | ShipTo.CountryCode mismatch | Kraj docelowy nie odpowiada szacowanemu przeznaczeniu |
| 10012 | ShipTo.StateProvinceCode mismatch | Dla przesyłek do Kanady/Brazylii, prowincja się nie zgadza |
| 10013 | No matching Product on quote with PartNumber | SKU produktu/productId nie znalezione w zamówieniu |
| 10015 | Quantity exceeds the quoted quantity | Żądana ilość jest większa niż szacowana |
Integracja ShipStation
Użytkownicy ShipStation mogą skonfigurować UPS Unlock poprzez dodanie prefiksu zx albo wcześniej (poprzez API przed dotarciem zamówień do ShipStation) lub w ShipStation za pomocą Label Messages i konfiguracji Automation Rules. To pozwala na włączenie prefiksu zx i identyfikatora zamówienia w przesyłkach UPS przetwarzanych poprzez ShipStation, uruchamiając UPS Unlock.
Po ukończeniu początkowych kroków konfiguracji, możesz zacząć konfigurować ShipStation do pracy z UPS Unlock.
Dodawanie zx wcześniej
Jeśli możesz dodać prefiks zx wcześniej (przed dotarciem zamówień do ShipStation), musisz tylko skonfigurować Label Messages, aby wyświetlać numer zamówienia zx:
Konfiguracja Label Messages
- Dostęp do ustawień Label Messages: Przejdź do Settings → Printing → Printing Setup, a następnie kliknij Document Options dla Label
- Skonfiguruj Label Messages: W sekcji Label Messages możesz zdefiniować do 3 niestandardowe wiadomości, które pojawią się jako numery referencyjne na etykietach UPS. Label Messages akceptują tylko wstępnie zdefiniowane wartości takie jak "Custom Field 1", "Order #", itp.
- Ustaw swoje wiadomości, aby używały numeru zamówienia: Ustaw wiadomość #1 na
[Order #]. Jeśli masz już #1, dodaj #2 lub #3 - Zapisz ustawienia, aby zastosować konfigurację
Po ukończeniu ShipStation automatycznie umieści Twój numer zamówienia na etykiecie, która zawiera skonfigurowany prefiks zx.
Dodawanie zx w ShipStation
Jeśli nie możesz dodać prefiksu zx wcześniej (przed dotarciem zamówień do ShipStation), musisz skonfigurować Label Messages i Automation Rules, aby wyświetlać prefiks zx i numer zamówienia za pomocą dwóch oddzielnych Label Messages:
Krok 1: Konfiguracja Label Messages
Skonfiguruj Label Messages, aby wyświetlać zarówno prefiks, jak i numer zamówienia:
- Dostęp do ustawień Label Messages: Przejdź do Settings → Printing → Printing Setup, a następnie kliknij Document Options dla Label
- Skonfiguruj Label Messages: W sekcji Label Messages możesz zdefiniować do 3 niestandardowe wiadomości, które pojawią się jako numery referencyjne na etykietach UPS.
- Ustaw swoje wiadomości:
- Ustaw wiadomość #1 na
[Custom Field 1](będzie wypełniana przez regułę automatyzacji) - Ustaw wiadomość #2 na
[Order #](wybierz z rozwijanego menu)
- Ustaw wiadomość #1 na
- Zapisz ustawienia, aby zastosować konfigurację
Krok 2: Konfiguracja Automation Rules
Po skonfigurowaniu Label Messages utwórz regułę automatyzacji, aby wypełnić Custom Field 1 prefiksem zx. Przejdź do Settings → Automation → Automation Rules, a następnie kliknij Create a Rule.
Reguła dla zamówień Zonos UPS:
- Nazwa: "Zonos UPS Unlock"
- Upewnij się, że Active Rule jest włączone
- Wybierz Orders match these specific criteria
- Ustaw kryteria: "International Order" = "True" AND "Carrier" + "Includes" + "UPS"
Uwaga: Twoje kryteria wyzwalające mogą się różnić w zależności od konfiguracji ShipStation. To jest rekomendowany punkt wyjścia - dostosuj warunki na podstawie Twojego konkretnego przepływu pracy i preferencji, aby upewnić się, że UPS Unlock jest stosowany tylko do odpowiednich zamówień.
- Ustaw akcje:
- Action Type: Wybierz "Set Custom Field 1..."
- Custom Field 1:
zx(ustawia prefiks)
- Kliknij Save Rule
Po ukończeniu ShipStation automatycznie wypełni Custom Field 1 za pomocą zx i Message #2 za pomocą numeru zamówienia dla międzynarodowych zamówień UPS. Pojawią się one na Twoich etykietach UPS jako dwie odrębne linie referencyjne.
Ważne: Konfiguracja Label Message w ShipStation to zmiana globalna, która wpływa na wszystkich przewoźników. Podejście z regułami automatyzacji pozwala UPS Unlock pracować bezproblemowo dla zamówień Zonos, zachowując jednocześnie Twoje preferowane Label Messages dla innych przesyłek.
UPS Unlock
Automatyzuj naliczanie ceł i podatków dla przesyłek UPS przetwarzanych poza Dashboard.
UPS Unlock pozwala na generowanie przesyłek zgodnych z Zonos z Twojej własnej platformy wysyłkowej zamiast korzystania z Dashboard Zonos. Poprzez dodanie określonego numeru referencyjnego podczas przetwarzania przesyłek UPS, UPS automatycznie sprawdza i aktualizuje dane przesyłki za pośrednictwem Zonos, w tym opisy celne, kody HS, numery kont celnych, numery identyfikacyjne podatkowe i wartości towarów. Eliminuje to potrzebę konfigurowania złożonych reguł lub integracji w celu przekazania tych informacji do platformy wysyłkowej. Zamiast tego UPS pobiera dane bezpośrednio z Zonos, zmniejszając ryzyko rozbieżności lub brakujących informacji, minimalizując ręczną konfigurację i czas konserwacji.