Saltar al contenido

API de folios y CAF del SII

Un CAF (Código de Autorización de Folios) es el archivo XML con que el SII autoriza a una empresa a usar un rango de folios de un tipo de documento.

Pide, recupera, controla y anula los folios de cada empresa que enrolas, con su propio certificado.

Ver la guía de foliosHablar con el equipo
caf_v1_listar 
$ API=https://api.enrolamiento.cl/v1/caf
$ curl -X POST -u '<usuario>:<apikey>' \
    --url-query ambiente=0 \
    "$API/11111111-1/listar/33"

200 OK

{ "Cafs": [ {
  "FolioInicial": 1001,
  "FolioFinal": 1100,
  "Cantidad": 100,
  "Fecha": "06-10-2026",
  "RUTDueno": "11111111-1",
  "Dueno": "Empresa de ejemplo"
} ] }
Datos de ejemplo, en certificación.

¿Qué puedes hacer con los folios de una empresa?

Todo el ciclo de un folio, del pedido al SII a la anulación.

  1. 01

    Pedir

    Un CAF nuevo para un tipo de documento. Cada llamada timbra folios: ante un error dudoso, revisa con reobtener sin folioInicial antes de volver a pedir.

  2. 02

    Recuperar

    Vuelve a bajar un CAF ya timbrado sin gastar folios, o mira cuáles tiene autorizados la empresa.

  3. 03

    Controlar

    Cuántos folios de un rango quedan, cuántos se usaron y cuál fue el último emitido.

  4. 04

    Anular

    Los folios que no vas a usar, por rango o en forma masiva. No se puede deshacer.

ambiente: 0 certificación · 1 producción. Pásalo siempre: si lo omites, la operación corre en producción.

Hecho para no perder folios.

  • Errores con código. Cada uno dice qué pasó y si conviene reintentar, también cuando el SII responde una página de error. Errores y reintentos
  • Sin doble timbraje. Con el control de pedidos concurrentes, los CAF de una misma empresa, tipo y ambiente se piden de a uno. Cómo funciona
  • Permisos del certificado. Valídalos antes de operar; si el titular no puede operar con folios, la respuesta es CERT_SIN_PERMISO. Validar un certificado
caf_v1_descargar · pedido en curso 
HTTP/1.1 429 Too Many Requests
Retry-After: 30

CAF_REQUEST_IN_PROGRESS:Ya existe una
solicitud de folios en curso para
este RUT y tipo de documento.
Datos de ejemplo. El segundo pedido no se ejecutó: espera y revisa.