UPS Unlock

UPS Unlock vous permet de générer des expéditions conformes Zonos depuis votre propre plateforme d'expédition, au lieu d'utiliser Zonos Dashboard. En ajoutant un numéro de référence spécifique lors du traitement des expéditions UPS, UPS valide et met à jour automatiquement les données d'expédition via Zonos, y compris les descriptions douanières, codes HS, numéros de compte de droits, identifiants fiscaux et valeurs des marchandises. Cela élimine le besoin de configurer des règles ou intégrations complexes pour transmettre ces informations à votre plateforme d'expédition. UPS récupère plutôt les données directement depuis Zonos, réduisant le risque d'écarts ou d'informations manquantes tout en minimisant le temps de configuration et de maintenance manuelle.

Configurer UPS Unlock 

1. Contacter le support Zonos - Avant d'activer UPS Unlock, contactez le support Zonos pour vérifier que votre compte UPS est correctement configuré. Ce processus prend généralement 24 à 48 heures.
2. Activer UPS Unlock dans Dashboard - Allez dans Zonos Dashboard → Settings → Rates → UPS et basculez UPS Unlock sur Enable
3. Configurer vos numéros de référence - Au moins un numéro de référence doit commencer par zx ou zx-. Tant qu'au moins une référence commence par zx (même si la valeur est uniquement zx), Zonos analysera toutes les références pour trouver un ID de commande Zonos ou un numéro de commande marchand correspondant.
   • Examples:
     • zxORDER123 or zx-ORDER123 (combined format with merchant order number)
     • zxorder_0jy1vh6gygcks or zx-order_0jy1vh6gygcks (combined format with Zonos order ID)
     • Reference 1: zx, Reference 2: ORDER123 (split across two reference fields)

Fonctionnement 

Une fois UPS Unlock configuré, les expéditions UPS référenceront les données de commande Zonos. Voici le déroulement :

1. UPS automatically calls Zonos to validate the order with the reference fields provided
2. Zonos validates and returns updated customs details to UPS - Zonos validates that the shipment matches the original quote by checking:
   1. Items in the shipment match those in the quote
   2. Quantities are less than or equal to the quoted amounts
   3. Part numbers match product IDs or SKUs from the quote
   4. Destination details (country/province) match the quote
3. UPS processes your shipment with compliance information
4. UPS calls Zonos to create shipment record with tracking number
5. Zonos records the shipment on the order

Correspondance des références 

Lorsque UPS appelle Zonos avec une référence comme zx-ORDER123, Zonos supprime le préfixe et recherche la commande. La valeur après le préfixe (ORDER123 dans cet exemple) est comparée à trois champs de la commande Zonos :

Zonos renvoie la commande correspondante la plus récente. Si aucune correspondance n'est trouvée, une erreur est renvoyée.

Requirements

Pour qu'UPS Unlock réussisse, la commande doit respecter ces exigences :

• Landed Cost Guarantee (LCG) - The order must have been created through the Zonos checkout flow with a guaranteed landed cost. Orders created outside of Zonos cannot be used with UPS Unlock.
• Matching origin/destination - The ship-from and ship-to countries must match the original quote. For shipments to Canada or Brazil, the province must also match.
• Matching products - Part numbers must match the product IDs or SKUs from the quote, and quantities cannot exceed the quoted amounts.

Codes d'erreur 

Si la validation échoue, UPS reçoit une réponse d'erreur de Zonos. Les codes d'erreur courants incluent :

Intégration ShipStation 

Les utilisateurs ShipStation peuvent configurer UPS Unlock en ajoutant le préfixe zx en amont (via API avant que les commandes n'atteignent ShipStation) ou dans ShipStation via Label Messages et Automation Rules. Cela permet d'inclure le préfixe zx et l'ID de commande dans les expéditions UPS traitées via ShipStation, déclenchant UPS Unlock. After completing the initial setup steps, you can begin configuring ShipStation to work with UPS Unlock.

Adding zx upstream

If you can add the zx prefix upstream (before orders reach ShipStation), you only need to configure your Label Messages to display the zx order number:

Label Messages configuration

1. Access Label Messages settings: Navigate to Settings → Printing → Printing Setup, then click Document Options for Label
2. Configure Label Messages: In the Label Messages section, you can define up to 3 custom messages that will appear as reference numbers on UPS labels. Label Messages only accept preset values like "Custom Field 1", "Order #", etc.
3. Set your Messages to use Order Number: Set Message #1 to [Order #]. If you already have a #1, add a #2 or #3
4. Save Settings to apply your configuration

Once complete, ShipStation will automatically put your order number on your label, which includes your configured zx prefix.

Adding zx in ShipStation

If you can't add the zx prefix upstream (before orders reach ShipStation), you'll need to configure your Label Messages and Automation Rules to display the zx prefix and order number using two separate Label Messages:

Step 1: Label Messages configuration

Configure your Label Messages to display both the prefix and order number:

1. Access Label Messages settings: Navigate to Settings → Printing → Printing Setup, then click Document Options for Label
2. Configure Label Messages: In the Label Messages section, you can define up to 3 custom messages that will appear as reference numbers on UPS labels.
3. Set your Messages:
   • Set Message #1 to [Custom Field 1] (this will be populated with "zx" by automation rule)
   • Set Message #2 to [Order #] (select from dropdown)
4. Save Settings to apply your configuration

Step 2: Automation Rules configuration

After setting up your Label Messages, create an automation rule to populate Custom Field 1 with the zx prefix. Navigate to Settings → Automation → Automation Rules then click Create a Rule.

Rule for Zonos UPS orders:

1. Name: "Zonos UPS Unlock"
2. Ensure Active Rule is toggled on
3. Select Orders match these specific criteria
4. Set criteria: "International Order" = "True" AND "Carrier" + "Includes" + "UPS"

Note: Your trigger criteria may vary based on your ShipStation configuration. This is a recommended starting point - customize the conditions based on your specific workflow and preferences to ensure UPS Unlock is applied only to the appropriate orders.

1. Set actions:
   • Action Type: Select "Set Custom Field 1..."
   • Custom Field 1: zx (this sets the prefix)
2. Click Save Rule

Once complete, ShipStation will automatically populate Custom Field 1 with zx and Message #2 with the order number for international UPS orders. These will appear on your UPS labels as two separate reference lines.

Important: The Label Message configuration in ShipStation is a global change that impacts all carriers. The automation rules approach allows UPS Unlock to work seamlessly for Zonos orders while maintaining your preferred Label Messages for other shipments.