通过

FedEx Dataworks （预览版）

FedEx Corp.为世界各地的客户和企业提供了广泛的运输、电子商务和商业服务组合。 连接到运输选择服务 API，接收有关运输计划的排名和服务建议。

此连接器在以下产品和区域中可用：

Service Class 区域
逻辑应用程序 标准 除以下各项外的所有 逻辑应用区域 ：
     - Azure Government区域
     - Azure中国区域
     - 美国国防部（DoD）
联系人
名称 Microsoft Dynamics
URL https://aka.ms/iomsupport
Email iomdri@microsoft.com
连接器元数据
发布者 Microsoft
网站 https://www.fedex.com/
隐私策略 https://www.fedex.com/en-us/trust-center.html
类别 商业;业务管理

FedEx Dataworks 连接器已专门开发，用于 Dynamics 365 Intelligent Order Management 的提供程序集成。

先决条件

请联系 FedEx 进行载入过程。

注意：建议专门使用此连接器来设置 Dynamics 365 智能订单管理 FedEx 提供程序。

如何获取凭据

  • 作为载入过程的一部分，每个品牌都需要生成 PGP 密钥对，以便 Dataworks 开发团队可以加密其Microsoft Entra ID 凭据。 公钥必须发送到 Dataworks 开发团队才能执行加密。
  • 可以使用 GnuPG 生成 PGP 密钥对。 可以从给定的链接下载它： 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 Intelligent Order Management 的 FedEx Provider 集成而开发。 对 Dynamics 365 智能订单管理之外的用例的支持将受到限制。

正在创建连接

连接器支持以下身份验证类型：
默认 用于创建连接的参数。 所有区域 不可共享

违约

适用：所有区域

用于创建连接的参数。

这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

名称 类型 说明 必需
客户端 ID 字符串 FedEx Dataworks 客户端 ID 真 实
客户端密码 securestring FedEx Dataworks 客户端密码 真 实

限制

名称 调用 续订期
每个连接的 API 调用数 100 60 秒
触发器轮询的频率 1 15 秒

操作

按事件为给定公司的 Webhook 订阅

按事件为给定公司的 Webhook 订阅。
按事件删除给定公司的 Webhook 注册

按事件删除给定公司的 Webhook 注册。
按事件删除给定公司的 Webhook 订阅

按事件删除给定公司的 Webhook 订阅。
按给定公司的事件获取有关 Webhook 注册列表的信息

按给定公司的事件获取有关 Webhook 注册列表的信息。
获取有关给定公司的 Webhook 订阅列表的信息

获取有关给定公司的 Webhook 订阅列表的信息。
获取运输计划分数

获取运输计划分数。
获取预测传递估计值

获取预测传递估计值。
验证 Webhook 通知HMACSHA256签名

验证 Webhook 通知HMACSHA256签名。

按事件为给定公司的 Webhook 订阅

操作 ID:
PostCompanySubscription

按事件为给定公司的 Webhook 订阅。

参数

名称 密钥 必需 类型 说明
事件
 event True string

事件EDD_CHANGED或EDTW_CHANGED的类型。
注册ID
 registrationId True string

注册 Webhook 时生成的 WebhookId。
回调网址
 callbackUrl string

客户端的回调 URL，用于发送更新（如果选择替代注册中使用的更新）。
关键值
 key True string

允许公司跟踪其信息的方式 - trackingNumber。
values
 values True array of string

跟踪有兴趣接收状态更新的 ID。

返回

名称 路径 类型 说明
成功
 successful boolean

对或错。
错误代码
 errorCode string

错误代码。
errorMessage
 errorMessage string

错误信息。
订阅编号
 subscriptionId array of string

插入的订阅 ID 列表。

按事件删除给定公司的 Webhook 注册

操作 ID:
DeleteCompanyRegistration

按事件删除给定公司的 Webhook 注册。

参数

名称 密钥 必需 类型 说明
注册 ID
 registrationId string

要删除的注册 ID。

返回

名称 路径 类型 说明
成功
 successful boolean

对或错。
错误代码
 errorCode string

错误代码。
errorMessage
 errorMessage string

错误信息。

按事件删除给定公司的 Webhook 订阅

操作 ID:
DeleteCompanySubscription

按事件删除给定公司的 Webhook 订阅。

参数

名称 密钥 必需 类型 说明
下标 ID
 subscriptionId True string

要删除的下标 ID。

返回

名称 路径 类型 说明
成功
 successful boolean

对或错。
错误代码
 errorCode string

错误代码。
errorMessage
 errorMessage string

错误信息。
订阅编号
 subscriptionId string

已删除的订阅 ID。

按给定公司的事件获取有关 Webhook 注册列表的信息

操作 ID:
GetCompanyRegistrations

按给定公司的事件获取有关 Webhook 注册列表的信息。

返回

名称 路径 类型 说明
成功
 successful boolean

对或错。
错误代码
 errorCode string

错误代码。
errorMessage
 errorMessage string

错误信息。
活动
 events array of object

列出给定公司注册的事件。
authUrl 的
 events.authUrl string

客户端的 OAuth2 授权终结点。
回调网址
 events.callbackUrl string

用于发送更新的客户端回调 URL。
callbackClientId
 events.callbackClientId string

用于客户端环境授权的客户端 ID。
callbackSignatureAlgorithm
 events.callbackSignatureAlgorithm string

签名 algorithim 用于使用 hmac-sha256 生成此有效负载的签名。
注册ID
 events.registrationId string

唯一标识给定注册的标识符。

获取有关给定公司的 Webhook 订阅列表的信息

操作 ID:
GetCompanySubscriptions

获取有关给定公司的 Webhook 订阅列表的信息。

返回

名称 路径 类型 说明
成功
 successful boolean

对或错。
错误代码
 errorCode string

错误代码。
errorMessage
 errorMessage string

错误信息。
订阅编号
 subscriptionId array of string

提取的订阅 ID 列表。

获取运输计划分数

操作 ID:
GetTransportationPlanScores

获取运输计划分数。

返回

名称 路径 类型 说明
HTTP状态代码 (httpStatusCode)
 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
 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

请求的日期时间。

获取预测传递估计值

操作 ID:
GetPredictiveDeliveryEstimates

获取预测传递估计值。

返回

名称 路径 类型 说明
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

验证 Webhook 通知HMACSHA256签名

操作 ID:
ValidateWebhookNotificationSignature

验证 Webhook 通知HMACSHA256签名。

参数

名称 密钥 必需 类型 说明
消息签名
 MessageSignature True string

要验证的消息签名。
密钥
 SecretKey True string

HMAC 的密钥。

返回

名称 路径 类型 说明
isValid
 isValid boolean

isValid

触发器

按事件为给定公司的 Webhook 注册

按事件为给定公司的 Webhook 注册。

按事件为给定公司的 Webhook 注册

操作 ID:
PostCompanyRegistration

按事件为给定公司的 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

早期或 ONTIME 或延迟。
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 风险分数。