FedEx Dataworks (プレビュー)
FedEx Corp. は、世界中のお客様と企業に輸送、eコマース、ビジネス サービスの幅広いポートフォリオを提供しています。 交通選択サービス API に接続して、輸送計画に関するランク付けとサービスの推奨事項を受け取ります。
このコネクタは、次の製品とリージョンで使用できます。
| Service | クラス | リージョン |
|---|---|---|
| ロジック アプリ | Standard | 次を除くすべての Logic Apps リージョン : - Azure Government リージョン - Azure China リージョン - 米国国防総省 (DoD) |
| 連絡先 | |
|---|---|
| 名前 | マイクロソフト・ダイナミクス |
| URL | https://aka.ms/iomsupport |
| iomdri@microsoft.com |
| コネクタ メタデータ | |
|---|---|
| 発行者 | マイクロソフト |
| ウェブサイト | https://www.fedex.com/ |
| プライバシー ポリシー | https://www.fedex.com/en-us/trust-center.html |
| カテゴリ | 商業;ビジネス管理 |
FedEx Dataworks コネクタは、Dynamics 365 Intelligent Order Management のプロバイダー統合に使用するために特別に開発されました。
前提条件
オンボード プロセスについては、FedEx にお問い合わせください。
注: このコネクタを使用して、Dynamics 365 Intelligent Order Management FedEx プロバイダーを設定することをお勧めします。
資格情報を取得する方法
- オンボード プロセスの一環として、Dataworks 開発チームが Microsoft Entra ID 資格情報を暗号化できるように、各ブランドで PGP キー ペアを生成する必要があります。 暗号化を実行するには、公開キーを Dataworks 開発チームに送信する必要があります。
- PGP キー ペアは GnuPG を使用して生成できます。 これは、指定されたリンクからダウンロードできます。 https://gpg4win.org/get-gpg4win.html
- Dataworks Development チームによってクライアント シークレットがプロビジョニングされると、キーがブランドに送信されます。 ブランドがキーを所有している場合は、暗号化を解除できます。
- 追加の詳細は、オンボード プロセスの一環として共有されます。
コネクタの概要
https://docs.microsoft.com/en-us/dynamics365/intelligent-order-management/work-providers#set-up-a-providerに従って、クライアント資格情報を使用して FedEx Provider を有効にします。
既知の問題と制限事項
このコネクタは、Dynamics 365 Intelligent Order Management の FedEx Provider 統合に使用するために特別に開発されています。 Dynamics 365 Intelligent Order Management 以外のユース ケースのサポートは制限されます。
接続を作成する
コネクタでは、次の認証の種類がサポートされています。
| デフォルト | 接続を作成するためのパラメーター。 | すべてのリージョン | 共有不可 |
デフォルト
適用対象: すべてのリージョン
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名前 | タイプ | 説明 | 必須 |
|---|---|---|---|
| クライアント ID | 文字列 | FedEx Dataworks クライアント ID | 正しい |
| クライアント シークレット | securestring | FedEx Dataworks クライアント シークレット | 正しい |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
| トリガーポーリングの頻度 | 1 | 15 秒 |
アクション
| Webhook 通知HMACSHA256署名の検証 |
Webhook 通知HMACSHA256署名を検証します。 |
| イベントによって特定の会社の Webhook サブスクリプションを削除する |
イベントごとに特定の会社の Webhook サブスクリプションを削除します。 |
| イベントによって特定の会社の Webhook 登録を削除する |
イベントによって特定の会社の Webhook 登録を削除します。 |
| イベント別の特定の会社の Webhook サブスクリプション |
イベント別の特定の会社の Webhook サブスクリプション。 |
| 予測配信の見積もりを取得する |
予測配信の見積もりを取得します。 |
| 交通計画のスコアを取得する |
交通計画のスコアを取得します。 |
| 特定の会社の Webhook サブスクリプションの一覧に関する情報を取得する |
特定の会社の Webhook サブスクリプションの一覧に関する情報を取得します。 |
| 特定の会社のイベント別の Webhook 登録の一覧に関する情報を取得する |
特定の会社のイベント別の Webhook 登録の一覧に関する情報を取得します。 |
Webhook 通知HMACSHA256署名の検証
Webhook 通知HMACSHA256署名を検証します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
メッセージ署名
|
MessageSignature | True | string |
検証対象のメッセージ署名。 |
|
秘密鍵
|
SecretKey | True | string |
HMAC の秘密鍵。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
isValid
|
isValid | boolean |
isValid |
イベントによって特定の会社の Webhook サブスクリプションを削除する
イベントごとに特定の会社の Webhook サブスクリプションを削除します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Subscripton Id
|
subscriptionId | True | string |
削除する添字 ID。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
成功
|
successful | boolean |
True または False です。 |
|
エラーコード
|
errorCode | string |
エラー コード。 |
|
errorMessage
|
errorMessage | string |
エラーメッセージ。 |
|
subscriptionId
|
subscriptionId | string |
削除されたサブスクリプション ID。 |
イベントによって特定の会社の Webhook 登録を削除する
イベントによって特定の会社の Webhook 登録を削除します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
登録 ID
|
registrationId | string |
削除する登録 ID。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
成功
|
successful | boolean |
True または False です。 |
|
エラーコード
|
errorCode | string |
エラー コード。 |
|
errorMessage
|
errorMessage | string |
エラーメッセージ。 |
イベント別の特定の会社の Webhook サブスクリプション
イベント別の特定の会社の Webhook サブスクリプション。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
イベント
|
event | True | string |
イベントの種類 (EDD_CHANGEDまたはEDTW_CHANGED)。 |
|
登録ID
|
registrationId | True | string |
Webhook に登録するときに生成される WebhookId。 |
|
コールバックURL
|
callbackUrl | string |
登録で使用されるコールバック URL をオーバーライドすることを選択した場合、更新プログラムの送信に使用されるクライアントのコールバック URL。 |
|
|
キー
|
key | True | string |
会社が自分の情報を追跡できる可能な方法 - trackingNumber。 |
|
values
|
values | True | array of string |
状態の更新の受信に関心のある ID の追跡。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
成功
|
successful | boolean |
True または False です。 |
|
エラーコード
|
errorCode | string |
エラー コード。 |
|
errorMessage
|
errorMessage | string |
エラーメッセージ。 |
|
subscriptionId
|
subscriptionId | array of string |
挿入されたサブスクリプション ID の一覧。 |
予測配信の見積もりを取得する
予測配信の見積もりを取得します。
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
originofpackage
|
responsebody.originofpackage | string |
パッケージの配信元 |
|
destinationofpackage
|
responsebody.destinationofpackage | string |
パッケージの宛先 |
|
datetimeofpossession
|
responsebody.datetimeofpossession | string |
所有日時 |
|
edds
|
responsebody.edds | array of object |
edds |
|
requestid
|
responsebody.metadata.requestid | string |
Requestid |
|
shipperId
|
responsebody.metadata.shipperId | string |
ShipperId |
交通計画のスコアを取得する
交通計画のスコアを取得します。
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
HTTPステータスコード
|
httpStatusCode | integer |
応答の Http 状態コード。 |
|
responseDateTime
|
data.responseDateTime | string |
応答の日付時刻。 |
|
transportationPlanScores
|
data.transportationPlanScores | array of object |
スコア付きの輸送計画の一覧。 |
|
planId
|
data.transportationPlanScores.planId | string |
プランの一意識別子。 |
|
value
|
data.transportationPlanScores.score.value | string |
整数の昇順の序数。 |
|
信頼度
|
data.transportationPlanScores.score.confidence | string |
信頼度の詳細。 |
|
shipmentServiceConditions
|
data.transportationPlanScores.shipmentServiceConditions | array of object |
出荷配送サービスの条件。 |
|
shipmentId
|
data.transportationPlanScores.shipmentServiceConditions.shipmentId | string |
出荷の一意識別子。 |
|
serviceCode
|
data.transportationPlanScores.shipmentServiceConditions.recommendedTransportationService.serviceCode | string |
配送のサービス コード。 |
|
通信事業者
|
data.transportationPlanScores.shipmentServiceConditions.recommendedTransportationService.carrier | string |
運送業者情報。 |
|
estimatedDeliveryDate
|
data.transportationPlanScores.shipmentServiceConditions.recommendedTransportationService.estimatedDeliveryDate | string |
出荷予定日。 |
|
結果
|
results | array of object |
状態を含む結果の一覧。 |
|
状態
|
results.status | array of object | |
|
コード
|
results.status.code | string |
応答のエラーまたは情報コード。 |
|
severity
|
results.status.severity | string |
応答中の状態の重大度は、ERROR/FATAL/INFO にすることができます。 |
|
メッセージ
|
results.status.message | string |
上記のコードを説明するメッセージ。 |
|
パス
|
results.status.path | string |
状態が指定されているフィールドのパス。 |
|
helpUrl
|
results.status.helpUrl | string |
コードとメッセージに関する詳細情報を取得するための URL。 |
|
recommendedRetryMinutes
|
results.status.recommendedRetryMinutes | integer |
同じ要求を再試行できる再試行時間 (分)。 |
|
バージョン
|
version | string |
API のバージョン。 |
|
requestTimeStamp
|
requestTimeStamp | string |
要求の日時。 |
特定の会社の Webhook サブスクリプションの一覧に関する情報を取得する
特定の会社の Webhook サブスクリプションの一覧に関する情報を取得します。
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
成功
|
successful | boolean |
True または False です。 |
|
エラーコード
|
errorCode | string |
エラー コード。 |
|
errorMessage
|
errorMessage | string |
エラーメッセージ。 |
|
subscriptionId
|
subscriptionId | array of string |
フェッチされたサブスクリプション ID の一覧。 |
特定の会社のイベント別の Webhook 登録の一覧に関する情報を取得する
特定の会社のイベント別の Webhook 登録の一覧に関する情報を取得します。
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
成功
|
successful | boolean |
True または False です。 |
|
エラーコード
|
errorCode | string |
エラー コード。 |
|
errorMessage
|
errorMessage | string |
エラーメッセージ。 |
|
イベント
|
events | array of object |
特定の会社がサインアップしたイベントを一覧表示します。 |
|
認証URL
|
events.authUrl | string |
クライアントの OAuth2 承認エンドポイント。 |
|
コールバックURL
|
events.callbackUrl | string |
更新の送信に使用されるクライアントのコールバック URL。 |
|
callbackClientId
|
events.callbackClientId | string |
クライアント環境の承認に使用されるクライアント ID。 |
|
callbackSignatureAlgorithm
|
events.callbackSignatureAlgorithm | string |
署名の algorithim は、hmac-sha256 を使用してこのペイロードの署名を生成するために使用されます。 |
|
登録ID
|
events.registrationId | string |
指定された登録を一意に識別する識別子。 |
トリガー
| イベント別の特定の会社の Webhook 登録 |
イベント別の特定の会社の Webhook 登録。 |
イベント別の特定の会社の Webhook 登録
イベント別の特定の会社の Webhook 登録。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
イベント
|
event | True | string |
イベントの種類 (EDD_CHANGEDまたはEDTW_CHANGED)。 |
|
callbackSignatureSecretKey
|
callbackSignatureSecretKey | True | string |
クライアントは、コールバックを使用して署名を生成するシークレットを提供します。 |
|
callbackAuthUrl
|
callbackAuthUrl | string |
クライアントの OAuth2 承認エンドポイント。 |
|
|
callbackClientId
|
callbackClientId | string |
クライアント環境の承認に使用されるクライアント ID。 |
|
|
callbackClientSecret
|
callbackClientSecret | string |
クライアント環境の承認に使用される暗号化されたクライアントのシークレット。 |
|
|
callbackSignatureAlgorithm
|
callbackSignatureAlgorithm | True | string |
署名の algorithim は、hmac-sha256 を使用してこのペイロードの署名を生成するために使用されます。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ftmTrackingNumber
|
ftmTrackingNumber | string |
出荷識別子。 |
|
ftmTrackingQualifier
|
ftmTrackingQualifier | string |
修飾子は、OpCo 内の出荷を一意に識別するために使用されます。 |
|
ftmTrackingCarrier
|
ftmTrackingCarrier | string |
パッケージ キャリア OpCo。 |
|
eddTime
|
eddTime | string |
GDPP からの推定配信日予測。 |
|
eddPrevTime
|
eddPrevTime | string |
以前の EDD。 |
|
eddStatus
|
eddStatus | string |
EARLY または ONTIME または DELAYED。 |
|
eddChanged
|
eddChanged | string |
EDD 予測が変更されたことを示すフラグ。 1 は、EDD が変更されたことを表します。 |
|
eddDelaysRiskScore
|
eddDelaysRiskScore | string |
消費者が予測情報の使用方法を決定できるようにする EDD リスク スコア。 |
|
eddDelayTypeCode
|
eddDelayTypeCode | string |
遅延理由コード。 OP の例 – 運用、WE – 天気。 |
|
edtwBegin
|
edtwBegin | string |
見積もり配信時間枠の開始。 |
|
edtwEnd
|
edtwEnd | string |
見積もり配信時間枠の終了。 |
|
edtwPrevBegin
|
edtwPrevBegin | string |
以前の推定配信時間枠の開始値。 |
|
edtwPrevEnd
|
edtwPrevEnd | string |
以前の推定配信時間ウィンドウの終了値。 |
|
edtwChanged
|
edtwChanged | string |
EDTW 予測が変更されたことを示すフラグ。 1 は、EDTW の変更があった場合を表します。 |
|
edtwDelaysRiskScore
|
edtwDelaysRiskScore | string |
ダウンストリーム コンシューマーしきい値の EDTW リスク スコア。 |