🚀 Inicio rápido

Iniciar sesión

1. Abre la app en tu navegador
2. Ingresa tu email y contraseña (te las dio el administrador)
3. Clic en "Iniciar Sesión"

Navegación general

• Menú lateral: secciones del sistema (Dashboard, Inventario, Ventas...)
• Barra superior: indicador "en línea", alertas rápidas, ❓ ayuda, 🌙 tema, 🔔 notificaciones, tu nombre
• Botón flotante 💬: abre el asistente IA en cualquier momento
• En móvil: clic en ☰ para abrir el menú lateral

Cerrar sesión

Menú lateral → última opción "🚪 Cerrar Sesión"

📊 Dashboard

Es la pantalla de inicio. Te muestra el estado del negocio de un vistazo:

• Productos: cantidad de SKUs (productos distintos) en el sistema
• Ventas del Mes: total facturado en el mes en curso
• Por Caducar ≤30D: lotes que vencen en los próximos 30 días
• Stock Bajo: productos por debajo de su mínimo

Abajo aparecen 3 tablas: Caducidades próximas, Stock crítico y Últimos movimientos.

📦 Inventario y productos

Crear un producto nuevo

Editar un producto

En la tabla de Inventario, clic en el botón ✏️ de la fila → cambia lo que necesites → "Actualizar Producto".

Eliminar un producto

Solo puedes eliminar productos que NO tienen lotes. Si tiene lotes, primero elimínalos uno por uno.

🏷️ Lotes y caducidades

Cada producto puede tener varios lotes (entradas distintas de mercancía). Cada lote tiene su propio número, cantidad, caducidad y proveedor.

Agregar un lote a un producto existente

En Inventario, fila del producto → clic en "+ Lote". Llena cantidad, número de lote, caducidad, etc.

Ver los lotes de un producto

Clic en 📦 N de la fila (donde N es el número de lotes). Se abre un panel lateral con el detalle de cada uno.

Editar un lote

Dentro del panel de lotes, clic en ✏️ del lote. Puedes cambiar:

• Número de lote
• Caducidad (útil cuando un lote llegó sin fecha)
• Proveedor
• Precio de compra
• Factura
• Fecha de entrada

No puedes editar la cantidad porque eso corrompería el stock. Si necesitas corregirla, mejor cancela el lote y crea uno nuevo.

Conceptos clave

• FIFO: el lote con caducidad más cercana se vende primero (automático)
• Lote vencido: días < 0 — el sistema NO lo usa al vender
• ≤30 días: alerta urgente, el lote va a caducar pronto
• "⚠ Sin caducidad": lote sin fecha. Edítalo lo antes posible

Sección "Caducidades"

En el menú lateral, vista dedicada a lotes que están cerca de vencer. Muestra contadores y la lista ordenada de más urgente a menos.

💰 Ventas

Crear una venta nueva

Editar metadata de una venta

En la tabla de Ventas → ✏️ → puedes cambiar cliente, fecha, estado y notas. NO puedes cambiar los productos (si te equivocaste, cancela y crea otra).

Cancelar una venta (con reverso de stock)

Imprimir comprobante

En la tabla → 🖨️ — se abre una ventana lista para imprimir o guardar como PDF.

🛒 Compras

Registra órdenes de compra a proveedores. No afecta el stock automáticamente — el stock se actualiza cuando registras los lotes que llegan.

Crear una compra

1. Menú → Compras → "+ Nueva Compra"
2. Selecciona Proveedor, fecha, factura
3. Agrega productos con cantidad y precio de compra
4. "Registrar Compra" — folio OC-XXXX

¿Y cómo entra el stock?

Tras crear la compra, ve a Inventario y agrega los lotes correspondientes con "+ Lote". O pídele al asistente IA: "registra un lote nuevo de 100 unidades de paracetamol, caducidad 2027-12-31".

Imprimir orden de compra

En la tabla → 🖨️.

👤 Clientes y proveedores

Crear cliente o proveedor

Menú → Clientes o Proveedores → "+ Nuevo". Llena los datos (nombre obligatorio, RFC opcional, contacto, etc.) → Guardar.

Editar

En la tabla → ✏️ → cambia → "Actualizar".

Ver historial de un cliente

Clic en 📎 N → se abre panel lateral con sus datos completos, documentos adjuntos y todas sus ventas históricas.

Subir documentos

Dentro del panel del cliente/proveedor, sube PDFs (cédula fiscal, comprobantes, etc.) arrastrando o desde el botón de carga.

🔄 Movimientos

Es la bitácora completa del inventario. Cada cambio queda registrado con fecha, usuario, producto, lote y cantidad.

Tipos de movimiento

Filtros

Por tipo, rango de fechas o búsqueda libre. Puedes exportar a Excel o imprimir.

🤖 Asistente IA

Cómo abrirlo

• Clic en el botón 💬 flotante (esquina inferior derecha)
• O usa el atajo Cmd/Ctrl + K

¿Qué puedo preguntarle?

Habla normal, en español. Algunos ejemplos:

• "¿Tenemos paracetamol en existencia?"
• "¿Qué productos tienen stock bajo?"
• "¿Qué lotes caducan en los próximos 30 días?"
• "Dame un resumen del negocio"
• "Top 5 productos más vendidos este mes"
• "Análisis ABC de productos"
• "Compara las ventas de este mes vs el anterior"
• "Historial del cliente Hospital ABC"

Pedirle que haga acciones

El asistente puede preparar acciones que tú confirmas con un botón:

• "Vende 5 paracetamoles al cliente X"
• "Registra una compra a proveedor Y de 100 unidades..."
• "Registra un lote nuevo de Z, caducidad 2027-12-31"
• "Agrega caducidad 2027-08-30 al lote LOT-XXX"

Cuando lo hagas, aparece una tarjeta de propuesta con [Confirmar] / [Cancelar]. Nada se ejecuta hasta que tú confirmes.

Historial de conversaciones

Clic en 📚 arriba del chat → ves todas tus conversaciones pasadas. Puedes buscarlas, abrirlas o eliminarlas.

Nueva conversación

Clic en 🗑 → la actual se guarda automáticamente y empiezas una nueva.

👥 Chat de equipo

Manda mensajes a tus compañeros del sistema. Como WhatsApp pero adentro de FarmaControl.

Cómo usarlo

1. Abre el chat con 💬 o Cmd + K
2. Clic en la pestaña "👥 Equipo"
3. Aparece la lista de todos los usuarios activos
4. Clic en el usuario para iniciar la conversación
5. Escribe y Enter para enviar (Shift+Enter para salto de línea)

Notificación de mensajes nuevos

En la pestaña Equipo aparece un badge rojo con el número de mensajes sin leer. Al abrir la conversación, se marcan como leídos.

🔔 Notificaciones

El sistema te avisa automáticamente cuando pasa algo importante:

• 📉 Stock bajo: un producto cruzó por debajo de su mínimo
• ⚠️ Lote por caducar: entra al rango ≤30 días
• 💰 Nueva venta: otro usuario registró una venta
• 🛒 Nueva compra: otro usuario registró una compra

Cómo verlas

Clic en la campana 🔔 de la barra superior. Aparece un panel con la lista. Clic en cualquiera te lleva a la sección relevante.

Marcar como leídas

Botón ✓✓ dentro del panel — todas se marcan como leídas. Botón 🗑 limpia la lista.

⌨️ Atajos de teclado

Presiona ? en cualquier momento para ver la lista. Los principales:

🌙 Modo oscuro

Clic en el botón 🌙 / ☀️ de la topbar. Cambia entre claro y oscuro. La preferencia se guarda — la próxima vez que entres, recuerda tu elección.

Si tu sistema operativo está en modo oscuro, la primera vez la app aparecerá en oscuro automáticamente.

🔐 Roles y permisos

Cada usuario tiene un rol que determina qué puede hacer:

CRUD = Crear, Leer, Actualizar, Borrar (todo). 👁 Ver = solo lectura.

💵 Cobranza (CxC / CxP)

Módulo para llevar control de cuentas por cobrar (lo que te deben los clientes) y cuentas por pagar (lo que le debes a los proveedores).

Acceder

Menú izquierdo → Cobranza (sección FINANZAS).

Vender a crédito

1. Ve a Ventas → Nueva Venta
2. En "Condición de pago" elige Crédito
3. Indica los días de crédito (ej: 30)
4. El sistema calcula automáticamente la fecha de vencimiento
5. La venta queda con saldo pendiente y aparece en Cobranza

Registrar un abono / pago

1. En Cobranza, busca la venta o factura
2. Click en "💰 Abonar" o "Registrar Pago"
3. Captura monto, fecha, forma de pago (efectivo/transferencia/tarjeta)
4. El saldo se actualiza automáticamente

Indicadores

• 🟢 Al corriente — pago dentro del plazo
• 🟡 Por vencer — menos de 7 días
• 🔴 Vencido — pasó la fecha

↩️ Devoluciones

Procesa devoluciones de productos vendidos, reintegrando stock al lote correspondiente.

Procesar una devolución

1. Ve a la venta original en Ventas
2. Click en el botón "↩️ Devolución"
3. Selecciona los productos a devolver y la cantidad
4. Indica el motivo (defectuoso, error, no quiso, etc.)
5. Confirma

Qué pasa automáticamente

• 📦 El stock regresa al lote original (FIFO reverso)
• 💵 Si fue venta a crédito, se ajusta el saldo
• 📋 Se registra un movimiento tipo "DEVOLUCIÓN" en la bitácora
• 📊 La devolución se refleja en reportes

📊 Reportes

Genera reportes financieros y operativos con los datos reales de tu empresa.

Tipos de reportes disponibles

• 📈 Ventas por período — diario, semanal, mensual
• 🏆 Top productos — más vendidos por cantidad y monto
• 👤 Top clientes — quién compra más
• 💰 Estado de resultados — ingresos vs costos
• 📦 Inventario valorizado — cuánto vale tu stock total
• ⚠️ Caducidades — lotes por vencer
• 📋 Movimientos — bitácora completa

Generar y exportar

1. Menú → Reportes
2. Elige el tipo y el rango de fechas
3. Click en "Generar"
4. Botones de exportar: 📊 Excel, 📄 PDF, 🖨️ Imprimir

💾 Backup (Respaldo)

Guarda toda tu información en archivos descargables. Recomendado: hacer backup semanal.

Crear un backup

1. Menú → Sistema → Backup (o desde Configuración)
2. Elige el formato:
   • 📊 Excel (.xlsx) — multi-hojas: productos, lotes, ventas, etc. (recomendado para humanos)
   • 📄 PDF — vista imprimible
   • 📋 JSON — técnico, para restaurar en otro sistema
3. Click descargar — el archivo se guarda en tu computadora

¿Cómo restaurar?

Si necesitas restaurar, contacta a soporte. El Excel/PDF son para consulta humana; el JSON sirve para migración técnica.

📸 Códigos de barras

Escanea códigos EAN/UPC con la cámara para acelerar búsquedas y registro de productos.

Asignar código a un producto

1. Ve a Inventario → editar producto
2. Baja al campo "Código de Barras"
3. Opción A: escribe el código manualmente (ej: 7501234567890)
4. Opción B: click en 📸 → activa cámara → apunta al producto
5. Guarda

Buscar producto escaneando

1. En Inventario, click en botón 📸 Escanear
2. Apunta la cámara al código del medicamento
3. El producto aparece automáticamente

Imprimir etiquetas con código de barras

1. En la tabla de Inventario, busca el botón 🖨️ en la columna de acciones
2. Se abre una ventana con 8 etiquetas listas (nombre + código + precio)
3. Click en "🖨️ Imprimir 8 etiquetas"
4. Usa papel adhesivo o normal

💼 Comisiones de vendedores

Calcula automáticamente comisiones por ventas para cada vendedor.

Configurar % de comisión

1. Menú → Sistema → Usuarios
2. Editar usuario con rol vendedor
3. Campo "% Comisión" → escribe el porcentaje (ej: 5 = 5%)
4. Guardar

Ver comisiones del período

1. Menú → Comisiones
2. Elige rango de fechas
3. Verás tabla con: vendedor, ventas totales, comisión calculada
4. Exporta a Excel para nómina

📥 Importación masiva

Carga grandes volúmenes de productos, clientes o proveedores desde Excel en segundos.

Pasos

1. Menú → Inventario (o Clientes / Proveedores)
2. Click en "📥 Importar Excel"
3. Descarga la plantilla de muestra (importante: respetar columnas)
4. Llena el Excel con tus datos
5. Súbelo → el sistema valida y carga
6. Si hay errores, te muestra qué filas fallaron y por qué

Columnas obligatorias (productos)

• nombre — nombre del producto
• categoria, presentacion, unidad
• precioCompra, precioVenta
• minimo — stock mínimo
• codigoBarras (opcional)

🎁 Promociones

Configura descuentos automáticos: 2x1, % de descuento, precios especiales por cliente, etc.

Crear una promoción

1. Menú → Promociones
2. Click en "➕ Nueva Promoción"
3. Configura:
   • Tipo: Descuento %, 2x1, 3x2, Precio fijo
   • Productos aplicables: todos, categoría específica, productos seleccionados
   • Vigencia: fecha inicio y fin
   • Cliente: aplica a todos o a uno específico
4. Activar la promo

Aplicar al vender

Cuando registres una venta con productos en promoción, el descuento se aplica automáticamente. El precio final se muestra antes de confirmar.

🏪 Multi-sucursal

Si tienes varios puntos de venta, FarmaControl maneja inventarios y ventas por sucursal.

Configurar sucursales

1. Menú → Sucursales
2. Click "➕ Nueva Sucursal"
3. Captura: nombre, código, dirección, ciudad, encargado, tel
4. Guarda

Asignar usuarios a sucursal

1. Menú → Usuarios → editar usuario
2. Campo "Sucursal" → selecciona
3. El usuario verá su sucursal por defecto

Filtrar por sucursal

En reportes, ventas, inventario, etc. tendrás un filtro "Sucursal" para ver datos solo de esa ubicación.

🔮 Predicción IA (Reorden inteligente)

Claude analiza tus ventas históricas y predice qué productos comprar y en qué cantidades, para no quedarte sin stock ni tener exceso.

Cómo usar

1. Abre el asistente IA (botón 💬 abajo a la derecha)
2. Pregunta: "¿Qué necesito comprar?" o "Predice mi demanda para los próximos 30 días"
3. El asistente analiza ventas pasadas, días de cobertura y caducidades
4. Te da una lista priorizada de productos a comprar con cantidades sugeridas

Qué considera el algoritmo

• 📊 Velocidad de venta de cada producto (últimos 60 días)
• ⏰ Estacionalidad (compara mismo mes año pasado si hay datos)
• 📦 Stock actual + stock mínimo
• 🗓️ Lead time de tus proveedores
• ⚠️ Lotes próximos a caducar (NO los cuenta como stock real)

📄 CFDI / Facturación electrónica

Genera facturas electrónicas timbradas ante el SAT mediante integración con Facturapi.io.

Configuración inicial (admin)

1. Menú → CFDI · docDigitales → Configuración
2. Captura los datos fiscales de tu empresa (RFC, régimen, código postal, etc.)
3. Sube tus certificados CSD (.cer y .key) y la contraseña
4. Configura el API key de Facturapi.io
5. Guarda

Timbrar una venta

1. Crea o abre una venta
2. Click en "📄 Timbrar CFDI"
3. Captura RFC del cliente, uso de CFDI (G01, G03, etc.)
4. Click "Timbrar"
5. Recibes el PDF y XML oficial timbrado
6. Se envía automático al correo del cliente (si lo tiene registrado)

Cancelar un CFDI

Desde el listado de CFDIs, click en "Cancelar", elige motivo. Sigue el proceso oficial SAT (puede tardar 72h en aceptarse).

💬 WhatsApp

Envía recordatorios de pago, confirmaciones y comprobantes por WhatsApp con un solo clic. No requiere API ni costo — usa wa.me (WhatsApp Web/App del usuario).

Requisitos

• El cliente debe tener su teléfono registrado (Clientes → editar → Teléfono)
• Tener WhatsApp Web abierto o WhatsApp instalado en el dispositivo

Enviar recordatorio de pago

1. Menú → Cobranza
2. Busca la venta con saldo pendiente
3. Click en el botón 💬 (verde) al final del renglón
4. Se abre WhatsApp con un mensaje pre-armado tipo:
   "Hola [Cliente], le recordamos que tiene un saldo pendiente de $X de la venta #VTA-001 con fecha XX/XX/XXXX. Gracias."
5. Solo presiona Enviar en WhatsApp ✓

🏢 Datos de empresa

Configura los datos de tu empresa que aparecen en todos los reportes, facturas y comprobantes.

Editar datos

1. Menú → Sistema → Perfil Empresa
2. Captura:
   • Nombre (razón social completa, ej: COMERCIALIZADORA ZETAMSA SA DE CV)
   • RFC, régimen fiscal, código postal
   • Dirección completa, teléfono, email, web
   • Logo — subir imagen (PNG/JPG, máx 2MB)
3. Guardar

Dónde aparecen estos datos

• 📄 Encabezado de todos los reportes (PDF, impresión, Excel)
• 🧾 Tickets de venta
• 📋 Facturas CFDI
• 📧 Correos enviados al cliente
• 📖 Cabecera del manual cuando se imprime

❓ Preguntas frecuentes

El chat IA dice "Overloaded" o "saturado"

Los servidores de Claude están temporalmente saturados (a nivel global, no es problema tuyo). Espera 30-60 segundos y vuelve a intentar. El sistema reintenta automáticamente hasta 3 veces.

"No tengo permiso para..."

Tu rol no permite esa acción. Pide a un administrador que te cree los permisos o que él lo haga.

No puedo eliminar un lote

El lote ya fue usado en ventas (disponible < cantidad original). No puede borrarse porque rompería la auditoría. Si está vencido y no se va a usar más, simplemente déjalo: el sistema NO lo considera al vender.

No puedo eliminar un producto

El producto tiene lotes. Primero elimina los lotes (uno por uno, solo los que no hayan sido vendidos), luego el producto.

Olvidé mi contraseña

En la pantalla de login: escribe tu email → clic en "¿Olvidaste tu contraseña?". Te llega correo para restablecerla.

La IA propuso una venta pero no quiero confirmarla

Clic en Cancelar en la tarjeta. Nada se ejecuta.

¿Mis datos están seguros?

Sí. Todo se guarda en Firebase (Google Cloud) con reglas de seguridad estrictas. Cada usuario solo ve los datos a los que su rol le da acceso. Los mensajes de chat de equipo son privados entre los participantes. Las conversaciones con la IA son privadas tuyas.

El escáner de códigos de barras no se activa

Asegúrate de:

1. Usar Chrome o Edge actualizado (Safari NO soporta BarcodeDetector)
2. Aceptar el permiso de cámara cuando lo pida
3. Estar conectado con HTTPS (no en localhost vía http://)
4. En móvil, apuntar bien y dar buena luz

Si no se activa, escribe el código manualmente.

WhatsApp abre pero no manda nada

El sistema solo te abre WhatsApp con el mensaje pre-armado. Tú tienes que apretar el botón Enviar. Esto es para que puedas editar antes de mandar y para no requerir API de pago.

El reporte muestra "Mi Empresa SA de CV" en vez de mi razón social

Vas a Sistema → Perfil Empresa y capturas los datos reales. Se sincronizan en tiempo real a todos los reportes.

Quiero cancelar un CFDI ya timbrado

Desde el listado de CFDIs, click en Cancelar, elige motivo SAT. El SAT puede tardar hasta 72h en aceptar la cancelación. Mientras tanto el CFDI sigue vigente.

La predicción IA me da números raros

Necesita datos. Si tienes menos de 30 días de ventas, la predicción es poco confiable. Mejora con el tiempo conforme se acumula histórico.

Subo el logo y se borra al recargar

Ya está arreglado. Si te pasa, vuelve a subirlo desde Sistema → Perfil Empresa. Ahora se guarda en Firebase (no solo en tu navegador).

¿Cómo migro de una sucursal a otra?

Las sucursales comparten la misma base de datos. Lo que cambia es el "filtro" por defecto. Pídele al admin que te cambie tu sucursal asignada en Usuarios.

¿Funciona en celular?

Sí, 100% responsive. El menú se convierte en hamburguesa (☰) arriba a la izquierda. La cámara para escanear códigos funciona mejor en móvil.

¿Funciona sin internet?

No completamente. Para registrar ventas necesitas conexión. Si la pierdes momentáneamente, verás un indicador "Sin conexión" en la barra superior.

¿Puedo usar la app desde mi celular?

Sí — está diseñada responsive. Usa el menú ☰ para navegar. Las tablas se adaptan al tamaño de pantalla.

¿Cómo lo abro más rápido en mi computadora?

En el navegador, agrega la URL a favoritos. En Chrome/Safari puedes "Crear acceso directo" o "Agregar a la pantalla de inicio" para que parezca una app nativa.