Saltar al contenido principal

Glosario

Términos y definiciones importantes para trabajar con Facturo ECF y facturación electrónica en República Dominicana.

A​

API (Application Programming Interface)​

Interfaz que permite la comunicación entre diferentes sistemas de software. Facturo ECF proporciona una API REST para la integración.

ANECF (Anulación de e-NCF)​

Formato de la DGII (v1.0) para anular rangos de e-NCF que no fueron utilizados o no fueron aceptados. Ver Anulación de secuencias.

API Key​

Clave secreta que identifica y autentica tu aplicación. Se envía en el header X-API-Key en cada petición a la API de Facturo ECF.

C​

Certificado Digital​

Archivo digital (.p12 o .pfx) emitido por la DGII que se usa para firmar electrónicamente los comprobantes fiscales, garantizando su autenticidad.

Comprador​

Persona o empresa que recibe un bien o servicio y para quien se emite el comprobante fiscal.

Código de Seguridad​

Código derivado de la firma digital del comprobante, que se incluye en su representación impresa para verificar su autenticidad. En la API se devuelve como security_code.

Company ID​

UUID que identifica a tu empresa en Facturo. Forma parte de todas las rutas de la API: /api/v1/companies/{company_id}/....

D​

dgii_env​

Campo que indica el ambiente de la DGII de una operación: testecf (pruebas), certecf (certificación) o ecf (producción).

DGII (Dirección General de Impuestos Internos)​

Entidad gubernamental de República Dominicana responsable de la administración tributaria y la regulación de la facturación electrónica.

DOP (Peso Dominicano)​

Moneda oficial de República Dominicana. Código ISO: DOP.

E​

eCF (Comprobante Fiscal Electrónico)​

Documento fiscal en formato digital que reemplaza a los NCF físicos tradicionales. Son generados, transmitidos y almacenados electrónicamente.

e-NCF (Número de Comprobante Fiscal Electrónico)​

Número de 13 caracteres que identifica un e-CF: serie (1), tipo (2) y secuencia (10). Ejemplo: E310000000001.

Emisor​

Persona o empresa que emite un comprobante fiscal. El vendedor o prestador de servicio.

Encabezado​

Sección del documento electrónico que contiene información general como tipo de comprobante, fecha, montos totales, etc.

I​

ITBIS (Impuesto a la Transferencia de Bienes Industrializados y Servicios)​

Impuesto al valor agregado (IVA) de República Dominicana. Las tasas comunes son 0%, 16% y 18%.

N​

NCF (Número de Comprobante Fiscal)​

Sistema anterior de numeración de comprobantes fiscales en papel. Está siendo reemplazado por el sistema eCF electrónico.

Nota de Crédito (tipo 34)​

Documento que disminuye el valor de una factura previamente emitida. Se usa para devoluciones, descuentos posteriores o correcciones.

Nota de Débito (tipo 33)​

Documento que aumenta el valor de una factura previamente emitida. Se usa para cargos adicionales o correcciones.

P​

Payload​

Datos enviados en el cuerpo de una petición HTTP. En Facturo ECF, típicamente es un documento en formato JSON.

Plan de Contingencia​

Sistema alternativo para emitir comprobantes fiscales cuando no hay conexión con los sistemas de la DGII.

R​

REST (Representational State Transfer)​

Arquitectura de API que usa métodos HTTP estándar (GET, POST, PUT, DELETE). La API de Facturo ECF es RESTful.

RNC (Registro Nacional de Contribuyentes)​

Número de identificación fiscal de 9 dígitos asignado por la DGII a personas y empresas en República Dominicana.

S​

Secuencia eCF​

Ver e-NCF.

Signature (Firma)​

Firma digital XML aplicada al comprobante con el certificado del emisor, requerida por la DGII.

T​

Tipo de Comprobante (TipoeCF)​

Código de dos dígitos que identifica el tipo de documento fiscal:

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

Track ID​

Identificador que asigna la DGII al recibir un comprobante. Se usa para consultar su estado.

Totales​

Sección del documento que resume los montos: subtotal, impuestos, descuentos, total final, etc.

X​

XML (eXtensible Markup Language)​

Formato de archivo usado para almacenar los comprobantes fiscales electrónicos después de ser firmados. La DGII requiere este formato.

Tipos de Factura​

Factura de Crédito Fiscal (tipo 31)​

Comprobante emitido en transacciones entre contribuyentes registrados. Permite al comprador usar el ITBIS como crédito fiscal.

Características:

  • Requiere RNC del comprador
  • Incluye fecha de vencimiento
  • Detalla ITBIS separadamente
  • Permite crédito fiscal

Factura de Consumo (tipo 32)​

Comprobante emitido a consumidores finales que no requieren crédito fiscal.

Características:

  • No requiere RNC (opcional)
  • Sin fecha de vencimiento
  • ITBIS incluido en precio
  • No permite crédito fiscal

Tasas de ITBIS​

Tasa General (18%)​

Tasa aplicada a la mayoría de bienes y servicios.

Tasa Reducida (16%)​

Tasa aplicada a ciertos productos específicos definidos por ley.

Tasa Cero (0%)​

Aplicada a productos exentos de ITBIS según la legislación dominicana. Ejemplos:

  • Productos de la canasta básica
  • Medicamentos esenciales
  • Servicios educativos
  • Exportaciones

Formas de Pago​

CódigoForma de Pago
1Efectivo
2Cheque / Transferencia / Depósito
3Tarjeta de Débito / Crédito
4Venta a Crédito
5Bonos o Certificados de Regalo
6Permuta
7Nota de Crédito
8Otras Formas de Pago

Estados de Documento​

Las respuestas de la API reportan dos estados por documento:

internal_status​

Estado del documento dentro de Facturo (recepción, firma, envío, reintentos).

dgii_status​

Estado reportado por la DGII tras validar el comprobante (por ejemplo, aceptado, aceptado condicional, rechazado o en proceso).

Códigos de Error​

Los errores se devuelven con un código HTTP 4xx/5xx y el detalle en el campo error o message. Ver Manejo de errores.

Ambientes​

dgii_envAmbienteValidez fiscal
testecfPruebas (TesteCF)No
certecfCertificación (CerteCF)No
ecfProducción (eCF)Sí

Todos los ambientes usan la misma URL base: https://ecf.facturord.app.

Referencias​

¿Falta algún término?​

Si crees que falta un término importante en este glosario: