CompraFlow · Guía de Usuario

03 · La plataforma

Módulos de la app

CompraFlow tiene 8 secciones accesibles desde el menú lateral.

📊

Dashboard

Resumen del negocio: stock crítico, productos, mejores precios disponibles y listas recientes.

📦

Productos

Listado completo del inventario. Edita stock y precios directamente desde la tabla.

⚠️

Reposición

Productos bajo stock mínimo con cantidades sugeridas. Genera pedidos en un click.

⚖️

Comparador

Compara el precio actual de compra vs el mejor precio disponible en los proveedores.

📥

Importar Lista

Sube el Excel del proveedor y el sistema detecta columnas y carga productos automáticamente.

🛒

Pedidos

Historial de pedidos generados. Cambia el estado: Borrador → Enviado → Recibido.

🚚

Proveedores

Gestiona tus proveedores: RUT, contacto, condición de pago y última lista importada.

⚙️

Configuración

Nombre del negocio, moneda, margen por defecto y token de seguridad.

04 · Antes de importar

Crear un Proveedor

Debes tener al menos un proveedor creado antes de importar una lista de precios.

1

Ve a Proveedores en el menú

Haz click en el botón Nuevo en la esquina superior derecha.

2

Completa los datos del proveedor

Solo el Nombre es obligatorio. Los demás campos (RUT, contacto, email, teléfono, condición de pago) son opcionales.

3

Presiona Guardar

El proveedor quedará disponible en los módulos de Importar Lista y Reposición.

05 · Flujo principal

Importar Lista Excel

El corazón de CompraFlow. Sube el Excel de tu proveedor y el sistema detecta columnas y actualiza tu inventario automáticamente.

1

Ve a Importar Lista

Selecciona el proveedor en el selector de la parte superior.

2

Arrastra o selecciona el archivo Excel

Acepta archivos .xlsx y .xls. El sistema busca automáticamente las columnas de Código, Nombre, Precio, Stock, Lote, etc.

3

Revisa la vista previa

Se muestran los primeros 20 productos detectados. Verifica que los datos sean correctos antes de confirmar.

4

Presiona Importar al sistema

Se procesan todos los productos. Los nuevos se crean automáticamente. Los existentes se comparan por código.

5

Revisa los cambios de precio (si los hay)

Si algún producto cambió de precio, aparece una alerta. Puedes seleccionar cuáles actualizar y con qué margen.

✅ No importa el formato exacto del Excel. El sistema detecta las columnas buscando palabras clave como "CODIGO", "DESCRIPCION", "PRECIO", "STOCK", etc. en la fila de encabezados.

⚠️ Si un producto no tiene código (columna vacía o con menos de 2 caracteres), se omite en la importación.

06 · Inventario

Productos e Inventario

Puedes editar stock y precios directamente desde la tabla, sin abrir ningún formulario.

·

Editar stock directamente

En la columna Stock hay un campo editable. Cambia el número y presiona Enter — se guarda al instante. El color indica el estado: rojo = sin stock, amarillo = bajo mínimo, verde = ok.

·

Editar precio de compra

En la columna P.Compra también hay un campo editable. Al cambiarlo, el precio de venta se recalcula automáticamente con el margen configurado.

·

Editar todos los datos del producto

Haz click en el ícono ✏️ de la fila para abrir el formulario completo: nombre, referencia, fabricante, clasificación, precios y más.

·

Exportar inventario

Usa los botones CSV o Excel para descargar el inventario completo con todos los campos.

07 · Compras

Reposición Inteligente

Lista automática de productos que necesitan reposición, ordenados por urgencia.

1

La lista se genera automáticamente

Muestra todos los productos con stock actual ≤ stock mínimo, ordenados del más urgente al menos urgente.

2

Filtra por proveedor para ver precios

Al seleccionar un proveedor en el filtro, se muestran columnas adicionales: precio del proveedor, stock disponible, fecha de vencimiento y si hay oferta.

3

Ajusta las cantidades sugeridas

La cantidad sugerida es stock mínimo × 2 − stock actual. Puedes modificarla directamente en la tabla.

4

Genera el pedido con un click

Selecciona los productos con el checkbox, elige el proveedor y presiona Generar Pedido. El pedido queda guardado en el módulo de Pedidos.

Fórmula cantidad sugerida

Mín × 2 − Stock

Siempre puedes editarla antes de pedir

Tiempo estimado

< 60 seg

De la alerta al pedido generado

08 · Ahorro

Comparador de Precios

Detecta automáticamente qué productos puedes comprar más barato en tus proveedores actuales.

·

Cómo funciona

Compara tu precio de compra actual con el mejor precio disponible en las listas más recientes de todos tus proveedores. Solo aparecen productos con stock disponible en el proveedor.

·

Filtra por variación

Usa el filtro "Precio bajó" para ver solo los productos donde hay ahorro disponible. La flecha verde ↓ indica baja, la flecha roja ↑ indica aumento.

·

Actualizar precios seleccionados

Marca los productos con el checkbox y presiona Actualizar precios seleccionados. Se abre un panel donde puedes confirmar cada cambio y ajustar el margen.

💡 El comparador solo funciona si tienes listas importadas de al menos un proveedor. Cuantos más proveedores con listas actualizadas, mejor la comparación.

09 · Seguimiento

Pedidos

Historial y seguimiento de todos los pedidos generados desde la Reposición.

·

Estados del pedido

Cada pedido pasa por: Borrador → Enviado → Recibido. Al marcarlo como Recibido, el stock de todos los productos del pedido se actualiza automáticamente.

·

Exportar pedido a Excel

Haz click en el ícono 📊 de cualquier pedido para descargar el detalle en CSV, listo para enviar al proveedor o archivar.

✅ Al recibir un pedido, el sistema suma automáticamente las cantidades al stock de cada producto y registra el movimiento en el historial.

10 · Ayuda

Preguntas Frecuentes

Respuestas a las dudas más comunes.

¿Qué pasa si el Excel del proveedor tiene un formato diferente? ▼

El sistema detecta automáticamente las columnas buscando palabras clave en la fila de encabezados (CODIGO, DESCRIPCION, PRECIO, STOCK, etc.). Si el encabezado está en otro idioma o nombre diferente, igual lo intenta mapear. Si no logra encontrar la columna de código, mostrará un error y podrás consultar con soporte.

¿Se pierden los datos si importo una lista nueva del mismo proveedor? ▼

No. Al importar una lista nueva se reemplaza solo la lista de precios de ese proveedor para esa fecha. El inventario de productos y el stock no se tocan — solo se actualizan si tú confirmas los cambios de precio en el paso de revisión.

¿Cómo se calcula el precio de venta automáticamente? ▼

La fórmula es: Precio Compra × 1.19 (IVA) × (1 + Margen%). Por ejemplo, con un precio de compra de $1.000 y margen del 30%: $1.000 × 1.19 × 1.30 = $1.547. El margen por defecto se configura en Configuración y puedes modificarlo producto a producto.

¿Puedo usar la app desde el celular? ▼

Sí. La interfaz es responsive y funciona en móvil. El menú lateral se colapsa y aparece el ícono de hamburguesa para abrirlo. La tabla de productos tiene scroll horizontal en pantallas pequeñas.

¿Qué ocurre si pongo mal el token? ▼

Aparece una barra roja en la parte superior que dice "Token incorrecto o no configurado" con un botón para ir a Configuración. Ve a Configuración → Acceso y Seguridad, borra el token actual, pega el correcto y guarda.

¿Cómo agregar una categoría o clasificación nueva? ▼

Actualmente las categorías se gestionan directamente en la base de datos o a través de la API (api.php?r=categorias). En una próxima versión se agregará un panel visual en Configuración para gestionar categorías.

¿Se puede usar con cualquier tipo de negocio? ▼

Sí. CompraFlow está diseñado genéricamente para cualquier negocio que compre a proveedores: farmacias, ferreterías, distribuidoras, retail, alimentos, automotriz, etc. Los campos "Referencia" y "Fabricante" reemplazan terminología específica de cada rubro, y las categorías son totalmente personalizables.