MITFacturas con IA
InvoiceFlow
Facturas con IA y validación fiscal DGII para República Dominicana.
InvoiceFlow convierte la foto de una factura en datos listos para contabilidad y marca con reglas fiscales lo que hay que revisar. Las facturas pueden llegar por la web o por WhatsApp y salir hacia el 606 de la DGII o el sistema contable.
- Estrellas
- 95
- Forks
- 47
- Lenguaje
- Python / FastAPI
- Licencia
- MIT
- 95
- estrellas en GitHub
- 47
- forks: equipos que tomaron el código como base
- 9
- formatos de exportación, incluido el 606 de la DGII
- 44
- rutas de API y pantallas en un solo servicio FastAPI
El reto
En República Dominicana cada factura de proveedor se digita a mano: nombre, RNC, NCF, fecha, base, ITBIS y retenciones. Es trabajo lento, y un dígito mal puesto en el RNC o en el NCF aparece después como error en el formato 606 que se envía a la DGII.
Además, las facturas no llegan a una sola bandeja. Muchas las toma un empleado con el celular en la calle y las manda por WhatsApp, así que el contador recibe fotos sueltas que luego tiene que pasar al sistema contable.
Lo que construimos
Construimos InvoiceFlow con FastAPI y SQLAlchemy. Recibe imágenes o PDF por subida web o por un webhook de Evolution API para WhatsApp, limitado a números autorizados. OpenAI lee el documento y devuelve los campos estructurados: proveedor, RNC, NCF, fechas, base, ITBIS, retenciones y líneas de producto.
La IA no tiene la última palabra. Encima de la extracción corren reglas fiscales escritas en código que marcan lo que hay que revisar: ITBIS fuera de 16% o 18%, facturas de más de 90 días, falta de NCF o del tipo de bienes y servicios del 606. Cada factura queda con su nivel de confianza y sus alertas a la vista.
La salida va directo a contabilidad: el 606 se llena sobre la plantilla oficial de Excel de la DGII, y hay exportaciones a CSV, Excel, JSON, QuickBooks, Xero, Odoo y Contaplus, más webhooks salientes. Para que la factura de OpenAI no se dispare, el sistema tiene un tope diario en dólares y otro de peticiones por hora.
Cómo se ve
PARA QUIÉN SIRVE
- Empresas dominicanas que reciben muchas facturas de proveedores y hoy las digitan a mano para el 606.
- Firmas de contabilidad que llevan varias empresas y quieren recibir las facturas por WhatsApp en vez de fotos sueltas.
- Desarrolladores que necesitan una base con las reglas de RNC, NCF e ITBIS ya escritas para montar su propio producto.
QUÉ HACE
- Extracción con OpenAI de proveedor, RNC, NCF, ITBIS, retenciones, totales y líneas de producto desde imágenes o PDF.
- Auditoría automática: alertas por datos faltantes, ITBIS fuera de 16% o 18% y facturas de más de 90 días.
- Recepción por WhatsApp con Evolution API, limitada a números autorizados y con respuesta de estado.
- Exportación al formato 606 de la DGII y a CSV, Excel, JSON, QuickBooks, Xero, Odoo y Contaplus.
- Control de costos de OpenAI con límite diario en dólares y de peticiones por hora.
- Dashboard con avisos en tiempo real por WebSocket y webhooks salientes hacia otros sistemas.
Cómo está armado
- Entrada La factura llega por subida web o por el webhook de Evolution API en WhatsApp.
- Deduplicación Redis descarta mensajes repetidos, aplica límites por IP y guarda en caché estadísticas y ajustes.
- Extracción con IA openai_service.py lee la imagen, estructura los campos y aplica las validaciones fiscales de la DGII.
- Almacenamiento SQLAlchemy guarda facturas, usuarios y organizaciones en SQLite o PostgreSQL.
- Salida Dashboard con WebSocket, webhooks salientes y export_service.py para el 606 y los formatos contables.
Stack
FastAPIPythonOpenAIWhatsAppSQLAlchemyPostgreSQLRedisWebSocketsTailwindAlpine.js
Por qué lo hicimos
Nace de un dolor real de las empresas dominicanas: la digitación de facturas y el cumplimiento con la DGII. Muestra cómo Taveras Solutions combina IA, reglas fiscales locales y WhatsApp en un solo flujo.
Cómo empezar
pip install -r requirements.txt
cp .env.example .env # OPENAI_API_KEY, SECRET_KEY y usuario admin
python check_db.py
python main.py # abre http://localhost:8000
LO QUE APRENDIMOS
- La IA extrae, pero las reglas fiscales deciden. Dejar las validaciones del RNC, el NCF y el ITBIS en código, y no en el prompt, hace que las alertas sean predecibles y fáciles de auditar.
- Llenar la plantilla oficial de la DGII sale mejor que inventar un formato propio: el contador abre el archivo que ya conoce y lo valida con la herramienta de siempre.
- Un servicio que llama a una API de pago necesita topes desde el día uno. El límite diario en dólares y el de peticiones por hora son parte del producto, no un extra.
Necesitas algo así a la medida?
Usamos estas mismas herramientas en los proyectos de nuestros clientes.
Otros proyectos open source
- Starter de SaaS django-saas-boilerplate Starter de SaaS con Django 6: login por correo, suscripciones con Stripe, dashboard, CSP y 67 pruebas. Listo para desplegar.
- App para macOS ModelNap App de barra de menú que duerme los modelos locales de Ollama cuando no los usas y le devuelve la memoria a tu Mac. Firmada y notarizada.
- Python / Django SocialStarter Plantilla para crear redes sociales con Django: perfiles, feeds y notificaciones.