Dashboard
📦
—
Productos
🏷️
—
Unidades en Stock
💰
—
Ventas Hoy
💵
—
Total Hoy
🎫
—
Ticket Promedio
📂
—
Importaciones
Acciones Rápidas
Alertas de Stock
Última Actividad
Catálogo de Productos
Cargando…
0 seleccionados
Punto de Venta
Carrito Actual
🛒
Carrito vacío
Historial de Ventas
#FechaClientePagoItemsTotal
Movimientos de Stock
FechaProductoCódigoTipoCantidadMotivo
Importar Catálogo
Vacío: se toma del nombre del archivo
📦 Carga masiva de catálogo
Respeta precio de venta, stock y código de barras del archivo
📄 Proveedor desde columna
Usa la columna proveedor del archivo (ignora el campo)
📄
Arrastrá o hacé clic para subir un archivo
DOCX, XLSX, XLS, CSV — máx 32MB
Historial de Importaciones
Mapeos Aprendidos

El sistema aprende automáticamente cómo mapear las columnas de tus archivos a los campos del catálogo. Cuanto más usás el mismo formato, más preciso se vuelve.

Estadísticas
Resultado del período
💵 Facturación
—
📈 Ganancia bruta
—
％ Margen
—
sobre facturación
🧾 Tickets
—
🎫 Ticket promedio
—
📦 Unidades vendidas
—
Inventario foto de hoy, no depende del período
🏭 Valor a costo
—
💰 Ganancia potencial
—
si se vende todo el stock
🧊 Capital sin rotar
—
⚠️ Stock bajo / agotados
—
🔻 Margen a revisar
—
venta ≤ costo
🧮 Stock negativo
—
diferencias a ajustar
📈 Evolución del período
💳 Formas de pago
🧭 Rentabilidad por
CorteFacturaciónGananciaMargen
🏆 Top productos por
ProductoUnid.FacturaciónMargen
🕐 Ventas por hora del día
📅 Ventas por día de la semana
🗓 Últimos 12 meses
📦 Stock por categoría
🧊 Capital sin rotar
Productos con stock que no se vendieron en el período. Es plata comprada que no se mueve.
CódigoProductoStockCapital
🔻 Márgenes a revisar
Se venden por debajo del costo o casi. Suele pasar después de importar una lista de proveedor.
CódigoProductoCostoVentaMargen
👤 Clientes con más compras en el período
ClienteTicketsFacturación
Cuentas Corrientes
💸 Deuda Total
—
✅ Cobros del Mes
—
🧾 Ventas a Cuenta
—
este mes
Cliente Teléfono DNI / CUIT Límite Saldo Estado Acciones
Control de Caja
Cargando cuentas…
📲 Alias registrados
Cargando…
🔍 Filtros
Cuenta
Hora Tipo Concepto Monto
Nuevo movimiento
Proveedores y Pagos
Razón Social CUIT Tipo N° Factura Fecha Monto Factura Monto Pagado Saldo Estado
Gestión de Usuarios
# Usuario Nombre Rol Estado Último acceso Acciones
Log de Actividad
Fecha Usuario Acción Método IP Estado Info
Configuración
Configurá los datos que aparecen en el ticket impreso. El ticket se adapta automáticamente al ancho de tu impresora térmica.
Manual de Uso — StockPro
🏠 StockPro — Sistema de Gestión de Comercio
StockPro es un sistema de punto de venta e inventario diseñado especialmente para comercios. Permite gestionar productos, ventas, stock e importar catálogos de proveedor.
Acceso al sistema
Al abrir la aplicación se solicita usuario y contraseña. El usuario administrador inicial es:
Usuario: admin
Contraseña: admin123

⚠️ Cambiá la contraseña desde Usuarios > Editar.
Navegación
Las pestañas de la barra superior llevan a cada sección. En la esquina superior derecha encontrás: la calculadora 🧮, el carrito 🛒 y el cambio de tema 🌙/☀️.
📦 Productos
Administrá todo tu catálogo de productos: crear, editar, eliminar y actualizar precios.
Buscar productos
Usá el campo de búsqueda para filtrar por nombre, código o categoría. La búsqueda es instantánea.
Agregar / editar producto
Hacé clic en + Nuevo Producto o en el ícono de editar (✏️) en cualquier fila. Los campos obligatorios son Código (único), Nombre y Precio de venta.
Actualización masiva de precios
El botón 📈 Actualizar Precios permite aplicar un porcentaje de incremento o descuento a todos los productos o a una categoría específica. El sistema registra cada actualización en el historial.
Alertas de stock
El Dashboard muestra automáticamente los productos con stock bajo (menor al mínimo configurado) y los productos sin stock. También podés filtrar por stock bajo en la tabla de productos.
🛒 Ventas — Punto de Venta
La pestaña Ventas es el punto de venta (POS). Permite armar un carrito y registrar cobros.
Agregar productos al carrito
Escribí el nombre o código del producto en el buscador. Aparecerán las tarjetas con precio y stock. Hacé clic para agregar al carrito.
Ajustar cantidades
Una vez en el carrito, usá los botones + y − para cambiar las cantidades, o el botón ✕ para eliminar un ítem.
Finalizar venta
  1. Seleccioná el método de pago: Efectivo, Transferencia o Tarjeta.
  2. Para Transferencia: ingresá el alias o CBU (con autocompletado de los últimos usados).
  3. Opcionalmente ingresá el nombre del cliente.
  4. Hacé clic en ✅ CONFIRMAR VENTA.
  5. El sistema emite el ticket automáticamente (si está configurado).
Historial de ventas
Debajo del POS se listan todas las ventas del sistema con fecha, cliente, método de pago e importe. Hacé clic en una venta para reimprimir el ticket.
🖨️ Ticket de impresión térmica
StockPro genera tickets compatibles con impresoras térmicas de 58 mm y 80 mm.
Configurar el ticket
Ir a Configuración → 🎫 Ticket y completar:
  • Nombre del negocio: aparece en el encabezado en grande.
  • Dirección, Teléfono, CUIT: datos de contacto.
  • Mensaje final: texto al pie del ticket (ej: "¡Gracias por su compra!").
  • Ancho del papel: 58 mm o 80 mm según tu impresora.
  • Imprimir automáticamente: si está activado, abre la ventana de impresión al confirmar cada venta.
Vista previa
El botón 👁 Vista previa muestra cómo quedaría el ticket con datos de muestra sin necesitar hacer una venta real.
Imprimir manualmente
Si la impresión automática está desactivada, después de cada venta aparece un enlace "Imprimir ticket" en la notificación. También podés hacerlo desde el historial de ventas.
Configurar impresora en Windows
1. Instalá el driver de tu impresora térmica.
2. En el diálogo de impresión del navegador, seleccioná tu impresora térmica.
3. Configurá el tamaño de papel como "Rollo" o el equivalente (58mm / 80mm).
4. Desactivá encabezados y pies de página del navegador.
5. Guardá como impresora predeterminada para esa ventana.
📥 Importar Catálogo
Importá productos masivamente desde archivos Excel (.xlsx, .xls), CSV o DOCX con listas de precios.
Proceso de importación
  1. Ir a la pestaña Importar.
  2. Arrastrá o seleccioná el archivo.
  3. El sistema detecta automáticamente las columnas (aprende de importaciones anteriores).
  4. Revisá y ajustá el mapeo de columnas si es necesario.
  5. Hacé clic en Importar para procesar.
Formatos soportados
  • Excel (.xlsx, .xls): ideal para listas de precios de proveedores.
  • CSV: exportaciones de otros sistemas.
Columnas reconocidas
codigo, nombre, precio_venta, precio_compra, stock_actual, stock_minimo, categoria, proveedor
Aprendizaje automático
Cada vez que mapeás una columna manualmente, el sistema la recuerda para futuras importaciones del mismo proveedor. Podés ver y gestionar estos mapeos en la pestaña Mapeos.
📊 Movimientos de Stock
Registra todo el historial de entradas, salidas y ajustes de inventario.
Registrar entrada manual
Ir a Movimientos → + Agregar movimiento. Seleccioná el producto, tipo (entrada/salida/ajuste), cantidad y motivo.
Tipos de movimiento
  • Entrada: mercadería recibida (suma al stock).
  • Salida: mercadería enviada o perdida (resta al stock).
  • Ajuste: corrección de inventario (puede ser positivo o negativo).
📈 Estadísticas
Visualizaciones y reportes de ventas, stock y rendimiento del negocio.
Gráficos disponibles
  • Ventas por período (diario / semanal / mensual).
  • Ventas por hora del día.
  • Distribución por método de pago.
  • Top productos más vendidos.
  • Stock por categoría.
  • Ventas de la semana actual vs semana anterior.
KPIs del dashboard
En la pestaña Dashboard se muestran los indicadores clave: ventas del día, total facturado, ticket promedio, productos sin stock y con stock bajo.
💾 Backups de Base de Datos
El sistema crea automáticamente un backup de la base de datos cada vez que inicia, si no existe uno para el día actual. Los backups se guardan en la carpeta backups/ del servidor.
Backup automático
Ocurre al arrancar el servidor. Se crea un archivo backup_YYYYMMDD_HHMMSS.db. Se conservan los últimos 30 backups.
Backup manual
Ir a Configuración → 💾 Backups y hacer clic en ➕ Crear backup ahora.
Descargar backup
En la lista de backups hacé clic en ⬇️ Descargar para guardar el archivo en tu computadora. Es un archivo SQLite que podés abrir con cualquier visor de SQLite.
Restaurar backup
1. Detené el servidor (Ctrl+C en la terminal).
2. Reemplazá el archivo catalog.db con el backup descargado.
3. Reiniciá el servidor.
⚙️ Configuración
Accedé a Configuración desde la barra de navegación. Contiene tres secciones:
🎫 Ticket
Configura los datos del negocio, formato del ticket y opciones de impresión. Ver la sección 🖨️ Ticket para más detalle.
💾 Backups
Lista de backups disponibles con opción de crear, descargar y eliminar. Ver 💾 Backups.
🤖 Entrenamiento IA
Gestión de ejemplos de entrenamiento para el importador. Ver 🧠 IA Training.
🧠 Entrenamiento IA
StockPro permite mejorar el reconocimiento de columnas del importador agregando ejemplos de entrenamiento reales basados en tus listas de proveedor.
Entrenamiento del Importador
Agregá mapeos de columna → campo para que el importador reconozca automáticamente las columnas de las planillas de tus proveedores. Exportá como JSONL para fine-tuning.
Exportar para fine-tuning externo
Los botones ⬇️ Exportar JSONL generan archivos en formato compatible con HuggingFace, OpenAI y otros frameworks de fine-tuning. Cada ejemplo tiene el formato:
{"messages": [ {"role": "system", "content": "..."}, {"role": "user", "content": "precio de tornillos"}, {"role": "assistant", "content": "...respuesta..."} ]}
👥 Usuarios y Permisos
Solo el administrador puede gestionar usuarios. Ir a la pestaña Usuarios.
Roles
  • admin: acceso completo a todo el sistema.
  • operator: puede leer y escribir, pero no eliminar.
  • viewer: solo lectura.
Permisos por recurso
Para cada usuario podés configurar individualmente los permisos de lectura, escritura y eliminación sobre: Productos, Ventas, Movimientos, Importar, Mapeos, Estadísticas y Actividad.
Cambiar contraseña
Editá un usuario y completá el campo Nueva contraseña. Dejalo vacío si no querés cambiarla.
⌨️ Atajos de Teclado
TeclaAcción
Alt + VIr a Ventas
Alt + PIr a Productos
Alt + DIr a Dashboard
Alt + CAbrir Calculadora
Alt + TCambiar tema claro/oscuro
F5Actualizar datos del dashboard
EscCerrar modales