Saltar al contenido principal

Servicios de Creación de Delivery Jobs

Esta página explica cómo crear delivery jobs con la Fleet API y cómo confirmar si los jobs enviados se crearon correctamente.

Acrónimos y Términos​

  • API: Interfaz de Programación de Aplicaciones.
  • ERP: Enterprise Resource Planning.
  • HTTP: Hypertext Transfer Protocol.

¿Qué endpoint debo utilizar?​

Utilice este mapeo según su volumen de creación y la forma de confirmación que necesita:

1) Bulk Upload Delivery Jobs​

Qué significa​

Permite enviar múltiples jobs en una sola solicitud, ideal cuando necesita integrar grandes volúmenes desde sistemas ERP o de despacho.

Confirmación y notificaciones​

El servicio de carga masiva admite el campo webhooks_url. Una vez finalizado el procesamiento, Cartrack envía un callback de webhook para que su sistema confirme el resultado y reconcilie lo que se creó. Para configuración de webhook, verificación de firma y lineamientos de seguridad, consulte Webhooks.

Propósito​

  • Es la mejor opción para importaciones programadas o de gran volumen.
  • Proporciona a los equipos operativos un flujo de confirmación confiable, en lugar de asumir que todos los jobs fueron creados.
  • Ayuda a detectar rápidamente escenarios de creación parcial.

Consideraciones para Developers​

  • Trate esta solicitud como un flujo asíncrono.
  • Use los callbacks de webhook como fuente de verdad del estado final de procesamiento.
  • Compare los jobs enviados con los resultados recibidos y aplique retry/escalation para los jobs no creados.

2) Create a Delivery Job​

Qué significa​

Permite crear un delivery job por solicitud con respuesta inmediata de la API.

Confirmación y errores​

Si el job no puede crearse, la API devuelve un código HTTP distinto de 200 junto con un mensaje de error adecuado.

Propósito​

  • Es más adecuado para flujos interactivos en los que los usuarios crean jobs uno por uno.
  • Los fallos se detectan de inmediato y pueden mostrarse directamente a los equipos de soporte o despacho.

Consideraciones para Developers​

  • Valide el estado HTTP de cada solicitud.
  • Trate todas las respuestas no 200 como fallas explícitas de creación.
  • Registre y devuelva el mensaje de error de la API para agilizar la resolución operativa.

Patrón de Integración Recomendado​

  1. Mantenga una referencia del lado cliente para cada job enviado (ERP/dispatch).
  2. Use carga masiva con webhooks_url para importaciones de alto volumen.
  3. Haga seguimiento de los callbacks y reconcilie jobs esperados vs jobs creados.
  4. Trate todas las respuestas no 200 de creación individual como fallas.
  5. Aplique retry o escale los jobs fallidos según su flujo interno.