Disponible para
- Roles: Administrador
- Planes: Starter, Premium, On demand, si la funcionalidad está activada
La pantalla Historial de integraciones le muestra el resultado de los intercambios entre sus sistemas y Mobility Work, sin necesidad de pasar por una solicitud al soporte.
La pantalla cubre dos tipos de intercambios: las llamadas recibidas por Mobility Work a través de la API de Partners, y los webhooks enviados por Mobility Work a sus sistemas.
Acceder al historial
- Vaya a Configuración de red desde el menú Red.
- Abra la pestaña Historial de integraciones.
- La lista se abre con los fallos de los últimos 7 días: es lo que más a menudo se busca al llegar a esta pantalla.
- Ajuste los filtros si es necesario.
Leer la lista
Encima de la lista, tres contadores resumen lo que está viendo: el número de llamadas mostradas, el número de entradas en esta página, y el número total de entradas en el período. Solo el último cubre todo el período definido por sus filtros; los dos primeros solo describen la página actual.
Cada línea de la lista corresponde a una llamada, no a un evento aislado. Una misma importación puede producir varias entradas: el lote recibido, su procesamiento unos minutos después, y luego una entrada por línea con error. La pantalla las agrupa para presentarle la llamada en su conjunto.
Una línea le indica:
- la integración correspondiente, por ejemplo Movimientos de stock, Creación y actualización de repuestos, o Webhooks;
- la dirección del intercambio: para una llamada recibida, el endpoint seguido del inicio de la referencia de la solicitud; para un webhook enviado, la URL de su sistema y el código de estado obtenido;
- el estado de la llamada en forma de etiqueta: un motivo de fallo, por ejemplo Repuesto no encontrado o Datos enviados inválidos, o Sin error cuando la llamada fue exitosa;
- el número de entradas vinculadas a esta llamada en la página actual;
- la fecha de la llamada.
La primera llamada de la lista se abre automáticamente, con sus motivos de fallo ya desplegados, para mostrarle lo que contiene el detalle sin necesidad de hacer clic.
Filtros disponibles
Cuatro filtros le permiten enfocar lo que busca.
Estado
Todos (ambos), Fallos (valor por defecto al abrir la pantalla), Éxitos.
Sentido
Todos (valor por defecto), Recibidas — las llamadas que sus sistemas envían a Mobility Work a través de la API de Partners —, Enviadas — los webhooks que Mobility Work envía a sus sistemas.
Integración
Permite enfocarse en una integración concreta: Movimientos de stock, Información de repuestos, Niveles de stock, Creación y actualización de repuestos, Inventario físico, Cambio de ubicación, Ubicaciones de almacenamiento, Equipos, Tareas, Partes de actividad, Webhooks.
La opción Todas las integraciones las muestra sin distinción.
Período
Se proponen tres ventanas: Último día, Últimos 7 días, Últimos 30 días. La pantalla se abre en Últimos 7 días. Según el volumen de su red, el período realmente disponible puede ser más corto: las entradas más antiguas se purgan regularmente.
Qué indican los contadores
Los contadores de la pantalla siempre hablan en entradas, nunca en elementos de negocio. Una entrada es una línea registrada por Mobility Work durante el procesamiento, no un repuesto ni un equipo.
Concretamente, una llamada que importó 1000 repuestos no mostrará "1000 entradas": nada registra el número de elementos contenidos en un lote. Por lo tanto, no encontrará un contador del tipo "950 exitosas de 1000".
Comportamientos que conviene conocer
- Cualquier cambio de filtro le devuelve a la página 1. La página 4 de una lista completa no es la página 4 de una lista filtrada por webhooks, y un número de página fuera de rango mostraría una lista vacía que podría confundirse con la ausencia de resultados.
- La lista muestra 20 entradas por página, no modificable. Cuando las entradas de una misma llamada no caben todas en una página, la pantalla se lo indica explícitamente en lugar de dejar que su contador pase por un total. El mensaje que aparece es: "Esta llamada tiene X entradas en esta página. Puede haber más en las páginas siguientes — filtre por 'Fallos' para conservar solo lo que falló."
- Cuando ningún intercambio corresponde a sus filtros, la pantalla muestra "Sin actividad de integración en este período."
- Si el historial no se puede cargar, la pantalla muestra "No se pudo cargar el historial de integraciones. Vuelva a intentarlo." Repita la operación antes de contactar al soporte.
- Si despliega una llamada totalmente exitosa, el detalle muestra "No se registraron errores para esta llamada."
- Cuando el contenido transmitido no se puede mostrar, la pantalla muestra "No se pudieron mostrar los datos enviados." En ese caso, comunique la referencia de la solicitud al soporte.
Compartir una vista filtrada
Los filtros y la página actual están incluidos en la dirección de la página. Por lo tanto, puede copiar la dirección desde la barra de su navegador y enviarla: la persona que la abre obtiene exactamente la misma lista, con los mismos filtros.
Esto es especialmente útil en dos situaciones: transmitir una importación fallida a un compañero encargado de corregir los datos, o adjuntar el enlace a una solicitud al soporte, además de la referencia de la solicitud.
El destinatario debe ser administrador de la red para abrir el enlace — un usuario sin ese rol será redirigido. El detalle desplegado de una llamada, en cambio, no forma parte del enlace: el destinatario abre la lista filtrada y luego despliega la llamada por su cuenta.
Analizar una llamada fallida
- Localice la llamada en cuestión en la lista — los motivos de fallo aparecen como etiquetas en la línea.
- Haga clic en la línea para desplegarla.
- Consulte los motivos de fallo y despliegue el que le interese para ver las entradas correspondientes.
Los motivos, y por qué están agrupados
El detalle de una llamada agrupa las entradas por motivo, no línea por línea. El motivo es la unidad útil: "3 repuestos no encontrados" es una sola cosa que corregir, mientras que tres líneas separadas le obligarían a reconstruir el problema usted mismo.
Motivos que puede encontrar:
- Lote recibido — Mobility Work ha recibido correctamente su envío.
- Procesado — el lote ha sido procesado.
- Datos enviados inválidos — el contenido de la solicitud no es utilizable.
- Referencia ambigua — la referencia proporcionada corresponde a varios elementos.
- Repuesto no encontrado — ninguna pieza corresponde a la referencia enviada.
- Ubicación de almacenamiento no encontrada — la ubicación indicada no existe en la red.
- Cambio de ubicación no posible — la pieza no puede reubicarse.
- Creación ignorada o Creación no posible — el elemento no fue creado.
- Procesamiento no posible — se produjo un error durante el procesamiento.
- Webhook entregado o Fallo de entrega del webhook — para las llamadas enviadas.
- Evento de integración — un intercambio que la pantalla aún no sabe nombrar con más precisión. Comunique la referencia al soporte si necesita interpretarlo.
Los motivos de éxito se listan junto con los motivos de fallo. Solo los motivos de fallo aparecen como etiqueta en la línea plegada, como máximo dos, contándose el resto.
Los datos enviados
Cuando la llamada incluye una entrada Lote recibido, un botón Mostrar datos enviados le permite consultar el contenido que su sistema transmitió: referencias, cantidades, precios unitarios, umbrales de stock.
Los datos enviados siempre están plegados por defecto. Le pertenecen, pero son voluminosos.
El caso de los webhooks enviados
Para cada webhook enviado por Mobility Work, el detalle conserva el intercambio con su sistema: la URL llamada, el código de estado de la respuesta, y el contenido de la respuesta devuelto por su sistema. La pantalla muestra una línea Respuesta, seguida del código en forma de punto verde o rojo, o de la mención Sin respuesta. El contenido está detrás de un botón Mostrar respuesta.
Un código de estado mostrado como Sin respuesta significa que su sistema no respondió en absoluto: nombre de dominio no encontrado, servidor inalcanzable, conexión rechazada. No es un código de estado igual a cero. En ese caso, verifique que la URL configurada sea accesible desde el exterior.
El caso de las llamadas recibidas
Para una llamada recibida a través de la API de Partners, el detalle muestra un Endpoint y no una URL: el método y la ruta llamados, sin nombre de dominio ni parámetros.
No hay respuesta que consultar, y no es un olvido. La API de Partners acusa recibo de inmediato y luego procesa su envío en segundo plano. Los errores que más le interesan — un repuesto no encontrado, por ejemplo — se registran, por tanto, mucho después de que ya se le haya devuelto la respuesta. Consecuencia práctica: justo después de una importación, la llamada puede mostrar solo su entrada Lote recibido. Vuelva unos minutos más tarde para ver el resultado del procesamiento y los posibles errores.
Comunicar una referencia al soporte
Un icono de copia junto a la referencia le permite obtenerla con un clic; cada entrada tiene el mismo icono para su propia referencia.
Es importante comunicar esta referencia al contactar al soporte: permite encontrar de inmediato el intercambio en cuestión. Cuando una entrada muestra Error técnico, el mensaje le invita explícitamente a comunicar la referencia indicada al soporte — es el caso en que el detalle técnico no se puede presentar tal cual, y el análisis debe hacerlo Mobility Work.
Entradas repartidas en varias páginas
Cuando una llamada tiene más entradas de las que una página puede mostrar, la pantalla se lo advierte y le propone filtrar por Fallos para conservar solo lo que falló. El número de entradas mostrado para una llamada corresponde a lo que contiene la página actual, no necesariamente al total de la llamada.