Facturador Bot Bolivia

Asistente de facturación por WhatsApp para contribuyentes bolivianos.

El producto permite crear un borrador de factura mediante texto o audio, validarlo con el usuario y emitirlo ante el SIN mediante nuestro propio Sistema Informático de Facturación Proveedor autorizado.

WhatsApp es la interfaz, no el sistema fiscal.

WhatsApp -> Facturador Bot -> Motor fiscal propio -> SIN

La inteligencia artificial interpreta la intención del usuario. Las reglas tributarias, importes, estados e idempotencia se ejecutan de manera determinística. Ninguna factura se emite sin confirmación explícita.

• Arquitectura de la solución
• Alcance y plan del MVP
• Evaluación de proveedores fiscales
• ADR-001: proveedor fiscal inicial
• Implementación directa del SIAT
• ADR-002: sistema proveedor propio
• Backlog de ejecución
• Inventario de artefactos oficiales
• Preparación para autorización
• Modelo de datos inicial

Base técnica inicial implementada:

• monorepo TypeScript con API, worker, dominio, motor fiscal y persistencia;
• esquema PostgreSQL/Prisma multiempresa;
• estados e idempotencia de la factura;
• motor fiscal simulado para desarrollar sin credenciales del SIN;
• pruebas automatizadas del dominio y la emisión simulada.

El motor simulado no genera facturas fiscales válidas ni se conecta al SIN. Será reemplazado progresivamente por el adaptador SIAT propio cuando el SIN entregue las credenciales, códigos de sistema y endpoints de pruebas.

Requisitos: Node.js 22 o superior. PostgreSQL será necesario al comenzar la capa de persistencia, pero todavía no es necesario para ejecutar las pruebas o la API demo.

npm install
npm run db:validate
npm run db:generate
npm run build
npm test
npm run start:api

Con la API activa:

GET  http://localhost:3000/health
POST http://localhost:3000/v1/demo/invoices

Las rutas bajo /v1/demo usan exclusivamente el motor fiscal simulado.