# 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.

> **Empieza hoy, en sandbox:**
> Cualquier cuenta emite hoy mismo en el **sandbox**: crea tu API key
> `sk_simplo_sandbox_` en app.simplo.cl → Desarrolladores (self-serve) y sigue
> el [Quickstart](/comienza/quickstart/) — sin certificado, sin folios, sin
> pedir acceso. Emitir en **producción** (documentos con validez tributaria)
> se habilita por empresa — ver
> [Pasar a producción](/comienza/pasar-a-produccion/).

## ¿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-3`) 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/).

Más sobre los fundamentos — certificado digital, CAF, el proceso de
certificación del SII y los ambientes de certificación vs. producción — en
[Facturación electrónica en Chile](/referencia/facturacion-electronica/).

## 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-3", "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: folio asignado, XML construido,
firmado digitalmente y en cola hacia el SII (real o simulado, según tu key).
En el sandbox funciona de inmediato; en producción, una vez completada la
configuración inicial (certificado digital + folios).

## Antes de emitir en producción

Dos pasos de configuración, una sola vez por empresa (en el **sandbox**
ninguno aplica — certificado y folios sintéticos vienen listos):

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