Le webhook Advanced Integrated Visibility permet à FedEx d’envoyer en temps quasi réel des données de suivi sécurisées à une URL de destination pour les envois associés à un ou plusieurs numéros de compte FedEx spécifiques.

Vous pouvez créer un projet de webhook Advanced Integrated Visibility dans le FedEx Developer Portal et l’associer avec un ou plusieurs numéros de compte ou numéros de suivi FedEx en fonction du type d’inscription que vous avez sélectionné.

Accéder à :

ABONNEMENT AUX NUMÉROS DE COMPTE ADVANCED INTEGRATED VISIBILITY  ou  Abonnement Aux Numéros De Suivi Advanced Integrated Visibility, pour afficher les étapes pour créer un webhook Advanced Integrated Visibility.

Les clients FedEx peuvent s’inscrire à un numéro de compte ou à un numéro de suivi pour recevoir des notifications sur l’envoi et le transit en temps quasi réel, de la création des étiquettes à la preuve de livraison des colis, ainsi que la preuve de livraison par image.

Types d’inscriptions

Les clients FedEx peuvent s’abonner à Advanced Integrated Visibility via les options suivantes :

• Par numéro de compte : inscrivez-vous au numéro de compte FedEx pour recevoir des mises à jour sur les envois associés au compte.
• Par numéro de suivi : inscrivez-vous au numéro de suivi FedEx pour recevoir des mises à jour sur les envois associés aux numéros de suivi spécifiés via les points de terminaison de l’API.

Si vous vous êtes inscrit au numéro de compte, il est actuellement obligatoire de disposer de comptes d’expédition FedEx à 9 chiffres basés aux États-Unis.

Le tableau ci-dessous vous renseigne sur les fonctionnalités des abonnements aux numéros de compte et aux numéros de suivi Advanced Integrated Visibility.

FedEx Integrated Visibility – Comparaison des fonctionnalités par type d’abonnement

Récapitulatif

Lorsque les clients s’abonnent aux mises à jour de suivi des envois via l’abonnement aux numéros de suivi Advanced Integrated Visibility, et non l’abonnement aux numéros de compte Advanced Integrated Visibility, des champs de données spécifiques sont masqués pour préserver la confidentialité des clients et se conformer aux politiques de sécurité des données.

Ce masquage garantit que les informations sensibles, telles que les coordonnées personnelles, les adresses et les prix, ne sont accessibles qu’aux personnes autorisées. Les clients avec un abonnement aux numéros de suivi Advanced Integrated Visibility verront « XXXXX » pour les champs masqués répertoriés ci-dessous, même si ces données sont accessibles via l’abonnement aux numéros de suivi Advanced Integrated Visibility.

Voici ce que ce masquage entraîne :

• Visibilité limitée des détails d’origine/de destination et des parties impliquées.
• L’absence d’informations d’identification personnelle (par exemple, noms, numéros de téléphone) et de données relatives au prix ou aux douanes.
• La protection des informations d’envoi confidentielles ou sensibles à des fins de sécurité et de conformité réglementaire.

Il est conseillé aux clients ayant besoin d’accéder à ces champs masqués pour des cas d’utilisation opérationnels ou commerciaux de s’abonner en utilisant leur numéro de compte.

Points de données MASQUÉS dans l’abonnement aux numéros de suivi Advanced Integrated Visibility :

Événements de scan

• 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

Informations concernant 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

Informations 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 changement 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

Infos 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 relatives au prix

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

Demande de renseignements et informations concernant les articles

• 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

Informations de facturation

• trackResult/billToParties/[Array]/billToParty/accountNumber

Avantages pour le client :

• Améliorez la confiance du destinataire grâce à des notifications proactives concernant les évolutions de la date de livraison estimée pendant le transit et du créneau de livraison.
• Réduisez les coûts du service clients associé aux appels WISMO (Where Is My Order) ainsi qu’aux litiges de livraison grâce à une preuve de livraison par image FedEx.
• Optimisez l’expérience client en fournissant des notifications en temps quasi réel sur le statut des envois.
• Stimulez l’efficacité opérationnelle grâce à des notifications push en temps réel concernant les envois, plutôt qu’en interrogeant continuellement l’interface pour suivre les mises à jour de chaque envoi.

Événements de suivi

Cette fonctionnalité permet aux clients de suivre proactivement le statut des envois en recevant des notifications sur les différentes mises à jour tout au long du cycle de l’envoi. Les clients ont la possibilité de choisir l’étape exacte du processus ou des événements d’envoi pour lesquels ils souhaitent recevoir une notification ou une alerte. Les événements d’expédition disponibles sont les suivants :

• Expédition : cette option permet de recevoir une notification lorsque l’événement d’expédition sélectionné a lieu. Exemple : création d’une étiquette, enlèvement, etc.
• En transit : cette option permet de recevoir une notification lors des événements de transit de l’envoi. Exemple : en transit, article consigné au bureau de livraison, etc.
• Livraison : cette option permet de notifier les événements relatifs à la livraison de l’envoi. Exemple : en cours de livraison, livré, etc.
• Exceptions : cette option permet de notifier les exceptions de livraison. Exemple : retard lié au dédouanement, etc.
• Options de livraison pratiques : sélectionnez cette option pour recevoir une notification lors de certains événements de suivi personnalisés. Exemple : demande de consignation dans un point de dépôt acceptée.

Pour plus d’informations sur les options disponibles pour les événements de livraison, consultez le tableau des codes de statut et statuts des événements de suivi des projets Advanced Integrated Visibility.

Preuve de livraison

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

• Preuve de livraison par image (PPOD) : permet aux clients de recevoir une photo montrant la localisation exacte de leur colis une fois qu’il a été livré à leur porte.
  Advanced Integrated Visibility fournit les images de la preuve de livraison par image dans la charge utile JSON au format Base64. Les images peuvent ensuite être converties au format JPEG.
  

  Remarque :

  • La preuve de livraison par image est disponible aux États-Unis, au Canada, à Porto Rico, à Hong Kong, en Nouvelle-Zélande, au Royaume-Uni et en Irlande.
  • La preuve de livraison par image n’est disponible que pour les adresses/colis résidentiels, FedEx Ground et FedEx Express.
  • La preuve de livraison par image est disponible pour les livraisons éligibles lorsque la preuve de livraison avec signature n’est pas obligatoire. La preuve de livraison par image et la preuve de livraison avec signature ne sont pas cumulables.
  • La preuve de livraison par image est disponible pour les livraisons sans aucune signature requise (NSR) qui ne sont pas remises directement à un client (par exemple, remises directement à un client lors de la livraison).
  • La preuve de livraison par image prend en charge les tailles d’image de 14 000 à 33 000 octets (applicable à la résolution d’image de 320 x 240).

   

• Preuve de tentative de livraison par photo (PPODA) : la PPODA permet aux clients de recevoir une photo de l’emplacement exact où le colis doit être livré, dans le cas où la livraison ne pourrait pas être effectuée. Advanced Integrated Visibility fournit les images de la preuve de livraison par image dans la charge utile JSON au format Base64. Les images peuvent ensuite être converties au format JPEG.
  • La preuve de tentative de livraison par image est disponible aux États-Unis et à Puerto Rico.
  • La preuve de tentative de livraison par image n’est disponible que pour les adresses/colis résidentiels, commerciaux, FedEx Ground et FedEx Express.
  • La preuve de tentative de livraison par image peut être :
  1. La preuve de tentative de livraison par image d’un avis de passage sur une porte.
  2. La photo d’obstruction au point de livraison (ex : portail fermé à clé).
  3. La preuve de livraison par image de colis livrés lors de l’étape.
  • La preuve de tentative de livraison par image prend en charge les tailles d’image de 14 000 à 33 000 octets (applicable à la résolution de 320 x 240).

 

• Preuve de livraison avec signature (PDLS) : permet aux clients de recevoir une image de la signature du destinataire, ainsi que son nom, la date, l’heure et le lieu de livraison. La preuve de livraison avec signature sera présentée sous forme de 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.
  • La preuve de livraison avec signature (PDLS) n’est pas disponible pour l’abonnement aux numéros de suivi Advanced Integrated Visibility.
  • La PDLS prend en charge les tailles d’image de 4 000 à 6 000 octets (applicable à la résolution d’image de 400 x 95).
  • La PDLS prend en charge les tailles d’image de 5 000 à 8 000 octets (applicable à la résolution d’image de 230 x 150).

 

• Preuve de livraison GPS (GPSPOD) :
  • La preuve de livraison GPS permet aux clients de recevoir les coordonnées géographiques du lieu de livraison.
    

    Remarque : la preuve de livraison GPS (GPSPOD) est disponible par défaut pour l’abonnement aux numéros de compte Advanced Integrated Visibility.

Événements de date de livraison et de créneau de livraison estimés

Cette fonctionnalité aide les destinataires des envois à organiser leur planning en indiquant une date ou une plage horaire pour les livraisons d’envois. Cela comprend :

• Date de livraison estimée (EDD) : cette option permet d’estimer la date de livraison de l’envoi au destinataire. Exemple : 20 nov 20XX.
• Date de créneau de livraison estimée (EDTW) : cette option permet au destinataire d’obtenir une estimation de l’heure de livraison de l’envoi le jour de sa livraison effective. Exemple : entre 14 h et 18 h.

Filtrage basé sur les événements

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

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

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

Politique concernant les nouvelles tentatives

Cette fonctionnalité empêche FedEx d’envoyer des données de suivi en cas d’incident côté client. FedEx conservera les données et tentera de les envoyer à nouveau à 3 reprises par intervalles de 5 minutes.

Si aucune réponse positive n’est reçue dans le délai défini, FedEx mettra fin à la livraison de l’événement en question. Néanmoins, le client peut demander à récupérer les événements manqués au cours des 7 derniers jours via le bouton « RÉESSAYER » figurant sur la page des détails du projet de webhook Advanced Integrated Visibility.

Pour plus d’informations sur les politiques en matière de nouvelles tentatives, reportez-vous à la section Mécanisme de nouvelle tentative.