1. ¿Error general o puntual?

2. ¿Url de tracking es de la misma compañía que la integración?

3. Estatus del Segmento

4. Revisión despacho en segmento vs. despacho en tracking

5. Comprobar campos críticos

6. Revisión de IDs de acuerdo al Reporte de Equipos de Transporte

7. Comprobación Multitracking

8. Errores y su interpretación

Errores llamados en punto

List all vehicles error - Error message: timeout when calling Meerkat API.

List all vehicles error - Error message: Locations not found

Errores llamados cada x minutos

List all vehicles error - Error message: timeout when calling Meerkat API.

Location failed to update - Error message: No match for the tractor

Location failed to update - Error message: locations not found

9. Errores específicos del transportista

10. Asegurar despacho de la unidad

11. Visibilidad del token del lado del Transportista

1. ¿Error general o puntual?

Cuando se detecta un error en una integración GPS, el primer paso recomendado es entender si se trata de un error puntual en una lectura determinada, o por el contrario es un error general que afecta al segmento completo y la integración nunca comenzó a funcionar.

Cómo comprobarlo

Podemos ir a la pestaña de tracking del segmento en cuestión y ver el histórico de tracking logs.

Podemos abrir los canales de notificaciones del GPS en cuestión, ya sea en el de errores o en el de logs, y ver si el mismo mensaje es recurrente o no.

Cómo analizarlo

• ¿Nunca empezó a funcionar la integración automática? Se trata de un error general de la integración y hay que seguir avanzando en el Troubleshooting.
• ¿Ha estado trackeando bien en automático con anterioridad al error y sólo faltan algunas lecturas por el momento o de forma intermitente? Entonces probablemente sea por cobertura, tomamos nota, lo dejamos estar unos minutos a que se produzcan un par de llamados más y volvemos a revisar. A veces no es un fallo de la integración, sino que simplemente la unidad ha perdido cobertura durante un tiempo específico.
• ¿Ha estado trackeando bien todo el trayecto...y de repente dejó de trackear hace 3-4-5 lecturas? Quizás ha llegado a destino y nos han quitado ya la visibilidad aunque en nuestro sistema lo sigamos teniendo en el estatus En Tránsito. Si la integración funciona a través de credenciales tipo token (u otro tipo de credenciales como por ejemplo Usuario, Contraseña, etc) se recomienda comunicarse con la línea de transporte para confirmar que la unidad llegó a destino y éste es el motivo por el que han cortado la visibilidad del token. En este caso, recordemos que lo ideal es que el token esté activo de forma global, sin que tengan que añadir y quitar unidades al mismo, precisamente para evitar estas situaciones y que el token se convierta en un proceso similar al de generación de cuenta espejo en cada load. Se recomienda invitar al transportista a dejar las unidades visibiles en el token, en lugar de irlas añadiendo y sacando. 

2. ¿Url de tracking es de la misma compañía que la integración?

Es habitual que un transportista no tenga el 100% de su flota trackeando con el mismo GPS.

Se dan situaciones en las que, por ejemplo: 

• Están migrando de un GPS  a otro, y tienen % de la flota con un GPS y otro % con otro GPS.
• La instalación del GPS en la línea es reciente, y quedan algunas unidades todavía por instalar por complicaciones en las citas.
• La unidad despachada pertenece a un socio comercial o permisionario, que tiene un GPS diferente al de la línea de transporte principal. (De hecho, gracias a las integraciones GPS, se descubren a veces prácticas ilícitas de contratación de terceros).
• Etc.

Por estos motivos, pese a que la integración y despacho sean correctos, la integración lanza un error, ya que el sistema intenta trackear con la integración disponible, pero al hacer el llamado, éste resulta vacío porque la unidad trackea con otra solución GPS diferente.

Cómo comprobarlo

Podemos irnos a la pestaña de tracking del segmento en cuestión y comprobar la cuenta espejo (CE) aportada como back up de trackeo manual.

Cómo analizarlo

• Si la CE y la integración pertenecen al mismo GPS, continuar con el troubleshooting.
• Si la CE aportada no corresponde con el GPS integrado, se recomienda: 

1. Confirmar con la línea de transporte que los datos son correctos, y que la unidad no trackeará vía integración con dicho GPS.
2. Desactivar el tracking automático, para no estar recibiendo notificaciones recurrentes en el canal provocando ruido innecesario.
3. Pasar a trackeo automatizdo vía Fr8App celular.
4. En caso de que la línea de transporte u operador no haga funcionar Fr8App celular, pasar a trackeo manual vía cuenta espejo.
5. Contactar a su departamento de integraciones, para que inicie la integración del carrier con el nuevo GPS detectado.

3. Estatus del Segmento

Llegados a este punto, se recomienda mirar el estatus actual del segmento.

Cómo analizarlo

• Si la integración funciona, por ejemplo, a través de credenciales tipo token (también puede ser a través de credenciales como, por ejemplo, Usuario, Contraseña, etc...) y la carga se encuentra en estatus finales del ciclo de vida de la carga, como por ejemplo En Destino, Cita de Entrega Confirmada, Caja en Patio de Entrega, etc, es muy probable que el transportista haya quitado la visibilidad de la unidad dentro del token.  En este caso, se recomienda confirmar este hecho con el transportista y cambiar el estatus de la carga, además de aprovechar para hablar con el transportista para invitarle a que cambien a un token con lectura global para evitar estos problemas en el futuro en lugar de visibilidad de las unidades en momentos específicos.
• Si la carga sigue En Tránsito, y no se tiene visibilidad, seguir avanzando con el troubleshooting.

4. Revisión despacho en segmento vs. despacho en tracking

Los datos de despacho en BO en la pestaña de SEGMENTOS y SEGUIMIENTO deben de coincidir.

Hay que tener cuidado porque sólo la PRIMERA vez que se pone el estatus Despachado en la pestaña del segmento, se copian en automático los datos al segmento correspondiente de la pestaña de tracking. 

Si luego se editan los campos en pestaña segmento, NO se aplicarán de forma automática a la pestaña TRACKING. Hay que ir a pestaña tracking a volcar los datos nuevos manualmente.

5. Comprobar campos críticos

Las integraciones GPS tienen algunos campos críticos del despacho que deben estar correctamente rellenos para que los llamados de la integración funcionen correctamente.

Si estos campos críticos no están rellenos correctamente, la integración no funcionará.

Por favor revise con detalle los campos críticos para que funcione esta integración.

Tenga en cuenta que algunas integraciones, los campos críticos son opcionales (por ejemplo, tractor id O tractor plates), mientras que otras son obligatorias (por ejemplo, tractor id Y tractor plates).

Un error típico es haber hecho un despacho incorrecto en momentos iniciales de la carga, poniendo dummy data en los campos (por ejemplo ND, AAA, PTE o similar), y luego olvidar actualizar dicha información.

Otro error típico es haber copiado espacios extra en los campos de despacho, antes o después de los datos, de forma que pese a no ser visible, los datos en el campo no coincidían con los disponibles en la base de datos del GPS. Desde julio 2023, nuestra plataforma fué modificada para que no se lean los espacios, y éste dejó de ser motivo de error en los llamados de las integraciones.

En el caso de Meerkat, el campo crítico es el TRACTOR.

6. Revisión de IDs de acuerdo al Reporte de Equipos de Transporte

Algunas integraciones disponen del Reporte Equipos de Transporte, en el que se detallan los IDs asignados a las unidades por el transportista.

¿Qué es un Reporte de Equipos de Transporte y para qué nos sirve?

Imaginemos que un transportista tiene un tractor con id A-95.

Cuando el transportista nos depacha la unidad, nos dice el dato como A95, a95 o similar.

Pero el día que lo registraron en su plataforma de GPS, como todos comenzaban por A-, pues los grabaron con 95 nada más.

En todos los casos, estamos hablando de la misma unidad...pero hay diferencias en su identificador, y cuando nuestra plataforma pregunta por esa unidad en tránsito al GPS, si no coinciden 100% los datos, nos devolverá una respuesta de error.

Por este motivo, algunas integraciones GPS disponen de un reporte Equipos de Transporte, donde podemos hacer búsquedas de los ID de las unidades, para entender el ID exacto por el que se debe preguntar en el llamado de ubicación.

¿Cómo analizarlo?

Llegados a este punto del troubleshooting:

• Miraremos si esta integración GPS tiene reporte de Equipos de Transporte o no.
• En caso de tenerlo, buscaremos la unidad en el reporte. Aquí recomendamos hacer una búsqueda amplia: probar por id, por placas, con guiones, sin guiones, con letras y sin letras, etc.
• En caso de encontrar la unidad: comprobar que el id del reporte y el id registrado en la casilla coinciden 100%.
• Si estaba correcto y ya coinciden 100%, seguir avanzando en el trouble shooting.
• Si no estaba correcto, y había pequeñas diferencias: corregir los datos de la cajita de tracking con el nuevo id, y esperar al siguiente llamado GPS para comprobar que ya funciona.
• Si no se encuentra ninguna unidad similar en el reporte de equipamiento, puede que se deba a que nos han despachado una unidad incorrecta, o que la unidad sea correcta pero no esté visible en el token de la integración. En cualquier caso, hablar con el transportista para analizar la situación.

Meerkat SÍ dispone de Reporte de Equipos de Transporte

7. Comprobación Multitracking

¿Qué es multitracking? 

Multitracking es la posibilidad de añadir varias integraciones de GPS al mismo transportista.

¿Cómo funciona multitracking?

En el llamado, si hay varias integraciones para un mismo transportista, se va llamando a cada uno en un orden de integración para ese transportista.
Esto ocasionaba que aparecieran errores en los canales no usados.
Por ejemplo: 

• CARRIER 1 está integrado para Samsara, Webfleet y Monarch. 
• Aparece un nuevo segmento en tránsito para el transportista. 
• Preguntamos coordenadas a las 3 integraciones. 
• Si esa unidad trackea con Samsara, aparecerán errores en los canales de Webfleet y Monarch y provocaba mucho ruido innecesario en los canales.

Error -MULTITRACKING

La solución es la siguiente: sólo va a aparecer el error en el canal del último GPS de la lista.
En el ejemplo anterior: 

• Un segmento del CARRIER 1 de antes por motivo x, aporta cuenta espejo de XXX (no corresponde a ninguna de las 3 integraciones), o simplemente no aporta CE porque estamos integrados pero ninguna de las 3 llega a funcionar.
• El llamado irá primero a Samsara, no tendrá respuesta, luego irá a Webfleet, no tendrá respuesta, luego irá a Monarch, no tendrá respuesta. Entonces volcará un error EN EL CANAL DEL ÚLTIMO GPS DE LA LISTA, TERMINANDO EN -MULTITRACKING.
• Gracias a esta distinción, ya debemos saber que ninguna de las 3 integraciones funcionó, pero sólo se nos está avisando en el canal del último para no tener ruido innecesario en todos los canales.

Cómo actuar ante el error de Multitracking

• Debemos comprobar todas las integraciones disponibles siguiendo su troubleshooting,
• Y/o hablar con el transportista para entender este segmento en particular, con qué solución GPS debe funcionar para afinar nuestra corrección del error.

8. Errores y su interpretación

Se detallan a continuación los diferentes mensajes de error que recibirá en esta integración GPS, para que sepa cómo interpretarlos.

Algunas integraciones tendrán dos tipos de errores:

• Errores en punto: Se trata de errores generales de la integración, no de una unidad en tránsito en específico. Sirven para avisar del estado de los tokens de un transportista en general. En los llamados en punto pueden llegar a acumularse varios mensajes, que suelen ser recurrentes al tratarse de errores generales que no se reparan en unos minutos. No obstante, no debemos ignorarlos o dejar de reaccionar ante ellos, porque pueden escaparse errores nuevos importantes. Debemos repasar, identificar y reaccionar a cada uno de ellos en los llamados. 
• Errores en los llamados cada x minutos: Se trata de errores ahora sí de una unidad en tránsito en específico.

Como regla general, cuando las integraciones han posicionado correctamente en algún momento y se empiezan a recibir mensajes de error sin que que se haya tocado nada del lado del desarrollo (siempre y cuando la información volcada en el segmento sea correcta -trailer, tractor, nombre y/o placas-), el problema estará del lado del proveedor del GPS. 

Pueden ser varios los motivos que generen el fallo, ya sea pérdida temporal de visibilidad, caducidad de credenciales, errores de posicionamiento de la unidad, fallos en el dispositivo de posicionamiento, etc.

Errores llamados en punto

List all vehicles error - Error message: timeout when calling Meerkat API.

Este error indica que ha pasado más tiempo del permitido en obtener una respuesta del servidor del proveedor de GPS.

Se puede deber a múltiples motivos por lo que hay que tener en cuenta:

• Si ha habido posicionamiento previamente, el error está del lado del proveedor.
  • Si el error es puntual: se puede obviar
  • Si el error persiste durante un tiempo prolongado y no se han obtenido localizaciones entre errores: contactar con el proveedor ya que puede deberse a pérdida visibilidad importante de la unidad o fallo en el equipo.

List all vehicles error - Error message: Locations not found

Este error indica que no se encontró una ubicación para actualizar. Suele presentarse alrededor de 30 minutos, después de haber estado trackeando automáticamente sin ningún error. En este periodo de 30 minutos se deberá trackear a través de la app o de forma manual hasta observar que la integración vuelva a volcar posicionamiento en automático.

Si no vuelve a posicionar, favor de contactar con el proveedor de GPS para hacer un seguimiento directo.

Errores llamados cada x minutos

List all vehicles error - Error message: timeout when calling Meerkat API.

Este error indica que ha pasado más tiempo del permitido en obtener una respuesta del servidor del proveedor de GPS.

Se puede deber a múltiples motivos por lo que hay que tener en cuenta:

• Si ha habido posicionamiento previamente, el error está del lado del proveedor.
  • Si el error es puntual: se puede obviar
  • Si el error persiste durante un tiempo prolongado y no se han obtenido localizaciones entre errores: contactar con el proveedor ya que puede deberse a pérdida visibilidad importante de la unidad o fallo en el equipo.

Location failed to update - Error message: No match for the tractor

Este error indica que no tenemos visibilidad de la unidad que estamos pidiendo en el llamado porque no hay coincidencia entre la información de la unidad que estamos solicitando y la información registrada en la plataforma del proveedor de GPS.

Cómo actuar ante este error:

• Hay que asegurarse que el identificador de los campos críticos introducido en la pestaña de seguimiento del segmento sea el correcto. Para ello, comprobamos las unidades con las que estamos recibiendo posicionamiento en esta integración para ese transportista gracias al reporte Equipamiento de Transportista. Si está bien y este no era el motivo, volver a comprobar el despacho de la unidad.
• En el caso en el que el despacho y el ID sean correctos, quiere decir que el token no tiene lectura global, sino que nos van poniendo y quitando unidades. Hay que llamar al transportista con dos objetivos: pedir visibilidad de la unidad en tránsito dando error, y pedir que nos pasen el token a lectura global para no tener estos errores humanos en futuras cargas.

Location failed to update - Error message: locations not found

Este error indica que no se encontró una ubicación para actualizar. Suele presentarse alrededor de 30 minutos, después de haber estado trackeando automáticamente sin ningún error. En este periodo de 30 minutos se deberá trackear a través de la app o de forma manual hasta observar que la integración vuelva a volcar posicionamiento en automático.

Si no vuelve a posicionar, favor de contactar con el proveedor de GPS para hacer un seguimiento directo.

9. Errores específicos del transportista

A veces los errores se deben a circunstancias específicas del transportista, que afectan a su integración pese a que la integración per se funcione correctamente.

Le recomendamos que a medida que avance en el uso de esta integración GPS, dedique un espacio a ir registrando los errores recurrentes con sus transportistas, para irlos identificando y trabajando con la línea de transporte.

10. Asegurar despacho de la unidad

Llegados hasta aquí, quizás sea un error humano al despachar la unidad.

Pasos a seguir:

• Internamente, mediante cuenta espejo. Pese a tener integración, por si éstas fallan, la buena práctica recomendada es siempre tener disponible cuenta espejo del segmento como back up. Abrir la CE proporcionada, y comprobar si los datos de unidad en movimiento coinciden con los volcados en nuestro sistema. A veces gracias a ésto, nos damos cuenta de que la CE pertenece a otra unidad diferente a la indicada en el despacho. Ésto suele ocurrir cuando hubo un cambio de unidad de último minuto que no se actualizó correctamente en BO.
• Internamente, mediante comunicaciones de la operación. Antes de salir  hablar con el transportista, comprobar primero si se trata de un error interno, recomprobando de nuevo que los datos de despacho volcados en BO son correctos.
• Externamente, hablando con el carrier. Hablar con el transportista para recomprobar la unidad despachada.

Si los datos eran correctos, continuar con el troubleshooting.

Si había error humano en los datos, corregir y esperar al próximo llamado a ver si ya trackea automático.

11. Visibilidad del token del lado del Transportista

Llegados hasta aquí, quizás la integración está bien y los datos están bien...pero el token (o Usuario, Contraseña, etc...) que nos dieron era de lectura de unidades específicas y no de lectura global...y quizás el despachador del transportista no ha agregado la unidad para que sea visible en nuestra cuenta.

Proceder llamando al transportista, a contactos de despachador, y pedir que vuelvan a comprobar si tenemos visibilidad de esa unidad específica, y aprovechar la oportunidad para invitarles a cambiar a LECTURA GLOBAL.