Nota de Crédito Electrónica en República Dominicana: e-CF Tipo 34 Explicado
Guía técnica del e-CF Tipo 34 en República Dominicana: cuándo emitirlo, campos de referencia al NCF original, flujo de validación asíncrona DGII y errores frecuentes para ISVs.
Cuando un sistema de facturación electrónica en República Dominicana necesita anular o ajustar un e-CF ya aceptado por la DGII, el flujo no es tan simple como marcar el documento como cancelado en la base de datos local. La nota de crédito electrónica — identificada como e-CF Tipo 34 en la normativa dominicana — tiene su propio proceso de habilitación, sus propios campos de referencia al comprobante original y un comportamiento de validación asíncrona que difiere del de las facturas ordinarias.
Esta guía explica el flujo técnico completo del e-CF Tipo 34 en República Dominicana: cuándo corresponde emitirlo, los campos de referencia al NCF del documento original, la estructura esperada por la DGII, los estados del ciclo de vida y los errores más comunes durante la implementación en plataformas ISV.
Qué es el e-CF Tipo 34 y cuándo corresponde emitirlo
Definición según la Norma General 06-2018 DGII
Según la Norma General 06-2018 de la DGII, el e-CF Tipo 34 es el comprobante fiscal electrónico utilizado para anular, total o parcialmente, una factura de venta con valor fiscal (e-CF Tipo 31) o un e-CF de consumo (Tipo 32) previamente aceptado. A diferencia de los documentos de venta, el Tipo 34 no genera ingresos en el sistema del emisor sino una reversión de los mismos; su propósito es ajustar la base imponible declarada ante la DGII en el período correspondiente. Toda nota de crédito emitida debe estar vinculada a un e-CF específico, y ese vínculo se declara mediante el campo NumeroComprobanteFiscalModificado en el XML del Tipo 34.
Diferencia entre Tipo 34 y anulación directa de NCF
En República Dominicana, un e-CF ya aceptado por la DGII no puede anularse directamente mediante una llamada de API. La única forma de revertir su efecto fiscal es emitir un e-CF Tipo 34. Si el ISV simplemente elimina el documento de su base de datos sin emitir la nota de crédito correspondiente, la DGII sigue considerando el e-CF original como válido en sus registros, lo que genera inconsistencias en la declaración de ITBIS del emisor. Esta discrepancia puede detectarse en los cruces de información que la DGII realiza entre los e-CF emitidos y las declaraciones mensuales del contribuyente.
Referencia al e-CF original: NCF y RNC del receptor
El campo NumeroComprobanteFiscalModificado
El campo NumeroComprobanteFiscalModificado es el vínculo obligatorio entre el Tipo 34 y el e-CF que se está ajustando. Debe contener el NCF completo del documento original (incluyendo el prefijo de tipo y el número secuencial) tal como fue asignado al emitir el e-CF de referencia. Si este campo está ausente o contiene un NCF que la DGII no reconoce en estado ACEPTADO, el Tipo 34 será rechazado en la validación. Almacenar el NCF de cada e-CF emitido como campo indexado en la base de datos del ISV, junto con su estado DGII, es el primer requisito de arquitectura para soportar el ciclo de vida completo del documento electrónico en República Dominicana.
Validación del e-CF original antes de emitir la nota
Antes de construir el XML del Tipo 34, el ISV debe verificar que el e-CF referenciado esté en estado ACEPTADO en la DGII, no en PENDIENTE ni en RECHAZADO. Un e-CF en PENDIENTE puede estar aún en proceso de validación asíncrona; emitir una nota de crédito sobre él antes de que la DGII lo confirme produce un error de referencia inválida. La verificación preventiva mediante consulta de estado al web service de la DGII antes de habilitar la opción de emisión del Tipo 34 en la interfaz del ISV es la práctica recomendada.
Estructura del e-CF Tipo 34: campos obligatorios
Encabezado: datos del emisor, receptor y referencia
El encabezado del e-CF Tipo 34 incluye los mismos campos de identificación del emisor que cualquier otro e-CF (RNC, nombre, dirección, información del software utilizado) más los campos específicos de la nota: TipoeCF (valor "34"), NCFModificado (el NCF del e-CF que se ajusta), RNCComprador y NombreComprador (datos del receptor del e-CF original, que deben coincidir exactamente con los del documento referenciado). Si el RNCComprador del Tipo 34 no coincide con el del e-CF original, la DGII rechazará la nota por inconsistencia de datos del receptor. Esta validación cruzada es uno de los errores más frecuentes en migraciones de datos donde el RNC del receptor se reformatea.
Líneas de detalle: cómo reflejar el ajuste de valor
Las líneas del Tipo 34 deben declarar los montos a ajustar, no los montos totales de la factura original. Para una anulación total, las líneas del Tipo 34 replican exactamente las líneas del e-CF original con los mismos valores e ITBIS. Para un ajuste parcial, solo se incluyen las líneas o montos que se revierten, con su ITBIS correspondiente calculado sobre la fracción que se anula. El monto total del Tipo 34 (campo MontoTotal) debe ser positivo (no negativo) y representar el valor del ajuste, no la diferencia con la factura. La DGII calcula internamente el efecto de la nota sobre la declaración del período; el ISV no debe enviar valores negativos en los campos de monto.
Flujo de transmisión y validación asíncrona DGII
Secuencia: envío, consulta de estado y acuse del receptor
A diferencia de Colombia, la DGII de República Dominicana valida los e-CF de forma asíncrona. El flujo completo para el Tipo 34 es: (1) el ISV transmite el XML firmado al web service de envío y recibe un acuse de recibo con el estado RECIBIDO; (2) la DGII procesa el documento y actualiza su estado a ACEPTADO o RECHAZADO en un tiempo variable, usualmente entre segundos y algunos minutos; (3) el ISV consulta el estado mediante el web service de consulta usando el NCF de la nota; (4) una vez ACEPTADO, el ISV puede generar el acuse de recibo para su receptor si aplica. No avanzar al paso 4 sin confirmar el estado ACEPTADO es crítico: entregar al cliente una nota en estado RECIBIDO como si fuera válida puede crear conflictos contables si la DGII la rechaza posteriormente.
Tiempos de respuesta y manejo de reintentos
Los tiempos de validación de la DGII para el Tipo 34 son similares a los de otros e-CF, pero en horas de alto tráfico (cierres de mes, vencimientos de declaraciones) pueden extenderse. Se recomienda implementar un mecanismo de sondeo con backoff exponencial: consultar cada 10 segundos los primeros 3 intentos, luego cada minuto durante 10 intentos, y finalmente poner el documento en cola de consulta periódica. Un Tipo 34 que permanece en estado RECIBIDO por más de 30 minutos sin transicionar debe generar una alerta en el sistema de monitoreo del ISV y revisarse manualmente.
Errores frecuentes y cómo resolverlos
Documento original no encontrado o en estado inválido
El error más frecuente es referenciar un NCF que la DGII no reconoce en estado ACEPTADO. Las causas más comunes: el e-CF original aún está en estado PENDIENTE o RECIBIDO (la validación asíncrona no ha concluido), el NCF fue rechazado y el ISV no actualizó el estado en su base local, o el NumeroComprobanteFiscalModificado tiene un formato incorrecto (por ejemplo, con espacios o con un tipo de e-CF equivocado en el prefijo). La solución correctiva es consultar el estado del e-CF original en la DGII antes de intentar la nota, y solo habilitar la emisión del Tipo 34 cuando el estado sea ACEPTADO de forma confirmada. Para ISVs que requieran una capa de gestión del ciclo de vida de documentos electrónicos en República Dominicana, la API de facturación electrónica de Alanube para República Dominicana gestiona los estados asíncronos y expone endpoints de consulta de estado consolidados.
NCF de la nota fuera del rango autorizado
El Tipo 34 requiere un NCF válido del rango de notas de crédito habilitado por la DGII para el emisor, distinto del rango de facturas ordinarias. Si el ISV intenta emitir un Tipo 34 usando un NCF del rango de facturas de consumo (Tipo 32) o facturas con valor fiscal (Tipo 31), el web service rechazará el documento por NCF inválido para el tipo de e-CF. Cada tipo de e-CF tiene su propio rango de secuencias. La lógica de asignación de NCF en el ISV debe consultar el rango habilitado por tipo, no reutilizar la misma secuencia para todos los documentos. Cuando el rango de Tipo 34 se agota, es necesario solicitar una nueva secuencia a la DGII antes de poder emitir más notas.
Preguntas frecuentes
¿Cuál es el plazo máximo para emitir una nota de crédito sobre un e-CF en República Dominicana? La Norma General 06-2018 no establece un plazo absoluto para emitir el e-CF Tipo 34, pero la práctica fiscal recomendada es emitirlo dentro del mismo período fiscal en que se emitió el e-CF original, para que el ajuste quede reflejado en la declaración de ITBIS del mismo mes. Emitir la nota en un período posterior obliga a realizar ajustes en declaraciones ya presentadas, lo que genera trámites adicionales ante la DGII. No existe restricción técnica en el web service para emitir el Tipo 34 sobre e-CF de períodos anteriores, pero el impacto contable y fiscal debe evaluarse.
¿Cómo puedo consultar el estado de un e-CF Tipo 34 enviado a la DGII? Debe usar el web service de consulta de la DGII con el NCF de la nota de crédito como parámetro de búsqueda. La respuesta incluye el estado actual del documento (RECIBIDO, ACEPTADO o RECHAZADO) y, en caso de rechazo, los códigos de error con la descripción del problema. La consulta puede realizarse tan pronto como el web service de envío confirme la recepción del documento. Se recomienda implementar un mecanismo automático de sondeo en el ISV en lugar de depender del operador para verificar manualmente el estado de cada nota emitida.
¿Qué diferencia hay entre un e-CF Tipo 34 y un e-CF Tipo 33 en República Dominicana? El Tipo 34 es una nota de crédito: reduce o anula el valor de un e-CF previo. El Tipo 33 es una nota de débito: incrementa el valor de un e-CF previo, por ejemplo para cobrar intereses de mora o ajustar un precio que fue inferior al pactado. Ambos tipos requieren el campo NumeroComprobanteFiscalModificado con el NCF del documento original. La diferencia operativa es que el Tipo 34 reduce la base imponible del emisor en la declaración de ITBIS, mientras el Tipo 33 la incrementa. Emitir un Tipo 33 cuando correspondía un Tipo 34 genera una inconsistencia fiscal que requiere una nota correctiva adicional.
¿Es posible emitir un e-CF Tipo 34 sobre un e-CF que está en estado PENDIENTE de validación? No. La DGII rechaza notas de crédito que referencian documentos en estado PENDIENTE o RECIBIDO porque el e-CF original aún no ha sido aceptado formalmente. El ISV debe esperar a que el e-CF de referencia alcance el estado ACEPTADO antes de iniciar el proceso de emisión del Tipo 34. En la práctica, esto significa que el flujo de solicitud de nota de crédito en la interfaz del ISV debe incluir una verificación de estado del e-CF original en tiempo real antes de permitir que el operador complete y envíe la nota.
Artículos Relacionados
Nota de Débito Electrónica en República Dominicana: e-CF Tipo 35 Paso a Paso
Guía técnica para implementar la nota de débito electrónica (e-CF Tipo 35) en República Dominicana: estructura XML, campos obligatorios, flujo DGII y errores frecuentes.
Idempotencia y Reintentos en la API del DGI Panamá: Guía para ISVs
Cómo implementar idempotencia y reintentos seguros en la integración con la API del DGI en Panamá. Guía técnica para evitar documentos duplicados en el SFEP.
Observabilidad y Logging en la Integración con la API de Hacienda Costa Rica
Cómo implementar logging estructurado, métricas y alertas en su integración con la API de Hacienda Costa Rica. Guía técnica para ISVs con volumen en producción.