DOCS

UPS Unlock

UPS Unlock

Automatiser told- og skatfakturering til Zonos for UPS-forsendelser behandlet uden for Dashboard.

UPS Unlock gør det muligt at generere Zonos-kompatible forsendelser fra din egen shippingplatform i stedet for at bruge Zonos Dashboard. Ved at tilføje et specifikt referencenummer, når du behandler UPS-forsendelser, validerer og opdaterer UPS automatisk forsendelsesdata gennem Zonos, herunder toldbeskrivelser, HS-koder, duty account numbers, skatte-ID'er og vareværdier. Det eliminerer behovet for at konfigurere komplekse regler eller integrationer for at videregive disse oplysninger til din shippingplatform. I stedet henter UPS dataene direkte fra Zonos, hvilket reducerer risikoen for uoverensstemmelser eller manglende oplysninger og minimerer tid brugt på manuel opsætning og vedligeholdelse.

Konfigurer UPS Unlock 

  1. Kontakt Zonos support - Før du aktiverer UPS Unlock, skal du kontakte Zonos Support for at sikre, at din UPS-konto er konfigureret korrekt. Denne proces tager typisk 24-48 timer at gennemføre.
  2. Aktiver UPS Unlock i Dashboard - Gå til Zonos Dashboard → SettingsRatesUPS og skift UPS Unlock til Enable
  3. Konfigurer dine referencenumre - Mindst ét referencenummer skal starte med zx eller zx-. Så længe mindst én reference starter med zx (selv hvis værdien kun er zx), scanner Zonos alle referencenumre for at finde et matchende Zonos order ID eller account order number.
    • Eksempler:
      • zxORDER123 eller zx-ORDER123 (kombineret format med merchant order number)
      • zxorder_0jy1vh6gygcks eller zx-order_0jy1vh6gygcks (kombineret format med Zonos order ID)
      • Reference 1: zx, Reference 2: ORDER123 (opdelt på to referencefelter)

Sådan fungerer det 

Når du har konfigureret UPS Unlock, vil UPS-forsendelser referere til Zonos-ordredata. Sådan fungerer processen:

  1. UPS kalder automatisk Zonos for at validere ordren med de angivne referencefelter
  2. Zonos validerer og returnerer opdaterede toldoplysninger til UPS - Zonos validerer, at forsendelsen matcher det oprindelige tilbud ved at kontrollere:
    1. Varer i forsendelsen matcher dem i tilbuddet
    2. Antal er mindre end eller lig med de angivne mængder
    3. Part numbers matcher product IDs eller SKUs fra tilbuddet
    4. Destinationsoplysninger (land/provins) matcher tilbuddet
  3. UPS behandler din forsendelse med compliance-oplysninger
  4. UPS kalder Zonos for at oprette forsendelsespost med tracking number
  5. Zonos registrerer forsendelsen på ordren

Referencematchning 

Når UPS kalder Zonos med en reference som zx-ORDER123, fjerner Zonos præfikset og søger efter ordren. Værdien efter præfikset (ORDER123 i dette eksempel) matches mod tre felter på Zonos-ordren:

FeltBeskrivelseEksempel
Order IDZonos order UUIDorder_0jy1vh6gygcks
Account order numberDit merchant order numberORD-12345, #1001
Zonos order IDZonos kort identifikatorzo-1232423

Zonos returnerer den senest matchende ordre. Hvis der ikke findes noget match, returneres en fejl.

Krav

For at UPS Unlock skal lykkes, skal ordren opfylde disse krav:

  • Landed Cost Guarantee (LCG) - Ordren skal være oprettet gennem Zonos checkout-flowet med en garanteret landed cost. Ordrer oprettet uden for Zonos kan ikke bruges med UPS Unlock.
  • Matchende origin/destination - Ship-from- og ship-to-lande skal matche det oprindelige tilbud. For forsendelser til Canada eller Brasilien skal provinsen også matche.
  • Matchende produkter - Part numbers skal matche product IDs eller SKUs fra tilbuddet, og antal må ikke overstige de angivne mængder.

Fejlkoder 

Hvis valideringen mislykkes, modtager UPS et fejlsvar fra Zonos. Almindelige fejlkoder omfatter:

KodeMeddelelseÅrsag
10001Shipper number not foundUPS shipper number er ikke registreret hos Zonos
10002No Zonos order found for any of the provided reference IDsIngen ordre matcher nogen reference (efter fjernelse af præfiks)
10003Invalid reference IDs. No prefix of zx- foundIngen af referencerne har zx- eller zx--præfiks
10006The requested order is not guaranteedOrdren findes, men har ikke Landed Cost Guarantee
10010ShipFrom.CountryCode mismatchShip-from-land matcher ikke den angivne origin
10011ShipTo.CountryCode mismatchShip-to-land matcher ikke den angivne destination
10012ShipTo.StateProvinceCode mismatchFor CA/BR-forsendelser matcher provinsen ikke
10013No matching Product on quote with PartNumberProduct SKU/productId findes ikke på ordren
10015Quantity exceeds the quoted quantityDet anmodede antal er større end det angivne

ShipStation-integration 

ShipStation-brugere kan konfigurere UPS Unlock ved at tilføje zx-præfikset enten upstream (via API før ordrer når ShipStation) eller i ShipStation ved hjælp af Label Messages og Automation Rules. Det gør det muligt at inkludere zx-præfikset og order ID i UPS-forsendelser behandlet gennem ShipStation, hvilket udløser UPS Unlock. Når du har gennemført de indledende opsætningstrin, kan du begynde at konfigurere ShipStation til at arbejde med UPS Unlock.

Tilføjelse af zx upstream

Hvis du kan tilføje zx-præfikset upstream (før ordrer når ShipStation), skal du kun konfigurere dine Label Messages til at vise zx-ordrenummeret:

Label Messages-konfiguration

  1. Åbn Label Messages-indstillinger: Gå til SettingsPrintingPrinting Setup, og klik derefter Document Options for Label
  2. Konfigurer Label Messages: I sektionen Label Messages kan du definere op til 3 brugerdefinerede meddelelser, der vises som referencenumre på UPS-labels. Label Messages accepterer kun forudindstillede værdier som "Custom Field 1", "Order #" osv.
  3. Indstil dine meddelelser til at bruge Order Number: Sæt Message #1 til [Order #]. Hvis du allerede har en #1, tilføj en #2 eller #3
  4. Save Settings for at anvende din konfiguration

Når du er færdig, sætter ShipStation automatisk dit ordrenummer på din label, som inkluderer dit konfigurerede zx-præfiks.

Tilføjelse af zx i ShipStation

Hvis du ikke kan tilføje zx-præfikset upstream (før ordrer når ShipStation), skal du konfigurere dine Label Messages og Automation Rules til at vise zx-præfikset og ordrenummeret ved hjælp af to separate Label Messages:

Trin 1: Label Messages-konfiguration

Konfigurer dine Label Messages til at vise både præfiks og ordrenummer:

  1. Åbn Label Messages-indstillinger: Gå til SettingsPrintingPrinting Setup, og klik derefter Document Options for Label
  2. Konfigurer Label Messages: I sektionen Label Messages kan du definere op til 3 brugerdefinerede meddelelser, der vises som referencenumre på UPS-labels.
  3. Indstil dine meddelelser:
    • Sæt Message #1 til [Custom Field 1] (denne udfyldes med "zx" af automation rule)
    • Sæt Message #2 til [Order #] (vælg fra dropdown)
  4. Save Settings for at anvende din konfiguration

Trin 2: Automation Rules-konfiguration

Når du har konfigureret dine Label Messages, opret en automation rule for at udfylde Custom Field 1 med zx-præfikset. Gå til SettingsAutomationAutomation Rules, og klik derefter Create a Rule.

Regel for Zonos UPS-ordrer:

  1. Name: "Zonos UPS Unlock"
  2. Sørg for, at Active Rule er slået til
  3. Vælg Orders match these specific criteria
  4. Sæt kriterier: "International Order" = "True" AND "Carrier" + "Includes" + "UPS"

Bemærk: Dine triggerkriterier kan variere baseret på din ShipStation-konfiguration. Dette er et anbefalet udgangspunkt — tilpas betingelserne baseret på din specifikke workflow og præferencer for at sikre, at UPS Unlock kun anvendes på de relevante ordrer.

  1. Sæt handlinger:
    • Action Type: Vælg "Set Custom Field 1..."
    • Custom Field 1: zx (dette sætter præfikset)
  2. Klik Save Rule

Når du er færdig, udfylder ShipStation automatisk Custom Field 1 med zx og Message #2 med ordrenummeret for internationale UPS-ordrer. Disse vises på dine UPS-labels som to separate referencelinjer.

Vigtigt: Label Message-konfigurationen i ShipStation er en global ændring, der påvirker alle transportører. Automation rules-tilgangen gør det muligt for UPS Unlock at fungere problemfrit for Zonos-ordrer, samtidig med at du bevarer dine foretrukne Label Messages for andre forsendelser.

Book en demo

Var denne side nyttig?