Monitor e-CF y Solución de Rechazos DGII
La Consola de Comprobantes Electrónicos (Comprobantes e-CF) (/accounting/ecf, con redirección desde /billing/ecf) centraliza la auditoría en tiempo real de todas tus facturas y notas de crédito electrónicas emitidas hacia los servidores de la DGII bajo la Ley 32-23.
Visibilidad condicional en el menú
Sección titulada «Visibilidad condicional en el menú»Para mantener la interfaz limpia, la opción Comprobantes e-CF en el menú lateral se muestra únicamente cuando tu empresa cumple ambas condiciones en Configuración:
- El interruptor Facturación Electrónica está activo (
electronicBilling === true). - Existe un Certificado Digital
.p12válido cargado (isUploaded === true).
Si ingresas a /accounting/ecf sin cumplir ambos requisitos, el sistema te redirige automáticamente a /accounting/ncf o muestra un aviso con acceso directo a Configuración.
Estados DGII en la Consola e-CF
Sección titulada «Estados DGII en la Consola e-CF»La consola muestra cinco tarjetas de métricas interactivas (haz clic en cualquiera para filtrar la tabla) y una barra de búsqueda por e-NCF, Cliente, RNC o TrackId:
| Estado en Zoule | Significado ante la DGII | Acción recomendada |
|---|---|---|
| Aceptado (o Aceptado Condicional) | La DGII validó el XML firmado y aprobó el comprobante (en Aceptado Condicional, la DGII lo admite pero notifica observaciones no bloqueantes). | Ninguna acción pendiente; válido tributariamente. |
| En Proceso / Recibido DGII | La DGII recibió el XML y asignó un TrackId, pero aún está procesando el dictamen final. |
Pulsa Consultar Estado Live en la fila o Sincronizar Pendientes arriba. |
| Rechazado | La DGII rechazó el comprobante por una regla de esquema XSD, firma o validación fiscal. | Haz clic en el badge Rechazado o en el ícono de escudo para abrir Auditoría Fiscal DGII. |
| Sin Enviar / Error | El comprobante no obtuvo TrackId debido a un corte temporal de red, timeout o error previo al envío. |
Usa Enviar a DGII en la fila o desde el modal de diagnóstico. |
Sincronización, Auditoría, XML y Representación Impresa
Sección titulada «Sincronización, Auditoría, XML y Representación Impresa»- Sincronización masiva (
Sincronizar Pendientes): Pulsa el botón azul superior para consultar en lote todos los e-CF que tienenTrackIdasignado pero siguen en estadoEn ProcesooRecibido. - Consulta individual en vivo (
Consultar Estado Live): El botón de sincronización en cada fila consulta directamente/ConsultaResultado/api/Consultas/Estadocon elTrackIddel comprobante. - Modal de Auditoría Fiscal DGII (
DgiiAuditModal): Muestra elTrackId, el Código de Seguridad de 6 caracteres, las fechas exactas de emisión y firma digital, los códigos y mensajes de error devueltos por la DGII, un acordeón técnico con la Respuesta Cruda JSON del WebService y botones directos para Reenviar a DGII o Consultar Estado Live. - Inspección de XML y Representación Impresa (RI):
- Haz clic en el
e-NCFo en el ícono de detalle para abrir la factura (/billing/invoices/:id), donde puedes Previsualizar PDF o abrir Imprimir / Acciones para descargar la Representación Impresa (RI) en formato Carta o Ticket 80mm con código QR oficial. - El XML firmado (
xmlContent) queda almacenado en cada factura para auditoría técnica y previsualización (/api/billing/:id/xml-preview).
- Haz clic en el
Guía práctica: Solución a rechazos frecuentes de la DGII
Sección titulada «Guía práctica: Solución a rechazos frecuentes de la DGII»Usa esta tabla para diagnosticar y resolver rápidamente los rechazos reportados en el modal Auditoría Fiscal DGII:
| Causa o mensaje de rechazo | Qué lo provoca | Cómo resolverlo en Zoule |
|---|---|---|
| RNC / Cédula del comprador inválido o inactivo | El <RNCComprador> no existe en la DGII, tiene menos de 9 u 11 dígitos o el contribuyente está dado de baja/suspendido. |
Abre la ficha del cliente en Facturación → Clientes, consulta el RNC/Cédula en el Padrón DGII local, corrige el documento y reenvía (o emite Nota de Crédito si corresponde). |
Factura E32 >= RD$250,000 sin RNC o Cédula |
Por ley, los comprobantes de Consumo (E32) iguales o mayores a RD$ 250,000.00 no pueden emitirse anónimos ni como CONSUMIDOR FINAL genérico. |
Asigna un cliente con RNC (9 dígitos) o Cédula (11 dígitos) válido (o cambia a E31 si el cliente requiere Crédito Fiscal). |
| Vencimiento o agotamiento de secuencia e-NCF | La secuencia superó su fecha_vencimiento, el e-NCF está fuera del rango aprobado en la OFV o ya fue usado previamente. |
Verifica el estado en Contabilidad → Comprobantes Fiscales (/accounting/ncf), solicita nuevos rangos en la OFV y registra la nueva secuencia. Recuerda que por esquema XSD de la DGII, E32 y E34 no llevan <FechaVencimientoSecuencia>, mientras que E31, E33 y E41–E47 sí la exigen vigente. |
Certificado .p12 vencido o firma XMLDSig rechazada |
El certificado digital expiró, fue revocado o la contraseña cargada no coincide al firmar con OpenSSL. | Verifica la Fecha de Vencimiento en Configuración → Facturación Electrónica. Si expiró, sube el nuevo archivo .p12 con su contraseña vigente y reenvía el comprobante desde la consola. |
| Diferencia de centavos o error en impuesto compuesto | Descuadre entre MontoGravado × 18% y TotalITBIS, o redondeos inconsistentes en el XML. |
Verifica las tasas de ITBIS en cada línea. Si usas Impuesto sobre Impuesto (Compuesto), asegúrate de activar el switch oficial en la línea para que Zoule aplique la partición proporcional (Base Gravada = ITBIS / 0.18 y Base Exenta complementaria) exigida por el validador matemático DGII. |
Desfase de ambiente (CerteCF vs. eCF Producción) |
La empresa está en Producción en la DGII pero Zoule apunta a CerteCF (o viceversa), o el QR muestra “No fue encontrada la factura”. |
Confirma en Configuración → Facturación Electrónica que el Ambiente de Operación DGII coincida exactamente con tu estatus en la OFV y guarda cambios. |
Nota de Crédito E34 rechazada por referencia |
El <NCFModificado> no corresponde a un e-CF aceptado, pertenece a otro cliente o intenta modificar una Serie B. |
Verifica que la factura original sea Serie E, esté aceptada por la DGII y pertenezca al mismo cliente (comprobantes Serie B deben modificarse con B04). |