Histórico
Esta documentación describe, a nivel funcional, la consulta del histórico de sincronizaciones entre Trowel y los proveedores externos Holded y Sage 50.
Cada vez que se ejecuta una sincronización, Trowel crea un paquete de integración que agrupa todos los registros procesados en esa ejecución (empresas, facturas de venta, facturas de gasto y pagos de factura). El histórico permite revisar qué se sincronizó en cada ejecución, comprobar errores y localizar registros en la aplicación de destino.
Dónde se accede
La funcionalidad está disponible en las pantallas de integración de cada proveedor:
Holded
Administración → Integraciones → Holded
Sage 50
Administración → Integraciones → Sage 50
En la barra de herramientas superior, junto a Actualizar, aparece el botón Histórico (icono de reloj). Solo se muestra cuando la integración ya está configurada (API Key en Holded o conexión activa en Sage 50).
Permisos
Se requiere el permiso de administración de integraciones (Pages.Administration.Integrations), el mismo que para configurar y lanzar sincronizaciones.
El histórico es solo lectura: no permite crear, modificar, cancelar ni relanzar sincronizaciones desde estas pantallas.
Listado de paquetes
Al pulsar Histórico se abre un modal a pantalla completa con los paquetes de integración del proveedor desde el que se ha accedido, ordenados por fecha de creación (más recientes primero).
Columnas del listado
Creado en
Fecha y hora en que se inició el paquete.
Tipo
Entidad sincronizada: Empresas, Facturas de venta o Facturas de gasto.
Estado
Estado del paquete: Pendiente, En cola, Sincronizando, Sincronizado, Completado con errores o Cancelado.
Dirección de integración
Sentido del flujo (por ejemplo, De Trowel a Holded o De Sage50 a Trowel).
Total registros
Número total de registros incluidos en el paquete.
Sincronizados
Registros sincronizados correctamente.
Errores
Registros que finalizaron con error.
Para ver el detalle de un paquete, haz clic en la fila correspondiente.
Detalle de un paquete
El detalle muestra un resumen del paquete (misma información que en el listado) y una tabla con todos los registros procesados en esa ejecución.
Columnas del detalle
Tipo de registro
Contacto, Factura de venta, Factura de gasto o Pago de factura.
Registro
Identificador legible del elemento en Trowel (nombre de empresa, número y fecha de factura, etc.).
ExternalId
Identificador del registro en el sistema externo (Holded o Sage 50).
Estado
Estado de sincronización del registro individual.
Última fecha de sincronización
Momento en que se procesó el registro.
Error
Enlace de descarga del documento de error, si existe (fichero de texto .txt).
Documento de la petición
Enlace de descarga del JSON enviado en la petición al proveedor, si existe (fichero .json).
Identificador del registro (columna Registro)
Según el tipo de entidad, Trowel muestra:
Contacto
Razón social de la empresa.
Factura de venta
Número y fecha de la factura.
Factura de gasto
Número de factura y nombre de la empresa.
Pago de factura
Número de la factura asociada, empresa (si aplica) y fecha del pago.
Si el registro aún no existía en Trowel en el momento de la sincronización (por ejemplo, importación desde el proveedor externo), la columna Registro puede quedar vacía; en ese caso utiliza ExternalId como referencia principal.
Documentos de error y de petición
Error: contiene el mensaje o respuesta de error devuelta por el proveedor externo. Útil para diagnosticar por qué un registro no se sincronizó.
Documento de la petición: contiene el cuerpo de la petición enviada al proveedor (formato JSON). Permite auditar qué datos se transmitieron en operaciones de salida desde Trowel.
Los enlaces solo aparecen cuando existe el documento correspondiente.
Exportación a Excel
Desde el detalle de un paquete, el botón Exportar a excel genera un fichero con:
Cabecera: resumen del paquete (fecha, tipo, estado, dirección, totales).
Tabla de registros: mismas columnas que en pantalla (tipo, registro, ExternalId, estado, fecha, indicadores de documentos de error y petición).
El nombre del fichero exportado es configurable por idioma (por defecto, HistoricoIntegracion / IntegrationPackHistory).
Alcance y limitaciones
El histórico muestra únicamente los paquetes del tenant actual y del proveedor desde el que se abrió (Holded o Sage 50).
Se listan como máximo los 20 paquetes más recientes en la pantalla de listado.
El detalle carga todos los registros del paquete seleccionado (no hay paginación en el detalle).
No incluye filtros por fecha, tipo o estado en esta versión.
Para relanzar una sincronización o corregir errores, utiliza las tarjetas de entidades en la pantalla principal de integraciones, no el histórico.
Un paquete en curso puede cambiar de estado mientras se consulta; usa Actualizar en la pantalla principal o vuelve a abrir el histórico para ver datos actualizados.
Casos de uso habituales
Localizar un contacto o factura en Holded/Sage 50 tras una sincronización desde Trowel: abre el paquete correspondiente, busca el registro por nombre o número y anota el ExternalId.
Investigar errores masivos: filtra visualmente paquetes con estado Completado con errores, entra al detalle y descarga los ficheros de error de los registros afectados.
Auditoría de una ejecución concreta: exporta el paquete a Excel para compartir o archivar el resultado de la sincronización.
Documentación relacionada
Last updated