DOCS

UPS Unlock

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.

Ställ in UPS Unlock 

  1. 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.
  2. Aktivera UPS Unlock i Dashboard - Gå till Zonos Dashboard → Settings → Rates → UPS och växla UPS Unlock till Enable
  3. Konfigurera era referensnummer - Minst ett referensnummer måste börja med zx eller zx-. Så länge minst en referens börjar med zx (även om värdet bara är zx) skannar Zonos alla referensnummer för att hitta ett matchande Zonos order-ID eller kontorder-nummer.
    • Exempel:
      • zxORDER123 eller zx-ORDER123 (kombinerat format med handlarens ordernummer)
      • zxorder_0jy1vh6gygcks eller zx-order_0jy1vh6gygcks (kombinerat format med Zonos order-ID)
      • Referens 1: zx, Referens 2: ORDER123 (uppdelat över två referensfält)

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:

  1. UPS anropar automatiskt Zonos för att validera ordern med de tillhandahållna referensfälten
  2. Zonos validerar och returnerar uppdaterade tulluppgifter till UPS - Zonos validerar att sändningen matchar den ursprungliga offerten genom att kontrollera:
    1. Artiklarna i sändningen matchar dem i offerten
    2. Kvantiteterna är mindre än eller lika med de offererade beloppen
    3. Artikelnummer matchar product IDs eller SKUs från offerten
    4. Destinationsuppgifter (land/provins) matchar offerten
  3. UPS bearbetar er sändning med efterlevnadsinformation
  4. UPS anropar Zonos för att skapa sändningspost med spårningsnummer
  5. 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ältBeskrivningExempel
Order IDZonos order-UUIDorder_0jy1vh6gygcks
Account order numberErt handlarordernummerORD-12345, #1001
Zonos order IDZonos korta identifierarezo-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:

KodMeddelandeOrsak
10001Shipper number not foundUPS-avsändarnummer är inte registrerat hos Zonos
10002No Zonos order found for any of the provided reference IDsIngen order matchar någon referens (efter prefixborttagning)
10003Invalid reference IDs. No prefix of zx- foundIngen av referenserna har prefixet zx eller zx-
10006The requested order is not guaranteedOrdern finns men har inte Landed Cost Guarantee
10010ShipFrom.CountryCode mismatchShip-from-landet matchar inte det offererade ursprunget
10011ShipTo.CountryCode mismatchShip-to-landet matchar inte den offererade destinationen
10012ShipTo.StateProvinceCode mismatchFör CA/BR-sändningar matchar inte provinsen
10013No matching Product on quote with PartNumberProduktens SKU/productId hittades inte på ordern
10015Quantity exceeds the quoted quantityBegä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

  1. Öppna inställningar för Label Messages: Navigera till SettingsPrintingPrinting Setup, och klicka sedan på Document Options för Label
  2. 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.
  3. 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
  4. 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:

  1. Öppna inställningar för Label Messages: Navigera till SettingsPrintingPrinting Setup, och klicka sedan på Document Options för Label
  2. Konfigurera Label Messages: I avsnittet Label Messages kan ni definiera upp till 3 anpassade meddelanden som visas som referensnummer på UPS-etiketter.
  3. 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)
  4. 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 SettingsAutomationAutomation Rules och klicka sedan på Create a Rule.

Regel för Zonos UPS-order:

  1. Namn: "Zonos UPS Unlock"
  2. Se till att Active Rule är aktiverad
  3. Välj Orders match these specific criteria
  4. 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.

  1. Ange åtgärder:
    • Action Type: Välj "Set Custom Field 1..."
    • Custom Field 1: zx (detta anger prefixet)
  2. 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.

Boka en demo

Var den här sidan till hjälp?