# 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](/referencia/contrato-openapi/) desde el que puedes generar
un cliente en tu lenguaje. La complementan un SDK TypeScript oficial
([`@simplohq/sdk`](https://github.com/SimploHQ/simplo-node-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.

> **Beta privada:**
> La API de Simplo está en **beta privada**: la autenticación es por API key, y
> el acceso a la superficie de emisión se habilita cuenta por cuenta durante el
> rollout. Para pedir acceso, escribe a
> [hola@simplo.cl](mailto:hola@simplo.cl).

## ¿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](/referencia/tipos-de-dte/).

## Cómo se ve

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

```bash
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 }]
  }'
```

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

En TypeScript, lo mismo es `await simplo.dtes.emit({ … })` con el
[SDK oficial](/agentes/sdk/).

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:

1. **Certificado digital** — se sube a tu cuenta de Simplo.
   [Detalles →](/referencia/certificado-digital/)
2. **Folios (CAF)** — descargas el CAF desde el portal del SII y lo subes a
   Simplo. [Detalles →](/referencia/folios-caf/)

## Por dónde seguir

- [Quickstart](/comienza/quickstart/) — emite tu primer DTE en minutos, en
  curl, C#, Java, Python o TypeScript.
- [El contrato OpenAPI](/referencia/contrato-openapi/) — descarga la spec y
  genera un cliente en tu lenguaje.
- [Referencia por endpoint](/api/) — los 27 endpoints de la API, navegables.
- [Autenticación](/comienza/autenticacion/) — API keys y su ciclo de vida.
- [Referencia API](/referencia/tipos-de-dte/) — tipos, estados, emisión,
  webhooks, errores.
- [Agentes](/agentes/conecta-tu-agente/) — MCP, coding agents y el SDK.

---

Versión HTML: https://docs.simplo.cl/comienza/introduccion/ · Índice para agentes: https://docs.simplo.cl/llms.txt