2025 – actualidad · Desarrollo, arquitectura, mantenimiento y comercialización
FACSIS — Facturación electrónica con asistente de IA
Web app y app móvil de facturación electrónica SIFEN para uso masivo
Este trabajo se realizó bajo acuerdos de confidencialidad. Describo mi rol, las decisiones y la arquitectura a nivel general, sin datos internos, cifras ni capturas de clientes.
Contexto
La facturación electrónica es obligatoria de forma progresiva en Paraguay y muchos contribuyentes pequeños no tenían una herramienta simple. FACSIS nace como producto propio de Encom para cubrir ese segmento, con una web app y apps móviles.
Mi rol
Soy el autor principal del producto (la gran mayoría de los commits) y responsable de su arquitectura, despliegue y evolución. También participo en su comercialización y en la relación con clientes, lo que me da contacto directo con el uso real.
Desafíos
- Cumplir el estándar técnico de SIFEN (firmado, lotes, consultas, eventos) manteniendo una experiencia simple para el usuario.
- Prepararse para picos de emisión altos sin comprometer la numeración ni la consistencia de los documentos.
- Incorporar IA de forma útil y segura: el modelo no puede emitir documentos ni inventar datos.
- Controlar el costo de la IA por plan y por cliente.
Decisiones
- Next.js con App Router y Prisma sobre PostgreSQL, con una base de datos extensa pero modelada por dominios (documentos, stock, compras, caja, suscripciones).
- El asistente solo usa herramientas de lectura y crea borradores; la emisión la confirma el usuario y es idempotente. Los cálculos de precios e IVA los hace el servidor, nunca el modelo.
- Cadena de proveedores de modelos con fallback y monitoreo de salud, cuotas de tokens por plan y tope de gasto mensual global.
- RAG con pgvector sobre la documentación del producto y las notas técnicas de la DNIT.
- Pruebas de carga por etapas con un mock de SIFEN, colas con reintentos exponenciales y bloqueos por timbrado para la numeración.
Resultado
FACSIS está en producción con apps en las tiendas de iOS y Android, API pública para integradores y asistente de IA disponible dentro de la aplicación, con trazabilidad por mensaje y control de costos.
Puntos clave
- Facturas, notas de crédito, remisiones, autofacturas y recibos, con integración completa al pipeline SIFEN.
- Multiempresa con roles e invitaciones, planes y suscripciones, API REST pública con claves por empresa y documentación OpenAPI.
- Asistente de IA por texto y voz (ver caso aparte) que redacta borradores, consulta ventas con gráficos y reportes, y responde desde la normativa con RAG.
- Diseño para alto volumen: emisión asíncrona con colas, límite de tasa distribuido y numeración protegida con bloqueos transaccionales.
- Pagos con tarjeta y QR, apps nativas publicadas con Capacitor y despliegue en Kubernetes con tareas programadas.
Puedo ampliar los detalles en una conversación, respetando las mismas restricciones.