Facturación Electrónica · Integración

Facturación Electrónica por API

Conecta tu ERP o tu sistema propio a la plataforma de Facturación Electrónica de Atrivia y emite tus e-CF ante la DGII sin cambiar de sistema. Tu sistema manda la factura; la plataforma genera el comprobante, lo firma con tu certificado digital, lo envía a la DGII y te devuelve el resultado.

Habla con nosotros sobre tu integración WhatsApp

Los 10 tipos de e-CF
Envías y recibes JSON
Plan gratis hasta 10 e-CF/mes

Cómo funciona

Cómo funciona, en 5 pasos

01Solicita tu cuenta
Te contactamos para activarla y arrancar el proceso de certificación con la DGII.
02Sube tu certificado digital
Cargas tu certificado (.p12) en el portal. Se guarda cifrado y el portal te avisa cuando le quedan 30 días o menos para vencer.
03Certifícate con la DGII desde el portal
Un asistente te lleva paso a paso: configuración, delegación, postulación, documentos, pruebas en TesteCF, certificación en CerteCF, declaración jurada y salida a producción.
04Conecta tu sistema
En el portal copias tus datos de integración: la dirección del API, el identificador de tu empresa y tu llave de API.
05Emite
Tu sistema manda cada factura en JSON. La plataforma genera el XML, lo valida contra el esquema de la DGII, lo firma, lo transmite y te devuelve el e-NCF, el código de seguridad, el TrackId y el enlace de verificación del QR.

Ejemplo

Crear, firmar y enviar

Paso 01 de 03

Crear el comprobante

Tu sistema manda la factura en JSON: tipo de e-CF, fecha, comprador, líneas y forma de pago. La plataforma asigna el e-NCF y deja el comprobante pendiente de firma.

e-NCF asignado

Paso 02 de 03

Firmar

La plataforma firma el XML con tu certificado digital y te devuelve el código de seguridad de 6 caracteres y la fecha de firma.

XML firmado

Paso 03 de 03

Enviar a la DGII

La plataforma transmite el comprobante y te devuelve el TrackId de la DGII y el enlace de consulta del timbre, que es lo que va en el QR.

TrackId y enlace del QR

JSON · valores ficticios

Envías

{"invoice_id": "FAC-2026-000123","ecf_type": "31","issue_date": "2026-11-01","payment_method": "01","buyer": {"rnc": "101000000","name": "CLIENTE DE EJEMPLO SRL","email": "compras@ejemplo.com"},"items": [{"description": "Servicio de ejemplo","quantity": 1,"unit_price": 10000,"item_type": "2","billing_indicator": "1","tax_type": "1","tax_amount": 1800}]}

Recibes

{"success": true,"data": {"invoice_id": "FAC-2026-000123","ecf_type": "31","assigned_ncf": "E310000000001","status": "pending_sign","total": "11800.00","dgii_environment": "TesteCF"}}

Recibes

{"success": true,"data": {"invoice_id": "FAC-2026-000123","encf": "E310000000001","security_code": "A1B2C3","status": "signed","signature_date": "01-11-2026 10:15:00","signed_xml": "<XML firmado en base64>"}}

Recibes

{"success": true,"data": {"invoice_id": "FAC-2026-000123","encf": "E310000000001","status": "sent","dgii_response": {"track_id": "00000000-0000-0000-0000-000000000000","timestamp": "2026-11-01T14:15:03"},"environment": "TesteCF","is_rfce": false,"consulta_timbre_url": "https://ecf.dgii.gov.do/testecf/ConsultaTimbre?…&ENCF=E310000000001&…&CodigoSeguridad=A1B2C3"}}

Los valores son ficticios; la forma y los nombres de campo son los reales.

Autenticación

Dos datos en cada solicitud

Las integraciones se autentican con dos datos que van en cada solicitud: una llave de API y el identificador de tu empresa. Antes de procesar nada, la plataforma comprueba que esa empresa exista y esté activa. Además exige que el RNC emisor de la factura sea el de tu empresa: con tu acceso no se puede facturar con el RNC de otra.

El portal web se usa con usuario y contraseña.

Content-Type: application/jsonx-api-key: <tu llave de API>X-Tenant-Id: <identificador de tu empresa>

Formato

JSON de ida y vuelta

Envías JSON: Tipo de e-CF, fecha, comprador (RNC o identificación extranjera, nombre, correo), líneas (descripción, cantidad, precio, tipo de bien o servicio, impuesto) y forma de pago. En notas de crédito y débito, también el e-NCF que modificas y el motivo.
Recibes JSON: Cada respuesta dice si la operación salió bien. Si sale bien, trae los datos del comprobante; si no, un código de error, un mensaje y la solución sugerida, con el detalle de cada validación que falló.
Lo que te devuelve la plataforma: El e-NCF asignado, el código de seguridad de 6 caracteres, la fecha de firma, el XML firmado, el TrackId de la DGII, el estado del comprobante y el enlace de consulta del timbre de la DGII, que es lo que va en el QR.
Comprador con RNC: La plataforma consulta en la DGII la razón social oficial del comprador.

Respuesta de error

{"success": false,"error": {"code": 2000,"error_name": "VALIDATION_ERROR","message": "Error de validacion","solution": "…","details": {"validation_errors": ["…"],"xsd_errors": ["…"]}}}

Operaciones

Lo que puedes hacer por API

Emitir
Los 10 tipos de e-CF, en tres pasos: crear, firmar y enviar a la DGII.
Consultar el estado
De un comprobante por TrackId o por e-NCF. La plataforma además revisa sola cada 5 minutos los comprobantes que siguen pendientes en la DGII.
Notas de crédito y débito
(e-34 y e-33), con referencia al e-NCF original y su código de modificación.
Resumen de Factura de Consumo (RFCE)
Las facturas de consumo de menos de RD$250,000 se envían por el canal de resumen que pide la DGII; la plataforma elige el canal sola. También acepta lotes de resumen.
Secuencias e-NCF
Las puede asignar la plataforma o tu propio sistema, según cómo configures tu empresa.
Sin duplicados
Si mandas el mismo documento con su identificador, la plataforma no lo emite de nuevo; te devuelve el que ya existe.
Consultar un RNC
En la DGII.

En el portal también tienes

Aprobación comercial (ACECF) y acuse de recibo (ARECF) de las facturas que te emiten tus suplidores.
Reportes 606, 607, 608 y 609.
Consulta de tasas de cambio.

Ambientes

Los tres ambientes de la DGII

Tu empresa pasa por los tres ambientes de la DGII. Cada comprobante queda marcado con el ambiente en que se emitió, y el portal muestra cada ambiente por separado.

PruebasTesteCF
CertificaciónCerteCF
ProduccióneCF

Tipos de e-CF

Los 10 tipos de e-CF

Código	Nombre
e-31	Factura de Crédito Fiscal Electrónica
e-32	Factura de Consumo Electrónica
e-33	Nota de Débito Electrónica
e-34	Nota de Crédito Electrónica
e-41	Compras Electrónico
e-43	Gastos Menores Electrónico
e-44	Regímenes Especiales Electrónico
e-45	Gubernamental Electrónico
e-46	Comprobante de Exportaciones Electrónico
e-47	Comprobante para Pagos al Exterior Electrónico

El portal

Todo a la vista en el portal

Resumen del mesFacturas emitidas, total facturado, pendientes en la DGII y secuencias disponibles.
Facturas por tipo y estado de las facturasBorrador, pendiente, firmada, enviada, aceptada, rechazada, anulada.
Últimas facturasCon filtro por mes y por ambiente (Pruebas, Certificación, Producción).
AvisoDe certificado digital por vencer.
ConfiguraciónCertificado, secuencias, usuarios y datos de integración.

Comprobantes por grupo

Consumoe-32

Fiscalese-31 · e-44 · e-45 · e-46

Proveedorese-41 · e-43 · e-47

Notase-33 · e-34

Si usas Odoo

No tienes que programar nada

El conector de Odoo se configura con cuatro datos. Emite los 10 tipos de e-CF desde la misma factura de Odoo.

Odoo Enterprise con Atrivia

01La dirección del API
02La llave de API
03El identificador de tu empresa
04El ambiente DGII (Pruebas, Certificación o Producción)

Habla con nosotros sobre tu integración

Facturación Electrónica: plan gratis hasta 10 e-CF/mes.

Habla con nosotros sobre tu integración WhatsApp