Cómo leer los Logs DGII

En el portal, Desarrolladores › Logs DGII muestra cada paso de tus e-CF: la firma, el envío a la DGII y lo que la DGII respondió, con el JSON exacto de cada evento. Es la misma información que usamos en soporte para revisar un envío.

Si eres Partner, elige el cliente en la tarjeta de arriba. Los filtros y el ambiente se mantienen al cambiar de cliente.

Ambiente y filtros

• Ambiente: arriba a la derecha, pruebas (TesteCF), certificación (CerteCF) o producción (eCF). Un Partner ve certificación y producción.
• Pestañas: los mismos estados de Enviados. Aceptados, Condicionales, Rechazados, Pendientes (en cola, enviado a la DGII o en proceso) y Errores (error o no encontrado). Cada pestaña muestra cuántos e-CF tiene con los filtros actuales.
• Búsqueda: por e-NCF o Track ID.
• Tipo y Estado: como en Enviados.
• Periodo: por fecha de creación del e-CF. Empieza en los últimos 7 días.
• Severidad: e-CF con al menos un evento de esa severidad. Con Alerta encuentras los que necesitaron reintentos aunque al final se aceptaran.

El pipeline de un e-CF

Cada fila es un e-CF. La columna Pipeline resume sus tres pasos: firma · envío · DGII.

Color	Qué significa
Verde	El paso terminó bien.
Azul	En curso: por firmar, por enviar o esperando la respuesta de la DGII.
Ámbar	Se está reintentando, el envío está en pausa o en contingencia, o la DGII lo aceptó de forma condicional.
Rojo	La firma o el envío fallaron sin más reintentos, o la DGII lo rechazó o no lo encontró.
Gris	El e-CF todavía no llega a ese paso.

Debajo de la fecha de Actualizado puede aparecer:

• sin actividad hace… (ámbar): el e-CF está pendiente y no tiene eventos nuevos desde hace más de una hora.
• envío nocturno programado: un resumen RFCE de factura de consumo menor a RD$250,000 que quedó pendiente. Sale en el envío nocturno.

Los eventos

Al abrir un e-CF ves su línea de tiempo, del evento más antiguo al más reciente. Cada evento lleva su etapa:

• Worker: ZarelaFact firma, envía, consulta el estado y reintenta.
• DGII: lo que respondió la DGII al envío y a cada consulta.
• Certificación: los documentos de las pruebas de la certificación DGII.
• Cuenta: secuencias, certificado y webhooks de prueba.

Al abrir un e-CF queda elegido el último error. Si no hay errores, la última alerta; si tampoco, la última respuesta de la DGII.

Los eventos que más vas a ver:

eventType	En el portal	Qué trae
ecf.queued	Encolado para firma y envío	La política de reintentos.
ecf.ecf_sign_succeeded	Firma completada	payload.result.securityCode: el código de seguridad del QR.
dgii.send_response	Respuesta al envío	payload.dgii: la respuesta de la DGII tal cual. payload.summary: su estado y mensajes.
ecf.ecf_send_succeeded	Envío a DGII completado	payload.result.trackId: el Track ID de la DGII.
ecf.ecf_status.poll_succeeded	Consulta de estado	El estado que devolvió la consulta.
dgii.status_response	Respuesta a la consulta	El estado final (Aceptado, Aceptado Condicional o Rechazado) con sus mensajes.
ecf.ecf_send_retrying y otros *_retrying	Reintento	Severidad warning. payload.attempt y payload.error.
ecf.ecf_send_failed y otros *_failed	… fallido	Severidad error. payload.error, payload.errorCode y, si la hubo, la respuesta de la DGII en payload.dgii.
ecf.rfce_nightly_queued	RFCE programado para el envío nocturno	El monto y el modo de envío del resumen.

La fila Sin e-NCF reúne los eventos de tu cuenta que no son de un e-CF: pruebas de certificación, secuencias por agotarse y webhooks de prueba. Su estado es la severidad más alta de esos eventos: Con errores, Con alertas o Informativo.

El JSON de un evento

Elige un evento en la línea de tiempo para ver su JSON a la derecha:

{
  "id": "4a06c57e-f90c-4fa4-8f17-b463839527c7",
  "eventType": "ecf.ecf_sign_succeeded",
  "severity": "info",
  "encf": "E320009002015",
  "trackId": null,
  "documentId": "ca9dcfb3-f270-4dd2-8821-605d5a55b8ee",
  "correlationId": "worker-7",
  "message": "Job ecf.sign completado (E320009002015)",
  "payload": {
    "jobId": "cd242e9e-e076-46bc-9314-ec3299ca7e22",
    "result": { "securityCode": "HUyIBW" }
  },
  "createdAt": "2026-10-03T13:12:04.000Z"
}

• severity: info, warning (reintentos y avisos) o error.
• trackId: el Track ID de la DGII. Es null hasta que el envío lo recibe.
• createdAt: fecha y hora en UTC (ISO 8601). El portal la muestra en tu hora local.

Copiar JSON copia el evento completo. Inclúyelo cuando escribas a soporte sobre un e-CF.

Qué no aparece

• Los eventos internos de la plataforma: la renovación del token de la DGII, los candados de envío y la apertura del certificado.
• De cada e-CF, solo los 30 eventos más recientes.
• La fila Sin e-NCF solo aparece en la primera página y sin filtros de documento: pestaña Todos, sin búsqueda, tipo ni estado. Trae hasta 50 eventos del periodo.

Del log a la acción

• Rechazado: abre la respuesta de la DGII (Respuesta al envío o Respuesta a la consulta) y lee sus mensajes en payload.dgii.mensajes. Corrige los datos y emite el e-CF con un e-NCF nuevo: el rechazado ya quedó usado.
• Reintentos: no hagas nada. ZarelaFact reintenta solo, con una espera cada vez más larga.
• Error: el reintento se agotó. El motivo está en payload.error del evento fallido.
• Sin actividad: escribe a soporte con el JSON del último evento.
• Ver documento en Enviados abre el e-CF en Enviados, en el mismo ambiente, con su detalle y sus archivos.