Konfigurer UPS Unlock
- 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.
- Aktiver UPS Unlock i Dashboard - Gå til Zonos Dashboard → Settings → Rates → UPS og skift UPS Unlock til Enable
- Konfigurer dine referencenumre - Mindst ét referencenummer skal starte med
zxellerzx-. Så længe mindst én reference starter medzx(selv hvis værdien kun erzx), scanner Zonos alle referencenumre for at finde et matchende Zonos order ID eller account order number.- Eksempler:
zxORDER123ellerzx-ORDER123(kombineret format med merchant order number)zxorder_0jy1vh6gygcksellerzx-order_0jy1vh6gygcks(kombineret format med Zonos order ID)- Reference 1:
zx, Reference 2:ORDER123(opdelt på to referencefelter)
- Eksempler:
Sådan fungerer det
Når du har konfigureret UPS Unlock, vil UPS-forsendelser referere til Zonos-ordredata. Sådan fungerer processen:
- UPS kalder automatisk Zonos for at validere ordren med de angivne referencefelter
- Zonos validerer og returnerer opdaterede toldoplysninger til UPS - Zonos validerer, at forsendelsen matcher det oprindelige tilbud ved at kontrollere:
- Varer i forsendelsen matcher dem i tilbuddet
- Antal er mindre end eller lig med de angivne mængder
- Part numbers matcher product IDs eller SKUs fra tilbuddet
- Destinationsoplysninger (land/provins) matcher tilbuddet
- UPS behandler din forsendelse med compliance-oplysninger
- UPS kalder Zonos for at oprette forsendelsespost med tracking number
- 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:
| Felt↕ | Beskrivelse↕ | Eksempel↕ |
|---|---|---|
| Order ID | Zonos order UUID | order_0jy1vh6gygcks |
| Account order number | Dit merchant order number | ORD-12345, #1001 |
| Zonos order ID | Zonos kort identifikator | zo-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:
| Kode↕ | Meddelelse↕ | Årsag↕ |
|---|---|---|
| 10001 | Shipper number not found | UPS shipper number er ikke registreret hos Zonos |
| 10002 | No Zonos order found for any of the provided reference IDs | Ingen ordre matcher nogen reference (efter fjernelse af præfiks) |
| 10003 | Invalid reference IDs. No prefix of zx- found | Ingen af referencerne har zx- eller zx--præfiks |
| 10006 | The requested order is not guaranteed | Ordren findes, men har ikke Landed Cost Guarantee |
| 10010 | ShipFrom.CountryCode mismatch | Ship-from-land matcher ikke den angivne origin |
| 10011 | ShipTo.CountryCode mismatch | Ship-to-land matcher ikke den angivne destination |
| 10012 | ShipTo.StateProvinceCode mismatch | For CA/BR-forsendelser matcher provinsen ikke |
| 10013 | No matching Product on quote with PartNumber | Product SKU/productId findes ikke på ordren |
| 10015 | Quantity exceeds the quoted quantity | Det 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
- Åbn Label Messages-indstillinger: Gå til Settings → Printing → Printing Setup, og klik derefter Document Options for Label
- 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.
- 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 - 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:
- Åbn Label Messages-indstillinger: Gå til Settings → Printing → Printing Setup, og klik derefter Document Options for Label
- Konfigurer Label Messages: I sektionen Label Messages kan du definere op til 3 brugerdefinerede meddelelser, der vises som referencenumre på UPS-labels.
- 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)
- Sæt Message #1 til
- 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 Settings → Automation → Automation Rules, og klik derefter Create a Rule.
Regel for Zonos UPS-ordrer:
- Name: "Zonos UPS Unlock"
- Sørg for, at Active Rule er slået til
- Vælg Orders match these specific criteria
- 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.
- Sæt handlinger:
- Action Type: Vælg "Set Custom Field 1..."
- Custom Field 1:
zx(dette sætter præfikset)
- 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.
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.