INTRODUCCIÓN

La sección Listado de Transacciones del módulo de Monitoreo en Bridge Manager permite a los usuarios visualizar y gestionar los registros de transacciones o TLOGs procesados en el sistema, mostrando su estado actual y los detalles relevantes en formato JSON, que es el formato almacenado en la base de datos. Esta herramienta es accesible tanto desde Bridge Manager Central (BMC) como desde Bridge Manager Tienda (BMT), con una diferencia clave en el alcance de los filtros disponibles: en BMC, los usuarios pueden seleccionar y filtrar transacciones de todas las tiendas y terminales registradas, mientras que en BMT solo pueden verse y gestionarse las transacciones de la tienda específica en la que se encuentra el usuario.

El objetivo de esta sección es facilitar el seguimiento y control de transacciones, permitiendo búsquedas rápidas y detalladas mediante filtros como estado, tipo de transacción, tienda, terminal y número de transacción. Los usuarios pueden profundizar en el Detalle de cada transacción para ver su JSON completo o utilizar la acción Reprocesar para intentar procesarla nuevamente si está en estado de error. Estas herramientas son esenciales para optimizar la resolución de errores y mejorar la eficiencia operativa en la gestión de transacciones en Bridge Manager.


Para acceder al módulo "Listado de transacciones" en Bridge Manager, dirígete al menú principal, selecciona Monitoreo y luego haz clic en Listado de transacciones.



LISTADO DE TRANSACCIONES

La pantalla Listado de Transacciones en Bridge Manager permite a los usuarios visualizar y gestionar de forma centralizada los registros de transacciones procesadas en el sistema, conocidos como TLOGs. Esta herramienta muestra cada transacción en un formato JSON legible que permite verificar el estado actual de la operación y acceder a detalles clave como origen, tipo, terminal, y usuario. Desde esta pantalla, los usuarios pueden filtrar y buscar transacciones según varios criterios, facilitando la identificación rápida de registros específicos, como aquellas transacciones con errores que requieren reprocesamiento.

El Listado de Transacciones está disponible tanto en Bridge Manager Central (BMC) como en Bridge Manager Tienda (BMT), con una diferencia en los filtros: en BMC, los usuarios pueden ver y filtrar transacciones de cualquier tienda y terminal registrada en el sistema; en cambio, en BMT solo se muestran las transacciones de la tienda en la que se encuentra el usuario.



Detalle de Elementos en Pantalla

Filtros:

  • Estado: Los usuarios pueden seleccionar transacciones en estado "Procesado", "Pendiente", "Error" o "Todos". Este filtro es útil para identificar y gestionar rápidamente transacciones que necesitan atención.
  • Tienda: En BMC, es posible filtrar las transacciones por cualquier tienda registrada; sin embargo, en BMT solo se muestran las transacciones de la tienda en la que se encuentra el usuario.
  • Terminal: En BMC, permite seleccionar una terminal específica en base a la tienda previamente seleccionada; en BMT, solo se listan las terminales de la tienda actual.
  • Tipo de Transacción: Este filtro permite al usuario seleccionar tipos específicos de transacciones, tales como "Venta Regular", "Devolución de Venta", "Presupuesto", "Préstamo", entre otros. Facilita la revisión de operaciones particulares.
  • Fecha Desde y Fecha Hasta: Permiten definir un rango de fechas para acotar las transacciones mostradas, ayudando a los usuarios a identificar registros dentro de un período específico.
  • Nro de Transacción: Campo de búsqueda directa por número de transacción, útil cuando se conoce un identificador exacto.


Botones:

  • Filtrar: Este botón, representado con un ícono de lupa, aplica los filtros seleccionados y muestra las transacciones que coinciden con los criterios definidos.
  • Limpiar: Con un ícono de "X", este botón elimina todos los filtros aplicados, devolviendo la vista original de todas las transacciones en la lista.
  • Fecha de selección rápida: La pantalla permite seleccionar fechas de manera rápida mediante íconos de calendario junto a los campos "Fecha Desde" y "Fecha Hasta".


Tabla de Resultados:

La tabla en pantalla presenta cada transacción con los siguientes datos:

  • Estado: Indica el estado de procesamiento de la transacción, como "Procesado", "Pendiente" o "Error".
  • Origen: Especifica el origen de la transacción, que puede ser desde el punto de venta (POS) o desde el Bridge Manager (BM).
  • Tipo de Transacción: Muestra el tipo específico de operación realizada, como "Venta Regular", "Rendición", "Transferencia de Caja", entre otros.
  • Tienda: Indica el nombre o código de la tienda en la que se generó la transacción.
  • Terminal: Muestra la terminal específica en la que se realizó la operación.
  • Nro de Transacción: Número único de identificación de la transacción.
  • Período y Subperíodo: Detallan el período contable en el que se registró la transacción.
  • Usuario: Nombre del usuario que ejecutó la operación.
  • Fecha: Fecha y hora en la que se realizó la transacción.
  • Datos de Envío: Incluye detalles adicionales de la operación en JSON para una verificación completa.


Acciones Disponibles:

  • Detalle: En las opciones de cada transacción, el botón "Detalle" abre una nueva pestaña en el navegador, donde se muestra el JSON completo de la transacción, permitiendo al usuario revisar tanto la cabecera como el cuerpo de la transacción en detalle.
  • Reprocesar: Esta opción está disponible para transacciones en estado "Error" y permite al usuario reintentar el procesamiento de la transacción. Una vez seleccionada, el sistema intenta procesar nuevamente la transacción, actualizando su estado según el resultado.



A partir de Bridge v7 no se generan los archivos XML de los TLOGs. 




DETALLE DE TRANSACCIÓN

La sección Detalle de Transacción en Bridge Manager permite a los usuarios acceder a una vista completa y estructurada de cada transacción registrada en el sistema. Al seleccionar la opción "Detalle" de una transacción específica, se abre una nueva pestaña en el navegador que muestra el JSON completo de la transacción, con sus datos de cabecera y el detalle de cada elemento procesado. El objetivo de esta sección es brindar una visión detallada y organizada de la transacción para facilitar la revisión y análisis de sus componentes, permitiendo a los usuarios identificar rápidamente cualquier discrepancia o información adicional que se requiera para la gestión y auditoría de operaciones.



Detalle de elementos en Pantalla

Cabecera: La sección de Cabecera muestra un resumen de los datos generales de la transacción. Los elementos que se presentan en esta sección incluyen:

  • Tienda: Indica el nombre o número de la tienda en la que se generó la transacción.
  • Terminal: Muestra el número de terminal desde donde se realizó la operación.
  • Nro: Número único de la transacción para identificarla en el sistema.
  • Fecha: Fecha y hora en la que se realizó la transacción, proporcionando contexto temporal para el registro.
  • Estado: Indica el estado de la transacción, como "Procesado" o "Error".
  • Tipo: Especifica el tipo de operación, como "Sale" (venta) u otros tipos de transacciones.
  • Origen: Muestra el origen de la transacción, que puede ser "POS" (punto de venta) o "BM" (Bridge Manager).
  • Usuario: Nombre del usuario que ejecutó la transacción.
  • Período - Subperíodo: Detalla el período contable al que pertenece la transacción, útil para fines de auditoría y contabilidad.

Detalle de Envío : La sección Detalle de Envío presenta la información completa de la transacción en formato JSON, la cual incluye configuraciones, propiedades, datos de la transaccion y datos adicionales que fueron enviados en la transacción.





REPROCESAR TRANSACCIÓN

La sección Reproceso de Transacciones está diseñada para gestionar las transacciones que han fallado en su procesamiento inicial, presentándose en el sistema con un estado de "Error". Esta funcionalidad permite a los usuarios reintentar el procesamiento de dichas transacciones mediante un simple comando de reproceso, enviando la transacción nuevamente a través del sistema vía API. El objetivo del reproceso es corregir posibles errores y asegurar que las transacciones se completen adecuadamente, actualizando su estado a "Procesado" o "Error" en función del resultado. Esta herramienta es fundamental para mantener la integridad operativa y resolver errores sin la necesidad de intervenciones manuales prolongadas.




En las transacciones con estado "Error", al acceder al "Detalle" se podrá consultar el campo "errorDetail" para obtener información sobre el posible error de procesamiento registrado por la API de BRIDGE.


...    "errorDetail" : {
        "message" : "[\"La sumatoria de los pagos debe ser igual al monto del pedido.\"]",
        "stack" : "NapseException: [\"La sumatoria de los pagos debe ser igual al monto del pedido.\"]\n    at /datadrive/bridgeCentral/bridgeapi/dist/services/order/order.services.js:1217:15\n    at Generator.next (<anonymous>)\n    at fulfilled (/datadrive/bridgeCentral/bridgeapi/dist/services/order/order.services.js:24:58)\n    at process.processTicksAndRejections (node:internal/process/task_queues:95:5)"
    },
    "originalPeriodCode" : null,
    "originalPeriodNumber" : null,
    "originalSubPeriodCode" : null,
    "originalSubPeriodNumber" : null,
    "trxExecutedQty" : 3
}