UPS Unlock

UPS Unlock ti consente di generare spedizioni conformi a Zonos dalla tua piattaforma di spedizione, invece di utilizzare Zonos Dashboard. Aggiungendo un numero di riferimento specifico durante l’elaborazione delle spedizioni UPS, UPS convalida e aggiorna automaticamente i dati di spedizione tramite Zonos, incluse descrizioni doganali, codici HS, numeri di account per i dazi, ID fiscali e valori delle merci. Questo elimina la necessità di configurare regole o integrazioni complesse per trasmettere queste informazioni alla tua piattaforma di spedizione. UPS recupera invece i dati direttamente da Zonos, riducendo il rischio di discrepanze o informazioni mancanti e riducendo al minimo i tempi di configurazione e manutenzione manuale.

Configura UPS Unlock 

1. Contatta il supporto Zonos - Prima di abilitare UPS Unlock, contatta Zonos Support per assicurarti che il tuo account UPS sia configurato correttamente. Questo processo richiede in genere 24-48 ore.
2. Abilita UPS Unlock in Dashboard - Vai su Zonos Dashboard → Settings → Rates → UPS e attiva UPS Unlock impostandolo su Enable
3. Configura i tuoi numeri di riferimento - Almeno un numero di riferimento deve iniziare con zx o zx-. Finché almeno un riferimento inizia con zx (anche se il valore è solo zx), Zonos analizzerà tutti i numeri di riferimento per trovare un ID ordine Zonos o un numero d’ordine dell’account corrispondente.
   • Esempi:
     • zxORDER123 o zx-ORDER123 (formato combinato con il numero d’ordine del commerciante)
     • zxorder_0jy1vh6gygcks o zx-order_0jy1vh6gygcks (formato combinato con l’ID ordine Zonos)
     • Riferimento 1: zx, Riferimento 2: ORDER123 (suddiviso su due campi di riferimento)

Come funziona 

Una volta configurato UPS Unlock, le spedizioni UPS faranno riferimento ai dati dell’ordine Zonos. Ecco come funziona il processo:

1. UPS chiama automaticamente Zonos per convalidare l’ordine con i campi di riferimento forniti
2. Zonos convalida e restituisce a UPS i dettagli doganali aggiornati - Zonos verifica che la spedizione corrisponda al preventivo originale controllando:
   1. Gli articoli nella spedizione corrispondono a quelli del preventivo
   2. Le quantità sono minori o uguali agli importi preventivati
   3. I part number corrispondono agli ID prodotto o agli SKU del preventivo
   4. I dettagli di destinazione (Paese/provincia) corrispondono al preventivo
3. UPS elabora la tua spedizione con le informazioni di conformità
4. UPS chiama Zonos per creare il record di spedizione con il numero di tracciamento
5. Zonos registra la spedizione sull’ordine

Corrispondenza dei riferimenti 

Quando UPS chiama Zonos con un riferimento come zx-ORDER123, Zonos rimuove il prefisso e cerca l’ordine. Il valore dopo il prefisso (ORDER123 in questo esempio) viene confrontato con tre campi dell’ordine Zonos:

Zonos restituisce l’ordine corrispondente più recente. Se non viene trovata alcuna corrispondenza, viene restituito un errore.

Requisiti

Perché UPS Unlock abbia successo, l’ordine deve soddisfare questi requisiti:

• Landed Cost Guarantee (LCG) - L’ordine deve essere stato creato tramite il flusso di checkout Zonos con un Landed Cost garantito. Gli ordini creati al di fuori di Zonos non possono essere utilizzati con UPS Unlock.
• Corrispondenza origine/destinazione - I Paesi di partenza e di destinazione della spedizione devono corrispondere al preventivo originale. Per le spedizioni verso Canada o Brasile, deve corrispondere anche la provincia.
• Corrispondenza dei prodotti - I part number devono corrispondere agli ID prodotto o agli SKU del preventivo e le quantità non possono superare gli importi preventivati.

Codici di errore 

Se la convalida non riesce, UPS riceve una risposta di errore da Zonos. I codici di errore più comuni includono:

Integrazione ShipStation 

Gli utenti ShipStation possono configurare UPS Unlock aggiungendo il prefisso zx a monte (tramite API prima che gli ordini raggiungano ShipStation) oppure all’interno di ShipStation utilizzando le configurazioni Label Messages e Automation Rules. Questo consente di includere il prefisso zx e l’ID ordine nelle spedizioni UPS elaborate tramite ShipStation, attivando UPS Unlock. Dopo aver completato i passaggi di configurazione iniziali, puoi iniziare a configurare ShipStation per lavorare con UPS Unlock.

Aggiungere zx a monte

Se puoi aggiungere il prefisso zx a monte (prima che gli ordini raggiungano ShipStation), devi solo configurare i tuoi Label Messages per visualizzare il numero d’ordine zx:

Configurazione di Label Messages

1. Accedi alle impostazioni di Label Messages: vai su Settings → Printing → Printing Setup, quindi fai clic su Document Options per Label
2. Configura Label Messages: nella sezione Label Messages, puoi definire fino a 3 messaggi personalizzati che appariranno come numeri di riferimento sulle etichette UPS. Label Messages accetta solo valori predefiniti come "Custom Field 1", "Order #", ecc.
3. Imposta i tuoi Messages per utilizzare Order Number: imposta Message #1 su [Order #]. Se hai già un #1, aggiungi un #2 o #3
4. Save Settings per applicare la tua configurazione

Una volta completato, ShipStation inserirà automaticamente il numero d’ordine sull’etichetta, che includerà il prefisso zx configurato.

Aggiungere zx in ShipStation

Se non puoi aggiungere il prefisso zx a monte (prima che gli ordini raggiungano ShipStation), dovrai configurare i tuoi Label Messages e Automation Rules per visualizzare il prefisso zx e il numero d’ordine utilizzando due Label Messages separati:

Fase 1: configurazione di Label Messages

Configura i tuoi Label Messages per visualizzare sia il prefisso che il numero d’ordine:

1. Accedi alle impostazioni di Label Messages: vai su Settings → Printing → Printing Setup, quindi fai clic su Document Options per Label
2. Configura Label Messages: nella sezione Label Messages, puoi definire fino a 3 messaggi personalizzati che appariranno come numeri di riferimento sulle etichette UPS.
3. Imposta i tuoi Messages:
   • Imposta Message #1 su [Custom Field 1] (verrà popolato con "zx" dalla automation rule)
   • Imposta Message #2 su [Order #] (seleziona dal menu a discesa)
4. Save Settings per applicare la tua configurazione

Fase 2: configurazione di Automation Rules

Dopo aver configurato i tuoi Label Messages, crea una automation rule per popolare Custom Field 1 con il prefisso zx. Vai su Settings → Automation → Automation Rules, quindi fai clic su Create a Rule.

Regola per gli ordini UPS Zonos:

1. Nome: "Zonos UPS Unlock"
2. Assicurati che Active Rule sia attivato
3. Seleziona Orders match these specific criteria
4. Imposta i criteri: "International Order" = "True" AND "Carrier" + "Includes" + "UPS"

Nota: i tuoi criteri di attivazione possono variare in base alla tua configurazione ShipStation. Questo è un punto di partenza consigliato: personalizza le condizioni in base al tuo flusso di lavoro e alle tue preferenze specifiche per assicurarti che UPS Unlock venga applicato solo agli ordini appropriati.

1. Imposta le azioni:
   • Action Type: seleziona "Set Custom Field 1..."
   • Custom Field 1: zx (questo imposta il prefisso)
2. Fai clic su Save Rule

Una volta completato, ShipStation popolerà automaticamente Custom Field 1 con zx e Message #2 con il numero d’ordine per gli ordini UPS internazionali. Questi appariranno sulle tue etichette UPS come due righe di riferimento separate.

Importante: la configurazione di Label Message in ShipStation è una modifica globale che influisce su tutti i carrier. L’approccio con automation rules consente a UPS Unlock di funzionare senza problemi per gli ordini Zonos, mantenendo al contempo i tuoi Label Messages preferiti per le altre spedizioni.