# Facturia (/docs)

Facturia es una API multiempresa de facturación electrónica chilena (DTE). Haces un `POST` con
un objeto JSON pequeño; nosotros asignamos un folio de un CAF real, armamos y firmamos el XML,
lo transmitimos al SII, lo seguimos hasta un estado terminal, generamos el PDF y te contamos qué
pasó — por polling o por webhooks. También recibimos los DTE de tus proveedores, mantenemos tu
Registro de Compras y Ventas sincronizado, calculamos tu F29 y lo declaramos.

## Tres hechos que explican la forma de la API [#tres-hechos-que-explican-la-forma-de-la-api]

**Multiempresa es la primitiva, no un plan superior.** Una cuenta, una llave, N empresas. Cada
request nombra su empresa con el header `Facturia-Empresa`.

**La emisión es asíncrona en el SII y nunca fingimos lo contrario.** El `POST` responde `201` al
tiro, con `status: queued` y `folio: null`: el folio se asigna cuando el documento llega a `sent`,
y lo sabes por `document.sent` o por el `Facturia-Poll-After` del `GET`. La ida y vuelta al SII es
una máquina de estados que observas, no una espera que te escondemos.

**El sandbox es gratis para siempre y toca el SII cero veces.** Puedes construir la integración
entera antes de tener un certificado.

## URL base [#url-base]

```
https://api.facturia.cl/v1
```

Toda ruta en esta documentación es relativa a esa base. Solo TLS 1.2+. HTTP/2. No hay raíz sin
versionar ni puerto sin cifrar.

## Por dónde empezar [#por-dónde-empezar]

- [Primera factura en 60 segundos](/docs/empezar/quickstart): De una llave `sk_test_` a una boleta emitida en el sandbox, con el ciclo `queued` → `accepted` completo.

- [Conceptos](/docs/empezar/conceptos): Empresa, documento, modo test/live y el header que nombra la empresa. Cuatro ideas y ya entiendes el resto.

- [Autenticación](/docs/autenticacion): Llaves `sk_test_` / `sk_live_`, scopes, lista blanca de empresas y límites de tasa.

- [Referencia de la API](/docs/referencia): Los 99 endpoints de `/v1`, generados desde el OpenAPI 3.1 que publicamos.

## Qué cubre esta documentación [#qué-cubre-esta-documentación]

| Capítulo                             | Qué resuelve                                             |
| ------------------------------------ | -------------------------------------------------------- |
| [Empieza aquí](/docs/empezar)        | Qué es Facturia, la primera emisión y los conceptos base |
| [Autenticación](/docs/autenticacion) | Llaves, scopes, empresas, rotación, límites              |
| [Emisión](/docs/emision)             | Crear DTE, previews, artefactos, estados del SII         |
| [Recepción](/docs/recepcion)         | La casilla de intercambio y la ventana de 8 días         |
| [Impuestos](/docs/impuestos)         | RCV, caracterización, F29 y el tipo 46                   |
| [Webhooks](/docs/webhooks)           | Firma, reintentos, replay y catálogo de eventos          |
| [MCP / IA](/docs/mcp)                | Conectar Claude u otro agente a `mcp.facturia.cl`        |
| [Referencia API](/docs/referencia)   | El contrato endpoint por endpoint                        |
| [Errores](/docs/errores)             | El sobre, los tipos y los códigos de rechazo             |

## Lo que no está en la v1 [#lo-que-no-está-en-la-v1]

Documentos de exportación (110/111/112), liquidación factura (43), boleta de honorarios (es otro
régimen del SII), F29 rectificatorias, F22 y declaraciones juradas, los libros de compra/venta como
recurso (el RCV los reemplazó), facturación multimoneda más allá del camino FX del tipo 46, copias
cedibles fuera del tipo 33, conectores de facturación de Meta y Google Ads, y versiones fechadas de
la API.

El sandbox sigue gratis para siempre. Esta referencia sigue siendo pública y sin autenticación: sin
muro de login, sin PDF detrás de un formulario.