Ställ in UPS Unlock
- Kontakta Zonos support - Innan ni aktiverar UPS Unlock, kontakta Zonos Support för att säkerställa att ert UPS-konto är korrekt konfigurerat. Denna process tar vanligtvis 24–48 timmar att slutföra.
- Aktivera UPS Unlock i Dashboard - Gå till Zonos Dashboard → Settings → Rates → UPS och växla UPS Unlock till Enable
- Konfigurera era referensnummer - Minst ett referensnummer måste börja med
zxellerzx-. Så länge minst en referens börjar medzx(även om värdet bara ärzx) skannar Zonos alla referensnummer för att hitta ett matchande Zonos order-ID eller kontorder-nummer.- Exempel:
zxORDER123ellerzx-ORDER123(kombinerat format med handlarens ordernummer)zxorder_0jy1vh6gygcksellerzx-order_0jy1vh6gygcks(kombinerat format med Zonos order-ID)- Referens 1:
zx, Referens 2:ORDER123(uppdelat över två referensfält)
- Exempel:
Hur det fungerar
När ni har ställt in UPS Unlock refererar UPS-sändningar till Zonos orderdata. Så här fungerar den processen:
- UPS anropar automatiskt Zonos för att validera ordern med de tillhandahållna referensfälten
- Zonos validerar och returnerar uppdaterade tulluppgifter till UPS - Zonos validerar att sändningen matchar den ursprungliga offerten genom att kontrollera:
- Artiklarna i sändningen matchar dem i offerten
- Kvantiteterna är mindre än eller lika med de offererade beloppen
- Artikelnummer matchar product IDs eller SKUs från offerten
- Destinationsuppgifter (land/provins) matchar offerten
- UPS bearbetar er sändning med efterlevnadsinformation
- UPS anropar Zonos för att skapa sändningspost med spårningsnummer
- Zonos registrerar sändningen på ordern
Referensmatchning
När UPS anropar Zonos med en referens som zx-ORDER123 tar Zonos bort prefixet och söker efter ordern. Värdet efter prefixet (ORDER123 i det här exemplet) matchas mot tre fält på Zonos-ordern:
| Fält↕ | Beskrivning↕ | Exempel↕ |
|---|---|---|
| Order ID | Zonos order-UUID | order_0jy1vh6gygcks |
| Account order number | Ert handlarordernummer | ORD-12345, #1001 |
| Zonos order ID | Zonos korta identifierare | zo-1232423 |
Zonos returnerar den senaste matchande ordern. Om ingen matchning hittas returneras ett fel.
Krav
För att UPS Unlock ska lyckas måste ordern uppfylla dessa krav:
- Landed Cost Guarantee (LCG) - Ordern måste ha skapats via Zonos Checkout-flödet med en garanterad landed cost. Order som skapats utanför Zonos kan inte användas med UPS Unlock.
- Matchande ursprung/destination - Ship-from- och ship-to-länderna måste matcha den ursprungliga offerten. För sändningar till Kanada eller Brasilien måste provinsen också matcha.
- Matchande produkter - Artikelnummer måste matcha product IDs eller SKUs från offerten, och kvantiteter får inte överstiga de offererade beloppen.
Felkoder
Om valideringen misslyckas får UPS ett felsvar från Zonos. Vanliga felkoder inkluderar:
| Kod↕ | Meddelande↕ | Orsak↕ |
|---|---|---|
| 10001 | Shipper number not found | UPS-avsändarnummer är inte registrerat hos Zonos |
| 10002 | No Zonos order found for any of the provided reference IDs | Ingen order matchar någon referens (efter prefixborttagning) |
| 10003 | Invalid reference IDs. No prefix of zx- found | Ingen av referenserna har prefixet zx eller zx- |
| 10006 | The requested order is not guaranteed | Ordern finns men har inte Landed Cost Guarantee |
| 10010 | ShipFrom.CountryCode mismatch | Ship-from-landet matchar inte det offererade ursprunget |
| 10011 | ShipTo.CountryCode mismatch | Ship-to-landet matchar inte den offererade destinationen |
| 10012 | ShipTo.StateProvinceCode mismatch | För CA/BR-sändningar matchar inte provinsen |
| 10013 | No matching Product on quote with PartNumber | Produktens SKU/productId hittades inte på ordern |
| 10015 | Quantity exceeds the quoted quantity | Begärd kvantitet är större än den offererade |
ShipStation-integration
ShipStation-användare kan konfigurera UPS Unlock genom att lägga till zx-prefixet antingen upstream (via API innan order når ShipStation) eller inom ShipStation med konfigurationer för Label Messages och Automation Rules. Detta gör det möjligt att inkludera prefixet zx och order-ID i UPS-sändningar som bearbetas via ShipStation, vilket utlöser UPS Unlock.
Efter att ni har slutfört de inledande installationsstegen kan ni börja konfigurera ShipStation för att fungera med UPS Unlock.
Lägga till zx upstream
Om ni kan lägga till prefixet zx upstream (innan order når ShipStation) behöver ni bara konfigurera era Label Messages för att visa zx-ordernumret:
Konfiguration av Label Messages
- Öppna inställningar för Label Messages: Navigera till Settings → Printing → Printing Setup, och klicka sedan på Document Options för Label
- Konfigurera Label Messages: I avsnittet Label Messages kan ni definiera upp till 3 anpassade meddelanden som visas som referensnummer på UPS-etiketter. Label Messages accepterar endast förinställda värden som "Custom Field 1", "Order #" osv.
- Ställ in era Messages att använda Order Number: Ställ in Message #1 på
[Order #]. Om ni redan har ett #1, lägg till ett #2 eller #3 - Spara Settings för att tillämpa er konfiguration
När det är klart lägger ShipStation automatiskt ert ordernummer på er etikett, vilket inkluderar ert konfigurerade zx-prefix.
Lägga till zx i ShipStation
Om ni inte kan lägga till prefixet zx upstream (innan order når ShipStation) behöver ni konfigurera era Label Messages och Automation Rules för att visa prefixet zx och ordernumret med två separata Label Messages:
Steg 1: Konfiguration av Label Messages
Konfigurera era Label Messages för att visa både prefixet och ordernumret:
- Öppna inställningar för Label Messages: Navigera till Settings → Printing → Printing Setup, och klicka sedan på Document Options för Label
- Konfigurera Label Messages: I avsnittet Label Messages kan ni definiera upp till 3 anpassade meddelanden som visas som referensnummer på UPS-etiketter.
- Ställ in era Messages:
- Ställ in Message #1 på
[Custom Field 1](detta fylls i med "zx" av automationsregeln) - Ställ in Message #2 på
[Order #](välj från rullgardinsmenyn)
- Ställ in Message #1 på
- Spara Settings för att tillämpa er konfiguration
Steg 2: Konfiguration av Automation Rules
Efter att ni har ställt in era Label Messages, skapa en automationsregel för att fylla Custom Field 1 med prefixet zx. Navigera till Settings → Automation → Automation Rules och klicka sedan på Create a Rule.
Regel för Zonos UPS-order:
- Namn: "Zonos UPS Unlock"
- Se till att Active Rule är aktiverad
- Välj Orders match these specific criteria
- Ange kriterier: "International Order" = "True" AND "Carrier" + "Includes" + "UPS"
Obs: Era utlösarkriterier kan variera baserat på er ShipStation-konfiguration. Detta är en rekommenderad utgångspunkt – anpassa villkoren baserat på ert specifika arbetsflöde och era preferenser för att säkerställa att UPS Unlock endast tillämpas på lämpliga order.
- Ange åtgärder:
- Action Type: Välj "Set Custom Field 1..."
- Custom Field 1:
zx(detta anger prefixet)
- Klicka på Save Rule
När det är klart fyller ShipStation automatiskt Custom Field 1 med zx och Message #2 med ordernumret för internationella UPS-order. Dessa visas på era UPS-etiketter som två separata referensrader.
Viktigt: Konfigurationen av Label Message i ShipStation är en global ändring som påverkar alla transportörer. Tillvägagångssättet med automationsregler gör att UPS Unlock fungerar sömlöst för Zonos-order samtidigt som era föredragna Label Messages behålls för andra sändningar.
UPS Unlock
Automatisera fakturering av tull och skatt till Zonos för UPS-sändningar som bearbetas utanför Dashboard.
UPS Unlock gör det möjligt för er att generera Zonos-kompatibla sändningar från er egen fraktplattform, i stället för att använda Zonos Dashboard. Genom att lägga till ett specifikt referensnummer när ni bearbetar UPS-sändningar validerar och uppdaterar UPS automatiskt sändningsdata via Zonos, inklusive tullbeskrivningar, HS-koder, tullkontonummer, tax IDs och varuvärden. Detta eliminerar behovet av att konfigurera komplexa regler eller integrationer för att skicka denna information till er fraktplattform. I stället hämtar UPS data direkt från Zonos, vilket minskar risken för avvikelser eller saknad information samtidigt som manuell installation och underhållstid minimeras.