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
CódigoNombreCategoríaProveedor P. CostoP. VentaStockAcciones
Punto de Venta
Carrito Actual
🛒
Carrito vacío
Historial de Ventas
#FechaClientePagoItemsTotal
Movimientos de Stock
FechaProductoCódigoTipoCantidadMotivo
Importar Catálogo
Se asignará a todos los productos importados
Ganancia sobre precio de costo
Ej: 10.5 o 21
🤖 Asistencia con IA
Usa Claude para mapear columnas difíciles
📷 OCR para PDFs
Extrae texto de PDFs escaneados
🗂 Mapeo manual de columnas
Revisá y ajustá el mapeo antes de importar
📄
Arrastrá o hacé clic para subir un archivo
PDF, DOCX, XLSX, XLS, CSV — máx 32MB
🌐 Importar desde URL de proveedor
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
💰 Ventas Hoy
—
📅 Esta Semana
—
📆 Este Mes
—
🎫 Ticket Promedio
—
este mes
🏭 Valor Inventario
—
a precio de costo
⚠️ Stock Bajo / Agotados
—
📈 Ventas por Período
💳 Por Método de Pago
🏆 Top 10 Productos Vendidos
📦 Stock por Categoría
🕐 Ventas por Hora del Día
📅 Ventas por Día de la Semana
Cuentas Corrientes
💸 Deuda Total
—
✅ Cobros del Mes
—
🧾 Ventas a Cuenta
—
este mes
Cliente Teléfono DNI / CUIT Límite Saldo Estado Acciones
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
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 Ferretería
StockPro es un sistema de punto de venta e inventario diseñado especialmente para ferreterías. Permite gestionar productos, ventas, stock, importar catálogos y usar un asistente de IA para operar más rápido.
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 🛒, el asistente IA 🤖 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. También podés usar el Asistente IA con comandos como agrega 2 HER-0829.
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.
🤖 Asistente IA
El asistente de chat permite operar el sistema por lenguaje natural, ideal para usar mientras atendés a clientes sin tener que navegar por menús.
Abrirlo
Hacé clic en 🤖 en la barra superior, o presioná Alt+A. Podés expandirlo con el botón ⤢.
Comandos disponibles
precio de martillos → Consultar precios stock de tornillos → Ver disponibilidad agrega 2 HER-0829 → Agregar al carrito por código agrega 3 martillos Stanley → Agregar por nombre ver carrito → Ver el carrito actual cobrar → Iniciar checkout entraron 50 tornillos 5mm → Registrar mercadería entrante ventas de hoy → Estadísticas del día agotados → Productos sin stock ayuda → Ver todos los comandos
Agregar múltiples productos
agrega 2 PR001, 3 PR002, 1 HER-0496
Errores comunes
  • Si no encuentra el producto, probá escribir el código con o sin guión: HER0829 o HER-0829.
  • Para códigos con espacios, escribilos juntos: her0829 (se normaliza automáticamente).
📥 Importar Catálogo
Importá productos masivamente desde archivos Excel (.xlsx, .xls), CSV o PDF 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.
  • PDF: extrae texto de listas de precios en PDF (requiere que el PDF tenga texto, no sea imagen).
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.
Via Asistente IA
entraron 50 tornillos 5mm llegaron 20 martillos truper recibimos 100 cajas de tornillos
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 asistente de chat y el importador. Ver 🧠 IA Training.
🧠 Entrenamiento IA
StockPro permite mejorar el desempeño de la IA del chat y del importador agregando ejemplos de entrenamiento reales basados en tu negocio.
Entrenamiento del Chat Asistente
Podés agregar pares de pregunta/respuesta que representan conversaciones reales de tu negocio. El sistema los usa para generar un Modelfile personalizado para Ollama que incluye:
  • Todo el catálogo actual como contexto (hasta 250 productos).
  • Ejemplos automáticos generados por categoría.
  • Tus ejemplos personalizados.
  • Parámetros optimizados para respuestas rápidas y precisas.
Cómo crear el modelo personalizado
  1. Ir a Configuración → 🤖 Entrenamiento IA → 💬 Chat Asistente.
  2. Agregá ejemplos de conversación relevantes para tu negocio.
  3. Hacé clic en ⚙️ Generar Modelfile.
  4. Descargá el archivo Modelfile.
  5. En una terminal, ejecutá:
    ollama create stockpro -f Modelfile
  6. El asistente usará el modelo stockpro la próxima vez.
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 + EExpandir/contraer chat
Alt + AAbrir/cerrar Asistente IA
Alt + CAbrir Calculadora
Alt + TCambiar tema claro/oscuro
F5Actualizar datos del dashboard
EscCerrar modales / chat