FedEx Dataworks (versión preliminar)
FedEx Corp. proporciona a los clientes y empresas de todo el mundo una amplia cartera de servicios de transporte, comercio electrónico y negocios. Conéctese a la API del servicio de selección de transporte para recibir recomendaciones de clasificación y servicio en los planes de transporte.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Microsoft Dynamics |
| URL | https://aka.ms/iomsupport |
| Correo electrónico | iomdri@microsoft.com |
| Metadatos del conector | |
|---|---|
| Publicador | Microsoft |
| Sitio web | https://www.fedex.com/ |
| Directiva de privacidad | https://www.fedex.com/en-us/trust-center.html |
| Categorías | Comercio; Gestión empresarial |
El conector de FedEx Dataworks se ha desarrollado específicamente para su uso para la integración del proveedor de Dynamics 365 Intelligent Order Management.
Prerrequisitos
Póngase en contacto con FedEx para el proceso de incorporación.
Nota: Se recomienda usar este conector específicamente para configurar el proveedor fedEx de Administración inteligente de pedidos de Dynamics 365.
Obtención de credenciales
- Como parte del proceso de incorporación, cada marca será necesaria para generar un par de claves PGP para que el equipo de desarrollo de Dataworks pueda cifrar sus credenciales de Id. de Microsoft Entra. La clave pública debe enviarse al equipo de desarrollo de Dataworks para realizar el cifrado.
- El par de claves PGP se puede generar mediante GnuPG. Se puede descargar desde el vínculo especificado: https://gpg4win.org/get-gpg4win.html
- Una vez que el equipo de desarrollo de Dataworks aprovisione el secreto de cliente, la clave se enviará a la marca. Una vez que la marca está en posesión de la clave, se puede descifrar.
- Se compartirán detalles adicionales como parte del proceso de incorporación.
Introducción al conector
Siga https://docs.microsoft.com/en-us/dynamics365/intelligent-order-management/work-providers#set-up-a-provider para habilitar el proveedor de FedEx con las credenciales de cliente.
Problemas y limitaciones conocidos
Este conector se ha desarrollado específicamente para su uso en la integración del proveedor FedEx de Dynamics 365 Intelligent Order Management. La compatibilidad con casos de uso fuera de Dynamics 365 Intelligent Order Management se limitará.
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
| Nombre | Tipo | Descripción | Obligatorio |
|---|---|---|---|
| Id de cliente | cuerda / cadena | Identificador de cliente de FedEx Dataworks | Cierto |
| Secreto del cliente | securestring | Secreto de cliente de FedEx Dataworks | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
| Frecuencia de sondeos de desencadenador | 1 | 15 segundos |
Acciones
| Eliminación de una suscripción de webhook para una empresa determinada por evento |
Elimine la suscripción de Webhook para una empresa determinada por evento. |
| Eliminación del registro de webhook para una empresa determinada por evento |
Elimine el registro de webhook para una empresa determinada por evento. |
| Obtener estimaciones de entrega predictiva |
Obtener estimaciones de entrega predictiva. |
| Obtener información sobre la lista de registros de webhook por evento para una empresa determinada |
Obtenga información sobre la lista de registros de webhook por evento para una empresa determinada. |
| Obtener información sobre la lista de suscripciones de Webhook para una empresa determinada |
Obtenga información sobre la lista de suscripciones de Webhook para una empresa determinada. |
| Obtener puntuaciones del plan de transporte |
Obtener puntuaciones del plan de transporte. |
| Suscripción de webhook para una empresa determinada por evento |
Suscripción de webhook para una empresa determinada por evento. |
| Validar la firma de notificación de webhook HMACSHA256 |
Valide la notificación de webhook HMACSHA256 firma. |
Eliminación de una suscripción de webhook para una empresa determinada por evento
Elimine la suscripción de Webhook para una empresa determinada por evento.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de subíndice
|
subscriptionId | True | string |
Identificador de subíndice que se va a eliminar. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Exitoso
|
successful | boolean |
Verdadero o Falso. |
|
código de error
|
errorCode | string |
Código de error. |
|
errorMessage
|
errorMessage | string |
Mensaje de error. |
|
ID de suscripción
|
subscriptionId | string |
Identificador de suscripción eliminado. |
Eliminación del registro de webhook para una empresa determinada por evento
Elimine el registro de webhook para una empresa determinada por evento.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de registro
|
registrationId | string |
Id. de registro que se va a eliminar. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Exitoso
|
successful | boolean |
Verdadero o Falso. |
|
código de error
|
errorCode | string |
Código de error. |
|
errorMessage
|
errorMessage | string |
Mensaje de error. |
Obtener estimaciones de entrega predictiva
Obtener estimaciones de entrega predictiva.
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
originofpackage
|
responsebody.originofpackage | string |
Origen del paquete |
|
destinationofpackage
|
responsebody.destinationofpackage | string |
Destino del paquete |
|
datetimeofpossession
|
responsebody.datetimeofpossession | string |
Fecha y hora de posesión |
|
edds
|
responsebody.edds | array of object |
edds |
|
requestid
|
responsebody.metadata.requestid | string |
Requestid |
|
shipperId
|
responsebody.metadata.shipperId | string |
ShipperId |
Obtener información sobre la lista de registros de webhook por evento para una empresa determinada
Obtenga información sobre la lista de registros de webhook por evento para una empresa determinada.
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Exitoso
|
successful | boolean |
Verdadero o Falso. |
|
código de error
|
errorCode | string |
Código de error. |
|
errorMessage
|
errorMessage | string |
Mensaje de error. |
|
events
|
events | array of object |
Enumerar eventos para los que una empresa determinada se ha registrado. |
|
authUrl
|
events.authUrl | string |
Punto de conexión de autorización de OAuth2 del cliente. |
|
callbackUrl
|
events.callbackUrl | string |
Dirección URL de devolución de llamada del cliente usada para enviar actualizaciones. |
|
callbackClientId
|
events.callbackClientId | string |
Identificador de cliente usado para la autorización del entorno de cliente. |
|
callbackSignatureAlgorithm
|
events.callbackSignatureAlgorithm | string |
La firma algorithim se usa para generar la firma de esta carga mediante hmac-sha256. |
|
ID de registro
|
events.registrationId | string |
Identificador que identifica de forma única el registro especificado. |
Obtener información sobre la lista de suscripciones de Webhook para una empresa determinada
Obtenga información sobre la lista de suscripciones de Webhook para una empresa determinada.
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Exitoso
|
successful | boolean |
Verdadero o Falso. |
|
código de error
|
errorCode | string |
Código de error. |
|
errorMessage
|
errorMessage | string |
Mensaje de error. |
|
ID de suscripción
|
subscriptionId | array of string |
Lista de identificadores de suscripción capturados. |
Obtener puntuaciones del plan de transporte
Obtener puntuaciones del plan de transporte.
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
código de estado HTTP
|
httpStatusCode | integer |
Código de estado HTTP de la respuesta. |
|
responseDateTime
|
data.responseDateTime | string |
Fecha y hora de respuesta. |
|
transportPlanScores
|
data.transportationPlanScores | array of object |
Lista de planes de transporte con puntuaciones. |
|
planId
|
data.transportationPlanScores.planId | string |
Identificador único del plan. |
|
value
|
data.transportationPlanScores.score.value | string |
Escala ordinal ascendente de enteros. |
|
confidence
|
data.transportationPlanScores.score.confidence | string |
Detalles de confianza. |
|
shipmentServiceConditions
|
data.transportationPlanScores.shipmentServiceConditions | array of object |
Condiciones del servicio de entrega de envíos. |
|
shipmentId
|
data.transportationPlanScores.shipmentServiceConditions.shipmentId | string |
Identificador único del envío. |
|
serviceCode
|
data.transportationPlanScores.shipmentServiceConditions.recommendedTransportationService.serviceCode | string |
Código de servicio para la entrega del envío. |
|
carrier
|
data.transportationPlanScores.shipmentServiceConditions.recommendedTransportationService.carrier | string |
Información del operador. |
|
estimatedDeliveryDate
|
data.transportationPlanScores.shipmentServiceConditions.recommendedTransportationService.estimatedDeliveryDate | string |
Fecha estimada de entrega del envío. |
|
results
|
results | array of object |
Lista de resultados que contienen el estado. |
|
estado
|
results.status | array of object | |
|
código
|
results.status.code | string |
Código informativo o de error para respuestas. |
|
severity
|
results.status.severity | string |
La gravedad del estado en respuesta puede ser ERROR/FATAL/INFO. |
|
Mensaje
|
results.status.message | string |
Mensaje que describe el código anterior. |
|
ruta
|
results.status.path | string |
Ruta de acceso del campo para el que se proporciona el estado. |
|
helpUrl
|
results.status.helpUrl | string |
Dirección URL para obtener más información sobre el código y el mensaje. |
|
recommendedRetryMinutes
|
results.status.recommendedRetryMinutes | integer |
Vuelva a intentar minutos para los que se puede volver a intentar la misma solicitud. |
|
versión
|
version | string |
Versión de la API. |
|
requestTimeStamp
|
requestTimeStamp | string |
Fecha y hora de la solicitud. |
Suscripción de webhook para una empresa determinada por evento
Suscripción de webhook para una empresa determinada por evento.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
evento
|
event | True | string |
Tipo de evento: EDD_CHANGED o EDTW_CHANGED. |
|
ID de registro
|
registrationId | True | string |
WebhookId generado al registrarse para el webhook. |
|
callbackUrl
|
callbackUrl | string |
La dirección URL de devolución de llamada del cliente que se usa para enviar actualizaciones si decide invalidar las usadas en el registro. |
|
|
clave
|
key | True | string |
Formas permitidas en las que una empresa podría realizar un seguimiento de su información: trackingNumber. |
|
values
|
values | True | array of string |
Identificadores de seguimiento interesados en recibir actualizaciones de estado. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Exitoso
|
successful | boolean |
Verdadero o Falso. |
|
código de error
|
errorCode | string |
Código de error. |
|
errorMessage
|
errorMessage | string |
Mensaje de error. |
|
ID de suscripción
|
subscriptionId | array of string |
Lista de identificadores de suscripción insertados. |
Validar la firma de notificación de webhook HMACSHA256
Valide la notificación de webhook HMACSHA256 firma.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Firma de mensaje
|
MessageSignature | True | string |
Firma de mensaje con la que se va a validar. |
|
Clave secreta
|
SecretKey | True | string |
Clave secreta para HMAC. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
esVálido
|
isValid | boolean |
esVálido |
Desencadenadores
| Registro de webhook para una empresa determinada por evento |
Registro de webhook para una empresa determinada por evento. |
Registro de webhook para una empresa determinada por evento
Registro de webhook para una empresa determinada por evento.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
evento
|
event | True | string |
Tipo de evento: EDD_CHANGED o EDTW_CHANGED. |
|
callbackSignatureSecretKey
|
callbackSignatureSecretKey | True | string |
El cliente proporciona el secreto para generar la firma con la devolución de llamada. |
|
callbackAuthUrl
|
callbackAuthUrl | string |
Punto de conexión de autorización de OAuth2 del cliente. |
|
|
callbackClientId
|
callbackClientId | string |
Identificador de cliente usado para la autorización del entorno de cliente. |
|
|
callbackClientSecret
|
callbackClientSecret | string |
Secreto del cliente cifrado usado para la autorización del entorno de cliente. |
|
|
callbackSignatureAlgorithm
|
callbackSignatureAlgorithm | True | string |
La firma algorithim se usa para generar la firma de esta carga mediante hmac-sha256. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
ftmTrackingNumber
|
ftmTrackingNumber | string |
Identificador de envío. |
|
ftmTrackingQualifier
|
ftmTrackingQualifier | string |
El calificador se usa para identificar de forma única el envío dentro de OpCo. |
|
ftmTrackingCarrier
|
ftmTrackingCarrier | string |
Operador de paquetes OpCo. |
|
eddTime
|
eddTime | string |
Predicción de fecha de entrega estimada del PIBP. |
|
eddPrevTime
|
eddPrevTime | string |
EDD anterior. |
|
eddStatus
|
eddStatus | string |
EARLY o ONTIME o DELAYED. |
|
eddChanged
|
eddChanged | string |
Marca que indica que ha cambiado la predicción de EDD. 1 representa que ha habido un cambio en EDD. |
|
eddDelaysRiskScore
|
eddDelaysRiskScore | string |
Puntuación de riesgo de EDD que permite a los consumidores tomar decisiones sobre cómo usar la información de predicción. |
|
eddDelayTypeCode
|
eddDelayTypeCode | string |
Retrasar el código de motivo. Op de ejemplo: operativo, WE – Tiempo. |
|
edtwBegin
|
edtwBegin | string |
Comienzo del período de tiempo de entrega estimado. |
|
edtwEnd
|
edtwEnd | string |
Fin del período de tiempo de entrega estimado. |
|
edtwPrevBegin
|
edtwPrevBegin | string |
Valor inicial de la ventana de tiempo de entrega estimado anterior. |
|
edtwPrevEnd
|
edtwPrevEnd | string |
Valor final de período de entrega estimado anterior. |
|
edtwChanged
|
edtwChanged | string |
Marca que indica que ha cambiado la predicción de EDTW. 1 representa que ha habido un cambio de EDTW. |
|
edtwDelaysRiskScore
|
edtwDelaysRiskScore | string |
Puntuación de riesgos de EDTW para el umbral de consumidor descendente. |