Fedex Logo

Cómo agregar un número de rastreo a un webhook

Para agregar un número de rastreo a tu webhook de suscripción utilizando la API de la suscripción del número de rastreo de visibilidad integrada avanzada, sigue estos pasos:

  1. Crea un proyecto de la suscripción del número de rastreo de visibilidad integrada avanzada siguiendo los pasos indicados en la sección anterior o siguiendo los pasos proporcionados en la Guía de inicio.
  2. Necesitas un token OAuth para iniciar llamadas a la API de la suscripción del número de rastreo de visibilidad integrada avanzada. Para generar un token OAUTH, usa la API de autorización. Consulta la documentación de la API de autorización en el catálogo de la API para conocer los pasos detallados para generar un token OAUTH.
  3. Haz clic en la opción Detalles del proyecto en el menú de navegación de la izquierda. En la pestaña Claves de producción, desplázate hacia abajo para encontrar la documentación de la API de la suscripción del número de rastreo de visibilidad integrada avanzada.

Una vez que accedas a la documentación de la API de la suscripción del número de rastreo de visibilidad integrada avanzada, encontrarás tres puntos finales:

Punto final de la asociación del número de rastreo

  • Usa este punto final para agregar o eliminar números de rastreo proporcionados a una suscripción de webhook determinada. Obtén más detalles en la documentación de la API de la suscripción del número de rastreo de visibilidad integrada avanzada.
  • Cualquier adición o eliminación de números de rastreo es un trabajo asincrónico. Se envía una ID de trabajo como respuesta para agregar o eliminar la llamada de la API de asociación del número de rastreo.

Punto final de detalles del trabajo del número de rastreo

Este punto final proporciona detalles sobre una ID del trabajo determinado, por ejemplo, de todos los números de rastreo enviados, cuántos se agregaron correctamente a la suscripción de webhook determinada o cuántos aún se están procesando.

Punto final del estado del trabajo del número de rastreo

Este punto final te permitirá obtener un resumen actual de todos los trabajos que se están procesando.

 

  1. Usa el token AUTH generado en el Paso 2 con el punto final de Asociación de número de rastreo para agregar números de rastreo a tu suscripción de webhook.

 

Reglas de validación:

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

      Ejemplo de mensaje de confirmación: <<nombre de webhook>> se creó con éxito. Los cambios pueden tardar hasta 10 minutos en verse reflejados.

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

Response

Copy