Glosario
Facturación electrónica
| Término | Definición |
|---|---|
| ACECF | Acuse Comercial de e-CF: el receptor acepta o rechaza comercialmente un e-CF recibido. |
| ANECF | Anulación de e-NCF: reporte a la DGII de secuencias que no se usarán. |
| ARECF | Acuse de Recibo de e-CF: constancia de recepción técnica de un e-CF. |
| Certificado digital | Archivo .p12 emitido por una entidad autorizada que identifica al contribuyente y le permite firmar. |
| Contingencia | Situación en la que la DGII no responde. ZarelaFact deja el documento en contingency y lo reintenta solo, sin plazo fijo, hasta que la DGII vuelve. Su representación impresa lleva la leyenda de contingencia. |
| DGII | Dirección General de Impuestos Internos de la República Dominicana. |
| e-CF | Comprobante Fiscal Electrónico; sustituye la factura en papel con el mismo valor legal. |
| eNCF | Número del comprobante electrónico, con formato EXXNNNNNNNNNN. Lo asigna tu ERP/POS. |
| Emisor electrónico | Contribuyente autorizado por la DGII para emitir e-CF. |
| FechaVencimientoSecuencia | Fecha de vencimiento del rango de eNCF autorizado por la DGII; obligatoria en la mayoría de los tipos. |
| IndicadorFacturacion | Tratamiento de ITBIS de un ítem: 1 = 18 %, 2 = 16 %, 3 = tasa 0, 4 = exento. |
| Firmante Autorizado | Rol que el contribuyente delega en la OFV al titular del certificado. Sin él, la DGII no recibe los e-CF firmados con ese certificado (DGII_CERTIFICATE_NOT_DELEGATED). |
| OFV | Oficina Virtual de la DGII, donde se asignan los roles del contribuyente. |
| PSFE | Proveedor de Servicios de Facturación Electrónica: la empresa cuyo software emite, recibe y conserva los e-CF por cuenta del contribuyente. |
| Padrón de contribuyentes | Registro de RNC y cédulas que publica la DGII cada día. ZarelaFact lo usa para verificar el RNC al crear una cuenta y para avisar si el RNC de un comprador no está activo. |
| Receptor electrónico | Contribuyente que recibe e-CF de sus proveedores y puede aceptarlos o rechazarlos comercialmente. Si tu comprador lo es, ZarelaFact le entrega tus e-CF. |
| RFCE | Resumen de Factura de Consumo Electrónica: lo que se envía a la DGII por facturas de consumo menores a RD$250,000. |
| RI | Representación impresa del e-CF (PDF con código QR). |
| RNC | Registro Nacional del Contribuyente. |
| Secuencia eNCF | Rango de números autorizado por la DGII. Tu ERP/POS asigna cada eNCF; ZarelaFact no reserva secuencias al emitir. |
| TrackID | Identificador que la DGII asigna para seguir el procesamiento de un documento. |
| XMLDSig | Firma digital del XML (RSA-SHA256) que exige la DGII. |
| XSD | Esquema que define la estructura de los XML de la DGII. |
Ambientes
| Ambiente | Uso |
|---|---|
| TesteCF | El ambiente de pruebas de la DGII, para pruebas técnicas y desarrollo. |
| CerteCF | Certificación del contribuyente ante la DGII. |
| eCF | Producción: emisión fiscal oficial. |
ZarelaFact
| Término | Definición |
|---|---|
| API key | Clave por ambiente (X-API-KEY) de una cuenta fiscal directa. |
| Contrato simplificado | JSON compacto opcional que ZarelaFact expande al JSON DGII/XSD completo. |
| Evidence pack | ZIP que genera el runner de certificación con JSON, XML firmado, RI/PDF, respuestas DGII y manifest. |
| Idempotencia | Reintentar una operación no crea duplicados. En la emisión, la identidad es el eNCF. |
| Marcador | Valor como {{RNC}} o {{FECHA_EMISION}} que ZarelaFact reemplaza con los datos de la cuenta al recibir un documento. Los de tu cliente, como {{RNC_COMPRADOR}}, los reemplazas tú antes de enviar. |
| Prevalidación | Envío con validate=true: valida sin firmar, sin enviar a la DGII y sin efectos fiscales. |
| Permiso (scope) | Lo que puede hacer una API key: ecf:validate, ecf:create, ecf:read, status:read o tenant:admin. |
| Sandbox | Prueba sin certificado: ZarelaFact simula el veredicto que daría la DGII para un JSON y guarda el resultado, con su XML y su PDF marcados SIN VALIDEZ FISCAL. No llega a la DGII y no cuenta en el plan. Ver Sandbox. |
| Webhook | Aviso que ZarelaFact envía a una URL de tu sistema cuando algo cambia, firmado para que puedas verificarlo. |
Partners
| Término | Definición |
|---|---|
| Partner | ERP, POS o SaaS autorizado para operar las cuentas fiscales de sus clientes mediante la API Partner. |
| Tenant ERP | Un cliente dentro de la plataforma del Partner, identificado por su externalTenantId. |
| Cuenta fiscal | El contribuyente (RNC) de un tenant, con certificado, certificación y emisión aislados. Se identifica con fiscalAccountId. |
| Titularidad del vínculo | Prueba de que el contribuyente autorizó al Partner: se obtiene al instalar un certificado válido de su RNC. |
| Caso de certificación | Proceso por el que una Cuenta fiscal completa los requisitos de la DGII. Solo hay uno activo por cuenta. |
| Atestación | Registro de que el usuario completó un paso en la DGII. No equivale a una aprobación. |
| Aprobación DGII verificada | Evidencia, validada por ZarelaFact, de que la DGII autorizó al contribuyente. |
| Activación productiva | Habilitación del ambiente eCF de una Cuenta fiscal, después de la aprobación verificada. |