Skip to content
Sildra Group API Facturación Electrónica

Recepción de Comprobantes Electrónicos (e-CF)

Este endpoint permite enviar cualquier tipo de comprobante fiscal electrónico, incluyendo facturas con crédito, notas de débito, exportaciones, y más.

¿Cuándo usar este endpoint?

Section titled “¿Cuándo usar este endpoint?”

Utiliza /fe/recepcion/ecf para todos los comprobantes que no sean RFCE. Este es el flujo general para integración completa de facturación.

Definición de Campos del Comprobante

Section titled “Definición de Campos del Comprobante”

Documentación basada en la versión oficial Formato Comprobante Fiscal Electrónico (e-CF) V1.0 de la DGII.

Encabezado

Section titled “Encabezado”
CampoDescripciónObligatorio
Encabezado.IdDocInformación general del comprobante fiscal.No
Encabezado.IdDoc.TipoeCfTipo de e-CF, según tabla de la DGII (ej. 32 = Factura de Consumo).No
Encabezado.IdDoc.ENcfNúmero del comprobante fiscal electrónico. Asignado por el sistema autorizado.No
Encabezado.IdDoc.IndicadorMontoGravadoIndica si el comprobante tiene montos gravados (0 = No, 1 = Sí).Sí
Encabezado.IdDoc.TipoIngresosTipo de ingreso (01 = Ordinarios, 02 = Extraordinarios).Sí
Encabezado.IdDoc.TipoPagoForma principal de pago (1 = Contado, 2 = Crédito, etc.).No
Encabezado.IdDoc.TablaFormasPago[].FormaPagoForma específica de pago (1 = Efectivo, 2 = Cheque, etc.).Sí
Encabezado.IdDoc.TablaFormasPago[].MontoPagoMonto correspondiente a esa forma de pago.Sí
Encabezado.Emisor.RNCEmisorRNC o cédula del emisor.No
Encabezado.Emisor.RazonSocialEmisorNombre legal del emisor registrado ante la DGII.No
Encabezado.Emisor.NombreComercialNombre comercial utilizado públicamente.Sí
Encabezado.Emisor.DireccionEmisorDirección completa del emisor.Sí
Encabezado.Emisor.FechaEmisionFecha de emisión del comprobante (formato DD-MM-AAAA).No
Encabezado.Comprador.RNCCompradorRNC o cédula del receptor del comprobante.Condicional
Encabezado.Comprador.RazonSocialCompradorNombre legal del comprador si aplica.Condicional
Encabezado.Totales.MontoGravadoTotalSuma de montos gravados del comprobante.Sí
Encabezado.Totales.MontoGravadoI1Monto gravado sujeto a ITBIS del 18%.Sí
Encabezado.Totales.ITbis1Porcentaje del ITBIS aplicado (por ejemplo, 18).Sí
Encabezado.Totales.TotalItbisTotal del ITBIS aplicado.Sí
Encabezado.Totales.TotalItbis1Monto del ITBIS al 18%.Sí
Encabezado.Totales.MontoTotalMonto total del comprobante incluyendo impuestos.No

DetallesItems

Section titled “DetallesItems”
CampoDescripciónObligatorio
DetallesItems[].NumeroLineaNúmero de línea del ítem dentro del detalle.No
DetallesItems[].IndicadorFacturacionIndica si el ítem es facturable (1 = Sí).No
DetallesItems[].NombreItemNombre o descripción del producto o servicio.No
DetallesItems[].IndicadorBienoServicioTipo del ítem (1 = Bien, 2 = Servicio).No
DetallesItems[].CantidadItemCantidad facturada del ítem.No
DetallesItems[].UnidadMedidaUnidad de medida (31 = Unidad).No
DetallesItems[].PrecioUnitarioItemPrecio por unidad del ítem sin impuestos.No
DetallesItems[].DescuentoMontoMonto de descuento aplicado al ítem, si aplica.Sí
DetallesItems[].MontoItemSubtotal calculado del ítem luego de descuentos.No

DescuentosORecargos

Section titled “DescuentosORecargos”
CampoDescripciónObligatorio
DescuentosORecargos[].Tipo1 = Descuento, 2 = Recargo.Sí
DescuentosORecargos[].MontoValor monetario del descuento o recargo.Sí
DescuentosORecargos[].IndicadorIndica si es un monto fijo o porcentaje.Sí
DescuentosORecargos[].DescripcionDescripción textual del ajuste aplicado.Sí

Método: POST

Section titled “Método: ”

URL sandbox:
https://sandbox-api.sildra.com.do/

Cabeceras necesarias:

Section titled “Cabeceras necesarias:”
X-API-Key: pk_test_xxxxxxx
Content-Type: application/json

Ejemplo curl

Section titled “Ejemplo curl”
Terminal window
curl -X POST https://sandbox-api.sildra.com.do/fe/recepcion/ecf \
  -H "X-API-Key: pk_test_tu_clave" \
  -H "Content-Type: application/json" \
  -d @ecf-payload.json

Cuerpo esperado (ecf-payload.json)

Section titled “Cuerpo esperado (ecf-payload.json)”
{
    "Encabezado": {
        "Version": "1.0",
        "IdDoc": {
            "TipoeCF": 31,
            "eNCF": "E310000000001",
            "FechaVencimientoSecuencia": "12/31/2024 00:00:00",
            "IndicadorMontoGravado": 0,
            "TipoIngresos": "01",
            "TipoPago": 1,
            "TablaFormasPago": [
                {
                    "FormaPago": 1,
                    "MontoPago": 1180.00
                }
            ]
        },
        "Emisor": {
            "RNCEmisor": "133288923",
            "RazonSocialEmisor": "SILDRA GROUP SRL",
            "NombreComercial": "SILDRA GROUP SRL",
            "DireccionEmisor": "OAQUIN INCHAUSTEGUI #43, 1ER NIVEL, EDIFICIO LAS LUISA, BANI, PROVINCIA PERAVIA",
            "FechaEmision": "04-05-2024"
        },
        "Comprador": {
            "RNCComprador": "133288923",
            "RazonSocialComprador": "SILDRA GROUP SRL"
        },
        "Totales": {
            "MontoGravadoTotal": 1000.00,
            "MontoGravadoI1": 1000.00,
            "ITBIS1": 18,
            "TotalITBIS": 180.00,
            "TotalITBIS1": 180.00,
            "MontoTotal": 1180.00
        }
    },
    "DetallesItems": [
        {
            "NumeroLinea": 1,
            "IndicadorFacturacion": 1,
            "NombreItem": "PRODUCTO CON ITBIS 18%",
            "IndicadorBienoServicio": 1,
            "CantidadItem": 1,
            "UnidadMedida": 31,
            "PrecioUnitarioItem": 1000.00,
            "MontoItem": 1000.00
        }
    ]
}

Respuesta esperada

Section titled “Respuesta esperada”
{
    "encf": {
    "trackid": "string",
    "codigo": "string",
    "estado": "string",
    "rnc": "string",
    "encf": "string",
    "secuenciaUtilizada": true,
    "fechaRecepcion": "string",
    "mensajes": [
      {
        // MessageResponse properties go here
      }
    ],
    "codigoSeguridad": "string",
    "urlQr": "string",
    "fechaHoraFirma": "string"
  },
  "xmlstring": ""
}