Connecter UPS : tarifs en direct, étiquettes, suivi
Créez une app dans UPS Developer Kit, collez Client ID / Secret et Shipper Number, testez, puis cotez et expédiez.
Le connecteur UPS obtient des tarifs en direct, achète des étiquettes et suit les colis via l’API UPS. Il faut un compte UPS avec Shipper Number à 6 chiffres.
Prérequis#
- Un compte UPS avec Shipper Number à 6 chiffres.
- Accès à UPS Developer Kit pour créer une app (developer.ups.com).
- Test et production ont des identifiants séparés ; commencez en mode test.
Obtenir les identifiants#
- Dans UPS Developer Kit, créez une app et notez le Client ID et le Client Secret OAuth.
- Trouvez votre Shipper Number à 6 chiffres dans votre compte UPS (numéro de compte sur vos factures).
- En mode test, utilisez les identifiants sandbox UPS ; en production, ceux de l’app de production.
Remplir dans Integration#
- Ouvrez Integration → Marketplace → UPS → Nouvelle connexion.
- Client ID / Client Secret : collez les identifiants OAuth. Chiffrés au repos, jamais réaffichés.
- Shipper Number : votre numéro de compte UPS à 6 chiffres.
- Environnement : test d’abord, production après un test de tarif réussi.
Tester la connexion#
Le test lance une cotation réelle pour un colis exemple. Une cotation en retour prouve que auth, compte et tarification fonctionnent.
Mapping / choisir un modèle#
UPS n’a pas besoin de mapping de commandes : elle traite des colis. Dans les paramètres, cochez les services proposés.
Activer#
Après activation, la connexion sert à coter et acheter des étiquettes à l’expédition. Le suivi revient automatiquement.
FAQ#
Échec d’authentification (401)
Le Client ID / Secret est incorrect, ou vous avez collé des identifiants de test dans une connexion de production (ou l’inverse).
Vérifiez d’abord le sélecteur d’environnement, puis recopiez les identifiants de cet environnement.
La cotation échoue mais l’authentification fonctionne
Le Shipper Number est incorrect, ou le compte n’a pas ce service activé.
Vérifiez le Shipper Number sur une facture UPS.
Étiquette achetée mais le suivi ne se met jamais à jour
Les mises à jour de suivi arrivent au rythme d’UPS, pas instantanément.
Si rien n’arrive sous 24 heures, vérifiez Runs / Logs pour les erreurs de webhook.