Folios y CAF

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. Ver el informativo oficial del SII sobre timbraje electrónico para el detalle normativo, y Facturación electrónica en Chile para el resto de los conceptos (certificado, certificación, ambientes).

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.

Estos endpoints son solo-sesión (JWT de tu cuenta): una API key billing:dte no puede llamarlos (403 BILLING_API_KEY_ROUTE_NOT_ALLOWED). Los folios se administran desde tu cuenta en app.simplo.cl; tu integración solo emite. En el sandbox no hay nada que subir: los folios sintéticos se aprovisionan solos al crear tu key.

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 desde tu cuenta (el evento de webhook caf.low_stock existe en el contrato, pero la entrega de webhooks aún no está activa) 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
• Facturación electrónica en Chile — el CAF en contexto, con las fuentes oficiales del SII