# Formato del e-CF

> Un JSON con los mismos nombres de campo de la DGII.

**En resumen**
- Los campos se llaman como en el XML de la DGII: `Encabezado`, `IdDoc`, `Totales`…
- Los montos van como texto, con punto decimal: `"5192.00"`.
- Las fechas, `DD-MM-AAAA`.

> Borrador v0 (16/11/2026): la API todavía no está abierta y las rutas y los nombres pueden cambiar. En esta versión envías los totales ya calculados. Los tres ejemplos pasan el XSD oficial de la DGII y nuestras reglas; el 34 trae un aviso porque, sin el 31 que modifica, no puede sumar las notas anteriores.

## Reglas comunes

- Lo que se repite va en una lista: `Item: [ … ]`, `FormaDePago: [ … ]`.
- Si un campo no aplica, quítalo. No mandes campos vacíos (el 32 de consumo lleva `Comprador: {}`).
- Punto decimal, sin comas de miles.
- Las cuentas deben cuadrar: líneas, ITBIS y `MontoTotal`.

## Ejemplos

**Ejemplos por tipo**

31 · Crédito fiscal: Una venta a otra empresa con RNC, pagada por transferencia: dos líneas al 18 %.

```json
{
  "Encabezado": {
    "Version": "1.0",
    "IdDoc": {
      "TipoeCF": "31",
      "eNCF": "E310000000001",
      "FechaVencimientoSecuencia": "31-12-2027",
      "IndicadorMontoGravado": "0",
      "TipoIngresos": "01",
      "TipoPago": "1",
      "TablaFormasPago": {
        "FormaDePago": [
          {
            "FormaPago": "2",
            "MontoPago": "5192.00"
          }
        ]
      }
    },
    "Emisor": {
      "RNCEmisor": "999000001",
      "RazonSocialEmisor": "Comercial Ficticia del Caribe, SRL",
      "DireccionEmisor": "Calle Imaginaria 123, Santo Domingo",
      "FechaEmision": "16-11-2026"
    },
    "Comprador": {
      "RNCComprador": "999000002",
      "RazonSocialComprador": "Distribuidora Imaginaria, SA"
    },
    "Totales": {
      "MontoGravadoTotal": "4400.00",
      "MontoGravadoI1": "4400.00",
      "ITBIS1": "18",
      "TotalITBIS": "792.00",
      "TotalITBIS1": "792.00",
      "MontoTotal": "5192.00"
    }
  },
  "DetallesItems": {
    "Item": [
      {
        "NumeroLinea": "1",
        "IndicadorFacturacion": "1",
        "NombreItem": "Servicio de consultoría",
        "IndicadorBienoServicio": "2",
        "CantidadItem": "2.00",
        "PrecioUnitarioItem": "1500.0000",
        "MontoItem": "3000.00"
      },
      {
        "NumeroLinea": "2",
        "IndicadorFacturacion": "1",
        "NombreItem": "Resma de papel 8.5x11",
        "IndicadorBienoServicio": "1",
        "CantidadItem": "5.00",
        "UnidadMedida": "31",
        "PrecioUnitarioItem": "280.0000",
        "MontoItem": "1400.00"
      }
    ]
  }
}
```

32 · Consumo: Una venta a un consumidor final, en efectivo: una línea al 18 % y otra exenta. Es menor de RD$250,000, así que nosotros armamos el resumen (RFCE) que pide la DGII.

```json
{
  "Encabezado": {
    "Version": "1.0",
    "IdDoc": {
      "TipoeCF": "32",
      "eNCF": "E320000000001",
      "IndicadorMontoGravado": "0",
      "TipoIngresos": "01",
      "TipoPago": "1",
      "TablaFormasPago": {
        "FormaDePago": [
          {
            "FormaPago": "1",
            "MontoPago": "926.00"
          }
        ]
      }
    },
    "Emisor": {
      "RNCEmisor": "999000001",
      "RazonSocialEmisor": "Comercial Ficticia del Caribe, SRL",
      "DireccionEmisor": "Calle Imaginaria 123, Santo Domingo",
      "FechaEmision": "16-11-2026"
    },
    "Comprador": {},
    "Totales": {
      "MontoGravadoTotal": "700.00",
      "MontoGravadoI1": "700.00",
      "MontoExento": "100.00",
      "ITBIS1": "18",
      "TotalITBIS": "126.00",
      "TotalITBIS1": "126.00",
      "MontoTotal": "926.00"
    }
  },
  "DetallesItems": {
    "Item": [
      {
        "NumeroLinea": "1",
        "IndicadorFacturacion": "1",
        "NombreItem": "Café molido 454 g",
        "IndicadorBienoServicio": "1",
        "CantidadItem": "2.00",
        "UnidadMedida": "43",
        "PrecioUnitarioItem": "350.0000",
        "MontoItem": "700.00"
      },
      {
        "NumeroLinea": "2",
        "IndicadorFacturacion": "4",
        "NombreItem": "Pan de agua",
        "IndicadorBienoServicio": "1",
        "CantidadItem": "10.00",
        "UnidadMedida": "43",
        "PrecioUnitarioItem": "10.0000",
        "MontoItem": "100.00"
      }
    ]
  }
}
```

34 · Nota de crédito: Devuelve una resma del 31. `InformacionReferencia` dice qué comprobante modifica.

```json
{
  "Encabezado": {
    "Version": "1.0",
    "IdDoc": {
      "TipoeCF": "34",
      "eNCF": "E340000000001",
      "IndicadorNotaCredito": "0",
      "IndicadorMontoGravado": "0",
      "TipoIngresos": "01",
      "TipoPago": "1"
    },
    "Emisor": {
      "RNCEmisor": "999000001",
      "RazonSocialEmisor": "Comercial Ficticia del Caribe, SRL",
      "DireccionEmisor": "Calle Imaginaria 123, Santo Domingo",
      "FechaEmision": "18-11-2026"
    },
    "Comprador": {
      "RNCComprador": "999000002",
      "RazonSocialComprador": "Distribuidora Imaginaria, SA"
    },
    "Totales": {
      "MontoGravadoTotal": "280.00",
      "MontoGravadoI1": "280.00",
      "ITBIS1": "18",
      "TotalITBIS": "50.40",
      "TotalITBIS1": "50.40",
      "MontoTotal": "330.40"
    }
  },
  "DetallesItems": {
    "Item": [
      {
        "NumeroLinea": "1",
        "IndicadorFacturacion": "1",
        "NombreItem": "Resma de papel 8.5x11 (devolución)",
        "IndicadorBienoServicio": "1",
        "CantidadItem": "1.00",
        "UnidadMedida": "31",
        "PrecioUnitarioItem": "280.0000",
        "MontoItem": "280.00"
      }
    ]
  },
  "InformacionReferencia": {
    "NCFModificado": "E310000000001",
    "FechaNCFModificado": "16-11-2026",
    "CodigoModificacion": "3",
    "RazonModificacion": "Devolución de una resma"
  }
}
```

## Tipos de e-CF

Los diez: 31, 32, 33, 34, 41, 43, 44, 45, 46 y 47. Los ejemplos de los demás llegan con la versión 1.
