Fedex Logo

CREAR UN
WEBHOOK GESTIONAR WEBHOOKS

Prueba de webhook


Puedes usar la función Probar URL del webhook para probar el tipo de datos de rastreo arrojados a la URL de destino (servidor destinatario/intérprete). Esto ayuda a validar la URL y los datos arrojados antes de crear un webhook de visibilidad integrada avanzada.

Navegación:

A continuación, se detallan las formas de navegar a la URL de prueba del webhook de la Consola Sandbox:

  • Mis proyectos (en el panel de navegación izquierdo) -> pestaña de Visibilidad integrada avanzada -> botón Probar la URL del  webhook ->en la Consola Sandbox, haz clic en Probar esta visibilidad integrada avanzada
  • Catálogo de la API (en el panel de navegación izquierdo) -> busca Visibilidad integrada avanzada/haz clic en visibilidad integrada avanzada en FILTROS -> tarjeta de visibilidad integrada avanzada:
    1. -> Descripción general -> botón de Documentación -> en la Consola Sandbox, haz clic en Probar esta visibilidad integrada avanzada.
    2. -> Documentación -> en la Consola Sandbox, haz clic en Probar esta visibilidad integrada avanzada.

Pasos:

A continuación, se indican los pasos para utilizar la funcionalidad Probar URL del webhook:

  1. Haz clic en el botón Probar URL del webhook.
  2. Ingresa los siguientes parámetros de prueba:
    Nombre del campo Descripción

    URL de destino

    Esta es la URL para recibir los datos/carga útil del evento de rastreo.

    • El cliente debe proporcionar una URL de destino válida y que funcione.
    • La URL de destino proporcionada debe tener el formato sintáctico estandarizado (URL https segura).

    Token de seguridad

    Se usa como un secreto compartido para autenticar y validar la respuesta de la visibilidad integrada avanzada del webhook.

    • El valor del token debe tener entre una longitud mínima de 26 caracteres y una máxima de 100 caracteres.
    • Se debe incluir al menos 1 mayúscula, 1 minúscula y 1 carácter numérico.
    • El token de seguridad se usará para crear un hash basado en la firma del código de autenticación de mensajes (HMAC) para la validación de la respuesta.

    Idioma de carga

    Selecciona tu idioma de preferencia para tus traducciones de datos de rastreo en la lista desplegable. A continuación se indican los 6 idiomas de muestra disponibles:

    • Inglés (Estados Unidos)(Predeterminado)

    Tipo de rastreo

    Selecciona el tipo de respuesta en la que deben recibirse los datos de rastreo.

    • Respuesta de rastreo detallada (la respuesta de rastreo detallada consiste en datos de rastreo seguros con un historial de eventos completo).(Predeterminado)
    • Respuesta de rastreo por evento específico (este tipo de respuesta consiste en datos de rastreo seguros solo con la información del evento más reciente).(Próximamente)

    Rastreo de eventos

    Selecciona una categoría de nivel superior para recibir notificaciones por correo electrónico relacionadas con eventos de envío en el ciclo de vida del paquete. Las siguientes son las categorías de nivel superior:

    • Envío
    • En tránsito
    • Entrega
    • Excepciones
    • Entrega estimada

    Estado del evento

    Un evento de rastreo en el ciclo de vida del paquete. Selecciona uno de los eventos de rastreo que se recibirán. A continuación se indican los 10 eventos de estado de muestra disponibles:

    1. Recogido
    2. En tránsito
    3. Entregados
    4. Excepción de entrega

     

    Nota: Los valores del campo “Evento de estado” se completarán según la “Categoría de evento de rastreo” seleccionada. Consulta la siguiente tabla para obtener más información sobre la “Categoría de evento de rastreo” y sus respectivos “Eventos de estado”.

     

    Categoría del estado del evento Estado del evento

    Envío
    • Recogido

    En tránsito
    • En tránsito

    Entrega
    • Entregados

    Excepciones
    • Excepción de entrega

    Entrega estimada(Próximamente)
    • Fecha de la entrega estimada (EDD)
    • Horario de entrega estimado (EDTW)

     

  3. Marca la casilla Acuerdo de licencia del FedEx Developer Portal (FDPLA) para firmar/aceptar el acuerdo de licencia.
  4. Haz clic en el botón PUSH para ver los resultados de la prueba.


Respuesta:

Los siguientes son los parámetros de respuesta en Sandbox:

  • Cuerpo: El cuerpo contiene los parámetros de respuesta en la pestaña Probar URL del webhook dentro de la Consola Sandbox.
  • Estado: Esta sección en la pestaña Resultado de prueba le proporciona el estado de la solicitud que se procesa.

    • Ejemplo de mensaje de éxito:
    Éxito
    Los detalles del evento de rastreo de la visibilidad integrada avanzada de prueba se entregaron correctamente.

 

Sandbox Console

Test Parameters

Add in test parameters and push to check if the URL receives test event data from Webhooks API calls.

The destination URL is where we will send you authentication codes and messages as well as Advanced Integrated Visibility payload notifications. Only HTTPS connections using TLS (SSL) 1.2 or higher protocol version that is configured with a certificate from a valid certificate authority is supported. (Character limit: 200)

The following are not valid destination URLs:
• All RFC1918 IP space<br>
• All fedex.com and its sub domain<br>
• IP addresses in the URL (including localhost, 127.0.0.1)

Security Token should be a minimum length of 25 characters and a maximum length of 100 characters, 1 upper case, 1 lower case, 1 numeric character.

Example: Y1F6OiVUQW2JPSElmRE9U0IY5

Payload languageThe language in which you will receive the tracking data. Currently payload language is only available in English
View a full list of languages

Currently detailed tracking is the only available tracking type.

Detailed Tracking
Detailed Tracking Response consists of secured data with the entire history of events.

Event-specific Tracking (coming soon)
Event-specific Tracking Response consists of secure tracking data with only the most recent event information.

Tracking event
These are different categories of tracking events in the shipment life cycle. select one or more of these categories. Then when an event in that category happens, we will trigger webhook notifications and send you a tracking payload response.

Select a tracking event in the package lifecycle to include

Copy copied

Status

Success

Test webhook tracking event details delivered successfully

Error

Test webhook tracking event details delivery failed

Ejemplo de mensaje de éxito

Si falla la entrega del evento de prueba, el ESTADO se mostrará como Error en la pestaña Resultados de prueba con el código de error y el mensaje de error correspondientes.

Ejemplo de mensaje de error:
Código de error: <<código de error>>
La entrega de los detalles del evento de rastreo de la visibilidad integrada avanzada de prueba falló.

Ejemplo de mensaje de error

Reglas de validación:

  • La URL de la visibilidad integrada avanzada debe estar en formato sintáctico estandarizado.
  • Ninguno de los campos obligatorios para probar una URL de la visibilidad integrada avanzada deben estar vacíos.
  • Para una validación exitosa:
    • FedEx enviará una solicitud con un evento de muestra JSON.
      • Nota: La URL de destino de la visibilidad integrada avanzada debe responder con 200 (BIEN) como código de estado HTTP para FedEx.
  • Para validación fallida:
    • Si FedEx recibe una respuesta distinta a 200 (BIEN), la validación de la URL de destino de la visibilidad integrada avanzada se considerará fallida.
    • FedEx mostrará el código de error y el mensaje de error en la pestaña Resultados de prueba.

Calculadora de carga de datos

La calculadora de datos de carga está diseñada para ayudar a los suscriptores a estimar el volumen de los datos generados a través de la actividad del webhook. Brinda visibilidad sobre los tamaños de carga diarios, conteo de envíos y eventos de rastreo, ayudando así a los usuarios a tomar decisiones informadas sobre el uso de los datos y para planificar la integración.

Cómo usar la calculadora

Los usuarios pueden ingresar los siguientes parámetros:

  • Número de envíos
  • Eventos por envío (valor predeterminado: 5)
  • Volumen de carga diaria (calculado automáticamente)

Con base en estos datos, la calculadora muestra lo siguiente de manera dinámica:

  •  Total de eventos de rastreo
  •  Carga diaria
  •  Tamaño total estimado de datos

Notas informativas:

  •  Los eventos por envío tienen un valor predeterminado de 5. Esto se basa en un promedio de 17 a 18 eventos por envío y los plazos de entrega típicos de entre uno a siete días, dependiendo del tipo de servicio, transportista y destino. Se asume que el tiempo de entrega promedio es de tres días. Nota: Este valor puede ser editado por el usuario.
  •  El volumen de carga diaria se calcula como: número de envíos x eventos por envío (valor predeterminado: 5)
  •  Los usuarios solo deben ingresar el número de envíos y hacer clic en «CALCULAR» para generar los resultados. Los demás valores se calculan automáticamente o se llenan con valores predeterminados.

Descargo de responsabilidad: Todos los valores proporcionados por la calculadora son aproximaciones y son únicamente para propósitos de planificación.

Number of Shipments
Events per Shipment (default 5)
Daily Payload Volume (events per day)



Note: Displayed values are approximations and may not reflect exact usage metrics.
CLOSE

Response

Copy