CRÉER UN
WEBHOOK GÉRER LES WEBHOOKS

Types de Webhooks à visibilité intégrée avancée

Le Webhook de visibilité intégrée avancée permet à FedEx de transmettre, en quasi temps réel, des données de suivi sécurisées vers une URL de destination pour les envois associés à un ou plusieurs numéros de compte FedEx.

Vous pouvez créer un projet de visibilité intégrée avancée sur le portail des développeurs FedEx, puis l’associer à un ou plusieurs numéros de compte FedEx ou numéros de suivi FedEx, selon le type d’abonnement choisi.

Accédez à :

ABONNEMENT AU NUMÉRO DE COMPTE DE VISIBILITÉ INTÉGRÉE AVANCÉE ou ABONNEMENT AU NUMÉRO DE SUIVI DE VISIBILITÉ INTÉGRÉE AVANCÉE, pour consulter les étapes permettant de créer le webhook de visibilité intégrée avancée.

Aperçu de la visibilité intégrée avancée de FedEx

Les clients de FedEx peuvent s’abonner à un numéro de compte ou à un numéro de suivi pour recevoir, en temps quasi réel, les envois en transit, de la création de l’étiquette jusqu’à la preuve de livraison des colis, y compris la preuve de livraison avec photo.

Types d‘abonnement

Les clients de FedEx peuvent s’abonner à la visibilité intégrée avancée par les options suivantes :

Par numéro de compte – Abonnez-vous au numéro de compte FedEx pour recevoir des mises à jour pour les envois correspondant au compte.
Par numéro de suivi – Abonnez-vous au numéro de suivi FedEx pour recevoir des mises à jour pour les envois correspondant aux numéros de suivi spécifiés via les points de terminaison API.

Remarque : les abonnements nécessitent actuellement un numéro de compte FedEx à neuf chiffres basé aux États-Unis pour la facturation et les clients doivent payer une redevance mensuelle basée sur le nombre de numéros de suivi. Pour en savoir plus sur les tarifs de la visibilité intégrée avancée, consultez le Guide des tarifs — Aperçu de la visibilité intégrée avancée.

Si l’abonnement est fait par numéro de compte, il doit actuellement être associé à un compte d’expédition FedEx de 9 chiffres basé aux États-Unis.

Le tableau ci-dessous présente les fonctionnalités de l’abonnement par numéro de compte et de l'abonnement à la visibilité intégrée avancée par numéro de suivi.

Caractéristiques	Abonnement au numéro de compte	Abonnement au numéro de suivi
Réponse	Données sécurisées = Données personnelles identifiables (PII), données de l’expéditeur et du destinataire, preuve de livraison avec signature (SPOD), options de livraison pratique (CDO)/réponse	Données anonymes = Comprennent les renseignements sur l’envoi et les mises à jour en transit, excluant les données personnelles identifiables (PII)/réponse
Association	Association par numéro de compte = Associe tous les numéros de suivi liés en une seule fois	Association des numéros de suivi
Propriété	Les numéros de compte doivent être détenus par l‘utilisateur lui-même.	Les numéros de suivi n‘ont pas besoin d‘être détenus par l‘utilisateur.
Filtrage	Possibilité de filtrer les événements par envois entrants, sortants ou de tiers	Impossible de filtrer les événements
Intégration	L‘association des numéros de compte se fait via l‘interface utilisateur (UI).	L‘association des numéros de suivi se fait via le point de terminaison API.
Limites	Il est possible d‘ajouter jusqu‘à 100 numéros de compte.	Il est possible d‘ajouter jusqu‘à 1 000 numéros de suivi par demande.
Cas d‘utilisation approprié	Clients de première partie – Si le client possède les numéros de compte.	Clients de troisième partie – Si le client possède des numéros de suivi appartenant à des clients de première partie.

Comparaison des fonctionnalités de la visibilité intégrée FedEx selon le type d’abonnement

Fonctionnalité/Élément de données	Abonnement au numéro de suivi	Abonnement au numéro de compte	Notes
SPOD (preuve de livraison avec signature)	Non disponible	Disponible (configuration requise)	Image de la signature au format TIFF, transmise dans les données utiles
PPOD (preuve de livraison par photo)	Disponible (configuration requise)	Disponible (configuration requise)	Image JPEG du lieu de livraison, encodée en base64
PPODA (preuve de tentative de livraison par photo)	Disponible (configuration requise)	Disponible (configuration requise)	En cas de tentative de livraison, une image JPEG est fournie
Coordonnées GPS (gpsPodCoordinates)	Non disponible	Disponibles	Masqué dans les abonnements basés sur le suivi
Infos de contact (nom, téléphone, entreprise)	Masqué	Disponibles	Pour l’expéditeur, le destinataire, l’origine, la destination, le courtier, etc.
Adresse de rue et code postal	Masqué	Disponibles	les champs streetLines et postalCode sont masqués dans les données utiles des abonnements basés sur le suivi
Numéros de comptes	Masqué	Disponibles	Inclut les valeurs des comptes du payeur, de l’expéditeur et du destinataire
Données financières du colis (p. ex. : declaredValue, codAmount)	Masqué	Disponibles	Les valeurs relatives aux douanes, au contre remboursement (COD) et à la valeur déclarée sont masquées
Détails des demandes et des retours (codes de demande, motifs de retour)	Masqué	Disponibles	Les détails complets sont uniquement visibles pour les abonnés par numéro de compte
Données sur les marchandises et le contenu	Masqué	Disponibles	Incluent les codes d’article, descriptions, quantités
Identifiant employé (p. ex. : personnel associé à l’événement)	Masqué	Non disponible	Masqué dans les deux cas pour des raisons de confidentialité
Notifications d’événement et EDD/EDTW	Disponibles	Disponibles	Les fonctionnalités de date/heure de livraison prévue sont prises en charge dans les deux types d’abonnement.
Envoi multicolis (MPS)	Disponibles	Disponibles	Avec informations de suivi supplémentaires
Fiabilité de la livraison prévue et scores de risque	Disponibles	Disponibles	Offert uniquement dans le niveau Premium

Champs de données masqués pour l’abonnement à la visibilité intégrée avancée par numéro de suivi

Récapitulatif

Lorsque les clients s’abonnent aux mises à jour de suivi d’envoi via l’abonnement à la visibilité intégrée avancée par numéro de suivi plutôt que par l’abonnement par numéro de compte, certains champs de données sont masqués afin de protéger la vie privée des clients et de respecter les politiques de sécurité des données.

Ce masquage garantit que les informations sensibles — telles que les coordonnées personnelles, les adresses et les données financières — ne sont accessibles qu’aux parties autorisées. Les clients utilisant l’abonnement à la visibilité intégrée avancée par numéro de suivi verront « XXXXX » pour les champs masqués ci-dessous, même si ces données peuvent être disponibles via l’abonnement à la visibilité intégrée avancée par numéro de compte.

Les conséquences de ce masquage incluent :

Une visibilité limitée sur les détails d’origine/de destination et les parties impliquées.
L’absence d’identifiants personnels (p. ex. : noms, numéros de téléphone) ainsi que de données financières ou liées aux douanes.
Conçu pour protéger les informations d’envoi sensibles ou confidentielles afin d’assurer la sécurité et la conformité réglementaire.

Les clients ayant besoin d’accéder à ces champs masqués pour des raisons opérationnelles ou commerciales sont invités à s’abonner à l’aide de leur numéro de compte.

Points de données MASQUÉS dans l’abonnement à la visibilité intégrée avancée par numéro de suivi :

Balayer les événements

scanEvent/location/locationContactAndAddress/address/streetLines
scanEvent/location/locationContactAndAddress/contact/phoneNumber
scanEvent/location/locationContactAndAddress/contact/companyName
scanEvent/location/locationContactAndAddress/contact/personName
scanEvent/previousEvents/[Array]/location/locationContactAndAddress/address/streetLines
scanEvent/previousEvents/[Array]/location/locationContactAndAddress/contact/phoneNumber
scanEvent/previousEvents/[Array]/location/locationContactAndAddress/contact/companyName
scanEvent/previousEvents/[Array]/location/locationContactAndAddress/contact/personName

Renseignements sur l’expéditeur

trackResult/shipperInfo/contactAndAddress/address/postalCode
trackResult/shipperInfo/contactAndAddress/address/streetLines
trackResult/shipperInfo/contactAndAddress/contact/phoneNumber
trackResult/shipperInfo/contactAndAddress/contact/companyName
trackResult/shipperInfo/contactAndAddress/contact/personName
trackResult/shipperInfo/account/value

Renseignements sur le destinataire

trackResult/recipientInfo/contactAndAddress/address/postalCode
trackResult/recipientInfo/contactAndAddress/address/streetLines
trackResult/recipientInfo/account/value
trackResult/recipientInfo/contactAndAddress/contact/phoneNumber
trackResult/recipientInfo/contactAndAddress/contact/companyName
trackResultecipientInfo/contactAndAddress/contact/personName

Lieu d’origine et de destination

trackResult/originLocation/locationDetail/locationContactAndAddress/contact/personName
trackResult/originLocation/locationDetail/locationContactAndAddress/contact/phoneNumber
trackResult/originLocation/locationDetail/locationContactAndAddress/contact/companyName
trackResult/originLocation/locationDetail/locationContactAndAddress/address/streetLines
trackResult/originLocation/locationDetail/locationContactAndAddress/address/postalCode
trackResult/destinationLocation/locationDetail/locationContactAndAddress/contact/personName
trackResult/destinationLocation/locationDetail/locationContactAndAddress/contact/phoneNumber
trackResult/destinationLocation/locationDetail/locationContactAndAddress/contact/companyName
trackResult/destinationLocation/locationDetail/locationContactAndAddress/address/streetLines
trackResult/destinationLocation/locationDetail/locationContactAndAddress/address/postalCode

Détails de livraison et de modification d’adresse

trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/address/streetLines
trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/address/postalCode
trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/address/gpsPodCoordinates
trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/contact/personName
trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/contact/phoneNumber
trackResult/actualDeliveryAddress/locationDetail/locationContactAndAddress/contact/companyName
trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/address/streetLines
trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/address/postalCode
trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/contact/personName
trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/contact/phoneNumber
trackResult/addressChangeRequested/locationDetail/locationContactAndAddress/contact/companyName

Renseignements sur le courtier

trackResult/broker/locationDetail/locationContactAndAddress/contact/phoneNumber
trackResult/broker/locationDetail/locationContactAndAddress/contact/companyName
trackResult/broker/locationDetail/locationContactAndAddress/contact/personName
trackResult/broker/locationDetail/locationContactAndAddress/address/streetLines
trackResult/broker/locationDetail/locationContactAndAddress/address/postalCode

Détails du colis et informations financières

trackResult/packageDetail/customsValue/value
trackResult/packageDetail/declaredValue/value
trackResult/packageDetail/originalTransportationCharge/value
trackResult/codDetail/codAmount/value

Informations sur les demandes et les marchandises

trackResult/inquiries/[Array]/categoryCode
trackResult/inquiries/[Array]/code
trackResult/inquiries/[Array]/createTime
trackResult/inquiries/[Array]/statusCode
trackResult/commodityInfo/[Array]/description
trackResult/commodityInfo/[Array]/code

Contenu du colis et motif de retour

trackResult/contents/[Array]/partNumber
trackResult/contents/[Array]/partCode
trackResult/contents/[Array]/description
trackResult/contents/[Array]/quantity
trackResult/returnReason/[Array]/code
trackResult/returnReason/[Array]/description

Renseignements sur la facturation

trackResult/billToParties/[Array]/billToParty/accountNumber

Les avantages pour les consommateurs :

Augmentation de la confiance des destinataires grâce à des notifications proactives en cas de modification en cours de route de la date de livraison prévue et du jour de l’intervalle de temps de livraison.
Réduction des coûts de service à la clientèle pour les appels WISMO (Où est ma commande) ainsi que pour les contestations de livraison en fournissant à une preuve de livraison de FedEx au format image.
Amélioration de l’expérience de la clientèle grâce à des notifications en temps quasi réel sur l’état de l'envoi.
Gain d‘efficacité opérationnelle grâce à la réception de mises à jour en temps réel sur les envois, au lieu d‘une interrogation permanente pour vérifier les mises à jour du suivi de chaque envoi.

Fonctionnalités et événements de suivi

Événements de suivi

Cette fonctionnalité permet de suivre l‘état des envois et de notifier proactivement les clients des différentes mises à jour tout au long du cycle de vie de l‘envoi. Elle permet aux clients de choisir l’étape exacte du processus d’envoi ou des événements pour lesquels ils souhaitent recevoir un avis ou une alerte. Les événements d’envoi disponibles sont les suivants :

Envoi : cette option fournit un avis lorsque l’événement d’envoi sélectionné se produit. Par exemple : étiquette créée, ramassage, etc.
En transit : cette option fournit un avis pour les événements de transit de l’envoi. Exemple : en transit, article retenu au bureau de livraison, etc.
Livraison : cette option fournit un avis pour les événements de livraison de l’envoi. Par exemple : livraison en cours, livré, etc.
Exceptions : cette option fournit un avis pour les exceptions de livraison. Par exemple : retards de dédouanement, etc.
Options de livraison personnalisées : sélectionnez cette option pour recevoir un avis pour certains événements de suivi personnalisés. Par exemple : demande de retenue à un centre accepté, etc.

Pour plus d’information sur les options d’événements d’expédition disponibles, consultez le tableau Codes et statuts pour les événements de suivi avec la visibilité intégrée avancée .

Preuve de livraison

Cette fonction confirme qu’une commande est bien arrivée à la destination prévue. Cela comprend :

Preuve de livraison avec image (PPOD) : la PPOD permet aux clients de recevoir une image de l’emplacement exact de leur colis, une fois qu’il a été livré à leur porte.
La solution de visibilité intégrée avancée fournit les images PPOD dans les données utiles JSON, au format Base64. Les images peuvent ensuite être converties au format JPEG.

Note :
Preuve de livraison avec image (PPODA) : la PPODA permet aux clients de recevoir une photo de l’endroit précis où le colis devait être livré, dans le cas où la livraison ne peut être complétée. La solution de visibilité intégrée avancée fournit les images PPODA dans les données utiles JSON, au format Base64. Les images peuvent ensuite être converties au format JPEG.

Preuve de livraison avec signature (SPOD) : la SPOD permet aux clients de recevoir une image de la signature du destinataire ainsi que son nom, la date, l’heure et l’emplacement de livraison. Les renseignements relatifs à la preuve de livraison avec signature seront présentés sous la forme d’un tableau d’octets au lieu d’une image. Le tableau d’octets est une chaîne codée en base64, qui doit être décodée pour obtenir l’image finale de la signature au format PNG.

Preuve de livraison par GPS (GPSPOD):
- Le GPS POD permet aux clients de recevoir les coordonnées géographiques du lieu de livraison.
  
  Remarque : le GPSPOD est offert par défaut avec l’abonnement à la visibilité intégrée avancée par numéro de compte.

Événements de la date de livraison prévue et de l‘intervalle de temps de livraison

Cette fonction aide les destinataires des envois à planifier leur emploi du temps en indiquant une date ou une plage horaire pour les livraisons des envois. Cela comprend :

Date de livraison prévue (EDD) : cette option fournit une date de livraison prévue de l’envoi au destinataire. Exemple : 20 novembre 20XX.
Plage de livraison prévue (EDTW) : cette option fournit au destinataire un intervalle de temps estimé pour la livraison de l’envoi le jour même de la livraison. Par exemple : 14 h à 18 h.

Filtration sur la base des événements

Cette fonction permet aux clients d’organiser leurs projets de webhook en fonction des méthodes de facturation des envois. Les options sont les suivantes :

Entrant : Sélectionnez cette option pour les envois qui vous seront livrés et qui seront payés par vous en tant que destinataire.
Sortant : Sélectionnez cette option pour les envois qui seront expédiés par vous et payés par vous en tant qu’expéditeur.
Tiers : Sélectionnez cette option pour les envois entrants et sortants qui vous sont facturés en tant que tiers payeur.

Remarque : votre numéro de compte FedEx sera utilisé pour facturer ou payer les envois. Dans le cas d’un tiers payeur, les frais seront facturés à votre numéro de compte FedEx, même si vous n’êtes ni l’expéditeur ni le destinataire.

Politique relative aux nouvelles tentatives

Cette fonction empêche FedEx d’envoyer des données de suivi en cas de problème du côté du client. FedEx retiendra les données et tentera de les renvoyer dans un délai de trois tentatives, avec des intervalles de cinq minutes entre chaque tentative.

Si FedEx ne reçoit pas de réponse positive dans le délai défini, FedEx interrompra la nouvelle livraison de l’événement en question. Cependant, le client peut demander les événements manqués des sept (7) derniers jours à l’aide du bouton manuel « RÉESSAYER » sur la page Détails du projet de visibilité intégrée avancée webhook.

Pour en savoir plus sur les politiques de nouvelle tentative, consultez la section Mécanisme de nouvelle tentative.

Request
Response

Response

Copy

CRÉER UN WEBHOOK GÉRER LES WEBHOOKS