Saltar al contenido principal

La operación del punto de venta ya se gobierna (REQ-POS-03)

· 3 min de lectura
Yovany Suárez Silva
Software Engineer - FullStack Developer

El punto de venta cobraba, imprimía y cerraba caja, pero no dejaba gobernarse: no había dónde ver el estado de las cajas, revisar una venta con su trazabilidad, auditar sus movimientos ni analizar la operación con cifras. Y los comprobantes de caja no se podían reimprimir ni reenviar.

Ahora hay cinco páginas propias en el menú —Cajas, Ventas, Movimientos, Estadísticas y Reportes, dentro del grupo Punto de venta— y un ítem Vender en la sección Operación que abre la caja con un clic. Leen el mismo modelo de REQ-POS-01/02, sin tablas paralelas.

Qué cambió​

  • Cajas: grilla con almacén, responsable, apertura y cierre, base inicial, totales y arqueo, con semáforo (abierta, cerrada, cerrada con diferencia). Detalle en modal con desglose por medio de pago, ventas incluidas y resultado del arqueo. El comprobante de apertura y el de cierre se reimprimen y se reenvían por correo sin alterar el turno.
  • Ventas: grilla paginada con filtros por fecha, almacén, cajero, medio de pago y estado, búsqueda por consecutivo o cliente y orden por columna en el servidor. El detalle muestra ítems, impuestos, pagos (referencia enmascarada), trazabilidad de la anulación y los movimientos que produjo. Se descarga o reimprime el comprobante, se reenvía la factura y se anula con confirmación y motivo obligatorio.
  • Movimientos: libro unificado de inventario (salidas y reversas) y caja (apertura, cierre, venta y anulación), con saldo resultante y documento. Cada fila abre el documento que la originó.
  • Estadísticas: total vendido, número de ventas, ticket promedio, anuladas y fuera de horario con comparación contra el periodo anterior, evolución diaria, participación por medio de pago y ranking de artículos. Mismo filtro que la grilla de ventas.
  • Reportes: cierre y apertura de caja, ventas por periodo, por medio de pago, anuladas y movimientos, en PDF, Excel, CSV y Markdown. Los envíos usan Resend, validan el destinatario, quedan registrados con su resultado y pueden reintentarse sin regenerar el documento.

Decisiones que conviene conocer​

  • Una sola fórmula para el arqueo. El total esperado (base inicial + efectivo vendido) y la diferencia se calculan en vivo con las ventas completadas; la grilla, el comprobante y el reporte no pueden discrepar.
  • Un solo generador de documentos. Excel, CSV, PDF y Markdown viven en common/exportacion/exportador-datos; la descarga y el adjunto del correo usan ese mismo binario. El formato Markdown se suma al catálogo del proyecto con la estructura de siempre: título, metadatos y tabla.
  • Reintentar no duplica. pos_envios_reporte guarda el archivo generado (bytea) para reenviarlo tal cual; el documento no cambia si entre intentos entran más ventas.
  • El grid ordena en servidor cuando hace falta. Se añadió onCambioOrden al grid estándar: con paginación, la pantalla vuelve a consultar en vez de reordenar solo la página visible.
  • Todo queda auditado. Consultas de detalle, reimpresiones, exportaciones, anulaciones y envíos se registran en logs_operacion con el usuario del JWT.

Migración​

1792730422563-CreatePosAdmin crea pos_envios_reporte y registra las cinco secciones del menú con su permiso para Administrador, Almacenista, Auxiliar inventario, Cajero y Auditor. No toca las tablas del POS.

Manual actualizado en Manuales → Punto de venta → Administración del POS.