Odoo es uno de los ERPs más usados en República Dominicana, pero por sí solo no emite e-CF: la firma XAdES, las semillas de autenticación, las secuencias NCF y el polling de estados a la DGII quedan por tu cuenta. El conector aura_ecf resuelve esa pieza delegando todo el ciclo fiscal a Aura. Odoo envía la factura en JSON; Aura devuelve el e-NCF, el QR y el código de seguridad.

Qué hace el conector

El conector cubre el ciclo fiscal completo de la DGII, no solo la factura básica: emite los diez tipos de e-CF, recibe los de tus proveedores, genera los reportes informativos y produce la representación impresa con QR. El tipo de comprobante se decide solo a partir de los datos que ya tienes en Odoo —el RNC del cliente, la posición fiscal, el país— sin que tengas que elegir nada.

Ventas: del E31 al E46

  • E31 Crédito Fiscal cuando el cliente tiene RNC de contribuyente (9 dígitos); E32 Consumo para consumidor final (cédula de 11 dígitos o sin identificación). El conector distingue RNC de cédula automáticamente.
  • E34 Nota de Crédito al reembolsar, referenciando el e-CF original y calculando el indicador de "más de 30 días". E33 Nota de Débito con el módulo de notas de débito de Odoo.
  • E44 Regímenes Especiales, E45 Gubernamental y E46 Exportación se autodetectan por la posición fiscal de l10n_do (Zona Franca, ventas al Estado) o por el país del cliente.

Compras: E41/E43/E47, recepción y el 606

  • E41 Compras (a proveedores informales) y E43 Gastos Menores que tu empresa se autoemite, disparados por la posición fiscal del proveedor. E47 Pagos al Exterior para servicios del exterior.
  • Captura el NCF del proveedor en las facturas de compra, que alimenta directamente el reporte 606.
  • Recepción de e-CF de proveedores: registra el comprobante que te envía un proveedor, devuelve el acuse (ARECF) y permite la aprobación comercial (aceptar/rechazar) que exige la DGII.

Punto de Venta

Con el módulo complementario Aura e-CF — Punto de Venta, cada ticket del POS de Odoo emite una Factura de Consumo (E32) —o E31 si el cliente da su RNC en caja— al sincronizar la venta. Si se cae la conexión, un proceso de reintento reemite los tickets pendientes (contingencia), para que la caja nunca se bloquee por la DGII.

Reportes 606 / 607 / 608

Desde Contabilidad → Reportes → Reportes DGII generas los archivos TXT en formato DGII listos para subir a la Oficina Virtual: 607 (ventas) y 608 (anulados) salen de los e-CF emitidos; 606 (compras) usa el NCF de proveedor capturado en las facturas de compra.

Impuestos y retenciones, sin reinventarlos

El conector lee la capa de impuestos de l10n_do en lugar de reimplementarla: ITBIS 0/16/18 por línea, y las retenciones de ITBIS (30/75/100%) e ISR (2/5/10/27%) que las posiciones fiscales dominicanas ya configuran. Llegan correctas al XML sin trabajo extra.

Estado en tiempo real, anulación y contingencia

  • Estado en tiempo real: webhooks firmados de Aura (HMAC-SHA256) reflejan cada cambio (aceptado, condicional, rechazado, anulado) en la factura; un cron cada 15 minutos actúa de respaldo si un webhook se pierde.
  • Anulación con causal de la DGII (Tabla VI), con motivo y código de modificación.
  • Contingencia: activa el modo contingencia cuando los servicios de la DGII estén caídos y emite firmando localmente, con envío diferido.
  • Representación impresa: QR, código de seguridad y fecha de firma en el PDF de la factura; o descarga la RI oficial generada por Aura.
  • Multi-compañía y autónomo: la configuración puede ser por compañía, y el módulo no depende de l10n_do aunque interopera con él.

Requisitos

  • Odoo 17 (Community o Enterprise).
  • Python requests y qrcode en el servidor de Odoo.
  • Una cuenta de Aura con un cliente emisor y una API Key con los scopes vouchers:issue/read/void y clients:read.

Instalación

  1. Instala «Aura e-CF» desde Odoo Apps (y Aura e-CF — Punto de Venta si usas el POS).
  2. Ve a Contabilidad → Configuración → Ajustes → Aura e-CF y completa la URL de la API y la API Key.
  3. Listo. El emisor se identifica automáticamente por el RNC de tu compañía — no hay que copiar ningún identificador.
Prueba sin riesgo. El ambiente (test o producción) se deriva del prefijo de tu API Key, al estilo Stripe: una key ecf_test_… emite contra el ambiente de pruebas y una ecf_live_… contra producción. Certifícate y prueba el flujo completo antes de emitir un solo e-CF real.

Cómo empezar

Crear una cuenta de Aura es gratis e incluye 100 e-CF por mes; las emisiones en CerteCF no se cobran, así que puedes certificarte sin presión. Regístrate en aura.nexo.com.do, obtén tu API Key y pégala en los ajustes del módulo. El emisor se identifica automáticamente por el RNC de tu compañía — no necesitas copiar ningún identificador.

¿Quieres ver la API antes? La documentación viva (OpenAPI 3.1) está en aura.nexo.com.do/docs. Para conocer todo lo que hace la plataforma, visita la página de Aura.