FedEx Dataworks (Vorschau)
FedEx Corp. bietet Kunden und Unternehmen weltweit ein breites Portfolio an Transport-, E-Commerce- und Business-Services. Stellen Sie eine Verbindung mit der Transportauswahldienst-API her, um Rangfolgen- und Serviceempfehlungen für Transportpläne zu erhalten.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Service | Klasse | Regions |
|---|---|---|
| Logik-Apps | Standard | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: – Azure Government-Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | Microsoft Dynamics |
| URL | https://aka.ms/iomsupport |
| E‑Mail | iomdri@microsoft.com |
| Connectormetadaten | |
|---|---|
| Herausgeber | Microsoft |
| Website | https://www.fedex.com/ |
| Datenschutzrichtlinie | https://www.fedex.com/en-us/trust-center.html |
| Kategorien | Handel; Unternehmensführung |
FedEx Dataworks Connector wurde speziell für die Integration von Dynamics 365 Intelligent Order Management entwickelt.
Voraussetzungen
Wenden Sie sich an FedEx für den Onboardingprozess.
Hinweis: Es wird empfohlen, diesen Connector speziell zum Einrichten des Dynamics 365 Intelligent Order Management FedEx-Anbieters zu verwenden.
So erhalten Sie Anmeldeinformationen
- Im Rahmen des Onboardingprozesses muss jede Marke ein PGP-Schlüsselpaar generieren, damit das Dataworks-Entwicklungsteam seine Microsoft Entra-ID-Anmeldeinformationen verschlüsseln kann. Der öffentliche Schlüssel muss an das Dataworks-Entwicklungsteam gesendet werden, um die Verschlüsselung auszuführen.
- PGP-Schlüsselpaar kann mit GnuPG generiert werden. Sie kann über den angegebenen Link heruntergeladen werden: https://gpg4win.org/get-gpg4win.html
- Nachdem der geheime Clientschlüssel vom Dataworks-Entwicklungsteam bereitgestellt wurde, wird der Schlüssel an die Marke gesendet. Sobald die Marke im Besitz des Schlüssels ist, kann sie entschlüsselt werden.
- Weitere Details werden im Rahmen des Onboardingprozesses freigegeben.
Erste Schritte mit Ihrem Connector
Folgen Sie https://docs.microsoft.com/en-us/dynamics365/intelligent-order-management/work-providers#set-up-a-provider , um FedEx-Anbieter mit den Clientanmeldeinformationen zu aktivieren.
Bekannte Probleme und Einschränkungen
Dieser Connector wurde speziell für die FedEx Provider-Integration von Dynamics 365 Intelligent Order Management entwickelt. Die Unterstützung für Anwendungsfälle außerhalb von Dynamics 365 Intelligent Order Management ist eingeschränkt.
Eine Verbindung wird erstellt
Der Connector unterstützt die folgenden Authentifizierungstypen:
| Vorgabe | Parameter zum Erstellen einer Verbindung. | Alle Regionen | Nicht teilbar |
Vorgabe
Anwendbar: Alle Regionen
Parameter zum Erstellen einer Verbindung.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
| Name | Typ | Beschreibung | Erforderlich |
|---|---|---|---|
| Client-ID | Schnur | FedEx Dataworks-Client-ID | Richtig |
| Geheimer Clientschlüssel | securestring | FedEx Dataworks-Clientschlüssel | Richtig |
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
| Häufigkeit der Triggerumfragen | 1 | 15 Sekunden |
Aktionen
| Abrufen von Informationen zur Liste der Webhook-Abonnements für ein bestimmtes Unternehmen |
Abrufen von Informationen zur Liste der Webhook-Abonnements für ein bestimmtes Unternehmen. |
| Abrufen von Informationen zur Liste der Webhook-Registrierungen nach Ereignis für ein bestimmtes Unternehmen |
Abrufen von Informationen zur Liste der Webhook-Registrierungen nach Ereignis für ein bestimmtes Unternehmen. |
| Abrufen von Vorhersage-Übermittlungsschätzungen |
Erhalten Sie Vorhersage-Übermittlungsschätzungen. |
| Bewertungen für Transportpläne abrufen |
Bewertungen für Transportpläne abrufen. |
| Löschen der Webhook-Registrierung für ein bestimmtes Unternehmen nach Ereignis |
Löschen Sie die Webhook-Registrierung für ein bestimmtes Unternehmen nach Ereignis. |
| Löschen eines Webhook-Abonnements für ein bestimmtes Unternehmen nach Ereignis |
Löschen des Webhook-Abonnements für ein bestimmtes Unternehmen nach Ereignis. |
| Webhook-Abonnement für ein bestimmtes Unternehmen nach Ereignis |
Webhook-Abonnement für ein bestimmtes Unternehmen nach Ereignis. |
| Überprüfen der Webhook-Benachrichtigung HMACSHA256 Signatur |
Überprüfen der Webhook-Benachrichtigung HMACSHA256 Signatur. |
Abrufen von Informationen zur Liste der Webhook-Abonnements für ein bestimmtes Unternehmen
Abrufen von Informationen zur Liste der Webhook-Abonnements für ein bestimmtes Unternehmen.
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Erfolgreiche
|
successful | boolean |
Wahr oder Falsch. |
|
Fehlercode
|
errorCode | string |
Fehlercode. |
|
errorMessage
|
errorMessage | string |
Fehlermeldung. |
|
subscriptionId
|
subscriptionId | array of string |
Liste der abgerufenen Abonnement-IDs. |
Abrufen von Informationen zur Liste der Webhook-Registrierungen nach Ereignis für ein bestimmtes Unternehmen
Abrufen von Informationen zur Liste der Webhook-Registrierungen nach Ereignis für ein bestimmtes Unternehmen.
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Erfolgreiche
|
successful | boolean |
Wahr oder Falsch. |
|
Fehlercode
|
errorCode | string |
Fehlercode. |
|
errorMessage
|
errorMessage | string |
Fehlermeldung. |
|
events
|
events | array of object |
Ereignisse auflisten, für die sich ein bestimmtes Unternehmen registriert hat. |
|
authUrl
|
events.authUrl | string |
OAuth2-Autorisierungsendpunkt des Clients. |
|
callbackUrl
|
events.callbackUrl | string |
Die Rückruf-URL des Clients, die zum Senden von Updates verwendet wird. |
|
callbackClientId
|
events.callbackClientId | string |
Client-ID, die für die Clientumgebungsautorisierung verwendet wird. |
|
callbackSignatureAlgorithm
|
events.callbackSignatureAlgorithm | string |
Die Signatur algorithim wird verwendet, um die Signatur für diese Nutzlast mithilfe der hmac-sha256 zu generieren. |
|
Registrierungs-ID
|
events.registrationId | string |
Ein Bezeichner, der die angegebene Registrierung eindeutig identifiziert. |
Abrufen von Vorhersage-Übermittlungsschätzungen
Erhalten Sie Vorhersage-Übermittlungsschätzungen.
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
originofpackage
|
responsebody.originofpackage | string |
Ursprung des Pakets |
|
destinationofpackage
|
responsebody.destinationofpackage | string |
Ziel des Pakets |
|
datetimeofpossession
|
responsebody.datetimeofpossession | string |
Datetime des Besitzes |
|
edds
|
responsebody.edds | array of object |
edds |
|
Requestid
|
responsebody.metadata.requestid | string |
Requestid |
|
Shipperid
|
responsebody.metadata.shipperId | string |
Shipperid |
Bewertungen für Transportpläne abrufen
Bewertungen für Transportpläne abrufen.
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
HTTP-Statuscode
|
httpStatusCode | integer |
Http-Statuscode der Antwort. |
|
responseDateTime
|
data.responseDateTime | string |
Datum der Antwort. |
|
transportationPlanScores
|
data.transportationPlanScores | array of object |
Liste des Transportplans mit Bewertungen. |
|
planId
|
data.transportationPlanScores.planId | string |
Eindeutiger Bezeichner des Plans. |
|
value
|
data.transportationPlanScores.score.value | string |
Aufsteigende Ordinalskala von ganzzahligen Zahlen. |
|
confidence
|
data.transportationPlanScores.score.confidence | string |
Konfidenzdetails. |
|
shipmentServiceConditions
|
data.transportationPlanScores.shipmentServiceConditions | array of object |
Lieferservicebedingungen für den Versand. |
|
shipmentId
|
data.transportationPlanScores.shipmentServiceConditions.shipmentId | string |
Eindeutiger Bezeichner der Lieferung. |
|
serviceCode
|
data.transportationPlanScores.shipmentServiceConditions.recommendedTransportationService.serviceCode | string |
Servicecode für die Lieferung der Lieferung. |
|
carrier
|
data.transportationPlanScores.shipmentServiceConditions.recommendedTransportationService.carrier | string |
Netzbetreiberinformationen. |
|
estimatedDeliveryDate
|
data.transportationPlanScores.shipmentServiceConditions.recommendedTransportationService.estimatedDeliveryDate | string |
Geschätzter Liefertermin. |
|
results
|
results | array of object |
Liste der Ergebnisse, die den Status enthalten. |
|
status
|
results.status | array of object | |
|
Programmcode
|
results.status.code | string |
Fehler oder Informationscode für Antworten. |
|
severity
|
results.status.severity | string |
Schweregrad des Status als Antwort kann FEHLER/TÖDLICH/INFO sein. |
|
Nachricht
|
results.status.message | string |
Meldung, die den obigen Code beschreibt. |
|
Pfad
|
results.status.path | string |
Pfad des Felds, für das der Status angegeben wird. |
|
helpUrl
|
results.status.helpUrl | string |
URL zum Abrufen weiterer Informationen zum Code und zur Nachricht. |
|
recommendedRetryMinutes
|
results.status.recommendedRetryMinutes | integer |
Wiederholen Sie Minuten, für die dieselbe Anforderung erneut versucht werden kann. |
|
Version
|
version | string |
Version der API. |
|
requestTimeStamp
|
requestTimeStamp | string |
Datum der Anforderung. |
Löschen der Webhook-Registrierung für ein bestimmtes Unternehmen nach Ereignis
Löschen Sie die Webhook-Registrierung für ein bestimmtes Unternehmen nach Ereignis.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Registrierungs-ID
|
registrationId | string |
Die zu löschende Registrierungs-ID. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Erfolgreiche
|
successful | boolean |
Wahr oder Falsch. |
|
Fehlercode
|
errorCode | string |
Fehlercode. |
|
errorMessage
|
errorMessage | string |
Fehlermeldung. |
Löschen eines Webhook-Abonnements für ein bestimmtes Unternehmen nach Ereignis
Löschen des Webhook-Abonnements für ein bestimmtes Unternehmen nach Ereignis.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Tiefgestellte ID
|
subscriptionId | True | string |
Zu löschende Tiefstellungs-ID. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Erfolgreiche
|
successful | boolean |
Wahr oder Falsch. |
|
Fehlercode
|
errorCode | string |
Fehlercode. |
|
errorMessage
|
errorMessage | string |
Fehlermeldung. |
|
subscriptionId
|
subscriptionId | string |
Gelöschte Abonnement-ID. |
Webhook-Abonnement für ein bestimmtes Unternehmen nach Ereignis
Webhook-Abonnement für ein bestimmtes Unternehmen nach Ereignis.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ereignis
|
event | True | string |
Ereignistyp– EDD_CHANGED oder EDTW_CHANGED. |
|
Registrierungs-ID
|
registrationId | True | string |
WebhookId, die beim Registrieren für den Webhook generiert wurde. |
|
callbackUrl
|
callbackUrl | string |
Die Rückruf-URL des Clients, die zum Senden von Updates verwendet wird, wenn sie die in der Registrierung verwendeten außer Kraft setzen möchten. |
|
|
Schlüssel
|
key | True | string |
Zulässige Möglichkeiten, wie ein Unternehmen seine Informationen nachverfolgen könnte– trackingNumber. |
|
values
|
values | True | array of string |
Nachverfolgen von IDs, die an Statusaktualisierungen interessiert sind. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Erfolgreiche
|
successful | boolean |
Wahr oder Falsch. |
|
Fehlercode
|
errorCode | string |
Fehlercode. |
|
errorMessage
|
errorMessage | string |
Fehlermeldung. |
|
subscriptionId
|
subscriptionId | array of string |
Liste der eingefügten Abonnement-IDs. |
Überprüfen der Webhook-Benachrichtigung HMACSHA256 Signatur
Überprüfen der Webhook-Benachrichtigung HMACSHA256 Signatur.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Nachrichtensignatur
|
MessageSignature | True | string |
Zu überprüfende Nachrichtensignatur. |
|
Geheimer Schlüssel
|
SecretKey | True | string |
Geheimer Schlüssel für HMAC. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
istGültig
|
isValid | boolean |
istGültig |
Trigger
| Webhook-Registrierung für ein bestimmtes Unternehmen nach Ereignis |
Webhook-Registrierung für ein bestimmtes Unternehmen nach Ereignis. |
Webhook-Registrierung für ein bestimmtes Unternehmen nach Ereignis
Webhook-Registrierung für ein bestimmtes Unternehmen nach Ereignis.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ereignis
|
event | True | string |
Ereignistyp– EDD_CHANGED oder EDTW_CHANGED. |
|
callbackSignatureSecretKey
|
callbackSignatureSecretKey | True | string |
Der Client stellt den geheimen Schlüssel bereit, um die Signatur mit dem Rückruf zu erstellen. |
|
callbackAuthUrl
|
callbackAuthUrl | string |
OAuth2-Autorisierungsendpunkt des Clients. |
|
|
callbackClientId
|
callbackClientId | string |
Client-ID, die für die Clientumgebungsautorisierung verwendet wird. |
|
|
callbackClientSecret
|
callbackClientSecret | string |
Der geheime Schlüssel des verschlüsselten Clients, der für die Clientumgebungsautorisierung verwendet wird. |
|
|
callbackSignatureAlgorithm
|
callbackSignatureAlgorithm | True | string |
Die Signatur algorithim wird verwendet, um die Signatur für diese Nutzlast mithilfe der hmac-sha256 zu generieren. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
ftmTrackingNumber
|
ftmTrackingNumber | string |
Versandbezeichner. |
|
ftmTrackingQualifier
|
ftmTrackingQualifier | string |
Der Qualifizierer wird verwendet, um die Lieferung innerhalb der OpCo eindeutig zu identifizieren. |
|
ftmTrackingCarrier
|
ftmTrackingCarrier | string |
Paketnetzbetreiber OpCo. |
|
eddTime
|
eddTime | string |
Geschätzte Lieferdatumsvorhersage vom BIPP. |
|
eddPrevTime
|
eddPrevTime | string |
Vorheriger EDD. |
|
eddStatus
|
eddStatus | string |
EARLY oder ONTIME oder DELAYED. |
|
eddChanged
|
eddChanged | string |
Flag, das angibt, dass die EDD-Vorhersage geändert wurde. 1 stellt eine EDD-Änderung dar. |
|
eddDelaysRiskScore
|
eddDelaysRiskScore | string |
EDD-Risikobewertung, mit der Verbraucher Entscheidungen zur Verwendung der Vorhersageinformationen treffen können. |
|
eddDelayTypeCode
|
eddDelayTypeCode | string |
Verzögerungsgrundcode. Beispiel OP – Betriebsbetrieb, WE – Wetter. |
|
edtwBegin
|
edtwBegin | string |
Anfang des Zeitfensters für die geschätzte Zustellung. |
|
edtwEnd
|
edtwEnd | string |
Ende des Zeitfensters für die geschätzte Zustellung. |
|
edtwPrevBegin
|
edtwPrevBegin | string |
Anfangswert des vorherigen geschätzten Übermittlungszeitfensters. |
|
edtwPrevEnd
|
edtwPrevEnd | string |
Endwert des vorherigen geschätzten Übermittlungszeitfensters. |
|
edtwChanged
|
edtwChanged | string |
Flag, das angibt, dass die EDTW-Vorhersage geändert wurde. 1 stellt eine Änderung des EDTW dar. |
|
edtwDelaysRiskScore
|
edtwDelaysRiskScore | string |
EDTW-Risikobewertung für nachgeschaltete Verbraucherschwellenwerte. |