DgiiConsultarEstado

Descripción

Consulta el estado de un e-CF ante la DGII de República Dominicana a partir del TrackId que la DGII asignó en la recepción. El estado devuelto puede ser Aceptado, Rechazado, AceptadoCondicional o EnProceso. Si el nodo encuentra el comprobante en la base de datos por su TrackId, actualiza el registro con el resultado final.

Este nodo es el que hay que usar cuando la emisión (DgiiEmitirFactura o DgiiEmitirNota) se hizo con consultar_estado en falso, o cuando la DGII devolvió inicialmente EnProceso y hace falta reintentar la consulta más tarde.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credentials	Sí	Credencial dgii
track_id	text	Sí	TrackId devuelto al emitir el e-CF

Credenciales

Este módulo requiere una credencial de tipo dgii con los siguientes campos:

• Certificado digital (.p12): certificado de firma en base64 (alternativamente, clave privada + certificado en PEM)
• Contraseña del certificado: contraseña del .p12
• RNC del emisor: RNC de la empresa emisora (9 a 11 dígitos)
• Ambiente: test, cert (certificación) o prod (producción)

Salida

{
  "trackId": "TR-2026-000123456",
  "estado": "accepted",
  "estadoDgii": "Aceptado",
  "aceptado": true,
  "rechazado": false,
  "mensajes": [],
  "encf": "E310000000123"
}

Ejemplo de Uso

{
  "credentials_id": "cred-dgii-prod",
  "track_id": "TR-2026-000123456"
}

Notas

• El campo estado normalizado que devuelve el nodo puede ser accepted, rejected, conditional o received (equivalente a EnProceso, todavía sin resolver).
• El campo estadoDgii conserva el texto literal que devuelve la DGII, útil para mostrarlo tal cual en pantalla.
• Si el TrackId no corresponde a ningún e-CF emitido por este tenant, el nodo igual consulta a la DGII pero no puede completar encf en la respuesta.
• La consulta es de solo lectura: no reintenta la recepción ni modifica el comprobante, solo actualiza el estado guardado.

Nodos Relacionados

• DgiiEmitirFactura - Emitir la factura cuyo TrackId se va a consultar
• DgiiEmitirNota - Emitir la nota cuyo TrackId se va a consultar
• DgiiRepresentación - Generar la representación impresa una vez aceptado el e-CF