Guía de integración de McLeod PowerBroker
Actualizado hoy
TrackFlo se conecta a su instancia de McLeod PowerBroker mediante su API de servicios web, la misma que su instancia documenta en https://<your-mcleod-host>/ws/docs/. Los movimientos se leen según un horario; si utiliza RapidAlerts, McLeod también puede enviar cambios a TrackFlo en cuanto ocurren.
Qué lee TrackFlo
Movimientos activos y sus órdenes, paradas, transportista, conductor y equipo.
Historial de llamadas de confirmación, para que las llamadas de seguimiento realizadas en McLeod aparezcan en la cronología de TrackFlo.
Estados de movimientos y de intermediación, asignados al vocabulario de estados compartido de TrackFlo.
Qué escribe TrackFlo
Llamadas de confirmación con estado, ciudad y estado, observaciones y una hora estimada de llegada.
Llegadas y salidas de las paradas.
Conductor, camión y remolque del movimiento.
Comprobante de entrega como documento digitalizado.
Qué configura su administrador de McLeod
Un usuario de API. McLeod admite HTTP Basic y su propio esquema de Token. El método que acepta su instancia varía según la versión y la configuración, por lo que lo confirmamos con su instancia durante la incorporación en lugar de darlo por sentado. Puede crear un token en Sys Admin → Smartphone Mobile Service o generarlo a partir de un inicio de sesión Basic.
Acceso de red al puerto de servicios web de su instancia desde TrackFlo, si se encuentra detrás de un firewall.
RapidAlerts (opcional). Dirija la alerta al nombre de host del webhook de TrackFlo de su tenant con el token de portador que le proporcionamos. Sin RapidAlerts, TrackFlo se mantiene actualizado mediante sondeos.
Aspectos que debe conocer
Los códigos de estado son propios de su instancia. Los códigos de estado de intermediación se configuran por instancia de McLeod, por lo que la asignación a los estados de TrackFlo se crea con usted, no se copia de otro cliente.
"No encontrado" es un 204. McLeod responde a una consulta de un registro inexistente con una respuesta de éxito vacía en lugar de un 404. TrackFlo lo gestiona; conviene saberlo si alguna vez lee la API por su cuenta.
Disponibilidad. Las instancias alojadas por McLeod tienen ventanas de mantenimiento y cortes ocasionales. TrackFlo vuelve a intentar y reanuda el proceso; cualquier interrupción en las actualizaciones durante un corte de McLeod se soluciona en el siguiente sondeo exitoso.