Medasoft Logo
Medasoft SRLe-CF Docs DGII
Integración API

Especificación y Estructura de Documentos e-CF (E31 - E47)

Guía exhaustiva sobre los 10 tipos de Comprobantes Fiscales Electrónicos de la Ley 32-23, estructura de nodos JSON/XML, diccionarios de datos y reglas tributarias.

La normativa de la Dirección General de Impuestos Internos (Ley 32-23 y Decreto 587-24) define 10 tipos principales de Comprobantes Fiscales Electrónicos (e-CF) para el régimen tributario dominicano.

📑 Tabla de Comprobantes e-CF Oficiales

TipoCódigoDenominación OficialReglas Específicas DGII
Factura de Crédito Fiscal31Tipo_31Sustenta costos y gastos para Impuesto sobre la Renta (ISR) y crédito fiscal de ITBIS (18%). Exige RNC de comprador válido y activo.
Factura de Consumo32Tipo_32Dirigida a consumidores finales. Si el monto total es mayor o igual a RD$250,000 (DOP), exige RNC/Cédula y envío individual.
Nota de Débito33Tipo_33Aumenta el valor de un e-CF emitido previamente por costos, intereses o fletes. Requiere <InformacionReferencia>.
Nota de Crédito34Tipo_34Anula o disminuye el valor de un e-CF previo. Requiere <InformacionReferencia> y código de modificación (1 a 5). Plazo de 30 días para rebaja de ITBIS.
Compras a Informales41Tipo_41Emitido por el comprador para sustentar compras a personas físicas no inscritas como contribuyentes. Aplica retención.
Gastos Menores43Tipo_43Sustenta pagos de gastos menudos del personal o caja chica (dietas, peajes). Ítems 100% exentos de ITBIS.
Regímenes Especiales44Tipo_44Facturación exenta a empresas en Zonas Francas (Ley 8-90) y turismo (Ley 158-01). Ítems exentos (IndicadorFacturacion = 4).
Gubernamental45Tipo_45Facturación de bienes y servicios prestados a instituciones del Estado Dominicano y entes públicos.
Exportaciones46Tipo_46Exportación de bienes fuera del territorio aduanero. Aplica Tasa Cero (IndicadorFacturacion = 3) y datos aduanales.
Pagos al Exterior47Tipo_47Sustenta rentas de fuente dominicana pagadas a personas o entidades no residentes. Aplica retención de ISR.

🧱 Estructura Jerárquica del JSON de Emisión

Medasoft e-CF traduce y mapea de forma limpia los esquemas XML de la DGII en una estructura JSON organizada en las siguientes secciones:

{
  "Encabezado": {
    "IdDoc": {
      "TipoeCF": 31,
      "eNCF": "E310000000001",
      "FechaVencimientoSecuencia": "31-12-2028",
      "IndicadorMontoGravado": 0,
      "TipoIngresos": 1,
      "TipoPago": 1,
      "FechaEmision": "17-08-2026"
    },
    "Emisor": {
      "RNCEmisor": "131592511",
      "RazonSocialEmisor": "MEDASOFT SRL",
      "NombreComercial": "Medasoft Solutions",
      "DireccionEmisor": "Av. Winston Churchill #1099, Santo Domingo",
      "Municipio": "010100",
      "Provincia": "010000"
    },
    "Comprador": {
      "RNCComprador": "130301931",
      "RazonSocialComprador": "PEGADOSA SRL",
      "DireccionComprador": "Zona Industrial de Herrera, Santo Domingo Oeste",
      "MunicipioComprador": "320200",
      "ProvinciaComprador": "320000"
    },
    "Totales": {
      "MontoGravadoTotal": 10000.00,
      "MontoGravadoI1": 10000.00,
      "ITBIS1": 18,
      "TotalITBIS": 1800.00,
      "TotalITBIS1": 1800.00,
      "MontoTotal": 11800.00
    }
  },
  "DetallesItems": [
    {
      "NumeroLinea": 1,
      "NombreItem": "Servicio de Consultoría Software e-CF",
      "IndicadorFacturacion": 1,
      "IndicadorBienoServicio": 2,
      "CantidadItem": 1.00,
      "UnidadMedida": 43,
      "PrecioUnitarioItem": 10000.00,
      "MontoItem": 10000.00
    }
  ]
}

🔍 Diccionario de Secciones y Campos Clave

1. IdDoc (Identificación del Documento)

  • TipoeCF: Código de 2 dígitos del comprobante (31 al 47).
  • eNCF: Secuencia alfanumérica autorizada de 13 caracteres (E310000000001).
  • FechaVencimientoSecuencia: Formato dd-MM-yyyy. Obligatorio en E31, E33, E41, E43, E44, E45, E46, E47 (no aplica a E32 ni E34).
  • IndicadorMontoGravado: 0 = Precios unitarios no incluyen ITBIS; 1 = Precios unitarios incluyen ITBIS.
  • TipoIngresos: 01 Operaciones, 02 Financieros, 03 Extraordinarios, 04 Arrendamientos, 05 Venta de Activos, 06 Otros.
  • TipoPago: 1 Contado, 2 Crédito (exige FechaLimitePago), 3 Gratuito.

2. DetallesItems (Líneas de Detalle)

  • NumeroLinea: Secuencial correlativo de 1 a 1,000 (hasta 10,000 en E32 menor a 250k).
  • IndicadorFacturacion:
    • 0: No Facturable / No sujeto a ITBIS.
    • 1: Gravado ITBIS 18%.
    • 2: Gravado ITBIS 16%.
    • 3: Gravado Tasa Cero 0% (Exportaciones E46).
    • 4: Exento de ITBIS (Regímenes Especiales E44, Gastos Menores E43).
  • PrecioUnitarioItem: Admite hasta 4 decimales (Decimal(16,4)).
  • UnidadMedida: Código según Tabla IV DGII (43 = Unidad, 15 = Galón, etc.).
  • MontoItem: (CantidadItem * PrecioUnitarioItem) - DescuentoMonto + RecargoMonto.

3. InformacionReferencia (Exclusivo para E33 / E34 o Contingencia)

  • NCFModificado: Secuencia afectada (11, 13 o 19 caracteres).
  • FechaNCFModificado: Fecha del comprobante original (dd-MM-yyyy).
  • CodigoModificacion: 1 Anula NCF, 2 Corrige Texto (total en 0), 3 Corrige Montos (aplica balance disponible), 4 Reemplazo NCF Contingencia, 5 Referencia Consumo.

Autenticación API & Endpoint /login

Cómo autenticarse en la API de Medasoft mediante credenciales API Key/Secret o endpoint /login, gestión de tokens JWT y consulta de perfil de empresa.

Emisión & Recepción de Comprobantes e-CF

Ciclo de vida completo del e-NCF, contrato JSON detallado, significado campo por campo de la respuesta y aclaración de firma en memoria previa al envío a DGII.

On this page

📑 Tabla de Comprobantes e-CF Oficiales🧱 Estructura Jerárquica del JSON de Emisión🔍 Diccionario de Secciones y Campos Clave1. IdDoc (Identificación del Documento)2. DetallesItems (Líneas de Detalle)3. InformacionReferencia (Exclusivo para E33 / E34 o Contingencia)