DGII República Dominicana — Facturación electrónica (e-CF)

Descripción

Los nodos DGII conectan tus workflows con la facturación electrónica de República Dominicana (DGII, e-CF). El e-CF es un XML firmado con XMLDSig (certificado digital). El envío requiere un token que se obtiene con un flujo de 3 pasos: pedir una semilla, firmarla y validarla. Con el token se envía el e-CF a recepción, que devuelve un TrackId; el estado (Aceptado / Rechazado) se consulta aparte.

Nodo	Qué hace
DGII: Emitir factura (dgiiEmitirFactura)	Factura de Crédito Fiscal (31) o de Consumo (32)
DGII: Nota crédito/débito (dgiiEmitirNota)	Nota de Débito (33) o de Crédito (34)
DGII: Consultar estado (dgiiConsultarEstado)	Consulta el estado de un e-CF por su TrackId
DGII: Representación / QR (dgiiRepresentacion)	Genera la representación impresa (RFCE) con QR

El e-CF es XML firmado con XMLDSig y usa TrackId

El documento es un XML firmado con una firma XMLDSig (certificado digital). La autenticación es en 3 pasos (semilla → firma → token). El envío no da el resultado final: devuelve un TrackId y el estado se consulta después (Aceptado, Rechazado, AceptadoCondicional, EnProceso). El código de seguridad son los primeros 6 caracteres de la firma. El e-NCF tiene 13 caracteres: E + tipo(2) + secuencia(10). El ITBIS general es 18%.

Credencial

Los nodos usan una credencial de tipo DGII. Creala en Credenciales → Agregar → República Dominicana / DGII con:

Campo	Descripción
RNC del emisor	El registro nacional del contribuyente.
Certificado digital (.p12)	Con su contraseña; se usa para firmar y autenticar.
Razón social / Nombre comercial	Datos del emisor.
Dirección, municipio, provincia	Ubicación del emisor.
Ambiente	Pruebas (TesteCF), Certificación (CerteCF) o Producción (eCF).

Emitir una factura (31 / 32)

Nodo: DGII: Emitir factura. Los precioUnitario van sin ITBIS; Floogos calcula el ITBIS (18%) y los totales. La Factura de Crédito Fiscal (31) requiere el RNC del comprador; la de Consumo (32) no.

{
  "tipo": "31",
  "comprador": { "rnc": "101023122", "razonSocial": "Cliente B2B SRL" },
  "items": [
    { "descripcion": "Servicio de consultoría", "cantidad": 1, "precioUnitario": 100 }
  ]
}

El nodo devuelve el e-NCF, el TrackId, el código de seguridad y (por defecto) consulta el estado una vez.

Notas de crédito y débito (33 / 34)

Nodo: DGII: Nota crédito/débito. La nota referencia el e-NCF de origen con informacionReferencia:

{
  "tipo": "34",
  "comprador": { "rnc": "101023122", "razonSocial": "Cliente B2B SRL" },
  "informacionReferencia": { "ncfModificado": "E310000000001", "fecha": "2026-07-29", "codigoModificacion": 1 },
  "items": [ { "descripcion": "Devolución", "cantidad": 1, "precioUnitario": 30 } ]
}

codigoModificacion: 1 anula el comprobante referenciado, 2 corrige texto, 3 corrige montos.

Consultar el estado

Nodo: DGII: Consultar estado. Consulta un e-CF por su TrackId y devuelve el estado (Aceptado, Rechazado, AceptadoCondicional, EnProceso). Útil cuando la recepción quedó EnProceso.

Representación impresa (QR)

Nodo: DGII: Representación / QR. Genera la representación imprimible en HTML (exportable a PDF), con el e-NCF, el código de seguridad y el QR que apunta a la consulta de timbre de la DGII.

Manejo de errores

Situación	Reintentable	Qué hacer
DGII rechaza (Rechazado)	No	El nodo devuelve los mensajes. Corregí el e-CF.
Certificado vencido	No	Renová el .p12 y actualizá la credencial.
Auth (semilla/token)	No	Revisá el certificado y el ambiente.
Red / Timeout	Sí	Problema pasajero; se reintenta automáticamente.

Sandbox de la DGII

Probá siempre en TesteCF / CerteCF antes de producción, y validá la estructura del XML contra el XSD oficial de la DGII. La firma XAdES completa (QualifyingProperties) debe validarse contra el ambiente de pruebas.

Ver también

• Cola de reintentos (DLQ) — cómo se reintentan las ejecuciones que fallan.
• Nodo HTTP — para servicios no cubiertos por estos nodos.