Su equipo puede enviar directamente cargas, trayectos, paradas, transportistas y actualizaciones de seguimiento a la Integration API. Getting Started with the Integration API explica paso a paso la primera solicitud.
Cómo se conecta TrackFlo con su TMS
Actualizado hoy
Nos conectamos a su TMS en dos direcciones. De entrada, mantenemos una copia activa de sus cargas, trayectos, paradas, transportistas y actualizaciones de seguimiento, para que sus rastreadores y automatizaciones funcionen con datos actuales. De salida, escribimos en la misma carga de su TMS lo que su equipo hace en TrackFlo: cambios de estado, llamadas de verificación y notas, llegadas y salidas de paradas, datos del conductor y del equipo, y comprobantes de entrega cuando su TMS los acepta.
La forma en que funciona cada parte depende del TMS. Leemos mediante su API según un horario, recibimos webhooks o un flujo de eventos cuando el TMS los ofrece y, para un TMS, leemos una réplica de base de datos. La tabla compara los seis TMS compatibles; cada guía incluye la configuración que debe realizar el administrador de su TMS antes de que se sincronice la primera carga.
Los seis TMS de un vistazo
TMS | Cómo leemos | Qué escribimos de vuelta | Qué proporciona su administrador |
|---|---|---|---|
Web services API, lectura cada 10 a 15 minutos, además de webhooks de RapidAlerts si los configura | Estado; llamadas de verificación con ubicación, hora estimada de llegada y observaciones; llegadas y salidas de paradas; conductor, camión y remolque; POD en McLeod Imaging cuando su instancia lo admite | Un usuario de API (autenticación Basic o Token); opcionalmente, RapidAlerts | |
Public API, lectura al menos cada 10 minutos, además de webhooks | Estado; notas; llegadas y salidas de paradas; conductor y proveedor de seguimiento; POD | Un nombre de usuario y una contraseña de Turvo, y una clave de Public API | |
Webhooks para envíos y ubicaciones nuevos o modificados, además de una actualización de las cargas del panel cada 30 minutos | Estado; actualizaciones de ubicación; llegadas y salidas de paradas; conductor, camión y remolque; comentarios como entradas del registro de actividad; POD que su equipo cargue en TrackFlo | Una clave de Tai Public API y suscripciones a webhooks en Tai | |
El flujo de eventos de Mastery, además de una actualización cada hora mediante la Mastery API | Notas de seguimiento; llegadas y salidas de paradas; conductor; despacho; enlaces de seguimiento; un enlace a la carga en TrackFlo | Credenciales de cliente OAuth y acceso al flujo de eventos | |
Consultas de Salesforce cada 5 minutos (sin webhooks) | Estado; comentarios y ubicación de las llamadas de verificación; llegadas y salidas de paradas con hora estimada de llegada; conductor, tractor y remolque | Una aplicación conectada de Salesforce que use el flujo de credenciales de cliente | |
Una réplica de base de datos de solo lectura, a la que se accede mediante una VPN de sitio a sitio y que se lee cada 1 o 2 minutos | Todavía nada: la conexión actualmente es de solo lectura | Un usuario de base de datos de solo lectura en una réplica y una VPN de sitio a sitio |
No archivamos los POD en Mastery ni en Revenova, ni en las instancias de McLeod sin acceso a Imaging; en esos casos, enviamos el POD por correo electrónico a su equipo. En Tai, los POD que su equipo carga en TrackFlo se archivan en Tai, y los POD recopilados de los transportistas se envían por correo electrónico.
Cómo llegan sus datos a TrackFlo
Cada cliente obtiene un servicio de integración dedicado que lee su TMS y envía los datos a TrackFlo mediante nuestra Integration API, usando una clave de API vinculada a ese único tenant.
Los webhooks llegan a un hostname propio,
https://<tenant>-integration-webhooks.trackflo.tech. Cada uno debe incluir la credencial que emitimos para su tenant; cualquier otra se rechaza.Las lecturas programadas se ejecutan independientemente de que haya webhooks configurados. Cuando un TMS ofrece ambas opciones, los webhooks reflejan los cambios en el panel en cuestión de segundos y la siguiente lectura programada recoge todo lo que un webhook no haya recibido.
Los estados se asignan del vocabulario de su TMS al conjunto común de estados de TrackFlo. Creamos esa asignación con usted, a partir de los estados que realmente tienen sus cargas.
Cómo llegan al TMS las actualizaciones de su equipo
Cada escritura de vuelta en su TMS se ejecuta como un trabajo en segundo plano, para que un rastreador nunca tenga que esperar a que el TMS guarde una actualización.
Los intentos de escritura fallidos se reintentan. Si falla el último intento, la persona que realizó la actualización recibe un correo electrónico y TrackFlo muestra una notificación.
Las notas llevan una etiqueta. En McLeod, Turvo, Mastery y Revenova, las notas que escribimos terminan en
(via TrackFlo), para que su equipo pueda distinguirlas de las notas introducidas en el TMS.Las escrituras siguen las acciones de su equipo. Escribimos cuando alguien guarda una actualización en TrackFlo o cuando se aprueba una actualización leída de un mensaje de un conductor o transportista, ya sea por una persona o mediante las reglas de aprobación automática que usted active. La única escritura permanente está en Mastery, donde añadimos un enlace a la carga de TrackFlo en cada ruta.
Seguridad y aislamiento de datos
Las credenciales que nos proporciona se almacenan cifradas en AWS Secrets Manager, nunca en el código ni en imágenes de contenedores.
Cada clave de Integration API está vinculada a un tenant y a un propósito, se almacena únicamente como hash, caduca y tiene un límite de frecuencia. Cada solicitud está limitada a su empresa. Las reglas se encuentran en Authentication and Tenants.
Todo el tráfico se cifra durante el tránsito con TLS 1.2 o 1.3, y el HTTP simple se redirige a HTTPS.
Nos conectamos a sus sistemas desde una dirección IP fija, que le proporcionamos durante la incorporación para que su firewall pueda permitirla.
Nuestra postura de seguridad completa se encuentra en trackflo.tech/security.
Cómo es la incorporación
La incorporación comienza con el administrador de su TMS y termina cuando las actualizaciones de su equipo fluyen de vuelta al TMS.
El administrador de su TMS crea los accesos que se indican en la guía de su TMS y comparte las credenciales con nosotros.
Nos conectamos, ejecutamos la primera sincronización y revisamos con usted sus cargas activas en TrackFlo.
Creamos con usted la asignación de estados.
Si su TMS admite webhooks, el administrador los configura con el hostname y la credencial que le enviamos.
Probamos cada tipo de escritura de vuelta, en su TMS de prueba o de staging si dispone de uno, antes de que su equipo dependa de ella.
Preguntas frecuentes
Mi TMS no es uno de los seis
¿Qué ocurre cuando nuestro TMS no funciona?
Su equipo puede seguir trabajando en TrackFlo. Las escrituras que fallan se reintentan y, si falla el último intento, la persona que realizó la actualización recibe un correo electrónico y TrackFlo muestra una notificación. En el lado de entrada, la siguiente lectura correcta recoge los cambios realizados mientras el TMS no estaba disponible.
¿TrackFlo cambia registros que no modificamos?
No. Solo escribimos los tipos de actualización indicados para su TMS y únicamente en la carga a la que pertenece la actualización.