Connecter FedEx : tarifs en direct, étiquettes, suivi

Récupérez l’API Key et la Secret Key de votre projet FedEx Developer Portal ainsi que votre FedEx Account Number à 9 chiffres, collez-les dans Integration, testez, mappez les services, puis cotez et expédiez.

Le connecteur FedEx obtient des tarifs en direct, achète des étiquettes, suit les envois et annule des étiquettes via l’API FedEx, le tout sur votre propre compte FedEx. Tarifs et frais d’étiquettes sont facturés au FedEx Account Number saisi.

Prérequis#

• Un compte FedEx avec un FedEx Account Number à 9 chiffres : tarifs et étiquettes sont facturés à ce compte.
• Accès à FedEx Developer Portal → My Projects, où s’affichent l’API Key et la Secret Key de votre projet.
• Choisissez d’abord l’environnement : mettez sandbox à true pour tester dans le bac à sable, ou laissez vide pour la production. Les identifiants sandbox et production ne se mélangent pas : utilisez ceux de l’environnement choisi.

Obtenir les identifiants#

1. Obtenez l’API Key : allez dans FedEx Developer Portal → My Projects → votre projet → API Key. Cette API Key est l’OAuth Client ID de votre projet : copiez-la telle qu’affichée.
2. Obtenez la Secret Key : dans le même projet, ouvrez Secret Key — c’est l’OAuth Client Secret. La valeur complète ne s’affiche en entier qu’au moment de la génération, conservez-la donc tout de suite en lieu sûr. Si vous la perdez, générez-en une nouvelle dans le portail.
3. Obtenez le FedEx Account Number : allez sur fedex.com → My Profile → Account Management et copiez votre numéro de compte d’expédition à 9 chiffres. Tarifs et étiquettes seront facturés à ce compte.
4. Avertissement — gardez les projets séparés : Track et Rate / Ship peuvent relever de deux projets Developer Portal distincts, chacun avec sa propre API Key et sa propre Secret Key. Pour une connexion, utilisez toujours l’API Key et la Secret Key du même projet. Mélanger la Key d’un projet avec le Secret de l’autre échouera.

Remplir dans Integration#

1. Ouvrez Integration → Marketplace → FedEx → Nouvelle connexion.
2. API Key : collez l’API Key de FedEx Developer Portal → My Projects → votre projet. C’est l’OAuth Client ID de ce projet. Elle est stockée comme secret et jamais réaffichée.
3. Secret Key : collez la Secret Key du même projet. Vérifiez qu’elle va avec l’API Key ci-dessus — n’utilisez pas la Secret Key d’un autre projet, par exemple celle du projet Track quand cette connexion sert à Rate / Ship. Elle est stockée comme secret et jamais réaffichée.
4. FedEx Account Number : saisissez votre numéro de compte d’expédition à 9 chiffres depuis fedex.com → My Profile → Account Management, par exemple 123456789. Vérifiez chaque chiffre — le test ne contrôle pas ce numéro, mais tarifs et étiquettes lui sont facturés.
5. Use sandbox — facultatif : mettez true pour utiliser le bac à sable, ou laissez vide pour la production. Mettez true uniquement avec les identifiants du projet sandbox ; laissez vide uniquement avec les identifiants du projet de production.

Tester la connexion#

Cliquez sur Tester la connexion. Le test échange uniquement votre API Key et votre Secret Key contre un jeton OAuth pour vérifier que les identifiants fonctionnent dans l’environnement choisi. Il ne contrôle pas le FedEx Account Number et ne cote aucun tarif : un test réussi confirme donc seulement la Key et le Secret — si le numéro de compte est faux, tarifs et étiquettes peuvent encore échouer ensuite. En cas d’échec, notez l’erreur et consultez la FAQ.

Mapping / choisir un modèle#

FedEx n’a pas besoin de mapping de commandes : elle traite des colis, pas des commandes. Ce que vous mappez ici, ce sont les services : associez chaque service FedEx à votre service interne correspondant (mapping de services) et n’activez que les services FedEx que vous utilisez réellement. La comparaison de tarifs et l’achat d’étiquettes suivent ce mapping, la commande ne cote et n’achète donc que le service prévu.

Activer#

Après activation, la connexion sert à comparer les tarifs et acheter des étiquettes à l’expédition, les mises à jour de suivi reviennent et s’enregistrent sur l’envoi, et les étiquettes devenues inutiles peuvent être annulées par la même connexion. Surveillez les premiers envois dans Runs / Logs — surtout la première cotation et la première étiquette — avant de le laisser sans surveillance.

FAQ#

Le test échoue avec 401

L’API Key ou la Secret Key est incorrecte, ou les deux ont été mélangées entre projets — par exemple l’API Key du projet Rate / Ship avec la Secret Key du projet Track. FedEx n’accepte qu’une Key et un Secret du même projet, un couple mélangé est donc rejeté.

Ouvrez un seul projet dans FedEx Developer Portal → My Projects, recopiez son API Key et sa Secret Key depuis ce même projet sans espaces supplémentaires, remplacez les deux champs, puis retestez.

Identifiants sandbox et production mélangés

L’environnement et les identifiants ne correspondent pas. Le champ sandbox indique un environnement — true pour le bac à sable, vide pour la production — mais l’API Key et la Secret Key viennent d’un projet de l’autre environnement, FedEx refuse donc l’échange de jeton.

Choisissez un environnement et rendez tout cohérent avec lui : pour tester, mettez Use sandbox à true et saisissez les identifiants du projet sandbox ; pour les envois réels, laissez Use sandbox vide et saisissez les identifiants du projet de production. Puis retestez.

Le test réussit mais les tarifs ou étiquettes échouent

Le FedEx Account Number est incorrect. Le test échange seulement un jeton OAuth et ne contrôle jamais le numéro de compte : un compte mal saisi ou faux passe donc le test — l’échec n’apparaît que lorsqu’un tarif ou une étiquette essaie de facturer ce compte.

Vérifiez le compte sur fedex.com → My Profile → Account Management, corrigez le champ FedEx Account Number avec le numéro exact à 9 chiffres qui y figure, puis relancez la cotation ou l’étiquette.

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

Les mises à jour de suivi arrivent au rythme de FedEx, pas instantanément : une étiquette nouvelle peut donc rester sans mouvement un moment. Si le colis n’a jamais été remis à FedEx, il n’y a pas encore de scan à reporter.

Confirmez d’abord que le colis a bien été remis à FedEx. Si le suivi ne montre toujours rien après l’entrée du colis dans le réseau FedEx, vérifiez Runs / Logs pour les erreurs de suivi et confirmez que la connexion utilisée pour le suivi détient l’API Key et la Secret Key du projet Track — pas le couple Rate / Ship.