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.
   • Exemples :
     • zxORDER123 ou zx-ORDER123 (format combiné avec le numéro de commande marchand)
     • zxorder_0jy1vh6gygcks ou zx-order_0jy1vh6gygcks (format combiné avec l'ID de commande Zonos)
     • Référence 1 : zx, Référence 2 : ORDER123 (répartie sur deux champs de référence)

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 appelle automatiquement Zonos pour valider la commande à l'aide des champs de référence fournis
2. Zonos valide et renvoie à UPS les détails douaniers mis à jour - Zonos vérifie que l'expédition correspond au devis d'origine en contrôlant :
   1. Les articles de l'expédition correspondent à ceux du devis
   2. Les quantités sont inférieures ou égales aux quantités devisées
   3. Les numéros de pièce correspondent aux ID de produit ou SKU du devis
   4. Les détails de destination (pays/province) correspondent au devis
3. UPS traite votre expédition avec les informations de conformité
4. UPS appelle Zonos pour créer l'enregistrement d'expédition avec le numéro de suivi
5. Zonos enregistre l'expédition sur la commande

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.

Exigences

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

• Landed Cost Guarantee (LCG) - La commande doit avoir été créée via le flux Zonos Checkout avec un landed cost garanti. Les commandes créées en dehors de Zonos ne peuvent pas être utilisées avec UPS Unlock.
• Correspondance origine/destination - Les pays d'expédition et de destination doivent correspondre au devis d'origine. Pour les expéditions vers le Canada ou le Brésil, la province doit également correspondre.
• Correspondance des produits - Les numéros de pièce doivent correspondre aux ID de produit ou SKU du devis, et les quantités ne peuvent pas dépasser les quantités devisées.

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. Une fois les étapes de configuration initiales terminées, vous pouvez commencer à configurer ShipStation pour qu'il fonctionne avec UPS Unlock.

Ajouter zx en amont

Si vous pouvez ajouter le préfixe zx en amont (avant que les commandes n'atteignent ShipStation), vous n'avez besoin que de configurer vos Label Messages pour afficher le numéro de commande zx :

Configuration des Label Messages

1. Accéder aux paramètres Label Messages : Naviguez vers Settings → Printing → Printing Setup, puis cliquez sur Document Options pour Label
2. Configurer les Label Messages : Dans la section Label Messages, vous pouvez définir jusqu'à 3 messages personnalisés qui apparaîtront comme numéros de référence sur les étiquettes UPS. Les Label Messages n'acceptent que des valeurs prédéfinies comme « Custom Field 1 », « Order # », etc.
3. Définir vos messages pour utiliser le numéro de commande : Réglez Message #1 sur [Order #]. Si vous avez déjà un #1, ajoutez un #2 ou #3
4. Enregistrer les paramètres (Save Settings) pour appliquer votre configuration

Une fois terminé, ShipStation placera automatiquement votre numéro de commande sur votre étiquette, incluant votre préfixe zx configuré.

Ajouter zx dans ShipStation

Si vous ne pouvez pas ajouter le préfixe zx en amont (avant que les commandes n'atteignent ShipStation), vous devrez configurer vos Label Messages et vos Automation Rules pour afficher le préfixe zx et le numéro de commande à l'aide de deux Label Messages distincts :

Étape 1 : Configuration des Label Messages

Configurez vos Label Messages pour afficher à la fois le préfixe et le numéro de commande :

1. Accéder aux paramètres Label Messages : Naviguez vers Settings → Printing → Printing Setup, puis cliquez sur Document Options pour Label
2. Configurer les Label Messages : Dans la section Label Messages, vous pouvez définir jusqu'à 3 messages personnalisés qui apparaîtront comme numéros de référence sur les étiquettes UPS.
3. Définir vos messages :
   • Réglez Message #1 sur [Custom Field 1] (il sera renseigné avec « zx » par la règle d'automatisation)
   • Réglez Message #2 sur [Order #] (à sélectionner dans le menu déroulant)
4. Enregistrer les paramètres (Save Settings) pour appliquer votre configuration

Étape 2 : Configuration des Automation Rules

Après avoir configuré vos Label Messages, créez une règle d'automatisation pour renseigner Custom Field 1 avec le préfixe zx. Naviguez vers Settings → Automation → Automation Rules puis cliquez sur Create a Rule.

Règle pour les commandes UPS Zonos :

1. Nom : « Zonos UPS Unlock »
2. Vérifiez que Active Rule est activé
3. Sélectionnez Orders match these specific criteria
4. Définissez le critère : « International Order » = « True » ET « Carrier » + « Includes » + « UPS »

Remarque : vos critères de déclenchement peuvent varier selon votre configuration ShipStation. Il s'agit d'un point de départ recommandé - personnalisez les conditions selon votre flux de travail et vos préférences afin qu'UPS Unlock ne s'applique qu'aux commandes appropriées.

1. Définissez les actions :
   • Action Type : Sélectionnez « Set Custom Field 1... »
   • Custom Field 1 : zx (ceci définit le préfixe)
2. Cliquez sur Save Rule

Une fois terminé, ShipStation renseignera automatiquement Custom Field 1 avec zx et Message #2 avec le numéro de commande pour les commandes UPS internationales. Ces éléments apparaîtront sur vos étiquettes UPS sous forme de deux lignes de référence distinctes.

Important : La configuration des Label Messages dans ShipStation est un changement global qui affecte tous les transporteurs. L'approche par règles d'automatisation permet à UPS Unlock de fonctionner de façon transparente pour les commandes Zonos tout en conservant vos Label Messages habituels pour les autres expéditions.