Fedex Logo

CREAR UN
WEBHOOK GESTIONAR WEBHOOKS

Reglas comerciales y proceso de validación


  • Un número de cuenta de envío no se puede utilizar en varias visibilidades integradas avanzadas.
  • La URL de destino/punto final creado por el cliente debe:
    • Ser un host HTTP.
    • Responder a solicitudes POST y analizar cargas JSON.
    • Límite de 200 caracteres
    • Tu URL será bloqueada si incluye:
      • Aquellos con espacio IP RFC1918
      • fedex.com o cualquiera de sus subdominios
      • Direcciones IP en el URL (incluido el localhost, 127.0.0.1)

 

  • Seguridad de la visibilidad integrada avanzada: solo se admiten conexiones HTTPS que utilicen TLS (SSL) 1.2 o versiones superiores del protocolo configuradas con un certificado de una autoridad certificadora (CA) válida y compatible. Permite el acceso a las siguientes direcciones IP para recibir actualizaciones de los servidores de FedEx sin interrupciones:
    Prod

         Los clientes pueden incluir en la lista blanca: «nat.fxconnect.eastus2.heap-prod.fedex.io»

         Uso de CIDR «20.65.16.22/31»
  • En ocasiones, los clientes pueden recibir las actualizaciones del evento de rastreo fuera de orden y deben consultar la marca de tiempo del evento de escaneo para ver el orden correcto.
  • Eliminar cuentas en FedEx Developer Portal:
    • El usuario/cliente no puede eliminar la(s) cuenta(s) en los siguientes casos:
      1. Si está asociada con alguna visibilidad integrada avanzada activa.
      2. Si la cuenta está disponible o asociada a un proyecto, y
      3. Si es la única cuenta en un proyecto/visibilidad integrada avanzada.
        Nota: el usuario/cliente primero debe eliminar la cuenta del proyecto/visibilidad integrada avanzada y luego, eliminarla de la organización.
    • El usuario/cliente puede eliminar la(s) cuenta(s) en los siguientes casos:
      1. La cuenta debe pertenecer a la misma organización.
      2. El usuario/cliente debe ser administrador para eliminar cuentas de la organización.

Restricciones comunes

  • Todos los envíos de clientes asociados con los números de cuenta FedEx de nueve dígitos de las compañías operativas: FedEx Express®, FedEx Ground® y FedEx Ground® Economy (anteriormente conocido como FedEx SmartPost®) están dentro del alcance independientemente del destino u origen (entrante, saliente, internacional, doméstico, etc.).
  • El webhook de visibilidad integrada avanzada solo admite cuentas habilitadas de nueve dígitos para paquetes o de empresas. Las cuentas de empresas permiten la creación de envíos asociados con todas las compañías operativas de FedEx, incluidas FedEx Express y FedEx Ground.

    • Nota: no se admiten cuentas de solo carga inferior a una camionada (LTL) de nueve dígitos. Si deseas agregar una cuenta de carga LTL, debes comunicarte con el servicio de atención al cliente para transferir una carga LTL a una cuenta empresarial.
  • Los clientes deben gestionar por su parte el orden de los eventos de rastreo de envíos recibidos.
  • Se envían notificaciones automáticas por correo electrónico cada vez que hay alguna actividad (guardada/fallida/crear/actualizar/cancelar/eliminar) en el webhook de visibilidad integrada avanzada suscrito.
  • Traducciones:
    • Las traducciones de la carga útil de rastreo se admiten en 41 idiomas (con configuraciones regionales).(Próximamente)
      Haz clic aquí para ver la lista de idiomas admitidos.
    • Actualmente, la traducción de la carga útil de rastreo se admite en inglés (Estados Unidos).
    • La traducción de notificaciones por correo electrónico está disponible solo para los idiomas admitidos en las regiones de EE. UU. (configuraciones regionales: inglés-EE. UU., español-EE. UU.).

 


Funciones de FedEx Developer Portal:


Dentro del FedEx Developer Portal, puedes realizar funciones específicas según el rol configurado.
Para obtener más información sobre el FedEx Developer Portal, consulta la Guía de administración de organizaciones.

Proceso de validación de la visibilidad integrada avanzada

¿Qué es MAC/HMAC y cómo se utiliza en el proceso de validación?

Un código de autenticación de mensajes (MAC) proporciona una manera de verificar la integridad de la información transmitida o almacenada en un medio no confiable, basándose en una clave secreta. Normalmente, los MAC se utilizan entre dos partes que comparten una clave secreta para validar la información transmitida entre las dos partes.

Un mecanismo MAC que se basa en funciones hash criptográficas se denomina HMAC. HMAC se puede utilizar con cualquier función hash criptográfica, por ejemplo, SHA256, en combinación con una clave secreta compartida. HMAC se especifica en RFC 2104. El webhook de visibilidad integrada avanzada de FedEx usará HMAC SHA256.

SHA256 (token de seguridad + carga) = firma fdx codificada en base 64 como parte del encabezado de carga

Ejemplo (de un fragmento de pseudocódigo para ilustrar un hash HMAC SHA256):

  • Primero, inicia MAC usando el algoritmo HmacSHA256 y el token de seguridad como clave secreta.
  • Luego, finaliza la operación MAC codificando hexadecimalmente la carga útil de la solicitud enviada por FedEx.
  • Este hash final debe coincidir con el valor del encabezado fdx-signature en el PUSH enviado por FedEx.

Mac mac = Mac.getInstance("HmacSHA256"); 

mac.init(new SecretKeySpec(secureToken.getBytes(), "HmacSHA256")); 

return new String(Base 64 encoded(mac.doFinal(payLoad.getBytes()))); 

Nota: La clave secreta utilizada es el token seguro que proporcionarás al configurar la visibilidad integrada avanzada o al probar la URL de la visibilidad integrada avanzada.

 

Cálculo de latencia

 

La hora de creación del evento indica cuándo ocurrió realmente el evento en la red.
Hasta que el evento se registre en el sistema (indicado por la marca de tiempo de creación del mensaje), ni los webhooks ni ningún otro sistema pueden procesarlo o entregarlo.

Recomendación

Los clientes deben usar la marca de tiempo de creación del mensaje para medir la latencia, ya que representa mejor el momento en que el evento estuvo disponible para los sistemas digitales. Esta marca de tiempo coincide casi exactamente con el momento en que FedEx publica sus actualizaciones digitales y suele ser más rápida que las actualizaciones que se ven en fedex.com, o suele estar muy alineada con ellas.

 

Reglas de validación: 

  • El nombre del webhook de visibilidad integrada avanzada debe ser único.
  • La URL de destino del webhook de visibilidad integrada avanzada debe estar en formato sintáctico estandarizado.
  • Ninguno de los campos obligatorios para crear un webhook de visibilidad integrada avanzada debe estar vacío.
  • Se debe asociar al menos un número de cuenta de envío de FedEx disponible para crear un webhook de visibilidad integrada avanzada.
  • Para una validación exitosa:
    • Cuando un webhook  de visibilidad integrada avanzada se crea correctamente, el cliente recibirá un mensaje de confirmación.

      Ejemplo de mensaje de confirmación: <<nombre del webhook de visibilidad integrada avanzada>> se creó correctamente. Los cambios pueden tardar hasta 10 minutos en verse reflejados.

  • Para validación fallida:
    • Si FedEx recibe una respuesta distinta de 200 (BIEN) o 202 (Aceptado), la validación de la URL de destino del webhook de visibilidad integrada avanzada se considerará fallida.

Ejemplos de reglas comerciales y proceso de validación


  • Un número de cuenta de envío no se puede utilizar en varias visibilidades integradas avanzadas.
  • La URL de destino/punto final creado por el cliente debe:
    • Ser un host HTTP.
    • Responder a solicitudes POST y analizar cargas JSON.
    • Límite de 200 caracteres
    • Tu URL será bloqueada si incluye:
      • Aquellos con espacio IP RFC1918
      • fedex.com o cualquiera de sus subdominios
      • Direcciones IP en el URL (incluido el localhost, 127.0.0.1)

 

  • Seguridad de la visibilidad integrada avanzada: solo se admiten conexiones HTTPS que utilicen TLS (SSL) 1.2 o versiones superiores del protocolo configuradas con un certificado de una autoridad certificadora (CA) válida y compatible. Permite el acceso a las siguientes direcciones IP para recibir actualizaciones de los servidores de FedEx sin interrupciones:
    Prod

         Los clientes pueden incluir en la lista blanca: «nat.fxconnect.eastus2.heap-prod.fedex.io»

         Uso de CIDR «20.65.16.22/31»
  • En ocasiones, los clientes pueden recibir las actualizaciones del evento de rastreo fuera de orden y deben consultar la marca de tiempo del evento de escaneo para ver el orden correcto.
  • Eliminar cuentas en FedEx Developer Portal:
    • El usuario/cliente no puede eliminar la(s) cuenta(s) en los siguientes casos:
      1. Si está asociada con alguna visibilidad integrada avanzada activa.
      2. Si la cuenta está disponible o asociada a un proyecto, y
      3. Si es la única cuenta en un proyecto/visibilidad integrada avanzada.
        Nota: el usuario/cliente primero debe eliminar la cuenta del proyecto/visibilidad integrada avanzada y luego, eliminarla de la organización.
    • El usuario/cliente puede eliminar la(s) cuenta(s) en los siguientes casos:
      1. La cuenta debe pertenecer a la misma organización.
      2. El usuario/cliente debe ser administrador para eliminar cuentas de la organización.
CLOSE

Response

Copy