Introducción

Qué es la API de Simplo, qué es un DTE y qué necesitas para emitir tu primer documento tributario electrónico en Chile.

Simplo es facturación electrónica chilena para developers: una API REST en https://api.simplo.cl, descrita por un contrato OpenAPI desde el que puedes generar un cliente en tu lenguaje. La complementan un SDK TypeScript oficial (@simplohq/sdk) y acceso de solo lectura para agentes vía MCP. Simplo se encarga de las partes difíciles — asignación de folios, generación del XML, timbre electrónico (TED), firma digital, envío al SII y seguimiento de estado — detrás de una API tipada.

¿Qué es un DTE? (primer de 60 segundos)

En Chile las facturas y boletas no son PDFs que tú diseñas — son DTE (Documentos Tributarios Electrónicos): documentos XML en un formato definido por el SII (Servicio de Impuestos Internos), firmados digitalmente y reportados al SII, que acepta o rechaza cada uno.

Concepto	Qué significa
DTE	Un documento tributario electrónico (factura, boleta, nota de crédito…) — XML, firmado y reportado
SII	La autoridad tributaria chilena que autoriza y valida cada DTE
RUT	El identificador tributario chileno (ej. `76543210-K`) de cada empresa y persona
Folio	El número del documento — pre-autorizado por el SII, no lo eliges tú
CAF	El archivo del SII que autoriza un rango de folios por tipo de documento; se sube una vez

Tipos comunes: 33 factura, 39 boleta, 61 nota de crédito, 52 guía de despacho. Los 12 tipos, sus particularidades y el ciclo de estados: Tipos de DTE.

Cómo se ve

Una llamada HTTP — desde curl, C#, Java, Python o lo que hable JSON:

curl -X POST https://api.simplo.cl/api/v1/billing/dte \
  -H "X-Api-Key: $SIMPLO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "tipo_dte": 33,
    "receptor": { "rut": "76543210-K", "razon_social": "Cliente Ejemplo SpA" },
    "detalle": [{ "nombre": "Servicios de consultoría", "cantidad": 10, "precio": 50000 }]
  }'

// 201 Created
{ "id": "4f9c…", "folio": 1042, "estado": "firmado", "monto_total": 595000 }

En TypeScript, lo mismo es await simplo.dtes.emit({ … }) con el SDK oficial.

Eso es una factura electrónica chilena real: folio asignado, XML construido, firmado digitalmente y en cola hacia el SII — siempre que tu empresa haya completado la configuración inicial (certificado digital + folios).

Antes de emitir en producción

Dos pasos de configuración, una sola vez por empresa:

Certificado digital — se sube a tu cuenta de Simplo. Detalles →
Folios (CAF) — descargas el CAF desde el portal del SII y lo subes a Simplo. Detalles →

Por dónde seguir

Quickstart — emite tu primer DTE en minutos, en curl, C#, Java, Python o TypeScript.
El contrato OpenAPI — descarga la spec y genera un cliente en tu lenguaje.
Referencia por endpoint — los 27 endpoints de la API, navegables.
Autenticación — API keys y su ciclo de vida.
Referencia API — tipos, estados, emisión, webhooks, errores.
Agentes — MCP, coding agents y el SDK.