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

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 — cómo se consumen los folios
Webhooks — el evento caf.low_stock
Certificado digital — el otro requisito de configuración inicial