📖 Ayuda del Sistema — FABAL FRIO

📋 Resumen general

Este es un sistema de Punto de Venta (POS) diseñado para operar en terminales locales. Funciona desde el navegador web y no requiere conexión a internet para las operaciones diarias.

Las principales áreas del sistema son:

• /pos — Pantalla de venta (la Caja que usa el cajero)
• /admin — Panel de administración (productos, categorías, promociones, usuarios, configuración, etc.)
• /conteo — Conteo físico de inventario
• /ventas-cloud — Consulta de ventas de todas las sucursales (solo en modo cloud)
• /panel — Dashboard de analítica de ventas
• /ayuda — Esta página de ayuda

🕐 Abrir / cerrar jornada

Antes de realizar ventas, es necesario abrir una jornada (turno). La jornada registra quién opera la caja y el efectivo inicial.

Abrir jornada

1. En la pantalla del POS, haz clic en el botón Abrir Jornada que aparece en el centro.
2. Selecciona el cajero de la lista.
3. Ingresa el monto de efectivo inicial en la caja (fondo).
4. Confirma para iniciar la jornada.

Cerrar jornada

1. Haz clic en el ícono de jornada en la barra inferior.
2. Ingresa el efectivo de cierre contado en la caja.
3. Opcionalmente agrega notas del turno.
4. Confirma el cierre. El sistema calculará automáticamente: total de ventas, transacciones, efectivo esperado y la diferencia.

🛒 Agregar productos al pedido

Hay varias formas de agregar productos al carrito:

Desde el catálogo

1. Selecciona una categoría en la parte superior de la pantalla.
2. Haz clic en el producto deseado en la grilla.
3. El producto se agrega al carrito a la derecha.

Cada producto se comporta distinto según su tipo (el ícono lo indica):

• Simple — un toque lo agrega directo al carrito (1 unidad).
• 🧑‍🍳 Preparado / armado — abre un asistente por pasos (ver Producto armado).
• 🧮 Por cantidad / peso — pide una cantidad decimal (ver Producto por cantidad).

Buscar productos

Usa la barra de búsqueda (🔍) en la parte superior para buscar por nombre, SKU o código. Los resultados se filtran en tiempo real. Al tocar el campo de búsqueda se abre automáticamente el teclado de texto en pantalla (si está habilitado).

Código de barras y balanza

Si tienes un lector de código de barras, simplemente escanea el producto. El campo de código de barras (fondo ámbar) está siempre activo y detecta la lectura al presionar Enter.

El sistema es inteligente al leer:

1. Primero intenta interpretar el código como una etiqueta de balanza (formato con PLU + peso). Si coincide, busca el producto por su PLU y calcula el precio según el peso pesado (precio por kilo × peso).
2. Si no es una etiqueta de balanza, hace una búsqueda normal por código de barras.
3. Si no encuentra nada, muestra "Producto no encontrado para código: …".

🧮 Producto por cantidad / peso

Algunos productos se venden por cantidad decimal (por ejemplo 0,5 · 1 · 1,15 · 2). Al tocarlos se abre un diálogo:

1. Muestra el precio base por unidad.
2. Ingresa la cantidad (acepta punto o coma como separador decimal) o usa los botones rápidos (0,5 / 1 / 1,15 / 1,5 / 2).
3. Confirma con Enter o "Agregar al carrito". La línea cobra precio base × cantidad.

Estos productos se configuran en Admin → Productos por Cantidad (ver esa sección).

🧑‍🍳 Producto armado (asistente de preparación)

Los productos como helados, packs o combos se arman en la caja con un asistente por pasos que aparece en una ventana flotante (el carrito de fondo no se pierde).

1. Toca el producto (marcado con 🧑‍🍳). Se abre el asistente.
2. Avanza por los pasos eligiendo las opciones (base, sabores, endulzantes, toppings…). Según el paso, puedes elegir una opción, varias, o repetir la misma varias veces (con los botones + / −).
3. El asistente valida los mínimos y máximos de cada paso (por ejemplo "elige exactamente 2", "hasta 3 toppings").
4. Al final ves un resumen con el desglose y el total.
5. Toca ✓ Confirmar para enviarlo al carrito.

🧾 Gestión del carrito

El carrito muestra el pedido actual (a la izquierda o derecha, según la configuración).

• Cambiar cantidad: botones + y − junto a cada producto.
• Duplicar ítem (⧉): para productos armados, crea una copia idéntica de la preparación.
• Quitar adicional: botón ✕ junto a cada adicional de un producto armado.
• Eliminar ítem: botón de eliminar (✕) del producto.
• Limpiar carrito: botón Limpiar en el encabezado del carrito para vaciar todo.

Abajo del carrito aparecen Subtotal, Descuento manual (si aplicaste uno), Promociones automáticas (🎁, con el detalle por promoción) y el Total. El botón "Cobrar $Total" expande u oculta los botones de pago para ganar espacio en pantalla.

👤 Asociar cliente a la venta

Debajo del número de pedido hay un campo para asociar un cliente a la venta.

1. Escribe el nombre o RUT del cliente (mínimo 2 caracteres).
2. Se mostrará una lista de sugerencias de clientes registrados en el sistema.
3. Selecciona el cliente de la lista usando el mouse o las teclas ↑ ↓ y Enter.
4. Si el cliente no está registrado, puedes escribir su nombre manualmente como referencia.

Al seleccionar un cliente registrado, su ID queda vinculado a la venta para gestión futura y promociones. Los clientes VIP se marcan con una etiqueta especial.

Para quitar la selección, haz clic en el botón ✕.

💰 Cobrar la venta

Cuando el pedido esté listo, procede al cobro. Hay varias formas de pago.

Pago rápido

Los medios marcados como "acceso rápido" aparecen como botones en el carrito:

• 💵 Efectivo: abre un diálogo con teclado numérico y atajos ($1.000, $2.000, $5.000, $10.000, $20.000, Exacto). Muestra en vivo el Vuelto (verde) si el monto alcanza, o lo que Falta (rojo) si no.
• Medios con referencia: piden un código obligatorio (por ejemplo el N° de pedido de una app de delivery).
• Otros medios: cobran el total exacto de inmediato.

Pago mixto (Checkout)

Usa el botón Cobrar / Checkout para combinar varios medios de pago en una misma venta. Con "+ Agregar medio de pago" añades filas; cada una con su medio, monto y referencia. El sistema valida que los montos cuadren.

Pago con terminal de tarjeta

Para medios conectados a un terminal físico (Transbank, MercadoPago, MP QR) el sistema:

1. Abre un diálogo con los pasos del pago.
2. Verifica que el terminal esté disponible antes de pedir la tarjeta.
3. Muestra los mensajes en vivo del pinpad ("INSERTE TARJETA", "INGRESE CLAVE").
4. Confirma la venta al aprobarse, o muestra el error.

El botón Cancelar aborta el cobro y devuelve el terminal a su estado normal.

Otros pagos

El menú 💼 Otros pagos en la barra inferior lista los medios que no son de acceso rápido.

Al completar la venta se muestra ✅ Venta Completada con el folio, el total y el vuelto. Desde ahí puedes 🖨️ Ver Boleta o iniciar una Nueva Venta.

🏷️ Promociones en el POS

El menú 🏷️ Promociones → "Ver promociones activas" abre una tabla con las promociones vigentes. Cada una tiene un estado con semáforo:

• 🟢 Aplica auto — ya está surtiendo efecto sobre el carrito; muestra el ahorro.
• 🟠 Manual — el cajero la activa o la quita con un botón.
• 🔵 Requiere código — botón Aplicar que pide el código promocional.
• ⚪ No aplica — existe, pero el carrito actual no cumple las condiciones.

La tabla tiene filtro de texto y muestra tipo, valor, código, días, horario, mínimo, vigencia y ahorro. Solo aparecen las promociones activas, dentro de fecha y del canal actual (normal o delivery).

✂️ Descuento manual

Además de las promociones, el cajero puede aplicar un descuento puntual a la venta:

1. Abre el formulario de descuento manual.
2. Elige el tipo: Porcentaje (ej. 10 = 10%) o Monto fijo (ej. 500 = $500).
3. Aplica. El descuento nunca supera el subtotal, y el porcentaje debe estar entre 0 y 100.

El botón ✕ junto a "Descuento" en el carrito lo quita.

🛵 Modo Delivery

La caja puede operar en modo normal (mostrador) o delivery. Cada modo tiene sus propios productos y promociones, que no se mezclan.

• El botón del encabezado alterna 🛵 Delivery ↔ 🏪 Volver a Normal.
• Al cambiar de modo se limpia el carrito (pide confirmación si tiene ítems) y la pantalla cambia de color para que se note.
• Puede volver solo al modo normal después de cada venta de delivery, si así se configuró.

🧾 Historial de ventas

Desde el POS accedes al historial de ventas, con dos pestañas: Historial de Venta y Jornadas.

• Cajero: ve solo las ventas de su jornada actual.
• Administrador: ve el historial completo, con selector "Todas / Jornada actual" y filtro por rango de fechas.

La tabla muestra fecha, hora, folio, terminal, detalle, total y estado, con opción de ver la boleta. Puedes exportar a Excel (XLSX) o JSON. En la pestaña Jornadas ves los turnos con su diferencia de caja y puedes ver, imprimir o reenviar por correo el cierre Z.

🔄 Actualizar catálogo

El menú 🔄 Catálogo en la barra inferior permite traer los últimos productos, precios y promociones desde el servidor central:

• Buscar actualización: revisa si hay una versión nueva (aparece un punto naranja si la hay).
• Sincronizar ahora: descarga e importa el catálogo. No toca ventas, jornadas ni inventario. Si ya estás al día, avisa "sin cambios".

⚙️ Menú de configuración

El ícono de engranaje ⚙️ en la esquina superior derecha abre el menú de configuración de la caja:

• 🖥️ Pantalla: tamaño de los botones (Normal / Grande / Compacto), posición del carrito (izquierda / derecha), pantalla completa, diagnóstico de resolución y recargar el POS.
• Sesión: iniciar o cerrar sesión; muestra el usuario y su rol.
• Inventario: acceso al conteo de inventario.
• Gestión (según permisos): Administración, Panel de ventas, SGO Cloud · Ventas, SAP Hana · Envíos y Ayuda.

Las preferencias visuales se guardan en cada terminal. Un doble clic en el logo oculta o muestra la información del encabezado.

Tema claro / oscuro

Haz clic en el ícono 🌓 para alternar entre tema claro y oscuro. La preferencia se guarda automáticamente.

⌨️ Teclados en pantalla

Para usar el sistema con pantalla táctil, hay dos teclados en pantalla (se habilitan desde la configuración):

• Numérico: dígitos, borrar y Enter. Se abre desde el menú "⌨️ Teclado" y apunta al campo de código de barras.
• Texto (QWERTY): con letras (incluida ñ), Shift, Bloq Mayús, espacio y símbolos. Se abre automáticamente al tocar la búsqueda.

🔧 Panel de administración

Accede desde /admin o desde el menú de configuración → Gestión → Administración. Requiere perfil de administrador o root.

El menú lateral está organizado en grupos:

• Catálogo: Productos, Productos por Cantidad, Categorías, Descuentos, Clientes, Asistentes.
• Inventario: Inventario, Historial Stock, Inventario Conteo.
• Cloud: SAP, Sincronización.
• Pagos: Terminal TBK, Terminal MP, Medios de Pago.
• Sistema: Usuarios, Jornadas, Folios, Agentico (IA), Bitácora, Configuración, Actualización, Herramientas.

📦 Productos

Gestión completa del catálogo: crear, editar, desactivar. El formulario está organizado en cuatro pestañas:

• General: Nombre, SKU, Categoría, Tipo, código de barras, unidad de medida (UN/KG/LT), canal de venta (Normal / Delivery / Ambos), Activo y descripción.
• Comercial: Precio, Costo, Tasa IVA (ej. 1900 = 19%), stock inicial (al crear), orden general y orden dentro de la categoría.
• Preparación: "barras base que descuenta" y perfil de tamaño (Simple/Mediano/Doble/Triple/ToGo), usado por el asistente para cobrar bases según el tamaño.
• Visual: color del botón e imagen.

La lista tiene buscador en vivo y muestra color, SKU, categoría, precio, costo, barras base, stock (físico/lógico, en rojo si ≤5), tipo, canal y estado. Eliminar equivale a desactivar (borrado lógico, se puede reactivar).

El sistema soporta tres tipos de producto, según cómo se vendan en el POS:

• Simple — un ítem único con precio fijo (ej. una bebida, un alfajor).
• Configurable — un ítem cuyo precio o variante depende de modificadores (ej. tamaño, sabor).
• Compuesto — un ítem armado en el POS combinando un producto base obligatorio + adicionales opcionales (ej. un helado con sabor + toppings).

🟢 Crear un producto simple

Es el caso más común. El producto se vende tal cual, con un precio fijo.

1. Ve a Admin → Productos.
2. En el formulario "Nuevo Producto", completa los campos:
   • Nombre *: nombre visible en el POS.
   • SKU *: código interno único.
   • Categoría *: a qué categoría pertenece.
   • Tipo: selecciona Simple.
   • Precio: precio de venta (sin decimales en CLP).
   • Costo: opcional, para reportes de margen.
   • Código de barras: opcional, para lectura con escáner.
   • Tasa IVA: ej. 1900 = 19%, 0 = exento.
   • Stock inicial: cantidad física al momento de crear.
   • Color: color del botón en el POS.
   • Activo: marcar para que aparezca en el POS.
3. Haz clic en Crear Producto.

✨ Crear producto simple de ejemplo Crea "Ejemplo Bebida 500ml" en la categoría Ejemplos.

🔵 Crear un producto configurable

Un producto configurable tiene grupos de modificadores (ej. "Tamaño", "Sabor") con opciones que pueden ajustar el precio. Al agregarlo al carrito, el cajero elige las opciones.

1. Crea primero el producto como en el caso simple, pero selecciona Tipo: Configurable.
2. El precio base es el precio mínimo (sin modificadores). Las opciones pueden sumarle valor.
3. Guarda el producto. Después abre Editar para definir los modificadores.
4. En la edición, agrega grupos de modificadores:
   • Nombre del grupo: ej. "Tamaño", "Sabor", "Acompañamiento".
   • Mín / Máx: cuántas opciones del grupo se deben elegir (ej. 1/1 obligatorio uno, 0/3 hasta tres opcionales).
   • Orden: secuencia en la que se muestran al cajero.
5. Para cada grupo, agrega opciones:
   • Nombre: ej. "Pequeño", "Mediano", "Grande".
   • Ajuste de precio: monto que se suma (o resta, con valor negativo) al precio base.
   • Por defecto: si la opción viene preseleccionada.

Ejemplo: Café configurable con base $1.500.

• Grupo "Tamaño" (1/1): Pequeño +$0, Mediano +$500, Grande +$1.000.
• Grupo "Leche" (0/1): Sin leche +$0, Almendras +$400, Avena +$400.

✨ Crear producto configurable de ejemplo Crea "Ejemplo Café Configurable" con grupos Tamaño y Leche.

🟣 Crear un producto compuesto

Un producto compuesto (también llamado "master") se arma combinando productos reales: una base obligatoria tomada de una categoría, más adicionales opcionales tomados de otra categoría. Es ideal para productos como helados (vaso + sabores + toppings).

Pre-requisito: primero debes crear las categorías y productos que harán de base y de adicionales.

1. Ve a Admin → Categorías y crea las categorías auxiliares con su rol:
   • Una categoría con rol composition_base (ej. "Sabores Helado"). Sus productos serán las bases válidas.
   • Una categoría con rol composition_addon (ej. "Toppings"). Sus productos serán los adicionales.
2. En Admin → Productos, crea los productos que irán dentro de cada categoría auxiliar (ej. "Chocolate", "Vainilla" en Sabores; "Maní", "Salsa de fresa" en Toppings). Estos sí son productos simples con su propio precio.
3. Crea el producto compuesto:
   • Tipo: Compuesto.
   • Categoría: la categoría visible donde aparecerá en el POS (ej. "Helados").
   • Precio: el precio del envase / cargo base. Los sabores y toppings suman su propio precio al total.
   • Categoría base (composite_base_cat_id): la categoría con rol composition_base.
   • Categoría adicionales (composite_addon_cat_id): la categoría con rol composition_addon.
4. Guarda. Al tocar el producto en el POS se abrirá un asistente que pide elegir la base y luego permite agregar adicionales antes de mandarlo al carrito.

Ejemplo completo: "Vaso Doble"

• Categoría "Sabores Helado" (rol composition_base) → productos: Chocolate ($1.500), Frutilla ($1.500), Vainilla ($1.500).
• Categoría "Toppings" (rol composition_addon) → productos: Maní ($300), Salsa Manjar ($400), Granas ($200).
• Producto "Vaso Doble" (tipo Compuesto, precio base $500, base = Sabores, addons = Toppings).
• El cajero arma el producto: Vaso Doble + Chocolate + Frutilla + Maní = $500 + $1.500 + $1.500 + $300 = $3.800.

✨ Crear producto compuesto de ejemplo Crea categorías Ejemplo Sabores + Ejemplo Toppings y el master "Ejemplo Vaso Doble".

🧮 Productos por Cantidad / precios por tamaño

Esta sección tiene dos módulos:

🍨 Precios de bases por tamaño

Para bases cuyo precio cambia según el tamaño del producto armado. Es una grilla donde cada SKU tiene un precio por columna: Simple, Mediano, Doble, Triple, ToGo Small, ToGo Big. El asistente elige la columna según el perfil de tamaño del master. Un precio en 0 elimina esa fila.

🧮 Productos por Cantidad (Factor)

Para productos vendidos por cantidad decimal (ej. 0,5 · 1,15). Se define un precio base por unidad; en el POS el cajero informa la cantidad y la línea cobra precio × cantidad. Un precio en 0 desactiva el modo cantidad.

🏷 Categorías

Organiza los productos en categorías. Cada categoría tiene nombre, rol (Normal / Base de composición / Addon de composición), color, ícono, orden y estado.

• Productos por categoría: desde una categoría puedes agregar/quitar productos y ajustar su orden dentro de la categoría.
• Visibilidad en POS: puedes ocultar o mostrar una categoría por terminal. Esta decisión se guarda localmente, así que una sincronización de catálogo no la reemplaza. Ocultar una categoría también oculta sus productos en la búsqueda de esa caja.

🎫 Descuentos y promociones

Motor completo de promociones. Tipos disponibles: compra X lleva Y (2x1, 3x2, 2ª unidad -%), porcentaje, monto fijo, por medio de pago, franja horaria (happy hour), día de la semana, cliente VIP, código promocional, N x precio fijo, 2ª unidad a $ fijo, descuento por cantidad y pack a $ fijo.

Hay tres formas de crear una promoción:

• Express: 14 tarjetas preset con solo los campos mínimos.
• Agente IA (beta): describes la promoción en lenguaje natural y la IA la arma para que la revises (requiere modelo IA configurado).
• Builder detallado: formulario por secciones — tipo, cuánto descuenta, alcance (productos y/o categorías; vacío = todo el catálogo), cómo se aplica (automática o manual, canal, base del descuento), condiciones (días, horario, vigencia, monto mínimo, solo VIP) y límites (prioridad, acumulable, tope, límite de usos).

Además puedes usar el selector visual de alcance (con vista previa de cuántos productos coinciden), exportar/importar promociones entre locales (por SKU y nombre de categoría), desactivar todas y restaurar las plantillas por defecto.

👥 Clientes

Registro de clientes con nombre, RUT, email, teléfono y marcador VIP (usado por las promociones VIP). Los clientes registrados aparecen en el autocompletado del POS.

🧑‍🍳 Asistentes de venta

Convierten un producto "master" (helado, pack, combo) en una venta guiada por pasos. Es el motor detrás de los productos armados del POS.

1. Crear: elige el producto master (o escribe un nombre), opcionalmente desde una plantilla. Se crea inactivo y abre el editor.
2. Editor: define los productos master y los pasos de la preparación. Cada paso tiene título/ayuda, origen (una categoría completa o productos específicos) y opciones: obligatorio, permitir varios, repetible, se cobra, descuenta barras base, y cantidad total mín/máx (mín=máx exige una cantidad exacta).
3. Los cambios se aplican al POS sin reiniciar.

📊 Inventario / Stock

Control del stock de productos:

• Ajuste de stock: selecciona un producto, el tipo de movimiento (Ajuste / Compra-Ingreso / Devolución / Inventario inicial), la cantidad (positivo = entrada, negativo = salida) y una nota.
• Inventario actual: stock físico y lógico de todos los productos (en rojo si ≤5).
• Historial de stock: todos los movimientos con fecha, producto, tipo, cantidad, stock anterior/posterior, referencia (por ejemplo la venta que descontó) y notas.

📐 Inventario Conteo

Permite hacer inventarios físicos mediante plantillas.

1. Plantillas (Admin): defines qué productos contar en cada plantilla, con nombre, descripción, estado (activa/visible) y orden.
2. Conteo (menú ⚙️ → Inventario, o /conteo): eliges una plantilla activa e ingresas las cantidades. La coma es el único separador decimal (ej. "3,2"; el punto se rechaza). Un contador en vivo muestra "X de N contados".
3. Borradores: el conteo se auto-guarda; al reabrir la plantilla se rellenan las cantidades del borrador (con opción de descartar).
4. Finalizar: avisa cuántos ítems faltan (quedan en 0) y guarda el conteo.

El historial guarda los últimos conteos (Borrador o Finalizado). Los finalizados se pueden ver, imprimir y enviar por correo.

💰 Medios de pago

Define qué formas de pago se aceptan. Cada medio tiene código, etiqueta, ícono, color, terminal asociado (Sin terminal / Transbank / Mercado Pago / MP QR), orden, acceso rápido (botón en el POS) y solicitar referencia (pide un código al cobrar). Los medios que no son de acceso rápido aparecen en "Otros pagos" del POS.

💳 Terminales (Transbank / MercadoPago)

Paneles para operar y probar los terminales de tarjeta:

• Terminal TBK (Transbank): muestra el estado del pinpad y permite ejecutar comandos directos (verificar estado, cargar llaves, totales, detalles, última venta, cerrar lote, volver a modo normal).
• Terminal MP (MercadoPago Point / QR): muestra el estado y permite verificar la conexión y hacer un cobro de prueba.

Los tokens e identificadores de cada terminal se editan en la configuración del sistema.

👤 Usuarios (cajeros)

Administra los usuarios que operan el sistema. Cada uno tiene nombre, PIN de acceso y estado activo/inactivo.

🕐 Jornadas

Historial completo de jornadas con estado, cajero, fechas, fondo inicial, ventas, transacciones, efectivo esperado, efectivo de cierre y diferencia. Permite ver/imprimir el cierre Z y reenviarlo por correo.

🧾 Folios

Control centralizado de la numeración de boletas (CAF). Muestra el próximo folio, los folios restantes (con %), el último emitido y alertas (agotados / quedan pocos). El formulario define folio inicial, final, actual y % de alerta.

⚙ Configuración

Configuración general del sistema, en cinco pestañas:

• Impresión: impresoras (boleta, DNF, comanda de cocina), ancho de papel, comandos de corte y de apertura de gaveta, y pruebas de hardware (probar corte, gaveta, boleta DNF y comanda).
• DNF y DTE: activar DNF (imprime local y delega el timbraje al cloud), emisión local de DTE, tipo de documento (39/41), resolución SII, giro y datos legales de la boleta.
• Dispositivos: balanza (prefijo, longitudes, divisor de peso) y teclados en pantalla.
• Pantalla POS: botones de productos y categorías (columnas, filas, alto, escala de texto) y Modo Delivery (habilitar, color, tema y comportamiento tras cada venta).
• Notificaciones: destinatarios de correo para apertura, cierre y reportes Z.

🛠 Herramientas

Control del sistema y operaciones de base de datos:

• Reiniciar / Detener POS.
• Restaurar / poblar desde JSON (solo root): borra los datos actuales y restaura desde un respaldo, URL o archivo. Requiere escribir "RESTAURAR".
• Limpiar base de datos (solo root): vacía todas las tablas. Requiere escribir "BORRAR". Irreversible.
• Descargar dumps (solo root): expone respaldos JSON como URL para que otro POS restaure desde ellos.

⬆️ Actualización

Actualización del programa a la última versión publicada:

• Buscar actualizaciones y aplicar ahora (descarga, valida la integridad, instala y reinicia).
• Chequeo automático: habilitar, URL del manifiesto y frecuencia. La actualización automática solo se aplica cuando no hay turno abierto.

🔄 SAP Hana

Conecta el POS con SAP Hana (Business One). La sección está organizada en pestañas:

• Configuración: series, bodega, socio de negocio y el envío automático de cada boleta a SAP Hana.
• Envíos a SAP Hana: registro de ventas enviadas (Enviada / Falló / No enviada), reenviar una venta, generar una gran boleta consolidada (varias ventas en un documento) y reprocesar los envíos marcados en SGO Cloud.
• Catálogo SAP Hana: consultar productos de SAP Hana, comparar el catálogo POS vs SAP Hana y copiar/actualizar productos al POS (individual o masivo).

🔄 Sincronización SGO Cloud

Mantiene el catálogo actualizado en todas las cajas desde un servidor central (SGO Cloud / Azure SQL). Incluye:

• URL pública del catálogo para que otras cajas descarguen.
• Configuración: modo SGO Cloud o local, sincronización automática + intervalo, endpoint y API key.
• Pull manual: reemplaza solo los datos del catálogo (no toca ventas, jornadas ni stock); requiere escribir "PULL".
• Snapshots publicados e historial de sincronizaciones.

☁️ SGO Cloud · Ventas y Envíos SAP Hana

SGO Cloud es la base central (Azure SQL) donde se consolidan los datos de todas las sucursales. Ofrece dos consolas (solo en modo cloud):

• SGO Cloud · Ventas (/ventas-cloud): consulta de las ventas de todas las sucursales.
• SAP Hana · Envíos (/envios-sap): registro de los envíos a SAP Hana con su estado y error; el usuario revisa los que fallaron (típicamente por falta de stock), y tras corregir en SAP Hana los marca para que el POS los reenvíe.

La consola de ventas permite:

• Filtros: rango de fechas, sucursal, terminal, estado, folio y búsqueda libre.
• KPIs: boletas, total, neto, IVA, ticket promedio, anuladas y desglose por forma de pago.
• Detalle de cada venta (productos, totales y formas de pago).
• Anular una boleta con motivo obligatorio (registra quién y cuándo; no altera montos).
• Exportar el conjunto filtrado a Excel o JSON.

🧠 Inteligencia Artificial

El sistema incluye ayudantes con inteligencia artificial (requieren configurar el modelo en Modelos IA):

• Consultas IA: preguntas en lenguaje natural (ej. "¿los 5 productos más vendidos este mes?") que la IA responde con una tabla. Solo consulta datos, nunca los modifica.
• Agentico (chat IA): un asistente conversacional que responde sobre el negocio y muestra gráficos, KPIs y rankings. Guarda las conversaciones por hilo y permite exportarlas a HTML.
• IA de promociones: genera una promoción a partir de una descripción en lenguaje natural.

📓 Bitácora

Un cuaderno interno para registrar avances del proyecto (features, correcciones, tareas, observaciones, hitos) con estado, prioridad, etiquetas y detalle. Incluye estadísticas y filtros.

📊 Panel de ventas (Dashboard)

Accede desde /panel. Muestra analítica de ventas con:

• KPIs: Total ventas, ingresos, ticket promedio, descuentos, artículos vendidos.
• Gráficos: Tendencia diaria, métodos de pago, ventas por día de semana, ventas por hora, productos más vendidos.
• Tablas: Top productos y detalle de promociones aplicadas.
• Filtro de fechas: Hoy, esta semana, este mes, este año, o rango personalizado.

💾 Respaldo de datos

El sistema genera respaldos automáticos de la base de datos. También puedes crear un respaldo manual desde el menú de configuración de la caja (según tus permisos). El respaldo guarda ambas bases de datos (la transaccional y la maestra) con marca de tiempo, en la carpeta de respaldos.