Quickstart

Cuatro pasos contra TesteCF. El host es siempre https://api.emite.do.

Registra la empresa

Usa el asistente de registro o pide a soporte que deje la empresa is_active con API key.La API key se muestra una vez. Guárdala como EMITE_API_KEY.

Carga el certificado P12

TesteCF admite el certificado de pruebas. Producción exige el P12 del emisor.

curl -X POST https://api.emite.do/api/v1/client/certificates \
  -H "X-API-Key: $EMITE_API_KEY" \
  -F "certificate=@certificado.p12" \
  -F "pin=$P12_PIN" \
  -F "environment=TesteCF"

Confirma rangos e-NCF

El e-NCF lo trae el payload. Debe existir un rango activo para ese tipo y ambiente.

curl "https://api.emite.do/api/v1/client/sequences?active_only=true" \
  -H "X-API-Key: $EMITE_API_KEY"

Envía un E31

idempotency_key es obligatorio. FechaEmision va en Emisor con formato DD-MM-YYYY.

curl -X POST https://api.emite.do/api/v1/ecf \
  -H "X-API-Key: $EMITE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "idempotency_key": "demo-e31-001",
    "external_id": "INV/2026/0001",
    "ecf_type": "31",
    "environment": "TesteCF",
    "payload": {
      "Encabezado": {
        "Version": "1.0",
        "IdDoc": {
          "TipoeCF": "31",
          "eNCF": "E310000000001",
          "FechaVencimientoSecuencia": "31-12-2028",
          "IndicadorMontoGravado": 0,
          "TipoIngresos": "01",
          "TipoPago": "1"
        },
        "Emisor": {
          "RNCEmisor": "130478031",
          "RazonSocialEmisor": "EMPRESA DEMO SRL",
          "DireccionEmisor": "AV. DEMO 1",
          "FechaEmision": "15-08-2026"
        },
        "Comprador": {
          "RNCComprador": "131098193",
          "RazonSocialComprador": "CLIENTE DEMO SRL"
        },
        "Totales": {
          "MontoGravadoTotal": 10000.0,
          "MontoGravadoI1": 10000.0,
          "MontoExento": 0.0,
          "ITBIS1": 18,
          "TotalITBIS": 1800.0,
          "TotalITBIS1": 1800.0,
          "MontoTotal": 11800.0
        }
      },
      "DetallesItems": {
        "Item": [
          {
            "NumeroLinea": 1,
            "IndicadorFacturacion": 1,
            "NombreItem": "SERVICIO DEMO",
            "IndicadorBienoServicio": 2,
            "CantidadItem": 1.0,
            "UnidadMedida": "43",
            "PrecioUnitarioItem": 10000.0,
            "MontoItem": 10000.0
          }
        ]
      }
    }
  }'

Respuesta inmediata (201 o 200 si reenvías la misma key):

{
  "public_id": "01J2XB4A...",
  "idempotency_key": "demo-e31-001",
  "status": "received",
  "encf": "E310000000001",
  "environment": "TesteCF"
}

Guarda public_id. Es el identificador para consultas, artefactos y soporte. external_id no lo sustituye.

El mismo POST /api/v1/ecf vale para E31–E47. Este E31 es solo el ejemplo: cambia ecf_type, IdDoc.TipoeCF y un e-NCF del tipo (E32…, E34…, E47…, …) con su rango activo. Siguiente: webhooks o primer documento.

⌘I

Empezar

Integración