MSeller LogoECF MSeller
🔍
Integración

Formato de Documentos e-CF

Ejemplos completos de JSON para cada tipo de Comprobante Fiscal Electrónico (e-CF) usado en las pruebas de certificación DGII con MSeller ECF. Tipos 31, 32, 33, 34, 41, 43, 44, 45, 46 y 47.

Formato de Documentos e-CF

Ejemplos JSON para cada tipo de e-CF que se envía durante las pruebas de simulación. Cada documento sigue la estructura estándar de la DGII.

Para entender el proceso completo de transformación JSON → XML → firma → envío, consulta la guía de formato de documentos de integración.

Los campos con placeholders como {{RNC}} se reemplazan automáticamente con los datos de tu cuenta al momento del envío.

PlaceholderSe reemplaza con
{{RNC}}RNC del emisor (tu empresa)
{{RAZON_SOCIAL}}Razón social del emisor
{{NOMBRE_COMERCIAL}}Nombre comercial registrado
{{FECHA_EMISION}}Fecha actual en formato DD-MM-YYYY
{{FECHA_LIMITE_PAGO}}Fecha actual + 30 días en formato DD-MM-YYYY
{{NCF_MODIFICADO}}eNCF del Tipo 32 (< 250K) enviado previamente

Tipo 31 — Factura de Crédito Fiscal

Factura estándar con crédito fiscal, emitida a un comprador con RNC.

{
  "ECF": {
    "Encabezado": {
      "Version": "1.0",
      "IdDoc": {
        "TipoeCF": 31,
        "eNCF": "E310000000002",
        "FechaVencimientoSecuencia": "31-12-2028",
        "IndicadorEnvioDiferido": 1,
        "TipoIngresos": "01",
        "TipoPago": 1
      },
      "Emisor": {
        "RNCEmisor": "{{RNC}}",
        "RazonSocialEmisor": "{{RAZON_SOCIAL}}",
        "DireccionEmisor": "Av",
        "FechaEmision": "{{FECHA_EMISION}}"
      },
      "Comprador": {
        "RNCComprador": "130862346",
        "RazonSocialComprador": "IT SOLUCLICK SRL"
      },
      "Totales": {
        "MontoExento": 244.0,
        "MontoTotal": 244.0
      }
    },
    "DetallesItems": {
      "Item": [
        {
          "NumeroLinea": 1,
          "IndicadorFacturacion": 4,
          "NombreItem": "CEDEBRAL 5000 JARABE",
          "IndicadorBienoServicio": 1,
          "CantidadItem": 1.0,
          "PrecioUnitarioItem": 244.0,
          "MontoItem": 244.0
        }
      ]
    }
  }
}

Tipo 32 — Factura de Consumo (< 250K)

Factura de consumo por un monto menor a RD$250,000. Este documento se usa como referencia para los tipos 33 y 34.

{
  "ECF": {
    "Encabezado": {
      "Version": "1.0",
      "IdDoc": {
        "TipoeCF": 32,
        "eNCF": "E320000000001",
        "IndicadorEnvioDiferido": 1,
        "IndicadorMontoGravado": 0,
        "TipoIngresos": "01",
        "TipoPago": 1
      },
      "Emisor": {
        "RNCEmisor": "{{RNC}}",
        "RazonSocialEmisor": "{{RAZON_SOCIAL}}",
        "DireccionEmisor": "Av",
        "FechaEmision": "{{FECHA_EMISION}}"
      },
      "Comprador": {
        "RNCComprador": "131880657",
        "RazonSocialComprador": "CLIENTES DE LA ADMINISTRACION"
      },
      "Totales": {
        "MontoExento": 601.0,
        "MontoTotal": 601.0
      }
    },
    "DetallesItems": {
      "Item": [
        {
          "NumeroLinea": 1,
          "IndicadorFacturacion": 4,
          "NombreItem": "CORACOR A C/30 TABS.",
          "IndicadorBienoServicio": 1,
          "CantidadItem": 1.0,
          "PrecioUnitarioItem": 601.0,
          "MontoItem": 601.0
        }
      ]
    }
  }
}

Tipo 32 — Factura de Consumo (≥ 250K)

Factura de consumo por un monto igual o mayor a RD$250,000. Requiere datos del comprador (RNC o cédula).

{
  "ECF": {
    "Encabezado": {
      "Version": "1.0",
      "IdDoc": {
        "TipoeCF": 32,
        "eNCF": "E320000000002",
        "IndicadorEnvioDiferido": 1,
        "IndicadorMontoGravado": 0,
        "TipoIngresos": "01",
        "TipoPago": 1
      },
      "Emisor": {
        "RNCEmisor": "{{RNC}}",
        "RazonSocialEmisor": "{{RAZON_SOCIAL}}",
        "DireccionEmisor": "Av",
        "FechaEmision": "{{FECHA_EMISION}}"
      },
      "Comprador": {
        "RNCComprador": "40208719662",
        "RazonSocialComprador": "BRYAN TORRES"
      },
      "Totales": {
        "MontoExento": 600000.0,
        "MontoTotal": 600000.0
      }
    },
    "DetallesItems": {
      "Item": [
        {
          "NumeroLinea": 1,
          "IndicadorFacturacion": 4,
          "NombreItem": "GREEN PIGEON PEAS CARIDOM 24/15 OZ.",
          "IndicadorBienoServicio": 1,
          "CantidadItem": 2.0,
          "PrecioUnitarioItem": 300000.0,
          "MontoItem": 600000.0
        }
      ]
    }
  }
}

Tipo 33 — Nota de Débito

Nota de débito que referencia un comprobante previo. Requiere la sección InformacionReferencia con el eNCF del documento que se modifica.

{
  "ECF": {
    "Encabezado": {
      "Version": "1.0",
      "IdDoc": {
        "TipoeCF": 33,
        "eNCF": "E330000000001",
        "FechaVencimientoSecuencia": "31-12-2028",
        "TipoIngresos": "01",
        "TipoPago": 1,
        "TablaFormasPago": {
          "FormaDePago": [
            {
              "FormaPago": 1,
              "MontoPago": "203898.31"
            }
          ]
        }
      },
      "Emisor": {
        "RNCEmisor": "{{RNC}}",
        "RazonSocialEmisor": "{{RAZON_SOCIAL}}",
        "DireccionEmisor": "Av",
        "FechaEmision": "{{FECHA_EMISION}}"
      },
      "Comprador": {
        "RNCComprador": "131880657",
        "RazonSocialComprador": "CLIENTES DE LA ADMINISTRACION",
        "DireccionComprador": "AV. CASANDRA DAMIRON #80"
      },
      "Totales": {
        "MontoExento": "203898.31",
        "MontoTotal": "203898.31"
      }
    },
    "DetallesItems": {
      "Item": [
        {
          "NumeroLinea": 1,
          "IndicadorFacturacion": 4,
          "NombreItem": "GENERAL",
          "IndicadorBienoServicio": 1,
          "CantidadItem": "1",
          "UnidadMedida": "47",
          "PrecioUnitarioItem": "203898.31",
          "MontoItem": "203898.31"
        }
      ]
    },
    "InformacionReferencia": {
      "NCFModificado": "{{NCF_MODIFICADO}}",
      "FechaNCFModificado": "{{FECHA_EMISION}}",
      "CodigoModificacion": "3"
    }
  }
}

Tipo 34 — Nota de Crédito

Nota de crédito que modifica un comprobante emitido previamente. Requiere la sección InformacionReferencia donde NCFModificado es el eNCF de cualquier comprobante que se desee modificar.

CodigoModificacion

CódigoDescripciónAplica a
1Anulación total del NCF modificadoNota de Crédito / Débito
2Corrección de texto del comprobanteNota de Crédito / Débito
3Corrección de montos del NCF modificadoNota de Crédito / Débito
4Reemplazo de NCF emitido en contingenciaCondicional
5Referencia a Factura de Consumo Electrónica—
{
  "ECF": {
    "Encabezado": {
      "Version": "1.0",
      "IdDoc": {
        "TipoeCF": 34,
        "eNCF": "E340000000001",
        "IndicadorNotaCredito": "0",
        "IndicadorEnvioDiferido": 1,
        "IndicadorMontoGravado": 0,
        "TipoIngresos": "01",
        "TipoPago": 2,
        "FechaLimitePago": "{{FECHA_LIMITE_PAGO}}"
      },
      "Emisor": {
        "RNCEmisor": "{{RNC}}",
        "RazonSocialEmisor": "{{RAZON_SOCIAL}}",
        "DireccionEmisor": "Av",
        "FechaEmision": "{{FECHA_EMISION}}"
      },
      "Comprador": {
        "RNCComprador": "131880657",
        "RazonSocialComprador": "CLIENTES DE LA ADMINISTRACION"
      },
      "Totales": {
        "MontoExento": 3005.0,
        "MontoTotal": 3005.0
      }
    },
    "DetallesItems": {
      "Item": [
        {
          "NumeroLinea": 1,
          "IndicadorFacturacion": 4,
          "NombreItem": "CORACOR A C/30 TABS.",
          "IndicadorBienoServicio": 1,
          "CantidadItem": 5.0,
          "PrecioUnitarioItem": 601.0,
          "MontoItem": 3005.0
        }
      ]
    },
    "InformacionReferencia": {
      "NCFModificado": "{{NCF_MODIFICADO}}",
      "FechaNCFModificado": "{{FECHA_EMISION}}",
      "CodigoModificacion": "3"
    }
  }
}

Nota: En el entorno de certificación, NCFModificado se completa automáticamente con el eNCF del Tipo 32 (< 250K). En producción, usa el eNCF del comprobante que deseas modificar y el CodigoModificacion que corresponda.

Tipo 41 — Compras

Comprobante de compras con ITBIS (impuesto). Incluye campos de retención.

{
  "ECF": {
    "Encabezado": {
      "Version": "1.0",
      "IdDoc": {
        "TipoeCF": 41,
        "eNCF": "E410000000001",
        "FechaVencimientoSecuencia": "31-12-2028",
        "IndicadorMontoGravado": 0,
        "TipoPago": 2,
        "FechaLimitePago": "{{FECHA_LIMITE_PAGO}}"
      },
      "Emisor": {
        "RNCEmisor": "{{RNC}}",
        "RazonSocialEmisor": "{{RAZON_SOCIAL}}",
        "DireccionEmisor": "Av",
        "FechaEmision": "{{FECHA_EMISION}}"
      },
      "Comprador": {
        "RNCComprador": "00100325067",
        "RazonSocialComprador": "ENRIQUE CAMILO SANTOS TAVAREZ"
      },
      "Totales": {
        "MontoGravadoTotal": 1000.0,
        "MontoGravadoI1": 1000.0,
        "ITBIS1": 18,
        "TotalITBIS": 180.0,
        "TotalITBIS1": 180.0,
        "MontoTotal": 1180.0,
        "TotalITBISRetenido": "0.00",
        "TotalISRRetencion": "0.00"
      }
    },
    "DetallesItems": {
      "Item": [
        {
          "NumeroLinea": 1,
          "IndicadorFacturacion": 1,
          "Retencion": {
            "IndicadorAgenteRetencionoPercepcion": 1,
            "MontoITBISRetenido": 0.0
          },
          "NombreItem": "COMISION VERIFON TARJETAS",
          "IndicadorBienoServicio": 1,
          "CantidadItem": 1.0,
          "PrecioUnitarioItem": 1000.0,
          "MontoItem": 1000.0
        }
      ]
    }
  }
}

Tipo 43 — Gastos Menores

Comprobante para gastos menores. Estructura simplificada sin datos del comprador.

{
  "ECF": {
    "Encabezado": {
      "Version": "1.0",
      "IdDoc": {
        "TipoeCF": 43,
        "eNCF": "E430000000001",
        "FechaVencimientoSecuencia": "31-12-2028"
      },
      "Emisor": {
        "RNCEmisor": "{{RNC}}",
        "RazonSocialEmisor": "{{RAZON_SOCIAL}}",
        "DireccionEmisor": "Av",
        "FechaEmision": "{{FECHA_EMISION}}"
      },
      "Totales": {
        "MontoExento": 1000.0,
        "MontoTotal": 1000.0
      }
    },
    "DetallesItems": {
      "Item": [
        {
          "NumeroLinea": 1,
          "IndicadorFacturacion": 4,
          "NombreItem": "PROPIETARIO COMPANIA DE TRANSPORTE DIVER",
          "IndicadorBienoServicio": 1,
          "CantidadItem": 1.0,
          "PrecioUnitarioItem": 1000.0,
          "MontoItem": 1000.0
        }
      ]
    }
  }
}

Tipo 44 — Regímenes Especiales

Comprobante para operaciones en zonas francas y regímenes especiales de tributación.

{
  "ECF": {
    "Encabezado": {
      "Version": "1.0",
      "IdDoc": {
        "TipoeCF": 44,
        "eNCF": "E440000000001",
        "FechaVencimientoSecuencia": "31-12-2028",
        "IndicadorEnvioDiferido": 1,
        "TipoIngresos": "01",
        "TipoPago": 1
      },
      "Emisor": {
        "RNCEmisor": "{{RNC}}",
        "RazonSocialEmisor": "{{RAZON_SOCIAL}}",
        "DireccionEmisor": "Av",
        "FechaEmision": "{{FECHA_EMISION}}"
      },
      "Comprador": {
        "RNCComprador": "131098843",
        "RazonSocialComprador": "ZONA FRANCA 6 DE NOVIEMBRE SRL"
      },
      "Totales": {
        "MontoExento": 29.5,
        "MontoTotal": 29.5
      }
    },
    "DetallesItems": {
      "Item": [
        {
          "NumeroLinea": 1,
          "IndicadorFacturacion": 4,
          "NombreItem": "GREEN PIGEON PEAS CARIDOM 24/15 OZ.",
          "IndicadorBienoServicio": 1,
          "CantidadItem": 1.0,
          "PrecioUnitarioItem": 29.5,
          "MontoItem": 29.5
        }
      ]
    }
  }
}

Tipo 45 — Gubernamental

Comprobante para ventas a entidades gubernamentales.

{
  "ECF": {
    "Encabezado": {
      "Version": "1.0",
      "IdDoc": {
        "TipoeCF": 45,
        "eNCF": "E450000000001",
        "FechaVencimientoSecuencia": "31-12-2028",
        "IndicadorEnvioDiferido": 1,
        "TipoIngresos": "01",
        "TipoPago": 1
      },
      "Emisor": {
        "RNCEmisor": "{{RNC}}",
        "RazonSocialEmisor": "{{RAZON_SOCIAL}}",
        "DireccionEmisor": "Av",
        "FechaEmision": "{{FECHA_EMISION}}"
      },
      "Comprador": {
        "RNCComprador": "401506459",
        "RazonSocialComprador": "PLAN DE ASISTENCIA SOCIAL DE LA PRESIDENCIA"
      },
      "Totales": {
        "MontoExento": 1197.0,
        "MontoTotal": 1197.0
      }
    },
    "DetallesItems": {
      "Item": [
        {
          "NumeroLinea": 1,
          "IndicadorFacturacion": 4,
          "NombreItem": "OXIGEN 200 C/30 TABS.",
          "IndicadorBienoServicio": 1,
          "CantidadItem": 1.0,
          "PrecioUnitarioItem": 1197.0,
          "MontoItem": 1197.0
        }
      ]
    }
  }
}

Tipo 46 — Exportaciones

Comprobante de exportación. Incluye secciones adicionales de InformacionesAdicionales y Transporte con datos de embarque, aduana y destino.

{
  "ECF": {
    "Encabezado": {
      "Version": "1.0",
      "IdDoc": {
        "TipoeCF": 46,
        "eNCF": "E460000000003",
        "FechaVencimientoSecuencia": "31-12-2028",
        "TipoIngresos": "01",
        "TipoPago": 2,
        "FechaLimitePago": "{{FECHA_LIMITE_PAGO}}",
        "TerminoPago": "1 mes",
        "TablaFormasPago": {
          "FormaDePago": [
            {
              "FormaPago": 2,
              "MontoPago": "1800000.00"
            }
          ]
        }
      },
      "Emisor": {
        "RNCEmisor": "{{RNC}}",
        "RazonSocialEmisor": "{{RAZON_SOCIAL}}",
        "DireccionEmisor": "Av",
        "CodigoVendedor": "AA0000000100000000010000000002000000000300000000050000000006",
        "NumeroFacturaInterna": "123456789016",
        "NumeroPedidoInterno": 123456789016,
        "FechaEmision": "{{FECHA_EMISION}}"
      },
      "Comprador": {
        "RNCComprador": "131880681",
        "RazonSocialComprador": "ZONA FRANCA LOI",
        "ContactoComprador": "MARCOS LLUBERES",
        "CorreoComprador": "MARCOSLLUBERES@KKKK.COM",
        "DireccionComprador": "ZONA HAINA",
        "MunicipioComprador": "010100",
        "ProvinciaComprador": "010000",
        "FechaEntrega": "07-04-2020",
        "ContactoEntrega": "JACINTO MANON",
        "DireccionEntrega": "ZONA HAINA",
        "TelefonoAdicional": "809-555-5050",
        "FechaOrdenCompra": "10-03-2020",
        "NumeroOrdenCompra": "4500352230",
        "CodigoInternoComprador": "10633441"
      },
      "InformacionesAdicionales": {
        "FechaEmbarque": "10-04-2020",
        "NumeroEmbarque": "10010-1207-000254",
        "NumeroContenedor": "ERTY227958722",
        "NumeroReferencia": "1448",
        "NombrePuertoEmbarque": "ZONA HAINA",
        "CondicionesEntrega": "FOB",
        "TotalFob": "1800.00",
        "Seguro": "250.00",
        "Flete": "22.00",
        "TotalCif": "2000.00",
        "RegimenAduanero": "EXPORTACION NACIONAL",
        "NombrePuertoSalida": "DOSDQ",
        "NombrePuertoDesembarque": "PTO RICO",
        "PesoBruto": "25000.00",
        "PesoNeto": "24878.00",
        "UnidadPesoBruto": "21",
        "UnidadPesoNeto": "21",
        "CantidadBulto": "250.00",
        "UnidadBulto": "25",
        "VolumenBulto": "45",
        "UnidadVolumen": "27"
      },
      "Transporte": {
        "ViaTransporte": "02",
        "PaisOrigen": "REPUBLICA DOMINICANA",
        "DireccionDestino": "CALLE GUALLUBI NO. 09",
        "PaisDestino": "PUERTO RICO",
        "NumeroAlbaran": "56789UJILLL"
      },
      "Totales": {
        "MontoGravadoTotal": "1800000.00",
        "MontoGravadoI3": "1800000.00",
        "ITBIS3": 0,
        "TotalITBIS": "0.00",
        "TotalITBIS3": "0.00",
        "MontoTotal": "1800000.00"
      }
    },
    "DetallesItems": {
      "Item": [
        {
          "NumeroLinea": 1,
          "TablaCodigosItem": {
            "CodigosItem": [
              {
                "TipoCodigo": "INTERNA",
                "CodigoItem": "123456"
              }
            ]
          },
          "IndicadorFacturacion": 3,
          "NombreItem": "AGUACATE CRIOLLO",
          "IndicadorBienoServicio": 1,
          "CantidadItem": "100.00",
          "UnidadMedida": "43",
          "PrecioUnitarioItem": "18000.00",
          "MontoItem": "1800000.00"
        }
      ]
    }
  }
}

Tipo 47 — Pagos al Exterior

Comprobante para pagos a proveedores en el exterior. Incluye secciones de OtraMoneda y Subtotales, y usa IdentificadorExtranjero en lugar de RNC del comprador.

{
  "ECF": {
    "Encabezado": {
      "Version": "1.0",
      "IdDoc": {
        "TipoeCF": 47,
        "eNCF": "E470000000001",
        "FechaVencimientoSecuencia": "31-12-2028",
        "NumeroCuentaPago": "BB00058745214789635111111111",
        "BancoPago": "BB0111111111111111111111111111111111111111111111111111111111111111111111111"
      },
      "Emisor": {
        "RNCEmisor": "{{RNC}}",
        "RazonSocialEmisor": "{{RAZON_SOCIAL}}",
        "DireccionEmisor": "Av",
        "NumeroFacturaInterna": "123456789016",
        "NumeroPedidoInterno": 123456789016,
        "FechaEmision": "{{FECHA_EMISION}}"
      },
      "Comprador": {
        "IdentificadorExtranjero": "533445888",
        "RazonSocialComprador": "ALEJA FERMIN SANTOS"
      },
      "Totales": {
        "MontoExento": "180000.00",
        "MontoTotal": "180000.00",
        "TotalISRRetencion": "48600.00"
      },
      "OtraMoneda": {
        "TipoMoneda": "USD",
        "TipoCambio": "60.0000",
        "MontoExentoOtraMoneda": "3000.00",
        "MontoTotalOtraMoneda": "3000.00"
      }
    },
    "DetallesItems": {
      "Item": [
        {
          "NumeroLinea": 1,
          "IndicadorFacturacion": 4,
          "Retencion": {
            "IndicadorAgenteRetencionoPercepcion": "1",
            "MontoISRRetenido": "48600.00"
          },
          "NombreItem": "LICENCIA WYI",
          "IndicadorBienoServicio": 2,
          "CantidadItem": "1.00",
          "UnidadMedida": "43",
          "PrecioUnitarioItem": "180000.00",
          "OtraMonedaDetalle": {
            "PrecioOtraMoneda": "3000.0000",
            "MontoItemOtraMoneda": "3000.00"
          },
          "MontoItem": "180000.00"
        }
      ]
    },
    "Subtotales": {
      "Subtotal": [
        {
          "NumeroSubTotal": "1",
          "DescripcionSubtotal": "N/A",
          "Orden": 1,
          "SubTotalExento": "180000.00",
          "MontoSubTotal": "180000.00",
          "Lineas": 1
        }
      ]
    }
  }
}

Secciones especiales por tipo

No todos los tipos de e-CF requieren las mismas secciones. La siguiente tabla resume qué secciones adicionales aplican:

Sección31323334414344454647
Comprador✅✅✅✅✅—✅✅✅✅
InformacionReferencia——✅✅——————
TablaFormasPago——✅—————✅—
Retencion (en Item)————✅————✅
InformacionesAdicionales————————✅—
Transporte————————✅—
OtraMoneda—————————✅
Subtotales—————————✅

Para más información sobre la estructura completa de documentos e-CF, consulta la sección de Formato de Documentos.

Formato de Documentos

Especificaciones para el formato de documentos JSON

Envío de Documentos

Cómo enviar documentos electrónicos en MSeller ECF