Fournisseur intégrateur 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 automatiquement l’administrateur. En tant qu’administrateur, vous pouvez inviter des utilisateurs à se joindre à l’organisation, leur attribuer des projets et des rôles d’utilisateur, et gérer les comptes de facturation.
Pour en savoir plus sur les rôles des utilisateurs, consultez les lignes directrices sur l’administration des organisations.
1. Sélectionnez Créer ou rejoindre une organisation dans la barre de navigation.
2. Veuillez entrer les renseignements suivants :
- Pour Je travaille pour une entreprise qui, sélectionnez Vend ou fournit une solution logicielle qui utilise la technologie de FedEx et souhaite s’inscrire en tant que fournisseur intégrateur validé de FedEx
- Veuillez 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.
- Veuillez entrez une adresse courriel officielle qui inclut le domaine de votre entreprise, le pays ou le territoire où votre entreprise est constituée, ainsi que les pays et territoires où vous vendez ou distribuez votre solution logicielle.
3. Sélectionnez Suivant.
Vous pouvez mettre à jour ou ajouter des détails ultérieurement sous Gérer l’organisation dans le menu.
Ajoutez 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.
Remarque : utilisez votre numéro de compte; il ne peut pas s’agir du numéro de compte FedEx d’un client.
2. Sélectionnez Ajouter un compte de facturation.
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.
Remarque : l’adresse de facturation doit correspondre à celle que vous avez utilisée lors de la configuration du compte. Ce compte devient le compte de facturation par défaut de votre organisation.
4. Choisir une option d’authentification.
- L’appel téléphonique est réservé aux intégrateurs aux États-Unis et au Canada seulement.
5. Veuillez entrez le code d’authentification que vous recevez et sélectionnez Soumettre.
6. Lisez et acceptez le Contrat d’intégrateur FedEx.
Invitez des utilisateurs en tant qu’administrateur
1. Accédez à Gérer l’organisation et sélectionnez l’onglet Utilisateurs .
2. Sélectionnez + Ajouter des utilisateurs.
3. Veuillez entrer les renseignements suivants :
- Le pays ou le territoire
- La langue préférée
4. Sélectionnez un rôle utilisateur (Visualiseur, Contributeur ou Administrateur).
5. (Facultatif) Affectez l’utilisateur à un projet.
- Vous pouvez assigner un utilisateur à tout moment depuis la page Aperçu du projet.
6. Veuillez 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. L’invitation est valable pour 24 heures.
Création d’un projet
1. Accédez à Mes projets dans le menu et sélectionnez + Créer un projet.
2. Entrez un nom de projet.
- Le format de nom recommandé Projectname_applicationname. Sélectionnez Suivant une fois terminé.
3. Sélectionnez les produits API et Visibilité intégrée avancée à inclure dans votre projet.
- Les produits de visibilité intégrée avancée ne sont disponibles que pour les intégrateurs FedEx américains.
- Si vous sélectionnez des produits payants, vous serez invité à attribuer un compte de facturation au projet et à accepter les conditions requises.
Attribution d’un compte de facturation
Remarque : cela est nécessaire seulement si vous sélectionnez un produit payant.
1. Attribuez un compte de facturation à partir de la liste des comptes ajoutés à l’organisation. Les comptes de facturation doivent être établis aux États-Unis.
2. Acceptez l’entente de licence du FedEx Developer Portal et le formulaire de commande, puis sélectionnez Créer.
Configurer la visibilité intégrée avancée dans un projet
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. Veuillez vous recommander au bon de commande pour en savoir plus sur les tarifs.
- 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. Entrez 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électionner Créer.
Remarque : en fonction de votre type d’abonnement choisi, vous pourriez avoir des étapes supplémentaires. Pour plus de détails, consultez notre documentation sur les webhooks.
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.
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. 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.
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 pageValidation des API pour obtenir de l’aide.
Pour déployer vos API en production, elles doivent être validées. Le niveau de validation varie selon l’API. 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. Identifiez les cas de test pour les régions ou territoires où vous prévoyez de déployer votre solution. Pour plus de détails, voir Base 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 les cas de test.
5. Complétez tous les cas de test requis.
6. Remplissez la fiche d’information sur le produit (PIW) avec vos coordonnées et votre choix de services FedEx.
7. Complétez la Page de garde de validation de l’intégrateur.
Soumettre les livrables
Envoyez tous les documents requis à validationmtp@fedex.com.
1. Préparez les documents suivants :
- PIW dûment rempli (PDF)
- Feuille de couverture de validation dûment remplie (PDF)
- Transactions d’inscription du client final avec authentification multifacteur (JSON)
- Étiquettes d’expédition numérisées pour tous les cas d’essai applicables (PDF ou PNG)
- Transactions d’expédition pour trois formats d’étiquettes (PDF, PNG et ZPL [JSON]), pour les API d’expédition et de tarification applicables.
- Captures d’écran (PDF) montrant :
- Solution orientée client qui présente les services FedEx et la manutention spéciale
- Déclaration d’avis de non-responsabilité
- Contrat de licence de l’utilisateur final (EULA)
- Flux d’inscription du client final
2. Compressez tous les fichiers dans un seul fichier.zip. fichier pour éviter les restrictions du fournisseur de courriel.
3. Envoyez le fichier.zip par courriel à l‘équipe de validation.
Meilleures pratiques pour éviter les retards
Suivez ces directives pour réduire le temps de révision :
- 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.
- Pour FedEx International Express🅪, incluez la lettre de transport aérien (LTA) auxiliaire (secondaire).
- Incluez une étiquette pour chaque colis dans les envois multipièces (MPS).
Évaluation des étiquettes
L’équipe de validation examine votre envoi.
- En cas de refus, répondez aux commentaires et soumettez à nouveau les produits à livrer.
- Si elle est approuvée, vous recevrez un courriel de confirmation. Après approbation, vos identifiants de production sont autorisés pour les transactions d’étiquettes d’expédition.
1. Dans le menu, sélectionnez Mes projets, puis le nom du projet.
2. Dans la section APIs , copiez et stockez en toute sécurité votre clé API de production et votre clé secrète.
Remarque : enregistrez votre clé secrète dans un emplacement sécurisé, car elle n’apparaît qu’une seule fois. Si vous la perdez, vous pouvez en générer une nouvelle plus tard.
