FedEx Dataworks (préversion)
FedEx Corp. fournit aux clients et aux entreprises du monde entier un vaste portefeuille de services de transport, de commerce électronique et d’affaires. Connectez-vous à l’API Transport Selection Service pour recevoir des recommandations de classement et de service sur les plans de transport.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | Classe | Régions |
|---|---|---|
| Applications logiques | Norme | Toutes les régions Logic Apps , à l’exception des suivantes : - Régions Azure Government - régions de chine Azure - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Nom | Microsoft Dynamics |
| URL | https://aka.ms/iomsupport |
| Courrier électronique | iomdri@microsoft.com |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Microsoft |
| Website | https://www.fedex.com/ |
| Politique de confidentialité | https://www.fedex.com/en-us/trust-center.html |
| Catégories | Commerce; Gestion de l’entreprise |
Le connecteur FedEx Dataworks a été spécifiquement développé pour être utilisé pour l’intégration du fournisseur de Dynamics 365 Intelligent Order Management.
Prerequisites
Contactez FedEx pour le processus d’intégration.
Remarque : il est recommandé d’utiliser ce connecteur spécifiquement pour configurer le fournisseur FedEx Dynamics 365 Intelligent Order Management.
Comment obtenir des informations d’identification
- Dans le cadre du processus d’intégration, chaque marque doit générer une paire de clés PGP afin que l’équipe de développement Dataworks puisse chiffrer ses informations d’identification d’ID Microsoft Entra. La clé publique doit être envoyée à l’équipe de développement Dataworks pour effectuer le chiffrement.
- La paire de clés PGP peut être générée à l’aide de GnuPG. Il peut être téléchargé à partir du lien donné : https://gpg4win.org/get-gpg4win.html
- Une fois la clé secrète client approvisionnée par l’équipe de développement Dataworks, la clé est envoyée à la marque. Une fois que la marque est en possession de la clé, elle peut être déchiffrée.
- Des détails supplémentaires seront partagés dans le cadre du processus d’intégration.
Prise en main de votre connecteur
Suivez https://docs.microsoft.com/en-us/dynamics365/intelligent-order-management/work-providers#set-up-a-provider pour activer le fournisseur FedEx avec les informations d’identification du client.
Problèmes connus et limitations
Ce connecteur a été spécifiquement développé pour être utilisé pour l’intégration du fournisseur FedEx de Dynamics 365 Intelligent Order Management. La prise en charge des cas d’usage en dehors de Dynamics 365 Intelligent Order Management sera limitée.
Création d’une connexion
Le connecteur prend en charge les types d’authentification suivants :
| Par défaut | Paramètres de création de connexion. | Toutes les régions | Non partageable |
Faire défaut
Applicable : Toutes les régions
Paramètres de création de connexion.
Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.
| Nom | Type | Description | Obligatoire |
|---|---|---|---|
| ID du client | ficelle | FedEx Dataworks Client ID | Vrai |
| Clé secrète client | securestring | FedEx Dataworks Client Secret | Vrai |
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 100 | 60 secondes |
| Fréquence des sondages déclencheurs | 1 | 15 secondes |
Actions
| Abonnement Webhook pour une entreprise donnée par événement |
Abonnement Webhook pour une entreprise donnée par événement. |
| Obtenir des estimations de remise prédictive |
Obtenir des estimations de remise prédictive. |
| Obtenir des informations sur la liste des abonnements Webhook pour une entreprise donnée |
Obtenez des informations sur la liste des abonnements Webhook pour une entreprise donnée. |
| Obtenir des informations sur la liste des inscriptions webhook par événement pour une entreprise donnée |
Obtenez des informations sur la liste des inscriptions de Webhook par événement pour une entreprise donnée. |
| Obtenir les scores du plan de transport |
Obtenez les scores du plan de transport. |
| Supprimer l’abonnement Webhook pour une entreprise donnée par événement |
Supprimez l’abonnement Webhook pour une entreprise donnée par événement. |
| Supprimer l’inscription de Webhook pour une entreprise donnée par événement |
Supprimez l’inscription webhook pour une entreprise donnée par événement. |
| Valider la signature de notification webhook HMACSHA256 |
Valider la notification webhook HMACSHA256 signature. |
Abonnement Webhook pour une entreprise donnée par événement
Abonnement Webhook pour une entreprise donnée par événement.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
événement
|
event | True | string |
Type d’événement : EDD_CHANGED ou EDTW_CHANGED. |
|
registrationId
|
registrationId | True | string |
WebhookId généré lors de l’inscription pour le webhook. |
|
callbackUrl
|
callbackUrl | string |
URL de rappel du client utilisée pour envoyer des mises à jour si elles choisissent de remplacer celles utilisées dans l’inscription. |
|
|
clé
|
key | True | string |
Méthodes autorisées pour qu’une entreprise puisse suivre ses informations- trackingNumber. |
|
values
|
values | True | array of string |
Suivi des ID intéressés par la réception des mises à jour d’état. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Réussi
|
successful | boolean |
Vrai ou faux. |
|
code d'erreur
|
errorCode | string |
Code d’erreur. |
|
errorMessage
|
errorMessage | string |
Message d'erreur. |
|
subscriptionId
|
subscriptionId | array of string |
Liste des ID d’abonnement insérés. |
Obtenir des estimations de remise prédictive
Obtenir des estimations de remise prédictive.
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
originofpackage
|
responsebody.originofpackage | string |
Origine du package |
|
destinationofpackage
|
responsebody.destinationofpackage | string |
Destination du package |
|
datetimeofpossession
|
responsebody.datetimeofpossession | string |
Date de possession |
|
Edds
|
responsebody.edds | array of object |
Edds |
|
requestid
|
responsebody.metadata.requestid | string |
Requestid |
|
shipperId
|
responsebody.metadata.shipperId | string |
ShipperId |
Obtenir des informations sur la liste des abonnements Webhook pour une entreprise donnée
Obtenez des informations sur la liste des abonnements Webhook pour une entreprise donnée.
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Réussi
|
successful | boolean |
Vrai ou faux. |
|
code d'erreur
|
errorCode | string |
Code d’erreur. |
|
errorMessage
|
errorMessage | string |
Message d'erreur. |
|
subscriptionId
|
subscriptionId | array of string |
Liste des ID d’abonnement récupérés. |
Obtenir des informations sur la liste des inscriptions webhook par événement pour une entreprise donnée
Obtenez des informations sur la liste des inscriptions de Webhook par événement pour une entreprise donnée.
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Réussi
|
successful | boolean |
Vrai ou faux. |
|
code d'erreur
|
errorCode | string |
Code d’erreur. |
|
errorMessage
|
errorMessage | string |
Message d'erreur. |
|
events
|
events | array of object |
Répertorier les événements auxquels une entreprise donnée s’est inscrite. |
|
authUrl
|
events.authUrl | string |
Point de terminaison d’autorisation OAuth2 du client. |
|
callbackUrl
|
events.callbackUrl | string |
URL de rappel du client utilisée pour l’envoi de mises à jour. |
|
callbackClientId
|
events.callbackClientId | string |
ID client utilisé pour l’autorisation de l’environnement client. |
|
callbackSignatureAlgorithm
|
events.callbackSignatureAlgorithm | string |
La signature algorithim est utilisée pour générer la signature de cette charge utile à l’aide du hmac-sha256. |
|
registrationId
|
events.registrationId | string |
Identificateur qui identifie de façon unique l’inscription donnée. |
Obtenir les scores du plan de transport
Obtenez les scores du plan de transport.
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
httpStatusCode
|
httpStatusCode | integer |
Code d’état Http de réponse. |
|
responseDateTime
|
data.responseDateTime | string |
Heure de date de la réponse. |
|
transportationPlanScores
|
data.transportationPlanScores | array of object |
Liste des plans de transport avec des scores. |
|
planId
|
data.transportationPlanScores.planId | string |
Identificateur unique du plan. |
|
valeur
|
data.transportationPlanScores.score.value | string |
Échelle ascendante ordinale d’entiers. |
|
confiance
|
data.transportationPlanScores.score.confidence | string |
Détails de confiance. |
|
shipmentServiceConditions
|
data.transportationPlanScores.shipmentServiceConditions | array of object |
Conditions du service de livraison d’expédition. |
|
shipmentId
|
data.transportationPlanScores.shipmentServiceConditions.shipmentId | string |
Identificateur unique de l’expédition. |
|
serviceCode
|
data.transportationPlanScores.shipmentServiceConditions.recommendedTransportationService.serviceCode | string |
Code de service pour la livraison de l’expédition. |
|
carrier
|
data.transportationPlanScores.shipmentServiceConditions.recommendedTransportationService.carrier | string |
Informations sur le transporteur. |
|
estimatedDeliveryDate
|
data.transportationPlanScores.shipmentServiceConditions.recommendedTransportationService.estimatedDeliveryDate | string |
Date de livraison estimée de l’expédition. |
|
results
|
results | array of object |
Liste des résultats contenant l’état. |
|
status
|
results.status | array of object | |
|
code
|
results.status.code | string |
Code d’erreur ou d’information pour les réponses. |
|
severity
|
results.status.severity | string |
La gravité de l’état en réponse peut être ERROR/FATAL/INFO. |
|
Message
|
results.status.message | string |
Message décrivant le code ci-dessus. |
|
chemin
|
results.status.path | string |
Chemin d’accès du champ pour lequel l’état est fourni. |
|
helpUrl
|
results.status.helpUrl | string |
URL pour obtenir plus d’informations sur le code et le message. |
|
recommendedRetryMinutes
|
results.status.recommendedRetryMinutes | integer |
Réessayez les minutes pour lesquelles la même requête peut être réessayé. |
|
version
|
version | string |
Version de l’API. |
|
requestTimeStamp
|
requestTimeStamp | string |
Heure de date de la requête. |
Supprimer l’abonnement Webhook pour une entreprise donnée par événement
Supprimez l’abonnement Webhook pour une entreprise donnée par événement.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID d’indice
|
subscriptionId | True | string |
ID d’indice à supprimer. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Réussi
|
successful | boolean |
Vrai ou faux. |
|
code d'erreur
|
errorCode | string |
Code d’erreur. |
|
errorMessage
|
errorMessage | string |
Message d'erreur. |
|
subscriptionId
|
subscriptionId | string |
ID d’abonnement supprimé. |
Supprimer l’inscription de Webhook pour une entreprise donnée par événement
Supprimez l’inscription webhook pour une entreprise donnée par événement.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
ID d’inscription
|
registrationId | string |
ID d’inscription à supprimer. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Réussi
|
successful | boolean |
Vrai ou faux. |
|
code d'erreur
|
errorCode | string |
Code d’erreur. |
|
errorMessage
|
errorMessage | string |
Message d'erreur. |
Valider la signature de notification webhook HMACSHA256
Valider la notification webhook HMACSHA256 signature.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Message Signature
|
MessageSignature | True | string |
Signature de message à valider. |
|
Clé secrète
|
SecretKey | True | string |
Clé secrète pour HMAC. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
isValid
|
isValid | boolean |
isValid |
Déclencheurs
| Inscription de webhook pour une entreprise donnée par événement |
Inscription de webhook pour une entreprise donnée par événement. |
Inscription de webhook pour une entreprise donnée par événement
Inscription de webhook pour une entreprise donnée par événement.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
événement
|
event | True | string |
Type d’événement : EDD_CHANGED ou EDTW_CHANGED. |
|
callbackSignatureSecretKey
|
callbackSignatureSecretKey | True | string |
Le client fournit le secret pour produire la signature avec le rappel. |
|
callbackAuthUrl
|
callbackAuthUrl | string |
Point de terminaison d’autorisation OAuth2 du client. |
|
|
callbackClientId
|
callbackClientId | string |
ID client utilisé pour l’autorisation de l’environnement client. |
|
|
callbackClientSecret
|
callbackClientSecret | string |
Clé secrète du client chiffrée utilisée pour l’autorisation de l’environnement client. |
|
|
callbackSignatureAlgorithm
|
callbackSignatureAlgorithm | True | string |
La signature algorithim est utilisée pour générer la signature de cette charge utile à l’aide du hmac-sha256. |
Retours
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
ftmTrackingNumber
|
ftmTrackingNumber | string |
Identificateur d’expédition. |
|
ftmTrackingQualifier
|
ftmTrackingQualifier | string |
Le qualificateur est utilisé pour identifier de manière unique l’expédition au sein de l’OpCo. |
|
ftmTrackingCarrier
|
ftmTrackingCarrier | string |
Opérateur de package OpCo. |
|
eddTime
|
eddTime | string |
Prédiction de date de livraison estimée à partir du PIBP. |
|
eddPrevTime
|
eddPrevTime | string |
Précédent EDD. |
|
eddStatus
|
eddStatus | string |
DÉBUT OU ONTIME OU DIFFÉRÉ. |
|
eddChanged
|
eddChanged | string |
Indicateur indiquant que la prédiction EDD a changé. 1 représente une modification EDD. |
|
eddDelaysRiskScore
|
eddDelaysRiskScore | string |
Score de risque EDD qui permet aux consommateurs de prendre des décisions sur l’utilisation des informations de prédiction. |
|
eddDelayTypeCode
|
eddDelayTypeCode | string |
Retarder le code de raison. Exemple OP – Opérationnel, WE – Météo. |
|
edtwBegin
|
edtwBegin | string |
Début de la fenêtre durée de livraison estimée. |
|
edtwEnd
|
edtwEnd | string |
Fin de la fenêtre durée de livraison estimée. |
|
edtwPrevBegin
|
edtwPrevBegin | string |
Valeur de début de la fenêtre de temps de remise estimée précédente. |
|
edtwPrevEnd
|
edtwPrevEnd | string |
Valeur de fin de la fenêtre de délai de remise estimée précédente. |
|
edtwChanged
|
edtwChanged | string |
Indicateur indiquant que la prédiction EDTW a changé. 1 représente une modification EDTW. |
|
edtwDelaysRiskScore
|
edtwDelaysRiskScore | string |
Score de risques EDTW pour le seuil des consommateurs en aval. |