Connecter FedEx Freight : obtenir des tarifs LTL et suivre les envois de fret
Obtenez un Client ID et un Client Secret sur le FedEx Developer Portal, saisissez-les avec votre numéro de compte Freight dans Integration, testez d’abord avec les identifiants sandbox, puis basculez test_mode en production pour les tarifs LTL et le suivi réels.
Le connecteur FedEx Freight concerne le fret en chargement partiel (LTL). Il obtient des devis de tarif LTL et suit les envois de fret par numéro de suivi ou numéro PRO, en renvoyant les événements de scan. Il ne crée pas d’étiquettes d’expédition et ce n’est pas la connexion FedEx petits colis : il utilise ses propres champs et votre compte FedEx Freight. La connexion utilise l’environnement sandbox par défaut : lisez donc attentivement l’étape de test avant de passer en production.
Prérequis#
- Une application dans le FedEx Developer Portal, pour pouvoir lire son Client ID et son Client Secret.
- Votre numéro de compte FedEx Freight : le compte Freight utilisé pour les devis et la facturation LTL. Un compte FedEx petits colis est un autre compte pour cette connexion.
- Un choix clair d’environnement pour le premier test : identifiants sandbox avec l’environnement sandbox, ou identifiants de production avec la production. La connexion utilise sandbox par défaut, et les identifiants sandbox et de production ne se mélangent pas.
- Au moins une liaison réelle que vous pouvez chiffrer, et un numéro de suivi ou un numéro PRO d’un envoi de fret passé, pour vérifier les tarifs et le suivi après le test.
Obtenir les identifiants#
- Connectez-vous au FedEx Developer Portal et ouvrez votre application.
- Dans votre application, lisez le Client ID et le Client Secret. Les deux valeurs forment une paire OAuth2 et vont ensemble : prenez les deux dans la même application.
- Notez votre numéro de compte FedEx Freight, le compte Freight utilisé pour les devis et la facturation LTL.
- Décidez avec quel jeu d’identifiants vous testerez d’abord. Les identifiants sandbox se testent sur l’adresse sandbox https://apis-sandbox.fedex.com ; les identifiants de production sur https://apis.fedex.com. Notez le jeu choisi : le champ test_mode doit lui correspondre.
Remplir dans Integration#
- Ouvrez Integration, choisissez FedEx Freight et démarrez une nouvelle connexion.
- client_id, obligatoire, Client ID : le Client ID de FedEx Developer Portal → votre application, sous la forme l7xxxxxx et les caractères suivants. Copiez-le depuis la même application que le secret ci-dessous.
- client_secret, obligatoire, Client Secret : le Client Secret de la même application dans le FedEx Developer Portal. Il est conservé comme secret.
- account_number, obligatoire, Freight Account Number : votre numéro de compte FedEx Freight, par ex. sous la forme 123456789. C’est le compte Freight utilisé pour les devis et la facturation LTL, pas un compte colis.
- test_mode, facultatif, Test Mode : saisissez true pour utiliser l’environnement sandbox https://apis-sandbox.fedex.com, qui est aussi le défaut quand le champ reste vide. Saisissez false pour utiliser la production https://apis.fedex.com. La valeur doit correspondre aux identifiants saisis : identifiants sandbox avec true, identifiants de production avec false.
Tester la connexion#
Cliquez sur Tester la connexion. Ce qui se passe dépend de ce que vous avez saisi. Si client_id, client_secret ou account_number manque, le test n’envoie aucune demande à FedEx : il exécute un contrôle d’essai local avec des données d’exemple et annonce un succès pour cet essai seulement. Lisez le détail du résultat : un succès d’essai ne prouve pas vos identifiants. Quand les trois valeurs sont présentes, le test s’exécute réellement en deux étapes : il échange d’abord votre client_id et votre client_secret contre un token OAuth2, puis il envoie un petit appel de devis LTL avec votre compte Freight. Une réponse 401 ou 403 compte comme un échec d’authentification ; les autres réponses de l’endpoint de devis comptent comme joignable. Un succès réel se lit ainsi : authentification OAuth2 réussie pour l’adresse de l’environnement, et endpoint de devis Freight joignable. Le test attend jusqu’à 12 secondes.
Mapping / choisir un modèle#
Choisissez le modèle standard FedEx Freight pour les devis et le suivi LTL. Les devis partent avec votre numéro de compte Freight, et les recherches de suivi acceptent un numéro de suivi ou un numéro PRO et renvoient les événements de scan. Après un test réellement réussi, lancez un devis sur une liaison que vous connaissez et comparez le tarif et le service renvoyés avec ce que vous attendez pour cette liaison ; puis recherchez un envoi passé par son numéro PRO et comparez les événements de scan. N’activez que lorsque les deux vérifications sont bonnes.
Activer#
Après activation, la connexion obtient des devis LTL réels avec votre compte Freight et suit les envois de fret par numéro de suivi ou numéro PRO. Pour passer du test au travail réel, mettez test_mode à false et vérifiez que le client_id et le client_secret de la connexion sont bien les valeurs de votre application de production : une connexion restée en sandbox continue de renvoyer des résultats sandbox. Surveillez les premiers devis et recherches de suivi dans Runs / Logs avant de laisser la connexion sans surveillance.
Ce que cette connexion ne fait pas : elle ne crée ni n’achète d’étiquettes d’expédition, et elle ne gère pas l’expédition FedEx petits colis. Pour les tarifs et étiquettes colis, utilisez la connexion FedEx petits colis séparée, avec ses propres identifiants et son propre compte.
FAQ#
Le test échoue avec 401 ou 403
FedEx a refusé l’authentification : la demande de token OAuth2 ou l’appel de devis a été rejeté avec 401 ou 403. La connexion traite 401 et 403 comme un échec d’authentification : le client_id, le client_secret ou l’environnement auquel ils appartiennent ne correspond donc pas.
Recopiez client_id et client_secret depuis la même application dans FedEx Developer Portal → votre application, vérifiez que test_mode correspond à ce jeu d’identifiants (sandbox avec true, production avec false), puis retestez.
Les identifiants de production échouent tout de suite au test
La connexion pointe encore sur le sandbox. test_mode utilise par défaut l’environnement sandbox https://apis-sandbox.fedex.com quand il est vide ou à true, et les identifiants de production ne sont pas valides dans le sandbox : un Client ID et un Secret de production corrects échouent donc quand même.
Mettez test_mode à false pour que le test s’exécute sur la production https://apis.fedex.com, gardez le client_id et le client_secret de production en place, enregistrez et retestez. Pour tester dans le sandbox, gardez test_mode à true et utilisez des identifiants sandbox.
Le test annonce un succès, mais aucun devis réel n’a été fait
L’une des trois valeurs obligatoires était vide lors du test. Si client_id, client_secret ou account_number manque, le test n’envoie aucune demande à FedEx et exécute seulement un contrôle d’essai local avec des données d’exemple : son message de succès indique que le contrôle a tourné sans identifiants réels et sans demande réelle.
Remplissez les trois valeurs — client_id et client_secret depuis FedEx Developer Portal → votre application, et votre numéro de compte Freight dans account_number — enregistrez et retestez. Seul un succès qui nomme l’adresse de l’environnement et l’endpoint de devis Freight compte comme un vrai test d’identifiants.
Les devis fonctionnent, mais le suivi ne renvoie rien pour un envoi
Le numéro utilisé n’est pas un numéro de suivi ou un numéro PRO FedEx Freight pour ce compte, ou l’envoi n’a pas encore d’événements de scan. Le suivi de cette connexion lit les envois de fret par numéro de suivi ou numéro PRO : un numéro de suivi de colis ne renverra pas d’événements de fret.
Copiez le numéro PRO ou le numéro de suivi depuis les documents de fret d’un envoi déjà enlevé, vérifiez-le chiffre par chiffre et relancez la recherche. Si un envoi enlevé connu ne renvoie toujours rien, confirmez que l’envoi a voyagé sous le même compte Freight que la connexion.
Cette connexion peut-elle créer des étiquettes FedEx Freight ?
Non. Cette connexion couvre uniquement les devis LTL et le suivi de fret : il n’y a pas de création d’étiquettes dedans. Chercher une étape d’étiquette dans cette connexion n’en trouvera pas, car le travail Freight ici, c’est le devis et le suivi.
Utilisez cette connexion pour le devis et le suivi de l’envoi de fret, et gardez le travail d’étiquettes et de réservation dans le canal où vous réservez le fret. Pour les étiquettes FedEx petits colis, utilisez plutôt la connexion FedEx petits colis séparée.