Folios CAF automáticos
Folios CAF que se reponen solos, sin bloquear tu timbraje
autoCaf es parte de SII SDK, una librería TypeScript que corre en tu propio backend: pide los folios al portal del SII con el certificado que ya tienes, sin enviarlo a un tercero. Revisa cuántos te quedan y su vigencia, consulta el tope que autoriza el SII y repone antes de que se agoten, siguiendo el orden que no agrava los bloqueos.
import { autoCaf, llamadasFoliosDeSii } from '@devlas-cl/folios'
const informe = await autoCaf({ clave: { rutEmisor, tipoDte: 39, ambiente: 'produccion' }, almacen, bloqueos, reloj, registro, llamadas: llamadasFoliosDeSii({ portal: configPortal, rutEmpresa: rutEmisor }), gestion: await leerGestion(clave), ultimoFolioEmitido,})// informe.valor.resultado: 'sin_accion' | 'repuesto' | 'precargado'// | 'enfriado' | 'bloqueado' | 'fallido' | 'omitido'Qué resuelve
Lo difícil de los folios no es pedirlos
Es no pedir de más, no repetir un folio, no perder uno en un envío cortado y saber qué hacer cuando el SII se niega.
Reposición a tiempo
Decide con una política (por ejemplo, boletas de a 200 folios con reposición bajo 20) y precarga el siguiente CAF para no quedarte sin folios.
Reobtener antes de anular
Recupera rangos ya autorizados y sin usar sin gastar cupo. La anulación queda como último recurso.
Respeta los bloqueos
Ante un rechazo del SII entra en enfriamiento y no vuelve a golpear el portal en cada llamada. El texto del SII llega literal.
Seguro entre réplicas
Un turno por clave evita que dos procesos pidan a la vez; la reserva de folios es atómica.
Ritmo que el SII tolera
Las llamadas al portal van a un ritmo de una por segundo y con una sola sesión por RUT, para no caer en el bloqueo del firewall ni en el límite de sesiones.
Avisos para el cajero
resumirFoliosCaf devuelve folios libres, días de alcance y vencimiento con un nivel (ok, aviso, crítico) y un mensaje en español.
Medido en el SII
Qué CAF vencen
Medido por Devlas en el ambiente de certificación del SII en octubre de 2026. La librería usa esta regla al calcular el vencimiento que guarda tu almacén.
| Tipo de documento | ¿Vence? |
|---|---|
| 33, 46, 56 y 61 | Sí, a los seis meses de la autorización |
| 34 y 52 | No |
| 39 y 41 (boletas) | No |
Cuánto cuesta
La obtención y reposición automática de folios está en el nivel AutoCAF, que incluye además todos los documentos del nivel Facturas. Sin AutoCAF puedes descargar el CAF a mano del portal y cargarlo en tu almacén.
Los niveles son acumulativos (Libre, Facturas, AutoCAF y Certificador): cada precio es el total, anual y más IVA, y no cambia según cuántos clientes finales atiendas. Ver qué trae cada nivel.
AutoCAF
60 UFal año, más IVA
Todo Facturas, más obtención y reposición automática de folios.
- Pedir CAF por el portal del SII sin pasos manuales.
- Reposición de folios antes de que se agoten, con autoCaf.
- Reobtener un CAF ya autorizado ante un bloqueo de timbraje, antes de anular.
Preguntas
Preguntas frecuentes
¿Qué es un CAF?
El Código de Autorización de Folios es el archivo XML que entrega el SII con un rango de folios de un tipo de documento. Trae la llave privada con la que se firma el timbre de cada documento, por eso es un secreto: si se filtra no se puede revocar.
¿Los CAF vencen?
Depende del tipo. En mediciones de Devlas en el ambiente de certificación del SII, los CAF de 33, 46, 56 y 61 vencen a los seis meses de su autorización y los de 34, 39, 41 y 52 no vencen. La librería aplica esa regla por tipo.
¿Qué hace ante un bloqueo de timbraje del SII?
Devuelve el resultado bloqueado con el texto literal del SII y entra en enfriamiento para no insistir. El orden de remedios es usar los folios en mano, reobtener folios ya autorizados sin usar, pedir en tandas y dejar la anulación como último recurso, porque anular es irreversible.
¿autoCaf anula folios por su cuenta?
No en producción: la política por defecto solo anula en el ambiente de certificación. Anular folios en producción queda como una decisión tuya, con las funciones de anulación del paquete.
¿Funciona con varias réplicas de mi servidor?
Sí. autoCaf toma un turno por RUT, tipo y ambiente con tu implementación de Bloqueos, así que dos réplicas no piden folios a la vez, y la reserva de folios del almacén es atómica.
¿Qué pasa con autoCaf si no renuevo la licencia?
AutoCAF funciona solo con licencia vigente: requiere licencia vigente (la verificación con llave firmada, sin conexión ni consultas a servidores de Devlas, llega en una próxima versión). Al vencer sin renovar hay 14 días de gracia con aviso; después, la obtención automática de folios se detiene. Sigues emitiendo con la última versión que recibiste, los CAF que ya tienes siguen sirviendo y puedes pedir folios por los medios del SII.
En la documentación
SII SDK es un producto de Devlas SpA. No es un producto del Servicio de Impuestos Internos, no está afiliado a él ni cuenta con su aval. Las cifras y comportamientos del SII que se citan fueron medidos por Devlas en el ambiente de certificación salvo que se indique otra cosa.