Guía de integración de Tai

TrackFlo recibe webhooks de Tai para los eventos de creación, actualización y ubicación de envíos, y ejecuta una consulta de conciliación en la API de Tai para detectar cualquier evento que no haya recibido mediante un webhook.

Qué lee TrackFlo

• Los envíos y sus paradas a partir de los eventos de creación y actualización.

• Las actualizaciones de ubicación del feed de seguimiento de Tai.

• Las entradas del registro de actividad, para que las notas realizadas en Tai aparezcan en la cronología de TrackFlo.

Qué escribe TrackFlo

• Cambios de estado y llegadas y salidas de las paradas, mediante los endpoints de seguimiento de Tai.

• Notas de llamadas de seguimiento.

Qué debe configurar su administrador de Tai

• Una clave de API de Tai para TrackFlo. Tai se autentica con un encabezado x-api-key, no con un token de tipo bearer.

• Entrega de webhooks a TrackFlo. Las suscripciones las configura el equipo de soporte de Tai, no se configuran mediante la API. Pida a Tai que envíe los eventos ShipmentCreate, ShipmentUpdate y de ubicación al nombre de host del webhook de TrackFlo de su tenant, usando las credenciales que le proporcionemos.

Aspectos que debe conocer

• Límites de frecuencia. Tai está detrás de un limitador de solicitudes que devuelve 429 cuando se producen ráfagas. TrackFlo regula el ritmo de sus consultas para adaptarse; es normal que ocasionalmente una actualización se retrase, no se trata de un error.

• No hay búsqueda de envíos. Tai no tiene ningún endpoint de listado o búsqueda, por lo que un envío para el que TrackFlo nunca recibió un evento no puede descubrirse mediante consultas periódicas. Por lo tanto, la entrega de webhooks es esencial.

• El estado a nivel de parada se deriva. Tai informa del estado del envío, no del estado de cada parada. TrackFlo calcula el progreso de las paradas a partir de las marcas de tiempo de llegada y salida.

• Zonas horarias. Tai informa de un desfase UTC por parada en lugar de un nombre de zona. TrackFlo realiza la conversión tanto al recibir como al enviar los datos.