Connecter USPS : tarifs en direct, étiquettes, suivi

Récupérez votre Consumer Key et votre Consumer Secret dans USPS Developer Portal, collez-les dans Integration, testez, mappez les services, puis cotez et expédiez.

Le connecteur USPS obtient des tarifs, achète des étiquettes et suit les envois via les API USPS. Une paire d’identifiants OAuth — Consumer Key et Consumer Secret — couvre tarifs et suivi ; l’achat d’étiquettes exige en plus vos identifiants de compte de paiement USPS.

Prérequis#

• Accès à USPS Developer Portal (developers.usps.com) et une app dans Apps : votre Consumer Key et votre Consumer Secret se trouvent sur la page de cette app.
• Choisissez d’abord l’environnement : commencez par l’environnement de test (TEM) avant la production.
• Tarifs et suivi ne demandent que la paire OAuth — aucun champ de compte n’est requis.
• Avant d’acheter des étiquettes, préparez vos identifiants de compte de paiement USPS : CRID, MID et EPS. Ils servent à l’achat d’une étiquette, pas à la création de cette connexion.

Obtenir les identifiants#

1. Allez dans USPS Developer Portal (developers.usps.com) → Apps → ouvrez votre app.
2. Sur la page de l’app, copiez le Consumer Key. Il sert d’OAuth client_id.
3. Sur la même page de l’app, copiez le Consumer Secret. Il sert d’OAuth client_secret.
4. Enregistrez le Consumer Secret en lieu sûr tout de suite. Perdu, générez-en un nouveau dans USPS Developer Portal.

Remplir dans Integration#

1. Ouvrez Integration → Marketplace → USPS → Nouvelle connexion.
2. Consumer Key (client_id), obligatoire : collez le Consumer Key de la page de votre app dans USPS Developer Portal. Dans l’assistant, le champ s’intitule « Consumer Key ».
3. Consumer Secret (client_secret), obligatoire : collez le Consumer Secret de la même page de l’app. Il est chiffré au repos, jamais réaffiché.
4. Use sandbox (sandbox), facultatif : saisissez « true » pour l’environnement de test TEM (apis-tem.usps.com). Laissez vide pour la production (apis.usps.com).
5. CRID / MID / EPS : ne les cherchez pas ici ; ce sont des identifiants de compte de paiement pour l’achat d’étiquettes, pas des champs de cet assistant de connexion. Préparez-les avant d’acheter des étiquettes.

Tester la connexion#

Cliquez sur Tester la connexion. Le test échange uniquement votre Consumer Key et votre Consumer Secret contre un token OAuth pour vérifier les identifiants — il ne cote pas de tarif, n’achète pas d’étiquette et ne vérifie pas le suivi. Réussi, clé, secret et environnement correspondent ; en cas d’échec, notez l’erreur et consultez la FAQ avant de changer autre chose.

Mapping / choisir un modèle#

USPS n’a pas besoin de mapping de commandes : elle traite des colis, pas des commandes. On mappe ici les services du transporteur : dans les paramètres de la connexion, associez chaque service d’expédition utilisé en interne au service USPS correspondant et n’activez que les services que vous utilisez vraiment, pour que la comparaison ne cote que des services réellement proposés.

Activer#

Après activation, la connexion sert à comparer les tarifs et acheter des étiquettes à l’expédition, et les mises à jour de suivi reviennent sur l’envoi. Avant votre première vraie étiquette, vérifiez que vos identifiants de compte de paiement (CRID / MID / EPS) sont prêts — le test de connexion ne les vérifie pas. Surveillez les premiers envois dans Runs / Logs avant de laisser tourner sans surveillance.

FAQ#

Le test échoue avec 401

Le Consumer Key ou le Consumer Secret est incorrect : les deux valeurs ont été inversées, ou l’une a été copiée incomplète ou avec un espace en trop, et USPS refuse l’échange de token.

Retournez dans USPS Developer Portal (developers.usps.com) → Apps → votre app, copiez le Consumer Key dans le champ Consumer Key et le Consumer Secret dans le champ Consumer Secret tels quels, puis retestez.

Environnement de test et production sont mélangés

L’environnement et l’attendu ne coïncident pas : Use sandbox vaut « true » et les appels vont vers l’environnement de test TEM, mais vous testez comme si c’était la production ; ou Use sandbox est vide pour la production alors que vous attendez encore un comportement de test.

Faites correspondre le réglage à l’environnement à tester, puis retestez : pour l’environnement de test, mettez Use sandbox à « true » ; pour la production, laissez Use sandbox vide. Si vous utilisez les deux, gardez des connexions séparées.

Le test réussit mais l’achat d’étiquette échoue

Cela arrive quand le côté paiement n’est pas prêt : le test ne vérifie que l’échange OAuth pour tarifs et suivi, alors que l’achat d’une étiquette exige en plus vos identifiants de compte de paiement USPS : CRID, MID et EPS.

Préparez vos CRID, MID et EPS avant d’acheter des étiquettes : ce ne sont pas des champs de l’assistant de connexion, donc un test réussi ne les couvre pas. Une fois prêts, réessayez l’achat et, en cas d’échec persistant, consultez l’erreur dans Runs / Logs.

Étiquette achetée mais le suivi ne se met jamais à jour

Les mises à jour de suivi arrivent au rythme d’USPS, pas instantanément, et une étiquette pas encore remise à USPS n’a aucun mouvement à afficher.

Vérifiez que le colis a bien été remis, attendez, puis contrôlez à nouveau. Si rien n’arrive après 24 heures, vérifiez dans Runs / Logs les erreurs de suivi de cet envoi.