<p align="center">
  <img src="https://i.ibb.co/logo_simple.png" alt="Automia" width="80" />
</p>

<h1 align="center">AUTOMIA</h1>
<h3 align="center">Plataforma ERP & Facturación Electrónica para Paraguay</h3>
<p align="center"><em>Propuesta Comercial de Servicios — Versión 2026</em></p>

---

# PROPUESTA COMERCIAL

## Plataforma Integral de Gestión Empresarial, Facturación Electrónica y Punto de Venta

**Preparado para:** [Nombre del Cliente / Empresa]
**Fecha:** [DD/MM/AAAA]
**Validez de la propuesta:** 30 días a partir de la fecha de emisión
**Contacto comercial:** [Nombre del ejecutivo comercial]

---

## ÍNDICE

1. [Resumen Ejecutivo](#1-resumen-ejecutivo)
2. [¿Qué es Automia?](#2-qué-es-automia)
3. [Módulos del Sistema](#3-módulos-del-sistema)
4. [Detalle Funcional por Módulo](#4-detalle-funcional-por-módulo)
5. [Integraciones y Tecnología](#5-integraciones-y-tecnología)
6. [Ventajas Competitivas](#6-ventajas-competitivas)
7. [Casos de Uso por Rubro](#7-casos-de-uso-por-rubro)
8. [Modelo SaaS y Planes de Suscripción](#8-modelo-saas-y-planes-de-suscripción)
9. [Seguridad y Cumplimiento](#9-seguridad-y-cumplimiento)
10. [Soporte y Acompañamiento](#10-soporte-y-acompañamiento)
11. [Hoja de Ruta del Producto](#11-hoja-de-ruta-del-producto)
12. [Preguntas Frecuentes](#12-preguntas-frecuentes)
13. [Próximos Pasos](#13-próximos-pasos)

---

## 1. RESUMEN EJECUTIVO

**Automia** es una plataforma ERP (Enterprise Resource Planning) 100% en la nube, diseñada específicamente para empresas paraguayas que necesitan **facturación electrónica integrada con SIFEN**, punto de venta profesional, control de inventario, tesorería, cobranzas, créditos y mucho más — todo en un solo lugar.

### Lo que ofrecemos en una línea:

> **Una solución completa que reemplaza múltiples herramientas desconectadas por un sistema unificado, accesible desde cualquier dispositivo, que opera incluso sin internet.**

### Beneficios clave para su empresa:

| Beneficio | Impacto |
|---|---|
| **Facturación electrónica SIFEN** | Cumplimiento normativo al 100%, envío automático de DTE |
| **Punto de Venta profesional** | Ventas más rápidas, menos errores, operación offline |
| **Control financiero total** | Tesorería, cajas, cobros y rendiciones en tiempo real |
| **Multi-sucursal, multi-empresa** | Gestión centralizada de toda su operación |
| **Acceso desde cualquier lugar** | Aplicación web + PWA instalable en cualquier dispositivo |
| **Cero inversión en infraestructura** | Sin servidores propios, sin licencias, sin instalaciones |

---

## 2. ¿QUÉ ES AUTOMIA?

Automia es un **sistema de gestión empresarial moderno, basado en la nube**, construido con tecnología de última generación para ofrecer:

- **Velocidad**: Interfaz rápida y responsiva que no requiere instalación
- **Confiabilidad**: Funciona incluso sin conexión a internet (modo offline)
- **Escalabilidad**: Desde un emprendimiento unipersonal hasta un grupo empresarial multi-empresa
- **Cumplimiento**: Integración nativa con SIFEN (SET - Paraguay)
- **Seguridad**: Encriptación de datos, autenticación JWT, auditoría completa de acciones

### Arquitectura del sistema

```
┌──────────────────────────────────────────────────────────────┐
│                    AUTOMIA — PLATAFORMA ERP                   │
│                                                               │
│   ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐ │
│   │  Aplicación  │  │  Aplicación  │  │   PWA Instalable    │ │
│   │    Web       │  │   Móvil     │  │   (POS Offline)     │ │
│   └──────┬───────┘  └──────┬───────┘  └──────────┬──────────┘ │
│          │                 │                      │            │
│          └─────────────────┼──────────────────────┘            │
│                            │                                   │
│                    ┌───────▼────────┐                          │
│                    │   API REST     │                          │
│                    │   Segura       │                          │
│                    └───────┬────────┘                          │
│                            │                                   │
│          ┌─────────────────┼─────────────────┐                │
│          │                 │                  │                │
│   ┌──────▼──────┐  ┌──────▼──────┐  ┌───────▼──────┐        │
│   │ PostgreSQL  │  │    Redis    │  │  AWS S3      │        │
│   │ Base Datos  │  │   Cache     │  │  Archivos    │        │
│   └─────────────┘  └─────────────┘  └──────────────┘        │
│                                                               │
│   ┌─────────────┐  ┌─────────────┐  ┌──────────────┐        │
│   │   SIFEN     │  │   Email     │  │  SMS/WhatsApp│        │
│   │   (SET PY)  │  │ Transacc.   │  │  (Twilio)    │        │
│   └─────────────┘  └─────────────┘  └──────────────┘        │
└──────────────────────────────────────────────────────────────┘
```

---

## 3. MÓDULOS DEL SISTEMA

Automia está compuesto por **18 módulos funcionales** que cubren toda la operación de su empresa:

| # | Módulo | Descripción | Estado |
|---|---|---|---|
| 1 | 🏪 **Punto de Venta (POS)** | POS retail y administrativo con operación offline | ✅ Disponible |
| 2 | 📄 **Facturación Electrónica** | Emisión de facturas con integración SIFEN | ✅ Disponible |
| 3 | 📦 **Inventario y Stock** | Control multi-almacén con movimientos y alertas | ✅ Disponible |
| 4 | 💰 **Tesorería y Cajas** | Apertura/cierre de cajas, movimientos, arqueos | ✅ Disponible |
| 5 | 🧾 **Cobros y Recibos** | Gestión de cobros, recibos, distribuciones | ✅ Disponible |
| 6 | 📊 **Dashboard y Reportes** | Métricas en tiempo real y centro de reportes | ✅ Disponible |
| 7 | 👥 **Contactos (CRM)** | Gestión de clientes y proveedores | ✅ Disponible |
| 8 | 🏷️ **Listas de Precios** | Múltiples listas con asignación por cliente | ✅ Disponible |
| 9 | 🎁 **Ofertas y Promociones** | Motor de ofertas flexible con múltiples tipos | ✅ Disponible |
| 10 | 📝 **Notas de Crédito** | Emisión con reversión SIFEN y devolución de stock | ✅ Disponible |
| 11 | 🤝 **Ventas Mayoristas** | Pedidos, negociación de precios, proformas | ✅ Disponible |
| 12 | 💳 **Créditos y Solicitudes** | Solicitudes de crédito con aprobación supervisada | ✅ Disponible |
| 13 | 📱 **Cuentas por Cobrar** | Seguimiento de cartera, vencimientos, morosidad | ✅ Disponible |
| 14 | 🧑‍💼 **Vendedores y Cobradores** | Asignación, comisiones, rendiciones, rutas | ✅ Disponible |
| 15 | 🔐 **Seguridad y Auditoría** | Logs completos, permisos granulares, PIN supervisor | ✅ Disponible |
| 16 | ⚙️ **Configuración** | Empresa, sucursales, usuarios, perfiles, impresoras | ✅ Disponible |
| 17 | 💎 **Suscripciones (SaaS)** | Gestión de planes, jerarquía empresarial, comisiones | ✅ Disponible |
| 18 | 📡 **Modo Offline (PWA)** | Operación sin internet con sincronización automática | ✅ Disponible |

---

## 4. DETALLE FUNCIONAL POR MÓDULO

### 4.1 — 🏪 PUNTO DE VENTA (POS)

El corazón operativo de su negocio. Dos modos para adaptarse a cualquier tipo de comercio:

#### POS Retail (Tipo Supermercado)
- **Interfaz visual con grilla de productos**: Tiles con imagen, precio y stock visible
- **Búsqueda ultra-rápida**: Por nombre, código de barras o SKU
- **Detección automática de lector de códigos de barras**: El sistema distingue automáticamente entre lectura de pistola y escritura manual
- **Carrito interactivo**: Cantidades editables, descuentos por ítem, eliminación rápida
- **Teclado numérico (Numpad)**: Para entrada rápida de cantidades
- **Múltiples medios de pago**: Efectivo, tarjeta, transferencia, cheque, mixto
- **Cálculo automático de vuelto**: Con desglose por medio de pago
- **Selección de cliente**: Búsqueda inline con creación rápida
- **Pantalla completa**: Diseñado para ocupar toda la pantalla sin distracciones
- **Integración con ofertas**: Las promociones se aplican automáticamente al carrito

#### POS Admin (Facturación Detallada)
- **Formulario completo de facturación**: Todos los campos requeridos por SIFEN
- **Creación de cliente inline**: Sin salir del flujo de facturación
- **Tabla de ítems editable**: Con cálculos automáticos de subtotales e IVA
- **Condiciones de operación**: Contado, crédito, cuotas
- **Numeración automática de documentos**: Con control de timbrado vigente
- **Vista previa e impresión**: Tickets térmicos, A4, PDF

#### Funcionalidades comunes del POS
- **Configuración por sucursal**: Cada sucursal puede tener su propio modo POS, tamaño de tiles, columnas, flags de stock
- **Apertura/cierre de caja obligatorio**: Control de sesiones con monto base
- **Arqueo de caja**: Parcial (durante el día) y final (al cerrar)
- **Autorización remota de supervisor**: Vía WebSocket en tiempo real para operaciones que requieren aprobación
- **Menú de acceso rápido**: Panel de administración, configuración, cierre de caja y logout

---

### 4.2 — 📄 FACTURACIÓN ELECTRÓNICA

Cumplimiento total con las normativas del **Sistema Integrado de Facturación Electrónica Nacional (SIFEN)** de la SET:

- **Emisión automática de Documentos Tributarios Electrónicos (DTE)**
- **Envío automático a SIFEN**: Las facturas se encolan y envían en segundo plano sin interrumpir la operación del cajero
- **Estados SIFEN en tiempo real**: Pendiente, Aprobado, Rechazado — con sincronización automática cada 5 minutos
- **Reenvío de lotes**: Facturas pendientes se pueden reenviar en lote
- **Timbrado electrónico**: Gestión de timbrados vigentes con fechas de validez
- **Numeración secuencial atómica**: Garantiza que nunca se duplique un número de factura
- **Múltiples puntos de expedición**: Configuración por sucursal
- **Tipos de documento**: Factura electrónica, Nota de crédito electrónica
- **KuDE (Código Digital del Evento)**: Generación de documento verificable
- **Cola de procesamiento**: Sistema de colas BullMQ para envío asíncrono que no bloquea la operación
- **Dashboard de estados**: Monitoreo visual de facturas aprobadas, rechazadas y pendientes

---

### 4.3 — 📦 INVENTARIO Y STOCK

Control total de su inventario con soporte multi-almacén:

- **Múltiples almacenes/depósitos**: Por sucursal o independientes
- **Stock por producto y depósito**: Visibilidad cruzada del inventario
- **Movimientos de inventario**: Entradas, salidas, transferencias entre depósitos
- **Descuento automático de stock**: Al facturar se descuenta automáticamente del depósito correcto
- **Devolución automática de stock**: Al crear nota de crédito, el stock se restaura
- **Productos con variantes**: Sistema padre-hijo (ej: Remera → Rojo/M, Rojo/L, Azul/M)
  - Cada variante con su propio código de barras, precio, stock
  - Generador automático de combinaciones de variantes
- **Presentaciones de producto**: Unidad, caja, paquete con factor de conversión automático
- **Productos con o sin gestión de inventario**: Flexibilidad para servicios vs. productos físicos
- **Categorías jerárquicas**: Categorías padre-hijo para organizar el catálogo
- **Marcas**: Catálogo de marcas con asignación a productos
- **Reportes de inventario**:
  - Movimientos de stock por período
  - Niveles de stock actuales por almacén
  - Productos con stock bajo (próximamente)

---

### 4.4 — 💰 TESORERÍA Y CAJAS

Gestión financiera operativa con control riguroso:

- **Cajas registradoras**: Múltiples cajas por sucursal con estado individual
- **Sesiones de caja**: Apertura con monto base, cierre con cuadre detallado
- **Movimientos de efectivo**: Entradas (ingresos adicionales) y salidas (gastos operativos) durante la sesión
- **Categorización de movimientos**: Para clasificación contable
- **Arqueo de caja**:
  - **Parcial**: Verificación sin cerrar la caja — durante la jornada
  - **Final**: Cierre con cuadre por denominación/moneda, diferencia sistema vs. contado
  - **Autorización requerida**: Si la diferencia supera el monto configurado
- **Multi-moneda**: Soporte para Guaraníes (PYG), Dólares (USD), Reales (BRL) y más
- **Cotizaciones diarias**: Registro de cotización por moneda con histórico
- **Reporte de movimientos de caja**: Detalle completo por sesión, cajero, fecha y tipo

---

### 4.5 — 🧾 COBROS Y RECIBOS

Sistema completo de gestión de cobros para empresas con cartera de clientes:

- **Registro de cobros**: Con recibo detallado por cuota/factura
- **Distribución de pagos**: Un solo pago se distribuye automáticamente entre múltiples cuotas pendientes
- **Múltiples medios de pago**: Efectivo, cheque, transferencia, etc.
- **Rendiciones de cobrador**: El supervisor agrupa los recibos del cobrador y genera una rendición para cierre contable
- **Auto-detección de cobrador**: El sistema detecta automáticamente al cobrador logueado y asigna sus recibos
- **Anulación de recibos**: Con auditoría completa y permisos específicos
- **Compatibilidad holding**: Las rendiciones pueden incluir recibos de empresas subsidiarias

---

### 4.6 — 📊 DASHBOARD Y REPORTES

Información gerencial en tiempo real para tomar decisiones acertadas:

#### Dashboard
- **Ventas del día/semana/mes**: Con comparativa vs. período anterior
- **Ticket promedio**: Evolución temporal
- **Productos top**: Los más vendidos por cantidad e importe
- **Ventas por hora**: Para identificar horarios pico
- **Desglose por categoría**: Distribución de ventas por tipo de producto
- **Gráficos interactivos**: Visualizaciones con Recharts (barras, líneas, pie)

#### Centro de Reportes
- **Resumen de ventas**: Filtros por fecha, sucursal, vendedor, estado
- **Reporte de productos**: Análisis de desempeño por producto
- **Movimientos de caja**: Detalle por sesión y cajero
- **Movimientos de stock**: Entradas/salidas por período y almacén
- **Niveles de stock**: Estado actual del inventario
- **Cuentas por cobrar**: Cartera vigente, vencida, proyección
- **Reporte por cobrador**: Productividad, montos asignados vs. cobrados, tasa de morosidad
- **Auditoría**: Logs de todas las acciones del sistema
- **Libro IVA Ventas**: Reporte fiscal (próximamente)
- **Exportación**: PDF y Excel disponibles en reportes clave

---

### 4.7 — 👥 CONTACTOS (CRM Básico)

Gestión centralizada de clientes y proveedores:

- **Base de datos unificada**: Clientes y proveedores en un solo lugar
- **Datos completos**: RUC/CI, razón social, teléfonos, email, dirección, referencia de domicilio
- **Naturaleza del receptor**: Persona física, jurídica — acorde a SIFEN
- **Tipo de contribuyente**: Contribuyente, no contribuyente
- **Tipo de documento de identidad**: CI, RUC, pasaporte, etc.
- **Historial de compras**: Facturas asociadas al cliente
- **Lista de precios asignada**: Cada cliente puede tener su propia lista de precios
- **Creación rápida desde POS**: Sin salir del flujo de facturación
- **Búsqueda avanzada**: Por razón social, RUC, documento, teléfono

---

### 4.8 — 🏷️ LISTAS DE PRECIOS

Sistema flexible de precios múltiples para adaptarse a cualquier estrategia comercial:

- **Múltiples listas**: General, Mayorista, VIP, Empleados, Convenio, Temporada, etc.
- **Tipos de aplicación**: General, por cliente, zona geográfica, canal de venta
- **Precios por producto**: Cada lista define precios específicos por producto
- **Descuentos/recargos globales**: Porcentaje de descuento o recargo automático sobre la lista base
- **Redondeo configurable**: Normal, hacia arriba, hacia abajo — con decimales configurables
- **Vigencia temporal**: Fecha de inicio y fin para listas estacionales
- **Prioridad**: Resolución automática de conflictos cuando un cliente tiene varias listas
- **Asignación flexible**: Por cliente individual, grupo de clientes, vendedor, zona
- **Precio mínimo y máximo**: Guardarrail para proteger el margen
- **Integración con POS**: Al seleccionar un cliente, su lista de precios se aplica automáticamente

---

### 4.9 — 🎁 OFERTAS Y PROMOCIONES

Motor de ofertas potente y flexible para impulsar ventas:

#### Tipos de ofertas disponibles
| Tipo | Ejemplo |
|---|---|
| **Descuento porcentaje** | 20% OFF en lácteos |
| **Descuento monto fijo** | Gs. 5.000 de descuento en producto X |
| **Precio especial** | Producto a Gs. 50.000 (era Gs. 65.000) |
| **NxM** | 3×2 en bebidas |
| **Combo** | Shampoo + Acondicionador = Gs. 15.000 |
| **Por medio de pago** | 10% con Visa, 15% efectivo |
| **Por día de semana** | Martes de farmacia 25% OFF |
| **Por horario** | Happy Hour 18-20hs 30% OFF |

#### Características del motor
- **Evaluación automática**: Al agregar ítems al carrito, el motor busca y aplica la mejor oferta
- **Condiciones combinables**: Cantidad mínima, monto mínimo, tipo de cliente, medio de pago
- **Multi-sucursal**: Ofertas pueden limitarse a sucursales específicas
- **Exclusiones**: Excluir productos o categorías específicas de una oferta global
- **Límites de uso**: Total y por cliente
- **Prioridad configurable**: Resolver conflictos entre ofertas competidoras
- **Historial de uso**: Trazabilidad completa de qué ofertas se aplicaron en cada factura

---

### 4.10 — 📝 NOTAS DE CRÉDITO

Gestión completa de notas de crédito con integración SIFEN:

- **Emisión vinculada a factura original**: Selección de ítems y cantidades a acreditar
- **Envío automático a SIFEN**: Cola de procesamiento independiente
- **Devolución automática de stock**: Al emitir la NC, el stock se restaura en el almacén correcto
- **Reversión SIFEN**: Soporte para eventos de cancelación (ECAN) e inutilización (EINU)
- **Re-descuento de stock**: Si una NC se cancela/inutiliza, el stock se descuenta nuevamente
- **Depósito destino configurable**: El stock se devuelve al depósito de origen o al principal

---

### 4.11 — 🤝 VENTAS MAYORISTAS

Módulo especializado para empresas que venden en volumen:

- **Flujo de negociación**: Vendedor ↔ Cliente con precios negociados en tiempo real
- **Pedidos/Proformas**: Estados: Borrador → Confirmado → En Caja → Facturado
- **Precio negociado vs. precio lista**: Visualización de descuento automático por ítem
- **Número de pedido secuencial**: PED-0000001 generado automáticamente
- **Historial de negociación**: Log completo de cambios de precio/cantidad durante la negociación
- **Catálogo con precios del cliente**: Al seleccionar un cliente, se muestran los precios de su lista asignada
- **Panel de información del cliente**: Historial de compras, crédito disponible, últimas transacciones
- **Productos frecuentes y top ventas**: Acceso rápido a lo más vendido
- **Cancelación con motivo**: Registro del motivo de cancelación para análisis
- **Integración con POS**: Los pedidos confirmados pueden cobrarse directamente en caja

---

### 4.12 — 💳 CRÉDITOS Y SOLICITUDES

Sistema completo de gestión de crédito para ventas a plazos:

- **Solicitud de crédito**: Formulario completo con datos del cliente, montos, plazos
- **Flujo de aprobación**: Borrador → Enviado → Aprobado/Rechazado por supervisor
- **Precios a cuotas por producto**: Definición manual de planes de cuotas por producto (ej: "3 × 100.000", "12 × 300.000")
- **Condiciones de pago flexibles**: Contado, 30/60/90 días, cuotas semanales, quincenales, mensuales
- **Día fijo de cobro**: Semanal (ej: todos los martes) o mensual (ej: día 15)
- **Cuota inicial configurable**: Posibilidad de exigir entrega inicial
- **Cronograma de cuotas automático**: Generación de fechas de vencimiento según condición
- **Asignación de cobrador**: Vincular un cobrador a la solicitud de crédito
- **Límite de crédito por cliente**: Control automático de saldo disponible

---

### 4.13 — 📱 CUENTAS POR COBRAR

Seguimiento integral de la cartera de créditos:

- **Vista consolidada**: Todas las cuentas pendientes con estado de morosidad
- **Filtros avanzados**: Por cliente, cobrador, estado, fecha de vencimiento, sucursal
- **Desglose por cuota**: Detalle de cuotas pagadas, pendientes y vencidas
- **Cálculo de mora**: Configurable por empresa (tasa diaria, mensual o monto fijo)
  - Período de gracia configurable
  - Base de cálculo: sobre capital o cuota completa
  - Monto mínimo y máximo de mora
- **Promesas de pago**: Registro y seguimiento de compromisos del cliente
- **Recordatorios automáticos**: SMS/WhatsApp vía Twilio un día antes del vencimiento
- **Panel del cobrador**: Vista mobile-first con cuotas ordenadas por urgencia

---

### 4.14 — 🧑‍💼 VENDEDORES Y COBRADORES

Gestión completa del equipo comercial y de cobranza:

- **Registro de vendedores y cobradores**: Con tipo (vendedor, cobrador, ambos)
- **Asignación automática**: Al facturar o cobrar, el sistema detecta al vendedor/cobrador logueado
- **Comisiones**: Cálculo automático basado en ventas o cobros realizados
- **Rendiciones**: Agrupación de recibos por cobrador para cierre y liquidación
- **Panel del supervisor**: Aprobación/rechazo de autorizaciones en tiempo real vía WebSocket
- **Autorización de descuentos**: Flujo cobrador → supervisor con TTL de 30 minutos
- **Reportes por cobrador**: Productividad, montos asignados vs. cobrados, tasa de morosidad
- **Asignación de facturas**: Para distribución de cartera entre cobradores

---

### 4.15 — 🔐 SEGURIDAD Y AUDITORÍA

Protección integral de su información y operaciones:

#### Autenticación y acceso
- **Autenticación JWT**: Tokens seguros con refresh automático
- **Refresh token**: Renovación transparente sin interrumpir al usuario
- **App Key**: Capa adicional de seguridad en endpoints públicos
- **Sesión segura**: Cierre automático por inactividad

#### Sistema de permisos granulares (2 capas)
- **Capa 1 — Plan de suscripción**: Controla qué módulos están disponibles
- **Capa 2 — Permisos de usuario**: Privilegios LEER / CREAR / EDITAR / ELIMINAR por módulo
- **Perfiles/roles**: Crear perfiles como "Cajero", "Supervisor", "Gerente" con permisos específicos
- **Super Admin**: Acceso total dentro del plan contratado

#### Auditoría
- **Log completo de acciones**: Cada creación, edición y eliminación queda registrada
- **Valores anterior y nuevo**: Se guarda el estado antes y después de cada cambio (JSON)
- **IP y User-Agent**: Trazabilidad completa del dispositivo de origen
- **Vinculación a caja/sesión**: Cada acción se asocia a la sesión de caja activa
- **Reporte de auditoría**: Consulta con filtros por usuario, entidad, fecha, tipo de acción

#### Seguridad POS
- **PIN de supervisor**: Para operaciones que requieren autorización (descuentos, anulaciones, etc.)
- **Autorización remota WebSocket**: El supervisor puede aprobar/rechazar desde otra terminal en tiempo real
- **Dispositivos autorizados**: Control de qué dispositivos pueden acceder al POS
- **Arqueo obligatorio**: No se puede cerrar caja sin cuadrar, con margen de tolerancia configurable

---

### 4.16 — ⚙️ CONFIGURACIÓN

Personalización completa del sistema:

- **Datos de empresa**: Razón social, RUC, logo, dirección, contactos
- **Sucursales**: Múltiples sucursales con datos independientes
- **Cajas registradoras**: Creación y gestión por sucursal
- **Almacenes/depósitos**: Por sucursal o independientes
- **Usuarios**: CRUD completo con asignación de perfil y sucursal
- **Perfiles y permisos**: Creación de roles con permisos granulares
- **Configuración del POS**: Tipo (retail/admin), tiles, columnas, flags de stock, por sucursal
- **Numeración de documentos**: Timbrado, punto de expedición, numeración secuencial
- **Configuración de ticket**: Personalización del ticket de impresión
- **Medios de pago**: Activar/desactivar medios de pago disponibles
- **Impresoras**: Configuración de impresoras térmicas y A4
- **Monedas y cotizaciones**: Monedas habilitadas con cotización del día
- **Listas de precios**: Creación y gestión desde configuración
- **Planes de cuotas**: Definición de planes de financiamiento
- **Configuración de mora**: Tasas, período de gracia, base de cálculo

---

### 4.17 — 💎 SUSCRIPCIONES Y MODELO MULTI-EMPRESA

Arquitectura empresarial avanzada para grupos y distribuidores:

#### Jerarquía empresarial
```
Holding (Casa matriz)
  ├── Reseller 1 (Distribuidor)
  │   ├── Subsidiario A (Cliente final)
  │   └── Subsidiario B
  └── Reseller 2
      └── Subsidiario C
```

- **Holding**: Administra todo el ecosistema, ve métricas consolidadas
- **Reseller**: Vende el servicio a subsidiarios y gana comisiones recurrentes
- **Subsidiario**: Usuario final del sistema con su propio plan

#### Funcionalidades de suscripción
- **Planes configurables**: Con límites de documentos, usuarios, productos, clientes, facturación
- **Módulos por plan**: Cada plan incluye un set específico de módulos
- **Módulos adicionales**: Se pueden agregar módulos extra a una suscripción
- **Override de límites**: Ajustes temporales para necesidades puntuales
- **Cambio de plan**: Upgrade/downgrade con motivo registrado
- **Vencimiento automático**: Cron diario que verifica y actualiza estados de suscripción
- **Período de gracia**: Días configurables antes de suspender el acceso
- **Guard de suscripción**: Bloquea operaciones de escritura cuando la suscripción expira (permite lectura)

#### Comisiones para Resellers
- **Cálculo automático**: Comisiones recurrentes por cada suscripción vendida
- **Dashboard de comisiones**: Resumen, pendientes, historial
- **Métricas de holding**: Vista consolidada de toda la red
- **Red empresarial visual**: Árbol jerárquico interactivo de todas las empresas

---

### 4.18 — 📡 MODO OFFLINE (PWA)

Operación ininterrumpida incluso sin conexión a internet:

- **Aplicación instalable**: Funciona como app nativa en Android, iOS y escritorio
- **Base de datos local (IndexedDB)**: Catálogo de productos, clientes, medios de pago almacenados localmente
- **Sincronización automática**: Cada 5 minutos sincroniza cambios con el servidor
- **Sincronización delta**: Solo descarga cambios desde la última sincronización (eficiente en datos)
- **Ventas offline**: Se almacenan localmente y se envían automáticamente al recuperar conexión
- **Detección de conectividad real**: Ping al servidor cada 30 segundos (no confía solo en `navigator.onLine`)
- **Indicador visual de estado**: Barra de sincronización que muestra el estado en tiempo real
- **Protección de datos**: `navigator.storage.persist()` protege la base local contra limpieza del navegador
- **Service Worker con Workbox**: Precache del shell de la aplicación (~7.5MB) para carga instantánea
- **Cache inteligente**: Google Fonts, imágenes y API de sincronización se cachean con estrategias optimizadas

---

## 5. INTEGRACIONES Y TECNOLOGÍA

### Integraciones nativas

| Integración | Descripción |
|---|---|
| **SIFEN (SET Paraguay)** | Facturación electrónica: envío, estados, KuDE, eventos |
| **Twilio SMS/WhatsApp** | Verificación de cuentas, recordatorios de pago |
| **Email transaccional** | Notificaciones, facturas por email, recuperación de contraseña |
| **AWS S3** | Almacenamiento seguro de archivos, imágenes de productos, comprobantes |
| **QZ Tray** | Impresión directa en impresoras térmicas (POS) |
| **Lector de código de barras** | Detección automática integrada en el POS |

### Stack tecnológico

| Componente | Tecnología | Beneficio |
|---|---|---|
| **Frontend** | React 18 + Vite 5 | Interfaz rápida y moderna |
| **Backend** | NestJS 11 + TypeScript | Robusto, escalable, mantenible |
| **Base de datos** | PostgreSQL | Confiable, potente, estándar empresarial |
| **Cache** | Redis | Respuestas instantáneas en consultas frecuentes |
| **Colas** | BullMQ + Redis | Procesamiento asíncrono (emails, SIFEN) sin bloquear la operación |
| **Offline** | Dexie.js (IndexedDB) + Service Worker | Operación sin internet |
| **Hosting** | Cloud (Firebase/AWS) | Alta disponibilidad, escalabilidad automática |
| **API** | REST versionada (/api/v1/) | Estándar, documentada con Swagger |

---

## 6. VENTAJAS COMPETITIVAS

### ¿Por qué elegir Automia?

#### 1. 🇵🇾 Diseñado para Paraguay
- Integración nativa con SIFEN (no es un addon)
- Soporte de Guaraníes, Dólares y Reales
- Tipos de documento paraguayos (CI, RUC, pasaporte)
- Normativa fiscal paraguaya incorporada desde el diseño

#### 2. 🌐 Funciona sin internet
- El POS opera normalmente sin conexión
- Las ventas se sincronizan automáticamente al recuperar conexión
- No pierde ventas por cortes de internet — **cero pérdida de ingresos**
- La aplicación se instala como app nativa (PWA)

#### 3. 🏢 Multi-todo
- **Multi-empresa**: Gestione un grupo empresarial completo
- **Multi-sucursal**: Cada sucursal con su configuración independiente
- **Multi-almacén**: Stock distribuido con visibilidad cruzada
- **Multi-caja**: Múltiples cajas por sucursal con control individual
- **Multi-moneda**: Guaraníes, dólares, reales con cotización diaria
- **Multi-usuario**: Sin límite de usuarios concurrentes (según plan)

#### 4. 🔒 Seguridad empresarial
- Permisos granulares por módulo y por acción (LEER/CREAR/EDITAR/ELIMINAR)
- Auditoría completa de cada operación (quién, cuándo, qué cambió, desde dónde)
- PIN de supervisor para operaciones sensibles
- Autorización remota en tiempo real vía WebSocket
- Tokens JWT con refresh automático
- Encriptación de contraseñas con bcrypt

#### 5. ⚡ Velocidad y rendimiento
- Cache Redis para consultas frecuentes
- Búsqueda fuzzy con índices trigram en PostgreSQL
- Procesamiento asíncrono de emails y SIFEN (no bloquea la operación)
- Sincronización delta (solo cambios, no todo el catálogo)
- Service Worker con precache para carga instantánea

#### 6. 📱 Accesible desde cualquier lugar
- Funciona en navegador web (Chrome, Firefox, Safari, Edge)
- Instalable como aplicación nativa (PWA) en Android, iOS y escritorio
- Diseño responsive: se adapta a desktop, tablet y móvil
- No requiere instalación de software — solo un navegador
- Cero inversión en hardware especial (funciona en cualquier PC/tablet)

#### 7. 🔄 Actualización continua
- Modelo SaaS: siempre tiene la última versión sin hacer nada
- Service Worker con auto-update silencioso
- Nuevas funcionalidades se despliegan sin interrupción del servicio
- Sin costos ocultos de actualización o migración

#### 8. 📊 Información en tiempo real
- Dashboard con métricas actualizadas al segundo
- Reportes con filtros dinámicos
- Cuentas por cobrar con estado de morosidad en vivo
- Stock actualizado automáticamente con cada venta/devolución

#### 9. 🤝 Escalable con su negocio
- Desde un emprendimiento unipersonal hasta un grupo empresarial
- Agregue sucursales, usuarios y módulos según crece
- Cambie de plan sin migración de datos
- Modelo holding → reseller → subsidiario para redes de distribución

#### 10. 💰 Retorno de inversión claro
- **Elimina**: Planillas de Excel, sistemas desconectados, procesos manuales
- **Reduce**: Errores de facturación, pérdida de stock, fraude de caja, morosidad no controlada
- **Acelera**: Proceso de venta (POS rápido), cobros (cobrador mobile), decisiones (dashboard en tiempo real)
- **Cumple**: Normativa SIFEN sin esfuerzo adicional

---

## 7. CASOS DE USO POR RUBRO

### 🛒 Supermercados y Retail
- POS Retail con grilla de productos y lector de códigos
- Control de stock multi-almacén
- Ofertas y promociones (3×2, descuentos por categoría, happy hour)
- Múltiples cajas con arqueo por sesión
- Operación offline para zonas con conectividad inestable
- Categorías jerárquicas para organizar miles de productos

### 🏭 Distribuidoras y Mayoristas
- Módulo de pedidos con negociación de precios
- Listas de precios por cliente/zona/volumen
- Condiciones de pago flexibles (contado, crédito, cuotas)
- Productos con presentaciones (unidad, caja, paquete)
- Vendedores con comisiones automáticas
- Solicitudes de crédito con aprobación supervisada

### 🏗️ Empresas de servicios
- Facturación electrónica SIFEN
- CRM básico con historial de clientes
- Cuentas por cobrar con seguimiento de morosidad
- Tesorería con control de flujo de caja
- Reportes de ventas y financieros

### 🏪 Cadenas de tiendas
- Multi-sucursal con configuración independiente
- Dashboard consolidado de todas las sucursales
- Stock centralizado o distribuido
- Usuarios con permisos por sucursal
- Jerarquía holding → subsidiarios

### 📱 Empresas con cobradores en campo
- Panel del cobrador mobile-first
- Cobros con distribución automática entre cuotas
- Rendiciones de cobrador con cierre supervisor
- Promesas de pago con recordatorio SMS/WhatsApp
- Reporte de productividad por cobrador
- Autorización de descuentos con flujo supervisor-cobrador

### 🏢 Grupos empresariales (Holdings)
- Red empresarial visual con jerarquía de empresas
- Métricas consolidadas del grupo
- Gestión centralizada de suscripciones y planes
- Módulos adicionales por subsidiario
- Override de límites para necesidades puntuales
- Comisiones automáticas para resellers

---

## 8. MODELO SAAS Y PLANES DE SUSCRIPCIÓN

### Modelo de servicio

Automia opera bajo el modelo **SaaS (Software as a Service)**:

| Concepto | Detalle |
|---|---|
| **Tipo** | Suscripción mensual o anual |
| **Hosting** | 100% en la nube, nosotros nos encargamos |
| **Actualizaciones** | Incluidas, automáticas, sin costo adicional |
| **Soporte** | Incluido según plan |
| **Backups** | Automáticos diarios |
| **SLA** | Disponibilidad 99.5%+ |

### Estructura de planes (referencial)

| Característica | Básico | Profesional | Empresarial | Holding |
|---|---|---|---|---|
| Usuarios | Hasta 3 | Hasta 10 | Hasta 30 | Ilimitados |
| Sucursales | 1 | Hasta 3 | Hasta 10 | Ilimitadas |
| Facturación SIFEN | ✅ | ✅ | ✅ | ✅ |
| POS (Retail + Admin) | ✅ | ✅ | ✅ | ✅ |
| Inventario | ✅ | ✅ | ✅ | ✅ |
| Tesorería | ✅ | ✅ | ✅ | ✅ |
| Contactos (CRM) | ✅ | ✅ | ✅ | ✅ |
| Modo Offline (PWA) | ✅ | ✅ | ✅ | ✅ |
| Reportes básicos | ✅ | ✅ | ✅ | ✅ |
| Cobros y recibos | — | ✅ | ✅ | ✅ |
| Listas de precios | — | ✅ | ✅ | ✅ |
| Ofertas y promociones | — | ✅ | ✅ | ✅ |
| Ventas mayoristas | — | — | ✅ | ✅ |
| Créditos y solicitudes | — | — | ✅ | ✅ |
| Cuentas por cobrar | — | — | ✅ | ✅ |
| Vendedores y cobradores | — | — | ✅ | ✅ |
| Multi-empresa (red) | — | — | — | ✅ |
| Comisiones reseller | — | — | — | ✅ |
| Métricas holding | — | — | — | ✅ |
| Auditoría avanzada | — | — | ✅ | ✅ |
| Módulos adicionales | — | Disponible | Disponible | Disponible |
| Soporte | Email | Email + Chat | Prioritario | Dedicado |

> *Los planes y precios son referenciales y se ajustan según las necesidades específicas de cada cliente.*

---

## 9. SEGURIDAD Y CUMPLIMIENTO

### Seguridad de datos

| Aspecto | Implementación |
|---|---|
| **Autenticación** | JWT con tokens de acceso y refresh |
| **Encriptación de contraseñas** | bcrypt con salt rounds |
| **API segura** | App Key + JWT Bearer en cada request |
| **CORS** | Configurado por dominio autorizado |
| **Validación de datos** | DTOs con class-validator (whitelist, forbid unknown) |
| **Soft delete** | Los datos nunca se eliminan físicamente |
| **Multi-tenancy** | Aislamiento total de datos por empresa (empresa_id) |

### Cumplimiento normativo

| Normativa | Cumplimiento |
|---|---|
| **SIFEN (SET Paraguay)** | Integración completa: DTE, KuDE, eventos, timbrado |
| **Factura electrónica** | Emisión, envío y consulta de estado |
| **Notas de crédito** | Emisión con eventos de cancelación/inutilización |
| **Numeración secuencial** | Control atómico sin duplicados |
| **Timbrado vigente** | Validación de fechas de vigencia |
| **Tipo de contribuyente** | Persona física y jurídica |
| **Tipos de IVA** | 10%, 5%, exento — según SIFEN |

### Auditoría y trazabilidad

- Todas las operaciones de escritura (crear, editar, eliminar) generan un registro de auditoría automático
- Cada registro incluye: usuario, fecha/hora, IP, user-agent, valores anterior y nuevo (JSON)
- Consulta de auditoría con filtros avanzados
- Ideal para auditorías internas y externas, cumplimiento tributario

---

## 10. SOPORTE Y ACOMPAÑAMIENTO

### Proceso de implementación

| Etapa | Descripción | Duración estimada |
|---|---|---|
| **1. Descubrimiento** | Relevamiento de necesidades, procesos actuales, datos a migrar | 1-2 días |
| **2. Configuración** | Empresa, sucursales, cajas, usuarios, permisos, numeración, timbrado | 1-2 días |
| **3. Carga de datos** | Productos, clientes, stock inicial (manual o importación) | 1-3 días |
| **4. Capacitación** | Entrenamiento presencial o remoto por módulo y por rol | 2-5 días |
| **5. Go-Live asistido** | Acompañamiento en las primeras operaciones reales | 1-3 días |
| **6. Soporte post-lanzamiento** | Resolución de dudas y ajustes finos | 30 días |

### Canales de soporte

| Canal | Disponibilidad |
|---|---|
| **Email** | Lunes a viernes, respuesta en < 24h |
| **Chat en línea** | Lunes a viernes, horario comercial |
| **Soporte telefónico** | Según plan (profesional en adelante) |
| **Mesa de ayuda** | Tickets con seguimiento (planes empresariales) |
| **Actualizaciones** | Automáticas, sin costo, sin interrupción |

---

## 11. HOJA DE RUTA DEL PRODUCTO

Automia está en constante evolución. Estos son algunos de los desarrollos planificados:

### Próximas funcionalidades

| Funcionalidad | Estado | ETA |
|---|---|---|
| Multi-moneda completa en POS | En desarrollo | Q2 2026 |
| Control de crédito de clientes automático | En desarrollo | Q2 2026 |
| App móvil nativa para cobradores | Planificado | Q3 2026 |
| Libro IVA Ventas/Compras | Planificado | Q3 2026 |
| Dashboard de morosidad con predicción | Planificado | Q4 2026 |
| Módulo de compras (Órdenes de compra) | Planificado | Q3 2026 |
| Integración WhatsApp Business API | Planificado | Q3 2026 |
| Reportes Z/X fiscales | Planificado | Q3 2026 |
| E-commerce B2B integrado | Planificado | Q4 2026 |
| Módulo contable básico | Planificado | Q4 2026 |
| Integración con balanza electrónica | Planificado | 2027 |
| Integración con gaveta de dinero ESC/POS | Planificado | 2027 |

---

## 12. PREGUNTAS FRECUENTES

**¿Necesito instalar algo en mi computadora?**
No. Automia funciona 100% en el navegador web. Opcionalmente puede instalarse como aplicación (PWA) para acceso directo y funcionamiento offline.

**¿Qué pasa si se corta el internet?**
El POS sigue funcionando normalmente. Las ventas se almacenan localmente y se sincronizan automáticamente al recuperar conexión. No pierde ni una sola venta.

**¿Puedo usarlo en una tablet?**
Sí. La interfaz es responsive y se adapta a tablets y celulares. El POS Retail está optimizado para pantallas táctiles.

**¿Es compatible con mi impresora de tickets?**
Sí. Soporta impresoras térmicas vía QZ Tray y también impresión en A4/PDF desde el navegador.

**¿Puedo migrar mis datos actuales?**
Sí. Ofrecemos asistencia para la migración de catálogo de productos, clientes y datos maestros desde sistemas existentes o archivos Excel.

**¿Qué sucede si quiero agregar más usuarios o sucursales?**
Puede cambiar de plan o agregar módulos adicionales en cualquier momento sin pérdida de datos.

**¿Mis datos están seguros?**
Sí. Utilizamos encriptación de datos, autenticación JWT, backups automáticos diarios y aislamiento total de datos entre empresas.

**¿Cómo funciona la facturación electrónica SIFEN?**
Las facturas se generan, se envían a SIFEN automáticamente en segundo plano y se actualiza el estado (Aprobado/Rechazado) sin intervención del usuario.

**¿Puedo usar Automia para gestionar varias empresas?**
Sí. Con el plan Holding puede gestionar una red completa de empresas con jerarquía holding → reseller → subsidiario.

**¿Hay límite de productos o clientes?**
Los límites dependen del plan contratado. Los planes empresariales ofrecen capacidades muy amplias y pueden ajustarse con overrides temporales.

---

## 13. PRÓXIMOS PASOS

Para avanzar con la implementación de Automia en su empresa, le proponemos:

### 1. Demo personalizada
Coordinemos una **demostración en vivo** del sistema adaptada a su rubro y necesidades específicas, sin compromiso.

### 2. Propuesta económica
Tras la demo, preparamos una **propuesta económica detallada** con el plan más adecuado para su operación.

### 3. Plan de implementación
Definimos juntos el **cronograma de implementación** con fechas, responsables y entregables.

### 4. Inicio
En **tan solo 1 semana** puede estar operando con Automia.

---

<p align="center">

### INFORMACIÓN DE CONTACTO

| | |
|---|---|
| **Empresa** | [Nombre de la empresa] |
| **Email** | [email@empresa.com] |
| **Teléfono** | [+595 XXX XXXXXX] |
| **Web** | [www.automia.com.py] |
| **Dirección** | [Dirección, Ciudad, Paraguay] |

</p>

---

<p align="center">
  <em>Automia — Automatizamos su gestión para que usted se enfoque en hacer crecer su negocio.</em>
</p>

<p align="center">
  <strong>© 2026 Automia. Todos los derechos reservados.</strong>
</p>
