# Folios y CAF

> Qué es un CAF, cómo se suben los folios autorizados por el SII a la API de Simplo y cómo evitar quedarte sin folios.

Los folios no los inventas tú ni Simplo — el SII pre-autoriza rangos por tipo
de documento mediante archivos **CAF** (Código de Autorización de Folios) que
descargas desde el portal del SII y subes una vez a Simplo.

## Endpoints

| Método | Path                  | Descripción                                                     |
| ------ | --------------------- | --------------------------------------------------------------- |
| `GET`  | `/api/v1/billing/caf` | Listar los rangos de folios (CAF) cargados y su disponibilidad. |
| `POST` | `/api/v1/billing/caf` | Subir un archivo CAF descargado del SII.                        |

## Con el SDK

```ts
await simplo.folios.upload({ tipo_dte: 33, caf_xml: cafFileContents });

const cafs = await simplo.folios.list({ tipo_dte: 33, is_active: true });
console.log(cafs[0].folios_disponibles); // ej. quedan 158
```

Simplo asigna el siguiente folio automáticamente en cada `emit`. Vigila
`folios_disponibles` (o el evento de webhook `caf.low_stock`) y sube un CAF
nuevo antes de quedarte sin folios — la emisión falla sin folios disponibles.

Subir un CAF duplicado es seguro: devuelve un `ConflictError`, nunca duplica
el rango.

`folios.list()` devuelve un array plano (sin paginación): una empresa maneja
un puñado de CAFs por naturaleza.

## Relacionado

- [Emisión](/referencia/emision/) — cómo se consumen los folios
- [Webhooks](/referencia/webhooks/) — el evento `caf.low_stock`
- [Certificado digital](/referencia/certificado-digital/) — el otro requisito
  de configuración inicial

---

Versión HTML: https://docs.simplo.cl/referencia/folios-caf/ · Índice para agentes: https://docs.simplo.cl/llms.txt