FedEx Dataworks (förhandsversion)
FedEx Corp. ger kunder och företag över hela världen en bred portfölj av transport-, e-handels- och affärstjänster. Anslut till API:et för transportvalstjänsten för att få ranknings- och tjänstrekommendationer för transportplaner.
Den här anslutningsappen är tillgänglig i följande produkter och regioner:
| Service | Class | Regioner |
|---|---|---|
| Logiska appar | Standard | Alla Logic Apps-regioner utom följande: - Azure Government regioner - Azure kinaregioner - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Namn | Microsoft Dynamics |
| URL | https://aka.ms/iomsupport |
| E-postmeddelande | iomdri@microsoft.com |
| Metadata för anslutningsprogram | |
|---|---|
| Publisher | Microsoft |
| Webbplats | https://www.fedex.com/ |
| Sekretesspolicy | https://www.fedex.com/en-us/trust-center.html |
| Kategorier | Handel; Företagsledning |
FedEx Dataworks-anslutningsprogrammet har utvecklats specifikt för att användas för Dynamics 365 Intelligent Order Managements providerintegrering.
Förutsättningar
Kontakta FedEx för registreringsprocessen.
Obs! Vi rekommenderar att du använder den här anslutningsappen specifikt för att konfigurera Dynamics 365 Intelligent Order Management FedEx-providern.
Hämta autentiseringsuppgifter
- Som en del av registreringsprocessen måste varje varumärke generera ett PGP-nyckelpar så att Dataworks-utvecklingsteamet kan kryptera sina Microsoft Entra-ID-autentiseringsuppgifter. Den offentliga nyckeln måste skickas till Dataworks Development-teamet för att utföra krypteringen.
- PGP-nyckelpar kan genereras med GnuPG. Den kan laddas ned från den angivna länken: https://gpg4win.org/get-gpg4win.html
- När klienthemligheten har etablerats av Dataworks Development-teamet skickas nyckeln till varumärket. När varumärket är i besittning av nyckeln kan den dekrypteras.
- Ytterligare information delas som en del av registreringsprocessen.
Komma igång med anslutningsappen
Följ https://docs.microsoft.com/en-us/dynamics365/intelligent-order-management/work-providers#set-up-a-provider för att aktivera FedEx-providern med klientautentiseringsuppgifterna.
Kända problem och begränsningar
Den här anslutningsappen har utvecklats specifikt för att användas för Dynamics 365 Intelligent Order Managements FedEx-providerintegrering. Stöd för användningsfall utanför Dynamics 365 Intelligent Order Management kommer att begränsas.
Skapa en anslutning
Anslutningsappen stöder följande autentiseringstyper:
| Standardinställning | Parametrar för att skapa anslutning. | Alla regioner | Går inte att dela |
Standard
Tillämpligt: Alla regioner
Parametrar för att skapa anslutning.
Det här är inte delningsbar anslutning. Om power-appen delas med en annan användare uppmanas en annan användare att skapa en ny anslutning explicit.
| Namn | Type | Beskrivning | Obligatoriskt |
|---|---|---|---|
| Kund-ID | snöre | FedEx Dataworks-klient-ID | Sann |
| Klienthemlighet | securestring | FedEx Dataworks-klienthemlighet | Sann |
Begränsningsgränser
| Name | Anrop | Förnyelseperiod |
|---|---|---|
| API-anrop per anslutning | 100 | 60 sekunder |
| Frekvens för utlösarundersökningar | 1 | 15 sekunder |
Åtgärder
| Hämta information om en lista över Webhook-prenumerationer för ett visst företag |
Hämta information om en lista över Webhook-prenumerationer för ett visst företag. |
| Hämta information om en lista över Webhook-registreringar efter händelse för ett visst företag |
Få information om en lista över Webhook-registreringar efter händelse för ett visst företag. |
| Hämta transportplanspoäng |
Hämta transportplanspoäng. |
| Hämta uppskattningar av förutsägande leverans |
Hämta uppskattningar av förutsägande leverans. |
| Ta bort Webhook-prenumeration för ett visst företag efter händelse |
Ta bort Webhook-prenumeration för ett visst företag efter händelse. |
| Ta bort Webhook-registrering för ett visst företag efter händelse |
Ta bort Webhook-registrering för ett visst företag efter händelse. |
| Verifiera Webhook-meddelande HMACSHA256 signatur |
Verifiera Webhook-meddelande HMACSHA256 signatur. |
| Webhook-prenumeration för ett visst företag per händelse |
Webhook-prenumeration för ett visst företag per händelse. |
Hämta information om en lista över Webhook-prenumerationer för ett visst företag
Hämta information om en lista över Webhook-prenumerationer för ett visst företag.
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
framgångsrik
|
successful | boolean |
Sant eller Falskt. |
|
felkod
|
errorCode | string |
Felkod. |
|
errorMessage
|
errorMessage | string |
Felmeddelande. |
|
subscriptionId
|
subscriptionId | array of string |
Lista över hämtade prenumerations-ID:t. |
Hämta information om en lista över Webhook-registreringar efter händelse för ett visst företag
Få information om en lista över Webhook-registreringar efter händelse för ett visst företag.
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
framgångsrik
|
successful | boolean |
Sant eller Falskt. |
|
felkod
|
errorCode | string |
Felkod. |
|
errorMessage
|
errorMessage | string |
Felmeddelande. |
|
events
|
events | array of object |
Visa en lista över händelser som ett visst företag har registrerat sig för. |
|
authUrl
|
events.authUrl | string |
Klientens OAuth2-auktoriseringsslutpunkt. |
|
callbackUrl
|
events.callbackUrl | string |
Klientens motringnings-URL som används för att skicka uppdateringar. |
|
callbackClientId
|
events.callbackClientId | string |
Klient-ID som används för klientmiljöauktorisering. |
|
callbackSignatureAlgorithm
|
events.callbackSignatureAlgorithm | string |
Signaturen algorithim används för att generera signaturen för den här nyttolasten med hjälp av hmac-sha256. |
|
registreringsID
|
events.registrationId | string |
En identifierare som unikt identifierar den angivna registreringen. |
Hämta transportplanspoäng
Hämta transportplanspoäng.
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
HTTP-statuskod
|
httpStatusCode | integer |
Http-statuskod för svar. |
|
responseDateTime
|
data.responseDateTime | string |
Datum för svarstid. |
|
transportationPlanScores
|
data.transportationPlanScores | array of object |
Lista över transportplan med poäng. |
|
planId
|
data.transportationPlanScores.planId | string |
Unik identifierare för planen. |
|
value
|
data.transportationPlanScores.score.value | string |
Stigande ordningsskala för heltal. |
|
konfidens
|
data.transportationPlanScores.score.confidence | string |
Konfidensinformation. |
|
shipmentServiceConditions
|
data.transportationPlanScores.shipmentServiceConditions | array of object |
Leveransleveranstjänstvillkor. |
|
shipmentId
|
data.transportationPlanScores.shipmentServiceConditions.shipmentId | string |
Unik identifierare för leverans. |
|
serviceCode
|
data.transportationPlanScores.shipmentServiceConditions.recommendedTransportationService.serviceCode | string |
Tjänstkod för leverans av leverans. |
|
transportföretag
|
data.transportationPlanScores.shipmentServiceConditions.recommendedTransportationService.carrier | string |
Information om transportföretaget. |
|
estimatedDeliveryDate
|
data.transportationPlanScores.shipmentServiceConditions.recommendedTransportationService.estimatedDeliveryDate | string |
Beräknat leveransdatum för leverans. |
|
results
|
results | array of object |
Lista över resultat som innehåller status. |
|
status
|
results.status | array of object | |
|
kod
|
results.status.code | string |
Fel eller informationskod för svar. |
|
severity
|
results.status.severity | string |
Allvarlighetsgraden för statusen som svar kan vara ERROR/FATAL/INFO. |
|
meddelande
|
results.status.message | string |
Meddelande som beskriver koden ovan. |
|
path
|
results.status.path | string |
Sökväg till det fält som statusen har angetts för. |
|
helpUrl
|
results.status.helpUrl | string |
URL för att få mer information om koden och meddelandet. |
|
recommendedRetryMinutes
|
results.status.recommendedRetryMinutes | integer |
Försök igen minuter för vilka samma begäran kan provas igen. |
|
version
|
version | string |
Version av API:et. |
|
requestTimeStamp
|
requestTimeStamp | string |
Datum för begäran. |
Hämta uppskattningar av förutsägande leverans
Hämta uppskattningar av förutsägande leverans.
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
originofpackage
|
responsebody.originofpackage | string |
Paketets ursprung |
|
destinationofpackage
|
responsebody.destinationofpackage | string |
Paketets mål |
|
datetimeofpossession
|
responsebody.datetimeofpossession | string |
Datum för innehav |
|
edds
|
responsebody.edds | array of object |
edds |
|
Id
|
responsebody.metadata.requestid | string |
Id |
|
shipperId
|
responsebody.metadata.shipperId | string |
ShipperId |
Ta bort Webhook-prenumeration för ett visst företag efter händelse
Ta bort Webhook-prenumeration för ett visst företag efter händelse.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Nedsänkt ID
|
subscriptionId | True | string |
Nedsänkt ID som ska tas bort. |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
framgångsrik
|
successful | boolean |
Sant eller Falskt. |
|
felkod
|
errorCode | string |
Felkod. |
|
errorMessage
|
errorMessage | string |
Felmeddelande. |
|
subscriptionId
|
subscriptionId | string |
Borttaget prenumerations-ID. |
Ta bort Webhook-registrering för ett visst företag efter händelse
Ta bort Webhook-registrering för ett visst företag efter händelse.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Registrerings-ID
|
registrationId | string |
Registrerings-ID som ska tas bort. |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
framgångsrik
|
successful | boolean |
Sant eller Falskt. |
|
felkod
|
errorCode | string |
Felkod. |
|
errorMessage
|
errorMessage | string |
Felmeddelande. |
Verifiera Webhook-meddelande HMACSHA256 signatur
Verifiera Webhook-meddelande HMACSHA256 signatur.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Meddelandesignatur
|
MessageSignature | True | string |
Meddelandesignatur att verifiera mot. |
|
Hemlig nyckel
|
SecretKey | True | string |
Hemlig nyckel för HMAC. |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
isValid
|
isValid | boolean |
isValid |
Webhook-prenumeration för ett visst företag per händelse
Webhook-prenumeration för ett visst företag per händelse.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
händelse
|
event | True | string |
Typ av händelse – EDD_CHANGED eller EDTW_CHANGED. |
|
registreringsID
|
registrationId | True | string |
WebhookId som genereras när du registrerar dig för webhooken. |
|
callbackUrl
|
callbackUrl | string |
Klientens motringnings-URL som används för att skicka uppdateringar om de väljer att åsidosätta de som används i registreringen. |
|
|
key
|
key | True | string |
Tillåtna sätt som ett företag kan spåra sin information– trackingNumber. |
|
values
|
values | True | array of string |
Spårnings-ID:er som är intresserade av att ta emot statusuppdateringar. |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
framgångsrik
|
successful | boolean |
Sant eller Falskt. |
|
felkod
|
errorCode | string |
Felkod. |
|
errorMessage
|
errorMessage | string |
Felmeddelande. |
|
subscriptionId
|
subscriptionId | array of string |
Lista över prenumerations-ID:t infogade. |
Utlösare
| Webhook-registrering för ett visst företag efter händelse |
Webhook-registrering för ett visst företag per händelse. |
Webhook-registrering för ett visst företag efter händelse
Webhook-registrering för ett visst företag per händelse.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
händelse
|
event | True | string |
Typ av händelse – EDD_CHANGED eller EDTW_CHANGED. |
|
callbackSignatureSecretKey
|
callbackSignatureSecretKey | True | string |
Klienten tillhandahåller hemligheten för att skapa signaturen med återanropet. |
|
callbackAuthUrl
|
callbackAuthUrl | string |
Klientens OAuth2-auktoriseringsslutpunkt. |
|
|
callbackClientId
|
callbackClientId | string |
Klient-ID som används för klientmiljöauktorisering. |
|
|
callbackClientSecret
|
callbackClientSecret | string |
Krypterad klienthemlighet som används för klientmiljöauktorisering. |
|
|
callbackSignatureAlgorithm
|
callbackSignatureAlgorithm | True | string |
Signaturen algorithim används för att generera signaturen för den här nyttolasten med hjälp av hmac-sha256. |
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
ftmTrackingNumber
|
ftmTrackingNumber | string |
Leveransidentifierare. |
|
ftmTrackingQualifier
|
ftmTrackingQualifier | string |
Kvalificeraren används för att unikt identifiera leveransen i OpCo. |
|
ftmTrackingCarrier
|
ftmTrackingCarrier | string |
Pakettransportören OpCo. |
|
eddTime
|
eddTime | string |
Beräknad leveransdatumförutsägelse från GDPP. |
|
eddPrevTime
|
eddPrevTime | string |
Tidigare EDD. |
|
eddStatus
|
eddStatus | string |
TIDIG ELLER ONTIME ELLER FÖRDRÖJD. |
|
eddChanged
|
eddChanged | string |
Flagga som anger att EDD-förutsägelsen har ändrats. 1 representerar att det har skett en EDD-ändring. |
|
eddDelaysRiskScore
|
eddDelaysRiskScore | string |
EDD-riskpoäng som gör det möjligt för konsumenter att fatta beslut om hur de ska använda förutsägelseinformationen. |
|
eddDelayTypeCode
|
eddDelayTypeCode | string |
Fördröj orsakskod. Exempel OP – Operational, WE – Weather. |
|
edtwBegin
|
edtwBegin | string |
Början av fönstret Uppskattad leveranstid. |
|
edtwEnd
|
edtwEnd | string |
Slutet av fönstret Uppskattad leveranstid. |
|
edtwPrevBegin
|
edtwPrevBegin | string |
Startvärde för tidigare uppskattad leveranstid. |
|
edtwPrevEnd
|
edtwPrevEnd | string |
Tidigare slutvärde för uppskattad leveranstid. |
|
edtwChanged
|
edtwChanged | string |
Flagga som anger att EDTW-förutsägelsen har ändrats. 1 representerar att det har skett en EDTW-ändring. |
|
edtwDelaysRiskScore
|
edtwDelaysRiskScore | string |
EDTW-riskpoäng för tröskelvärden för nedströmskonsumenter. |