# NovaSIS ERP Solutions

> Documento comercial canonico para ventas.  
> Fecha de corte de datos (snapshot BD): **26/04/2026**.

## Resumen comercial para ventas
NovaSIS ERP vende una propuesta simple: **orden operativo + control financiero + crecimiento escalable**.  
En una sola plataforma integra ventas, compras, gastos, inventario, cobranzas, tesoreria, contabilidad, reportes y analitica con IA.

Puntos de venta clave:
- Menos perdida por errores operativos y falta de control.
- Mejor conversion de ventas y mejor recuperacion de cobros.
- Menos quiebres de stock y mejor margen por producto.
- Trazabilidad total de punta a punta (documento, usuario, estado, pago).
- Escalamiento por plan y por modulos segun necesidad del cliente.

## Soluciones por area de negocio
### Ventas
- POS Admin y POS Retail para escenarios de mostrador y venta rapida.
- Facturacion electronica, notas de credito y soporte operativo SIFEN.
- Gestion de clientes, precios, promociones y trazabilidad comercial.
- Flujo de credito y cobranzas integrado cuando el plan lo habilita.

### Compras
- Flujo operativo completo: requisicion, orden de compra, recepcion, factura de compra y matching.
- Integracion con cuentas por pagar y orden de pago para cierre financiero.
- Reglas configurables por empresa para aprobaciones y ruta operativa.

### Gastos
- Registro de gastos con proveedor opcional, factura fiscal y deducibilidad.
- Modelo hibrido por item (producto + item libre).
- Integracion al mismo motor de cuentas por pagar y orden de pago.

### Inventario
- Control de stock en tiempo real por deposito/sucursal.
- Ajustes, transferencias y movimientos auditables.
- Base para reposicion, analitica de rotacion y control de costo.

### Cobranzas y cuentas por cobrar
- Gestion de cuotas, vencimientos y cartera pendiente.
- Cobros, seguimiento de mora y soporte para gestion de cobrador.
- Reportes para recuperacion y control de riesgo.

### Tesoreria y bancos
- Caja del dia, movimientos, saldos y control de liquidez.
- Transferencias y procesos de tesoreria en flujo integrado.
- Base para conciliacion y control financiero diario.

### Contabilidad
- Integracion contable con procesos operativos.
- Reportes contables y estructura de gestion por empresa.
- Mejor cierre y analisis financiero para direccion.

### Configuracion y gobierno
- Usuarios, perfiles, permisos, numeraciones, medios de pago, sucursales y almacenes.
- Gestion modular por suscripcion.
- Permite estandarizar operacion por rubro y por etapa de madurez.

### IA aplicada a gestion
- Resumen ejecutivo automatico con narrativa de negocio.
- Alertas, timeline y predicciones de ventas/cobranzas/compras/stock.
- Chat en lenguaje natural para analisis y reportes con datos reales.

## IA para generacion de reportes y analisis: como funciona
### Que recibe el cliente
- **Resumen ejecutivo**: lectura gerencial de estado del negocio.
- **Alertas inteligentes**: mora, limite de credito, stock bajo, cheque por vencer, saldo bajo.
- **Timeline**: eventos relevantes del negocio por periodo.
- **Predicciones**: cobranza, riesgo de clientes, ventas, compras y reorden.
- **Chat IA**: consulta en lenguaje natural, genera respuesta con datos y grafico.
- **Favoritos**: guarda consultas frecuentes para reuso comercial/gerencial.
- **Consumo IA**: metricas de tokens, volumen de consultas y tasa de exito.

### Flujo funcional
1. Empresa configura proveedor IA y modelo (`Anthropic` u `OpenAI`).
2. Carga API key en panel de configuracion IA.
3. IA activa recalcule automatico programado + recalcule manual on-demand.
4. Usuario consulta resumen/predicciones o usa chat para preguntas ad hoc.
5. Sistema guarda historial, favoritos y metricas de consumo.

### Seguridad explicada en lenguaje comercial
- API key cifrada antes de almacenarse (no se guarda en texto plano).
- Auditoria de consultas IA con resultado, tiempos, tokens y trazabilidad.
- Validacion de SQL generado (bloqueos de operaciones no permitidas).
- Ejecucion en usuario read-only para reducir riesgo operativo.

### Disponibilidad por plan
- La funcionalidad IA requiere modulo **`INTEGRACION_IA`**.
- En el snapshot del 26/04/2026, `INTEGRACION_IA` esta activo en planes personalizados del Anexo A.

## Catalogo comercial de planes (principal)
> Catalogo principal utilizado para oferta comercial estandar.

| Codigo | Nombre comercial | Precio mensual (Gs.) | Ciclo | Max usuarios | Max productos | Max documentos/mes | Max clientes | Monto facturacion | Max empresas | Max sucursales | Dias de gracia | Modulos |
|---|---|---:|---|---:|---:|---:|---:|---|---|---|---:|---:|
| `1` | Plan Trial | 0 | mensual | 1 | 5 | 10 | 10 | Sin limite (valor 0) | 1 | 1 | 3 | 23 |
| `PLAN_BASICO` | Plan Basico | 99.000 | mensual | 1 | 50 | 50 | 100 | Sin limite (valor 0) | 1 | 1 | 5 | 21 |
| `PLAN_PRO` | Plan Profesional | 499.000 | mensual | 5 | 5.000 | 3.000 | 1.000 | Sin limite (valor 0) | 1 | 5 | 5 | 35 |
| `PLAN_ENTERPRISE` | Plan Enterprise | 949.000 | mensual | 20 | 5.000 | 10.000 | 2.000 | Sin limite (valor 0) | Sin limite (NULL) | Sin limite (NULL) | 0 | 34 |

## Matriz modulo x plan (catalogo)
> Matriz operativa real segun snapshot BD del 26/04/2026.

| Modulo | Trial (`1`) | Basico | Pro | Enterprise |
|---|---|---|---|---|
| `DASHBOARD` | SI | SI | SI | SI |
| `FACTURACION` | SI | SI | SI | SI |
| `POS_ADMIN` | SI | SI | SI | SI |
| `POS_RETAIL` | NO | NO | NO | SI |
| `NOTAS_CREDITO` | SI | SI | SI | SI |
| `SIFEN` | SI | SI | SI | NO |
| `CLIENTES` | SI | SI | SI | SI |
| `CONTACTOS` | NO | NO | SI | SI |
| `PRODUCTOS` | SI | SI | SI | SI |
| `CATEGORIAS` | SI | SI | SI | SI |
| `MARCAS` | SI | SI | SI | SI |
| `STOCK` | SI | SI | SI | SI |
| `INVENTARIO` | NO | NO | SI | NO |
| `AJUSTE_STOCK` | NO | NO | SI | SI |
| `TRANSFERENCIAS` | NO | NO | SI | SI |
| `MOVIMIENTOS_INV` | NO | NO | SI | SI |
| `LISTA_PRECIOS` | NO | NO | SI | SI |
| `OFERTAS` | NO | NO | SI | SI |
| `COBROS` | NO | NO | SI | SI |
| `CUENTAS_COBRAR` | NO | NO | SI | SI |
| `VENDEDORES` | NO | NO | NO | SI |
| `COMPRAS` | NO | NO | SI | NO |
| `GASTOS` | NO | NO | NO | NO |
| `FINANZAS` | SI | SI | SI | SI |
| `TESORERIA` | SI | SI | SI | SI |
| `REPORTES` | NO | NO | SI | SI |
| `CONTABILIDAD` | SI | SI | SI | SI |
| `MONEDA_COTIZACION` | SI | SI | SI | NO |
| `CONFIG_EMPRESA` | SI | SI | SI | SI |
| `CONFIG_SUCURSALES` | SI | SI | SI | SI |
| `CONFIG_USUARIOS` | SI | SI | SI | SI |
| `CONFIG_PERFILES` | NO | NO | SI | SI |
| `CONFIG_NUMERACION` | SI | SI | SI | SI |
| `CONFIG_MEDIOS_PAGO` | SI | SI | SI | SI |
| `CONFIG_COND_PAGO` | SI | SI | SI | SI |
| `CONFIG_TICKET` | SI | NO | NO | SI |
| `CONFIG_IMPRESORAS` | NO | NO | NO | SI |
| `CONFIG_ALMACENES` | NO | NO | SI | SI |
| `CONFIGURACION` | SI | SI | SI | NO |
| `SUSCRIPCIONES` | SI | SI | SI | SI |
| `INTEGRACION_IA` | NO | NO | NO | NO |

## Opciones por modulo (checklist exhaustivo por subflujo)
### `FACTURACION` + `POS_ADMIN` + `POS_RETAIL`
**Que resuelve:** venta diaria, emision de documentos y operacion de caja.  
**Opciones/subflujos disponibles:** venta mostrador, facturacion con detalle, notas de credito, flujo electronico SIFEN, operacion POS admin y POS retail (segun plan).  
**Resultado de negocio:** mayor velocidad comercial y menor error de emision.  
**Planes:** Trial, Basico, Pro, Enterprise (POS Retail solo Enterprise).

### `CLIENTES` + `CONTACTOS`
**Que resuelve:** gestion de cartera comercial y base de proveedores/contactos.  
**Opciones/subflujos disponibles:** alta/edicion de clientes, datos fiscales/comerciales, segmentacion operativa, gestion de proveedores y contactos.  
**Resultado de negocio:** mejor gestion comercial y mejor calidad de dato para cobro/compra.  
**Planes:** `CLIENTES` en todos los planes; `CONTACTOS` en Pro y Enterprise.

### `PRODUCTOS` + `CATEGORIAS` + `MARCAS`
**Que resuelve:** catalogo comercial e inventariable.  
**Opciones/subflujos disponibles:** gestion de SKU, clasificacion por categoria/marca, soporte para precio e impuestos operativos.  
**Resultado de negocio:** control de margen, orden comercial e integracion con ventas/compras.  
**Planes:** todos los planes del catalogo.

### `STOCK` + `INVENTARIO` + `AJUSTE_STOCK` + `TRANSFERENCIAS` + `MOVIMIENTOS_INV`
**Que resuelve:** control fisico y logico de existencias.  
**Opciones/subflujos disponibles:** consulta de stock, ajustes, transferencias entre depositos, historial de movimientos auditables.  
**Resultado de negocio:** menos quiebres, menos diferencia de inventario, mejor reposicion.  
**Planes:** `STOCK` en todos; flujo avanzado (`INVENTARIO`, ajustes, transferencias, movimientos) en Pro/Enterprise segun matriz.

### `LISTA_PRECIOS` + `OFERTAS`
**Que resuelve:** estrategia comercial y politica de precios.  
**Opciones/subflujos disponibles:** multiples listas de precios, promociones/ofertas, habilitacion por contexto comercial.  
**Resultado de negocio:** mejor conversion y mejor gestion de margen por segmento.  
**Planes:** Pro y Enterprise.

### `COBROS` + `CUENTAS_COBRAR`
**Que resuelve:** recuperacion de cartera y control de vencimientos.  
**Opciones/subflujos disponibles:** registro de cobros, control de cuotas, seguimiento de saldos pendientes y reportabilidad de mora.  
**Resultado de negocio:** mejora directa del flujo de caja y menor incobrabilidad.  
**Planes:** Pro y Enterprise.

### `COMPRAS`
**Que resuelve:** abastecimiento con trazabilidad operativa-financiera.  
**Opciones/subflujos disponibles:** requisicion, orden de compra, recepcion, matching de factura de compra y enlace a cuentas por pagar/orden de pago.  
**Resultado de negocio:** menor sobrecosto y mejor control de compras por politica.  
**Planes:** Pro (en catalogo principal al corte actual) y planes personalizados del Anexo A.

### `GASTOS`
**Que resuelve:** registro estructurado de egresos no comerciales con enfoque fiscal.  
**Opciones/subflujos disponibles:** carga de gasto deducible/no deducible, iva, item por producto o libre, integracion con CxP/OP segun flujo operativo.  
**Resultado de negocio:** mejor control de gasto y mejor cierre tributario-contable.  
**Planes:** no incluido en catalogo principal al corte actual; disponible via configuracion personalizada.

### Flujo unificado CxP/Orden de Pago (compras + gastos)
**Que resuelve:** pago a proveedores con trazabilidad unica.  
**Opciones/subflujos disponibles:** cuentas por pagar por origen, orden de pago manual/operativa, ejecucion y control de estado.  
**Resultado de negocio:** elimina pagos sin control y mejora gobernanza financiera.  
**Planes:** ligado a `COMPRAS`/`FINANZAS`/`TESORERIA`; se define por habilitacion modular del cliente.

### `FINANZAS` + `TESORERIA`
**Que resuelve:** control diario de caja, bancos y liquidez.  
**Opciones/subflujos disponibles:** caja del dia, movimientos, transferencias, control de saldos y operacion de tesoreria.  
**Resultado de negocio:** mayor previsibilidad financiera y menor riesgo operativo.  
**Planes:** todos los planes del catalogo.

### `REPORTES`
**Que resuelve:** visibilidad ejecutiva por area de negocio.  
**Opciones/subflujos disponibles:** reportes operativos/comerciales/financieros segun modulos activos.  
**Resultado de negocio:** decisiones mas rapidas y basadas en datos.  
**Planes:** Pro y Enterprise.

### `CONTABILIDAD`
**Que resuelve:** formalizacion contable de la operacion.  
**Opciones/subflujos disponibles:** reportes contables y proceso de control financiero por empresa.  
**Resultado de negocio:** mejor cierre, mejor trazabilidad y soporte a auditoria.  
**Planes:** todos los planes del catalogo.

### `VENDEDORES`
**Que resuelve:** control de equipos de venta/cobranza en campo.  
**Opciones/subflujos disponibles:** gestion de vendedores/cobradores y seguimiento operativo asociado.  
**Resultado de negocio:** mejor productividad de equipo comercial y cobranzas.  
**Planes:** Enterprise (catalogo) y personalizados.

### `SUSCRIPCIONES`
**Que resuelve:** administracion comercial del servicio ERP por plan/modulo.  
**Opciones/subflujos disponibles:** control de plan vigente, cambio de plan y gestion de alcance de modulos.  
**Resultado de negocio:** escalamiento ordenado del cliente sin friccion operativa.  
**Planes:** todos los planes del catalogo.

### `INTEGRACION_IA`
**Que resuelve:** analitica inteligente y reportes conversacionales.  
**Opciones/subflujos disponibles:** resumen ejecutivo, alertas, timeline, predicciones, chat IA, favoritos y metricas de consumo.  
**Resultado de negocio:** lectura ejecutiva diaria sin depender de analista tecnico para cada consulta.  
**Planes:** no incluido en catalogo principal al corte actual; presente en personalizados del Anexo A.

### `CONFIG_EMPRESA` + `CONFIG_SUCURSALES` + `CONFIG_USUARIOS` + `CONFIG_PERFILES` + `CONFIG_NUMERACION` + `CONFIG_MEDIOS_PAGO` + `CONFIG_COND_PAGO` + `CONFIG_TICKET` + `CONFIG_IMPRESORAS` + `CONFIG_ALMACENES`
**Que resuelve:** estandarizacion operativa y gobierno interno.  
**Opciones/subflujos disponibles:** estructura empresarial, seguridad por rol, timbrados/numeracion, medios de pago, ticket, impresoras y almacenes.  
**Resultado de negocio:** menos desorden interno y mejor cumplimiento operativo por equipo/sucursal.  
**Planes:** variable por modulo segun matriz del catalogo.

## Fuentes de verdad utilizadas
- Snapshot de BD del **26/04/2026**: planes, limites, modulos y relacion plan-modulo.
- Implementacion vigente de IA: `ai-dashboard`, `ai-chat`, `ai-config`, proveedor IA y auditoria.
- Flujos de compras y gastos consolidados en `plan-compras-gastos.md`.
- Catalogo funcional del sistema segun seed y modulos activos.

## APIs / interfaces publicas
- No se introducen cambios breaking en contratos publicos por este documento.
- El alcance aqui documentado refleja capacidades vigentes observadas en implementacion actual.
- Para IA, compras/gastos y CxP/OP se documenta disponibilidad funcional, no rediseño de API.

## Anexo A: planes personalizados activos (snapshot BD)
> Planes activos fuera del catalogo principal (26/04/2026).

| Codigo | Nombre | Precio mensual (Gs.) | Limites principales | Modulos (cantidad) | Diferenciales destacados |
|---|---|---:|---|---:|---|
| `PLAN-CONTADO-CLI` | PLAN CONTABLE CLIENTE | 0 | U:1 / P:1 / D:1 / C:1 / Emp:1 / Suc:1 | 3 | Perfil ultra focalizado en contabilidad y reportes |
| `PLAN-STD` | PLAN standard | 249.000 | U:3 / P:500 / D:250 / C:1000 / Emp:1 / Suc:3 | 30 | Incluye inventario operativo y reportes |
| `PLAN-CONTADOR` | PLAN CONTADOR | 500.000 | U:1 / P:1 / D:1 / C:1 / Emp:1 / Suc:1 | 5 | Incluye `INTEGRACION_IA` + contabilidad + reportes |
| `PLAN-COMER-KETY` | PLAN PROFECIONAL | 1.500.000 | U:20 / P:10000 / D:5000 / C:5000 / Emp:1 / Suc:5 | 43 | Incluye IA, compras, solicitud de credito, panel cobrador y modulos extendidos |

Notas de lectura:
- U = max usuarios, P = max productos, D = max documentos/mes, C = max clientes.
- Este anexo se usa para ventas consultivas y renovaciones personalizadas.

## Anexo B: guia de upgrade entre planes
### Ruta comercial recomendada
1. **Trial (`1`) -> Basico**  
   Cuando el cliente valida producto y necesita ampliar volumen operativo sin complejidad.
2. **Basico -> Pro**  
   Cuando aparece necesidad de cobranzas formales, compras, reportes, inventario avanzado y mayor control.
3. **Pro -> Enterprise**  
   Cuando crece estructura, equipos y exigencia de gobierno operativo multiarea.
4. **Enterprise/custom -> IA (`INTEGRACION_IA`)**  
   Para direccion y gerencia que necesita analisis diario automatizado y chat de datos.

### Disparadores de upgrade que ventas debe monitorear
- Topes de usuarios/productos/documentos al limite de plan.
- Necesidad de modulos hoy no habilitados (ej. `COMPRAS`, `GASTOS`, `INTEGRACION_IA`).
- Expansion a multiples sucursales o mayor complejidad de control financiero.
- Necesidad de visibilidad ejecutiva con prediccion y alertas (IA).

### Mensaje comercial de cierre
NovaSIS no obliga a cambiar de sistema para crecer: permite **escalar por modulo y por plan**, manteniendo continuidad operativa y trazabilidad del negocio.