Saltar al contenido
Taveras Solutions · Ir al inicio
Agendar diagnóstico

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
Detalle de una factura de demostración en InvoiceFlow: observaciones de auditoría (ITBIS de 16%, factura de más de 90 días, falta el tipo de bienes y servicios del 606), totales con ITBIS, la imagen original y la vista previa del asiento contable
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

Centro de control de InvoiceFlow con la cola de procesamiento, facturas procesadas hoy, calidad de extracción, costo promedio por documento y la actividad reciente
El panel muestra la cola, la calidad de extracción y lo que cuesta cada documento.
Registro de facturas con tres facturas seleccionadas y el menú de exportación abierto en la opción DGII 606
Se seleccionan las facturas y se exportan en lote al formato que use la contabilidad.
Contenido del archivo 606 exportado: RNC, tipo de identificación, tipo de bienes y servicios, NCF, fecha, montos e ITBIS de tres facturas de demostración
El 606 sale sobre la plantilla oficial de la DGII. Vista parcial de las columnas, con los valores del archivo real.
Ajustes del motor de IA: clave de OpenAI oculta, modelo seleccionado y límite diario en dólares
Un tope diario en dólares evita sorpresas en la cuenta de OpenAI.

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

  1. Entrada La factura llega por subida web o por el webhook de Evolution API en WhatsApp.
  2. Deduplicación Redis descarta mensajes repetidos, aplica límites por IP y guarda en caché estadísticas y ajustes.
  3. Extracción con IA openai_service.py lee la imagen, estructura los campos y aplica las validaciones fiscales de la DGII.
  4. Almacenamiento SQLAlchemy guarda facturas, usuarios y organizaciones en SQLite o PostgreSQL.
  5. 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.