Expéditeur FedEx
Condition préalable
Vous devez avoir un id utilisateur FedEx pour vous connecter à FedEx Developer Portal et créer une organisation.
Rejoignez l’organisation de votre entreprise pour collaborer avec votre équipe. Si votre entreprise n’a pas d’organisation, vous pouvez en créer une.
Se joindre à une organisation existante
1. Demander une invitation.
Demandez à l’administrateur de votre organisation de vous envoyer une invitation. Vous avez 24 heures pour l’accepter. Si l’invitation expire, demandez à l’administrateur de la renvoyer.
2. Accepter l’invitation
Connectez-vous en utilisant votre ID utilisateur et votre mot de passe existants. Si votre ID utilisateur est associé à une autre organisation, créez un nouvel identifiant.
Création d’une nouvelle organisation
Lorsque vous créez une organisation, vous devenez l’administrateur. En tant qu’administrateur, vous pouvez inviter des utilisateurs à se joindre à l’organisation, leur attribuer des projets et des rôles, et gérer les comptes d’expédition.
Pour en savoir plus sur les rôles des utilisateurs, consultez les lignes directrices sur l’administration des organisations.
1. Connectez-vous au FedEx Developer Portal.
2. Dans le menu, sélectionnez Mes projets, puis Créer une organisation.
3. Veuillez saisir les renseignements suivants :
- Pour Je travaille pour une entreprise qui, sélectionnez Expédie par FedEx et a besoin d’intégrer les API de FedEx à ses propres applications
- Entrez le nom de votre entreprise, le site Web de votre entreprise et un nom d’organisation que votre équipe reconnaîtra, tel que le nom de votre entreprise, le département, la division ou la région.
4. Sélectionnez Créer.
Vous pouvez mettre à jour ou ajouter des détails ultérieurement sous Gérer l’organisation dans le menu.
Ajout d’un compte d’expédition
1. Sélectionnez Ajouter des comptes d’expédition sur la vignette Ajouter des comptes . Si vous n’avez pas de compte FedEx, sélectionnez Créer un compte pour en ouvrir un nouveau ou communiquez avec le support FedEx.
2. Sélectionnez + Ajouter un compte.
3. Entrez votre numéro de compte FedEx, un surnom de compte et l’adresse de facturation que vous avez utilisée lors de la configuration du compte.
4. Acceptez le Contrat de licence de l‘utilisateur final ou transmettez-le à un représentant autorisé de votre entreprise.
Ajouter un compte de facturation
1. Sélectionnez l’onglet Comptes de facturation . Si vous n’avez pas de compte de facturation FedEx, sélectionnez Ouvrir un compte de facturation pour en ouvrir un nouveau ou contactez le soutien de FedEx.
2. Sélectionnez Ajouter un compte de facturation. Les comptes de facturation doivent être établis aux États-Unis.
3. Entrez votre numéro de compte FedEx, un surnom de compte et une adresse de facturation américaine que vous avez utilisée lors de la création du compte.
4. Lisez et acceptez le Contrat de licence de l’utilisateur final.
Inviter des utilisateurs en tant qu’administrateur
1. Dans le menu, sélectionnez Gérer l’organisation, puis l’onglet Utilisateurs .
2. Sélectionnez + Ajouter des utilisateurs.
3. Sélectionnez un pays ou un territoire et une langue préférée, puis choisissez un rôle utilisateur: spectateur, contributeur ou administrateur.
4. (Facultatif) Attribuez l’utilisateur à un projet. Vous pouvez assigner des utilisateurs en tout temps à partir de la page Aperçu du projet.
5. Entrez les adresses courriel des utilisateurs et cliquez sur Inviter. Vous pouvez inviter jusqu’à 20 utilisateurs à la fois, chaque courriel étant séparé par une virgule. Les invitations expirent après 24 heures.
Création d’un projet API
1. Dans le menu, sélectionnez Mes projets, puis l’onglet API et cliquez sur + Créer un projet API.
2. Confirmez vos besoins en matière d’API.
3. Sélectionnez les API à inclure dans votre projet.
4. Créez un nom de projet et sélectionnez les pays où vous prévoyez d’expédier afin de recevoir un compte d’expédition d’essai. Pour les envois nationaux européens, vous devez disposer d’un compte essai distinct pour chaque pays. Vous pouvez ajouter ou supprimer des pays ultérieurement.
5. Sélectionnez Paramètres sous Notifications pour définir vos préférences en matière de notifications.
6. Lisez et acceptez les modalités.
Créer un projet de visibilité intégrée avancée
Conditions préalables
- Consultez les tarifs : des frais mensuels sont facturés aux abonnés en fonction du nombre de numéros de repérage. Consultez le Guide des tarifs pour en savoir plus sur la tarification.
- Configurer les comptes : le webhook de visibilité des envois nécessite un compte de facturation basé aux États-Unis ainsi qu’au moins un compte d’expédition, ces deux types de comptes sont mutuellement exclusifs. Seuls les administrateurs peuvent ajouter des comptes de facturation et d’expédition sur la page Gérer l’organisation.
1. Créez une URL de destination dans votre application ou plateforme pour recevoir les rappels. L’URL doit :
- Utilisez HTTPS
- Excluez l’espace IP RFC1918, fedex.com et ses sous-domaines, ainsi que les adresses IP telles que localhost ou 127.0.0.1.
2. Générer un jeton de sécurité pour l’authentification. Le jeton doit :
- Contient de 26 à 100 caractères, au moins une lettre majuscule, une lettre minuscule et un chiffre.
3. Dans le menu, sélectionnez Mes projets, puis l’onglet Visibilité intégrée avancée .
4. Sélectionnez Créer un projet de visibilité intégrée avancée.
5. Sélectionnez le type d’utilisateur.
- Expéditeur FedEx : expédie avec FedEx et doit intégrer les API FedEx dans ses propres applications.
- Fournisseur compatible FedEx : est un fournisseur compatible certifié de FedEx.
- Fournisseur intégrateur FedEx : vend ou fournit une solution logicielle utilisant la technologie de FedEx et étant un fournisseur intégrateur validé de FedEx.
6. Sélectionnez le type d’abonnement. Vous pouvez vous abonner aux événements par numéro de compte ou numéro de suivi.
7. Confirmez le compte de facturation et sélectionnez les fonctionnalités que vous souhaitez, telles que la preuve de livraison, la livraison prévue, les événements de suivi ou le filtrage basé sur les événements.
8. Entrer les détails du projet.
- Saisissez un nom de projet unique et reconnaissable.
- Entrez l’URL de destination et le jeton de sécurité que vous avez créés.
- Saisissez une adresse courriel et la langue préférée pour les avis concernant les mises à jour et les pannes de la visibilité intégrée avancée.
9. Acceptez le contrat de licence et le formulaire de commande du FedEx Developer Portal, puis sélectionnez Créer.
Remarque : selon le type d’abonnement que vous avez choisi, il se peut que vous ayez des étapes supplémentaires à franchir. Pour en savoir davantage, consultez notre documentation Webhook.
Suivez ces étapes pour vérifier l’intégration de votre API et confirmer que votre application peut envoyer et recevoir des données d’essai.
Récupération des identifiants d’essai
1. Dans le menu, sélectionnez Mes projets, puis le nom du projet.
2. Dans l’onglet clés API , sous Clé de test, trouvez vos identifiants d’essai.
3. Connectez-vous et téléchargez la collection API JSON en utilisant le bouton Télécharger le schéma JSON situé en haut de la page de documentation. Examinez des exemples de requêtes pour les points de terminaison utilisés par votre intégration.
4. Demandez un jeton d’accès OAuth à utiliser avec chaque transaction API.
Remarque : Le jeton est valide pendant une heure, et vous pouvez configurer votre application pour l’actualiser avant son expiration. Pour plus de détails, consultez la documentation sur API Authorization.
5. Dans le menu, sélectionnez Catalogue d’API, choisissez l’API avec laquelle vous souhaitez travailler, puis sélectionnez Documentation.
6. Dans le menu, sélectionnez le point de terminaison.
7. Envoyez des demandes d’échantillons en utilisant vos identifiants de test et l’URL de test FedEx, puis confirmez que les réponses correspondent aux exemples de la documentation. Pour plus de détails, consultez le Guide de virtualisation du bac à sable.
8. Effectuez des tests avec la visibilité intégrée avancée pour générer des données types et confirmer que votre application traite correctement les renseignements de suivi.
Remarque : les essais ne permettent pas d’authentifier votre URL de rappel. Pour en savoir davantage, consultez la documentation sur la visibilité intégrée avancée.
Mettre votre projet en production
Configurez votre configuration de production avant la mise en ligne. Vous pouvez renommer la clé, ajouter des comptes supplémentaires après la mise en ligne du projet et vérifier le numéro de compte sélectionné lors de la création du projet. Ce numéro de compte fait passer votre projet à la production.
Remarque : Les projets de visibilité intégrée avancée basés sur le numéro de compte ne nécessitent pas d’activation de la production.
1. Dans le menu, sélectionnez Mes projets, puis le nom du projet.
2. Sélectionnez l’onglet Clé de production .
3. Récupérez et stockez vos identifiants de production en toute sécurité.
- Copiez la clé API de production et la clé secrète dans un endroit sécurisé.
- Lorsque vous demandez une clé de production, conservez-la dans un endroit sûr, car elle n’apparaît qu’une seule fois. Si vous la perdez, vous pouvez en générer une nouvelle plus tard.
4. Sélectionnez Suivant pour afficher les détails de votre projet dans l’onglet Clé de production.
Pour ajouter d’autres comptes d’expédition, sélectionnez Modifier en haut du tableau des comptes d’expédition.
Les étapes de validation varient selon la région
Les étapes suivantes s’appliquent uniquement aux clients des États-Unis et du Canada. Si vous résidez à l’extérieur de ces pays, visitez la page Validation des API pour obtenir de l’aide.
Validation de votre API
Certaines API de FedEx nécessitent une validation de l’étiquette d’expédition avant de pouvoir être utilisées en production. Examinez les exigences de validation de l’API avant de commencer.
1. Dans le menu, sélectionnez Mes projets, puis le nom du projet.
2. Dans l’onglet Clés API , sous Clé d’essai, trouvez vos identifiants d’essai.
3. Une fois les essais terminés, déplacez votre projet en production dans le FedEx Developer Portal pour commencer la validation.
- Lorsque vous demandez une clé de production, conservez-la dans un endroit sûr, car elle n’apparaît qu’une seule fois. Si vous la perdez, vous pouvez en générer une nouvelle plus tard.
4. Fournissez les informations requises sur la feuille de couverture de l’étiquette, y compris les coordonnées, les services que vous prévoyez mettre en œuvre, le numéro de compte et la clé API de production.
5. Créez des étiquettes d’essai dans l’environnement d’essai FedEx, puis soumettez-les au groupe d’analyse des codes à barres FedEx pour examen. Veuillez prévoir trois jours ouvrables pour l’évaluation des étiquettes.
Meilleures pratiques pour éviter les retards :
- Imprimez et scannez les étiquettes à une résolution minimale de 600 ppp. Ne soumettez pas de fichiers générés directement à partir des API.
- Pour les imprimantes thermiques, demandez le type d’image qui correspond à votre imprimante, par exemple ZPLII pour les imprimantes Zebra.
- Utilisez des adresses valides d’expéditeur et de destinataire pour les étiquettes d’exemple. Créez des étiquettes uniquement pour les services que vous prévoyez utiliser.
- Pour le service contre remboursement (CR) de FedEx, incluez l’étiquette de retour CR.
- Pour FedEx International Express🅪, incluez la lettre de transport aérien (LTA) auxiliaire (secondaire).
- Pour les envois multipièces, soumettez une étiquette pour chaque colis.
Soumettez vos documents en utilisant l’une des options suivantes :
- Envoyez le PDF et la feuille de couverture de l’étiquette par courriel à label@fedex.com.
- Envoyer les étiquettes physiques à :
Services FedEx
WTC-Business Solutions Testing
10 FedEx Parkway
2e étage — Aile horizontale
Collierville, TN 38017
Remarque : pour les étiquettes physiques, assurez-vous qu’elles ne présentent pas de défauts visibles, tels que des lignes d’encre ou des dommages. Ne pas agrandir ni rétrécir les étiquettes lors de l’impression.
6. Le groupe d’analyse des codes-barres de FedEx examine votre demande et approuve ou rejette les étiquettes. Si les étiquettes sont rejetées, tenez compte des commentaires et soumettez-les à nouveau.
7. Après approbation, le groupe d’analyse des codes-barres de FedEx vous envoie un courriel après avoir autorisé vos identifiants de production pour les transactions d’étiquettes d’expédition.
Remarque : l’approbation s’applique par projet. Chaque nouveau projet nécessite une approbation.
8. Remplacez les URL et les identifiants d’essai par les URL et les identifiants de production.
9. Effectuez un essai final de production avec des exemples de données pour confirmer que tout fonctionne comme prévu.
