Manual de usuario · Facturación electrónica
Comprobantes Fiscales Electrónicos (e-CF) de República Dominicana en Odoo 19
Conexión con la API Carga Factura de GTI, los diez tipos de e-CF, notas de crédito y débito, compras con retenciones, contingencia, bitácora y facturación electrónica en el punto de venta.
1.Introducción
Qué resuelve este manual, para quién está escrito y qué módulos cubre.
Desde la entrada en vigor de la facturación electrónica en República Dominicana, cada comprobante fiscal se emite como un e-CF: un documento XML firmado digitalmente que la Dirección General de Impuestos Internos (DGII) recibe, valida y registra. Este manual explica cómo emitir esos comprobantes desde Odoo 19 a través de la API Carga Factura de GTI, el proveedor de servicios que recibe la información de la factura, genera y firma el XML y lo entrega a la DGII.
Cubre dos módulos que trabajan juntos:
multicert_feldo
El motor. Arma la información del comprobante con las reglas de cada tipo de e-CF, la envía a GTI, guarda el e-NCF, el código de seguridad y la fecha de firma, imprime la representación con el QR de la DGII y gestiona notas de crédito y débito, compras, contingencia y la bitácora.
pos_multicert_feldo
Lleva el e-CF al punto de venta: emite el comprobante al cobrar, deja elegir el tipo en caja, convierte las devoluciones en notas de crédito e imprime el ticket con el e-NCF y el QR.
Está pensado para tres perfiles:
- Contabilidad y facturación, que emite y corrige comprobantes todos los días (capítulos 8 a 15).
- Cajeros y encargados de tienda, que venden en el punto de venta (capítulos 16 y 17).
- El administrador de Odoo o el implementador, que configura la compañía, los impuestos, los diarios y la conexión con GTI (capítulos 3 a 7 y 18).
Todas las pantallas provienen de una base de demostración de la empresa ficticia Comercial Quisqueya, S.R.L. Los comprobantes se emitieron en el ambiente de simulación del módulo, que valida cada documento con las mismas reglas del instructivo de GTI y responde con su mismo formato, pero no lo envía a la DGII. El capítulo 18 explica cómo se pasa a los ambientes de pruebas y producción de GTI.
2.Cómo funciona la emisión
El recorrido de un comprobante desde que se confirma la factura hasta que queda registrado, y los datos que vuelven a Odoo.
2.1 El circuito de un e-CF
Todo ocurre al pulsar Confirmar y tarda pocos segundos. Antes de enviar, Odoo revisa el comprobante contra las reglas del instructivo de GTI para cada tipo de e-CF —campos obligatorios, campos que no deben enviarse, montos que deben cuadrar— y detiene el proceso con un mensaje claro si algo no cumple. Si la comunicación con GTI falla, el comprobante pasa a contingencia y se reenvía solo cuando el servicio vuelve.
2.2 Los datos que devuelve GTI
| Dato | Qué es |
|---|---|
| e-NCF | El número de comprobante fiscal electrónico: la letra E, el tipo de
e-CF y diez dígitos (por ejemplo E310000000001). Es el número que el cliente
reconoce y el que se informa a la DGII. |
| ID documento GTI | El identificador interno del comprobante en la plataforma de GTI. Sirve para cualquier consulta con su soporte. |
| Código de seguridad | Seis caracteres derivados de la firma digital. Se imprime en la representación impresa y forma parte del QR de la DGII. |
| Fecha de firma | Momento en que se firmó el XML. También va en el QR. |
| URL QR DGII | El enlace de consulta pública de la DGII, que se imprime como código QR para que cualquiera verifique el comprobante. |
2.3 Los tipos de e-CF
| Tipo | Comprobante | Cuándo se usa en Odoo |
|---|---|---|
| 31 | Factura de Crédito Fiscal Electrónica | Venta a un contribuyente que necesita el crédito fiscal (empresa con RNC). |
| 32 | Factura de Consumo Electrónica | Venta al consumidor final, identificado o no. |
| 33 | Nota de Débito Electrónica | Cargo adicional sobre un e-CF ya emitido. |
| 34 | Nota de Crédito Electrónica | Anulación o corrección de un comprobante emitido; también las devoluciones en caja. |
| 41 | Compras Electrónico | Lo emite la empresa al comprar a un proveedor informal, con las retenciones. |
| 43 | Gastos Menores Electrónico | Gastos menores sin comprobante del proveedor (taxis, parqueos). |
| 44 | Regímenes Especiales Electrónica | Ventas exentas a zonas francas y otros regímenes especiales. |
| 45 | Gubernamental Electrónico | Ventas a instituciones del Estado. |
| 46 | Comprobante para Exportaciones Electrónico | Ventas al exterior, con ITBIS tasa cero. |
| 47 | Comprobante para Pagos al Exterior Electrónico | Pagos a proveedores del exterior con retención de ISR. |
2.4 Los estados del comprobante
| Estado e-CF | Significado |
|---|---|
| Pendiente | La factura aún no se ha enviado (borrador) o no lleva e-CF. |
| Aceptado | GTI aceptó el comprobante y devolvió su e-NCF. Ya no se puede modificar ni volver a borrador. |
| Rechazado | El comprobante no cumplió una regla o GTI lo rechazó; el mensaje explica por qué (capítulo 13). |
| Contingencia | No hubo comunicación con GTI o hay una contingencia abierta; se enviará automáticamente (capítulo 14). |
Para seguir leyendo, crea tu cuenta
Quedan 17 capítulos más en este manual. Crea tu cuenta y solicita el acceso: lo aprobamos a mano, normalmente el mismo día.