FedEx Dataworks（預覽版）
FedEx 公司為全球客戶與企業提供廣泛的運輸、電子商務及商業服務組合。 連接交通選擇服務API，接收交通規劃的排名與服務建議。
此連接器適用於以下產品和區域：
| Service | Class | Regions |
|---|---|---|
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - Azure Government 區域 - Azure中國地區 - 美國國防部 （DoD） |
| 連絡人 | |
|---|---|
| 名稱 | Microsoft動力學 |
| URL | https://aka.ms/iomsupport |
| iomdri@microsoft.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | Microsoft |
| 網站 | https://www.fedex.com/ |
| 隱私策略 | https://www.fedex.com/en-us/trust-center.html |
| 類別 | 商;企業管理 |
FedEx Dataworks 連接器專為 Dynamics 365 智慧訂單管理的供應商整合而開發。
先決條件
聯絡FedEx進行入職流程。
注意：建議使用此連接器來設定 Dynamics 365 智慧訂單管理 FedEx 服務提供者。
如何取得認證
- 作為導入流程的一部分，每個品牌都必須產生一對 PGP 金鑰，以便 Dataworks 開發團隊能加密他們的 Microsoft Entra ID 憑證。 公開金鑰必須傳送給 Dataworks 開發團隊以執行加密。
- PGP 金鑰對可用 GnuPG 產生。 可從以下連結下載： https://gpg4win.org/get-gpg4win.html
- 當 Dataworks 開發團隊設定好客戶端秘密後，金鑰會傳送給品牌。 一旦品牌取得金鑰，就可以進行解密。
- 更多細節將在入職流程中陸續公布。
開始使用連接器
請跟著 https://docs.microsoft.com/en-us/dynamics365/intelligent-order-management/work-providers#set-up-a-provider 啟用 FedEx 供應商並輸入客戶憑證。
已知問題與限制
此連接器專為 Dynamics 365 智慧訂單管理與 FedEx 供應商整合而開發。 對 Dynamics 365 Intelligent Order Management 以外的使用案例的支援將受到限制。
正在建立連線
連接器支援下列驗證類型：
| 預設值 | 建立連線的參數。 | 所有地區 | 不可共享 |
預設
適用：所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | 說明 | Required |
|---|---|---|---|
| 用戶端識別碼 | 字串 | FedEx Dataworks 客戶識別碼 | 對 |
| 用戶端密碼 | 安全字串 | FedEx Dataworks 客戶秘密 | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
| 觸發輪詢的頻率 | 1 | 15 秒 |
動作
| 依事件分類的公司 Webhook 訂閱 |
依事件為特定公司提供 Webhook 訂閱。 |
| 依事件刪除某家公司的 Webhook 訂閱 |
依事件刪除特定公司的 Webhook 訂閱。 |
| 依事件刪除特定公司的 Webhook 註冊 |
依事件刪除特定公司的 Webhook 註冊。 |
| 取得交通規劃分數 |
取得交通計畫分數。 |
| 取得預測性交付估算 |
取得預測性交付估算。 |
| 獲取特定公司 Webhook 訂閱名單的資訊 |
取得特定公司 Webhook 訂閱名單的資訊。 |
| 獲取特定公司按活動分類的 Webhook 註冊名單資訊 |
獲取特定公司按活動分類的 Webhook 註冊名單資訊。 |
| 驗證 Webhook 通知HMACSHA256簽章 |
驗證 Webhook 通知HMACSHA256簽名。 |
依事件分類的公司 Webhook 訂閱
依事件為特定公司提供 Webhook 訂閱。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
事件
|
event | True | string |
活動類型——EDD_CHANGED或EDTW_CHANGED。 |
|
註冊ID
|
registrationId | True | string |
WebhookID 是在註冊 webhook 時產生的。 |
|
回調網址
|
callbackUrl | string |
如果客戶端選擇覆蓋註冊時使用的回調 URL，則用來發送更新。 |
|
|
Key
|
key | True | string |
公司可追蹤其資訊的可行方式——trackingNumber。 |
|
values
|
values | True | array of string |
有興趣接收狀態更新的追蹤身分證。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
成功的
|
successful | boolean |
對或錯。 |
|
錯誤代碼
|
errorCode | string |
錯誤代碼。 |
|
errorMessage
|
errorMessage | string |
錯誤資訊。 |
|
subscriptionId
|
subscriptionId | array of string |
已插入訂閱 ID 列表。 |
依事件刪除某家公司的 Webhook 訂閱
依事件刪除特定公司的 Webhook 訂閱。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Subscripton Id
|
subscriptionId | True | string |
用 ID 下註刪除。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
成功的
|
successful | boolean |
對或錯。 |
|
錯誤代碼
|
errorCode | string |
錯誤代碼。 |
|
errorMessage
|
errorMessage | string |
錯誤資訊。 |
|
subscriptionId
|
subscriptionId | string |
已刪除訂閱 ID。 |
依事件刪除特定公司的 Webhook 註冊
依事件刪除特定公司的 Webhook 註冊。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
註冊編號
|
registrationId | string |
請使用註冊 ID 刪除。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
成功的
|
successful | boolean |
對或錯。 |
|
錯誤代碼
|
errorCode | string |
錯誤代碼。 |
|
errorMessage
|
errorMessage | string |
錯誤資訊。 |
取得交通規劃分數
取得交通計畫分數。
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
http狀態代碼
|
httpStatusCode | integer |
回應的 HTTP 狀態碼。 |
|
回應日期時間
|
data.responseDateTime | string |
回覆日期、時間。 |
|
交通計畫分數
|
data.transportationPlanScores | array of object |
交通計畫清單及分數。 |
|
planId
|
data.transportationPlanScores.planId | string |
計畫的唯一識別碼。 |
|
value
|
data.transportationPlanScores.score.value | string |
整數的序數升標。 |
|
信賴度
|
data.transportationPlanScores.score.confidence | string |
信心細節。 |
|
運送服務條件
|
data.transportationPlanScores.shipmentServiceConditions | array of object |
貨物配送服務條件。 |
|
shipmentID
|
data.transportationPlanScores.shipmentServiceConditions.shipmentId | string |
運送的唯一識別碼。 |
|
服務代碼
|
data.transportationPlanScores.shipmentServiceConditions.recommendedTransportationService.serviceCode | string |
運送服務代碼。 |
|
電訊廠商
|
data.transportationPlanScores.shipmentServiceConditions.recommendedTransportationService.carrier | string |
承運商資訊。 |
|
預計交付日期
|
data.transportationPlanScores.shipmentServiceConditions.recommendedTransportationService.estimatedDeliveryDate | string |
預計運送的交付日期。 |
|
results
|
results | array of object |
包含狀態的結果列表。 |
|
狀態
|
results.status | array of object | |
|
字碼
|
results.status.code | string |
錯誤或資訊代碼用於回應。 |
|
severity
|
results.status.severity | string |
回應中狀態的嚴重程度可能是錯誤/致命/資訊。 |
|
訊息
|
results.status.message | string |
描述上述程式碼的訊息。 |
|
路徑
|
results.status.path | string |
提供狀態欄位的路徑。 |
|
幫助網址
|
results.status.helpUrl | string |
關於程式碼和訊息的更多資訊網址。 |
|
建議重試分鐘
|
results.status.recommendedRetryMinutes | integer |
重試通話分鐘，該請求可再次嘗試。 |
|
版本
|
version | string |
API 的版本。 |
|
請求時間戳記
|
requestTimeStamp | string |
申請日期、時間。 |
取得預測性交付估算
取得預測性交付估算。
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
originofpackage
|
responsebody.originofpackage | string |
套件起源 |
|
destinationofpackage
|
responsebody.destinationofpackage | string |
包裹目的地 |
|
持有日期
|
responsebody.datetimeofpossession | string |
佔有日期 |
|
EDDS
|
responsebody.edds | array of object |
EDDS |
|
請求
|
responsebody.metadata.requestid | string |
請求 |
|
配對者身份
|
responsebody.metadata.shipperId | string |
貨主身份 |
獲取特定公司 Webhook 訂閱名單的資訊
取得特定公司 Webhook 訂閱名單的資訊。
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
成功的
|
successful | boolean |
對或錯。 |
|
錯誤代碼
|
errorCode | string |
錯誤代碼。 |
|
errorMessage
|
errorMessage | string |
錯誤資訊。 |
|
subscriptionId
|
subscriptionId | array of string |
已取得的訂閱 ID 列表。 |
獲取特定公司按活動分類的 Webhook 註冊名單資訊
獲取特定公司按活動分類的 Webhook 註冊名單資訊。
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
成功的
|
successful | boolean |
對或錯。 |
|
錯誤代碼
|
errorCode | string |
錯誤代碼。 |
|
errorMessage
|
errorMessage | string |
錯誤資訊。 |
|
events
|
events | array of object |
列出某家公司已報名參加的活動。 |
|
authUrl 的
|
events.authUrl | string |
客戶端的 OAuth2 授權端點。 |
|
回調網址
|
events.callbackUrl | string |
客戶端用於傳送更新的回撥網址。 |
|
callbackClientId
|
events.callbackClientId | string |
用戶端 ID 用於用戶端環境授權。 |
|
回調簽名演算法
|
events.callbackSignatureAlgorithm | string |
簽名演算法用於使用 hmac-sha256 產生此有效載荷的簽名。 |
|
註冊ID
|
events.registrationId | string |
一個能唯一識別特定登記的識別碼。 |
驗證 Webhook 通知HMACSHA256簽章
驗證 Webhook 通知HMACSHA256簽名。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
訊息簽章
|
MessageSignature | True | string |
訊息簽名來驗證。 |
|
秘密金鑰
|
SecretKey | True | string |
HMAC 的秘密金鑰。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
是有效
|
isValid | boolean |
是有效 |
觸發程序
| 依事件為特定公司註冊 Webhook |
Webhook 依事件註冊特定公司。 |
依事件為特定公司註冊 Webhook
Webhook 依事件註冊特定公司。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
事件
|
event | True | string |
活動類型——EDD_CHANGED或EDTW_CHANGED。 |
|
回撥簽名秘密金鑰
|
callbackSignatureSecretKey | True | string |
用戶端提供密碼以產生帶有回撥的簽名。 |
|
回撥AuthUrl
|
callbackAuthUrl | string |
客戶端的 OAuth2 授權端點。 |
|
|
callbackClientId
|
callbackClientId | string |
用戶端 ID 用於用戶端環境授權。 |
|
|
callbackClientSecret
|
callbackClientSecret | string |
用於用戶端環境授權的加密用戶端秘密。 |
|
|
回調簽名演算法
|
callbackSignatureAlgorithm | True | string |
簽名演算法用於使用 hmac-sha256 產生此有效載荷的簽名。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
ftm追蹤號碼
|
ftmTrackingNumber | string |
貨運識別碼。 |
|
ftm追蹤資格
|
ftmTrackingQualifier | string |
限定詞用於在營運公司內唯一識別該貨運。 |
|
ftm追蹤載體
|
ftmTrackingCarrier | string |
包裹承運人 OpCo。 |
|
edd時間
|
eddTime | string |
根據GDPP預測的預估交貨日期。 |
|
edd上文時間
|
eddPrevTime | string |
之前有EDD。 |
|
edd狀態
|
eddStatus | string |
提早、準時或延遲。 |
|
eddChanged
|
eddChanged | string |
標誌顯示EDD預測有所改變。 1 代表 EDD 已經變更。 |
|
eddDelaysRiskScore
|
eddDelaysRiskScore | string |
EDD風險分數，讓消費者能決定如何使用預測資訊。 |
|
eddDelayTypeCode
|
eddDelayTypeCode | string |
延遲原因代碼。 範例：OP – 運作，WE – 天氣。 |
|
edtw開始
|
edtwBegin | string |
預估交貨時間窗口開始。 |
|
edtwEnd
|
edtwEnd | string |
預估交貨時間窗口結束。 |
|
edtwPrev開始
|
edtwPrevBegin | string |
先前預估交付時間窗口開始價值。 |
|
edtwPrevEnd
|
edtwPrevEnd | string |
先前預估交貨時間窗期終值。 |
|
edtwChanged
|
edtwChanged | string |
這些標誌表示EDTW的預測已經改變。 1 代表 EDTW 已經變更。 |
|
edtw延遲風險分數
|
edtwDelaysRiskScore | string |
EDTW 風險分數用於下游消費者閾值。 |