Fournisseur d’intégrateur FedEx
Prérequis
Vous devez posséder un ID d’utilisateur FedEx pour vous connecter au 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.
Rejoindre 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 avec votre ID d’utilisateur et votre mot de passe. Si votre ID d’utilisateur est lié à une autre organisation, créez-en un nouveau.
Créer une organisation
Lorsque vous créez une organisation, vous en devenez l’administrateur. En tant qu’administrateur, vous pouvez inviter des utilisateurs à rejoindre l’organisation, leur attribuer des projets et des rôles utilisateur, et gérer les comptes de facturation.
Pour en savoir plus sur les rôles utilisateur, consultez les conseils sur l’administration des organisations.
1. Sélectionnez Créer ou rejoindre une organisation dans la barre de navigation.
2. Saisissez les informations suivantes :
- Pour Je travaille pour une entreprise qui, sélectionnez Vend ou propose une solution logicielle qui utilise la technologie FedEx et souhaite s’inscrire comme un fournisseur FedEx Intégrateur validé.
- Saisissez le nom de votre entreprise, son site Web ainsi qu’un nom d’organisation que votre équipe reconnaîtra, comme le nom de votre société, d’un service, d’une division ou d’une région.
- Saisissez une adresse e-mail officielle comprenant le domaine de votre entreprise, le pays ou territoire où votre entreprise est constituée, ainsi que les pays et territoires où vous vendez ou distribuez votre solution logicielle.
3. Cliquez sur Suivant.
Vous pourrez mettre à jour ou ajouter des détails plus tard via l’onglet Gérer l’organisation dans le menu.
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 ou contactez l’assistance FedEx.
Remarque : utilisez votre numéro de compte. Cela ne peut pas être le numéro de compte FedEx d’un client.
2. Sélectionnez Ajouter un compte de facturation.
3. Saisissez votre numéro de compte FedEx, l’alias du compte et l’adresse de facturation située aux États-Unis associée au compte.
Remarque : l’adresse de facturation doit correspondre à l’adresse utilisée lors de la création du compte. Ce compte devient le compte de facturation par défaut de votre organisation.
4. Choisissez une option d’authentification.
- L’appel téléphonique est réservé aux intégrateurs des États-Unis et du Canada.
5. Saisissez le code d’authentification que vous avez reçu et sélectionnez Envoyer.
6. Lisez et acceptez le Contrat d’intégrateur FedEx.
Inviter des utilisateurs en tant qu’administrateurs
1. Dans Gérer l’organisation, sélectionnez l’onglet Utilisateurs.
2. Sélectionnez + Ajouter des utilisateurs.
3. Saisissez les informations suivantes :
- Le pays et le territoire ;
- La langue souhaitée.
4. Sélectionnez un rôle utilisateur (lecteur, contributeur ou administrateur).
5. (Facultatif) Attribuez l’utilisateur à un projet.
- Vous pouvez attribuer un utilisateur à tout moment depuis la page Aperçu du projet.
6. Saisissez les adresses e-mail des utilisateurs et cliquez sur Inviter.
- Vous pouvez inviter jusqu’à 20 utilisateurs à la fois, en séparant chaque adresse e-mail par une virgule. L’invitation est valide 24 heures.
Créer un projet
1. Dans Mes projets, sélectionnez + Créer un projet.
2. Saisissez un Nom de projet.
- Le format de nom recommandé est Nomduprojet_nomdelapplication. Sélectionnez Suivant lorsque vous avez terminé.
3. Sélectionnez les produits API et Advanced Integrated Visibility à inclure dans votre projet.
- Les produits Advanced Integrated Visibility ne sont disponibles que pour les fournisseurs Intégrateur FedEx aux États-Unis.
- Si vous sélectionnez des produits payants, il vous sera demandé d’attribuer un compte de facturation au projet et d’accepter les conditions requises.
Attribuer un compte de facturation
Remarque : cette étape n’est requise que si vous sélectionnez un produit payant.
1. Attribuez un compte de facturation depuis la liste des comptes ajoutés à l’organisation. Les comptes de facturation doivent être basés aux États-Unis.
2. Acceptez le Contrat de licence du FedEx Developer Portal ainsi que le formulaire de commande et cliquez sur Créer.
Configurer Advanced Integrated Visibility dans un projet
Conditions préalables
- Tarification : les abonnés sont facturés mensuellement en fonction du nombre de numéros de suivi. Consultez le formulaire de commande pour en savoir plus sur nos tarifs.
- Configurer des comptes : le webhook Shipment Visibility nécessite un compte de facturation basé aux États-Unis et au moins un compte d’expédition, ces deux types de comptes étant mutuellement exclusifs. Seuls les administrateurs peuvent ajouter des comptes 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 :
- Utiliser le protocole HTTPS ;
- Exclure l’espace d’adressage IP RFC1918, le domaine fedex.com et ses sous-domaines, ainsi que les adresses IP de type localhost ou 127.0.0.1.
2. Générez un jeton de sécurité pour vous authentifier. Le jeton doit :
- Contenir entre 26 et 100 caractères, au moins une lettre majuscule, une lettre minuscule et un chiffre.
3. Dans le menu, cliquez sur Mes projets, puis sélectionnez l’onglet Advanced Integrated Visibility.
4. Sélectionnez Créer un projet Advanced Integrated Visibility.
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 FedEx Compatible : est un fournisseur FedEx Compatible
- Fournisseur Intégrateur FedEx : vend ou propose une solution logicielle basée sur une technologie FedEx, et est un Fournisseur FedEx Intégrateur validé.
6. Sélectionnez le type d’abonnement. Vous pouvez vous abonner aux événements via les numéros de compte ou les numéros de suivi.
7. Confirmez le compte de facturation et sélectionnez les fonctionnalités désirées, telles que la preuve de livraison, la livraison estimée, les événements de suivi ou le filtrage basé sur les événements.
8. Saisissez les informations de projet.
- Saisissez un nom de projet unique et reconnaissable.
- Saisissez l’URL de destination et le jeton de sécurité que vous avez créés.
- Saisissez une adresse e-mail et une langue de préférence pour recevoir les notifications concernant les mises à jour et les interruptions de service d’Advanced Integrated Visibility.
9. Acceptez le Contrat de licence du FedEx Developer Portal ainsi que le formulaire de commande et cliquez sur Créer.
Remarque : selon le type d’abonnement choisi, des étapes supplémentaires peuvent être nécessaires. Pour plus d’informations, voir la documentation du webhook.
Suivez ces étapes pour vérifier votre intégration API et confirmer que votre application peut envoyer et recevoir des données de test.
1. Dans le menu, cliquez sur Mes projets, puis sélectionnez l’onglet Nom du projet.
2. Dans l’onglet Clés API, sous Clé de test, trouvez vos identifiants de test.
3. Connectez-vous et téléchargez la collection d’API JSON via le bouton Télécharger le schéma JSON situé en haut de la page de documentation. Examinez les 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. Le jeton est valide pendant une heure. Vous pouvez configurer votre application pour le renouveler avant son expiration. Pour plus d’informations, consultez la documentation sur l’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 requêtes d’exemple en utilisant vos identifiants de test et l’URL de test de FedEx, puis confirmez que les réponses correspondent aux exemples de la documentation. Pour plus de détails, consultez le Guide de virtualisation Sandbox.
8. Effectuez des tests avec Advanced Integrated Visibility pour générer des données d’exemple et confirmer que votre application traite correctement les informations de suivi.
Remarque : ce test ne permet pas d’authentifier votre adresse URL de rappel. Pour plus d’informations, consultez la documentation d’Advanced Integrated Visibility.
Les étapes de validation varient selon la région
Ces étapes s’appliquent uniquement aux clients situés aux États-Unis et au Canada. Si vous résidez en dehors de ces pays, veuillez consulter la page de validation de l’API pour trouver de l’aide.
Pour passer vos API en production, ils doivent être validés. Le niveau de validation varie selon l’API. Consultez les exigences de validation de l’API avant de commencer.
1. Dans le menu, cliquez sur Mes projets, puis sélectionnez l’onglet Nom du projet.
2. Dans l’onglet Clés API, sous Clé de test, recherchez vos identifiants de test.
3. Identifiez les cas de test pour les régions ou les territoires où vous prévoyez de déployer votre solution. Pour plus d’informations, consultez la base de référence des cas de test de l’Intégrateur.
4. Effectuez les transactions d’enregistrement en utilisant les numéros de compte de test fournis avant d’exécuter vos cas de test.
5. Complétez tous les cas de test requis.
6. Remplissez la fiche d’information produit (FIP) avec vos coordonnées et votre choix de services FedEx.
7. Remplissez la page de garde de validation de l’Intégrateur.
Soumettre des livrables
Envoyez toutes les ressources requises à validationmtp@fedex.com.
1. Préparez les livrables suivants :
- FIP remplie (PDF)
- Page de garde de validation remplie (PDF)
- Transactions d’enregistrement du client final avec authentification multifacteur (JSON)
- Étiquettes d’expédition numérisées pour tous les cas de test applicables (PDF ou PNG)
- Transactions d’expédition pour trois formats d’étiquettes (PDF, PNG et ZPL [JSON]) pour les API Shipping et Rating applicables
- Captures d’écran (PDF) montrant :
- Solution client affichant les services FedEx et la manutention spéciale
- Clause de non-responsabilité
- Contrat de licence de l’utilisateur final (CLUF)
- Parcours d’enregistrement du client final
2. Compressez tous les fichiers dans un seul fichier .zip afin d’éviter les restrictions imposées par les fournisseurs d’adresse e-mail.
3. Envoyez le fichier .zip par e-mail à l’équipe de validation.
Bonnes pratiques pour éviter les retards
Suivez ces directives pour réduire le temps de révision :
- Imprimez et scannez les étiquettes à une résolution minimum de 600 DPI. Ne soumettez pas de fichiers générés directement par les API.
- Pour les imprimantes thermiques, demandez le type d’image qui correspond à votre imprimante, par exemple ZPLII pour les imprimantes Zebra.
- Pour FedEx International Express®, incluez le bordereau d’expédition auxiliaire/secondaire.
- Incluez une étiquette pour chaque colis dans les envois multicolis (MPS).
Évaluation des étiquettes
L’équipe de validation examine votre demande.
- En cas de rejet, tenez compte des remarques et soumettez à nouveau les documents requis.
- Si elle est approuvée, vous recevrez un e-mail confirmant la validation. Après approbation, vos identifiants de production sont autorisés pour les transactions d’étiquettes d’expédition.
1. Dans le menu, cliquez sur Mes projets, puis sélectionnez l’onglet Nom du projet.
2. Dans la section API, copiez et stockez votre clé API de production et votre clé secrète de manière sécurisée.
Remarque : enregistrez votre clé secrète dans un emplacement sécurisé, car elle ne s’affiche qu’une seule fois. Si vous la perdez, vous pourrez en générer une nouvelle ultérieurement.
