Folios

Los folios son números autorizados por el SII para emitir documentos tributarios. Antes de emitir cualquier DTE, necesitas solicitar folios para ese tipo de documento.

Solicitar folios

curl -X POST https://api.example.com/api/v1/tenants/{tenantId}/folios/request \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"tipoDte": 33, "cantidad": 50}'

await fetch(
  `https://api.example.com/api/v1/tenants/${tenantId}/folios/request`,
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer sk_live_...',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ tipoDte: 33, cantidad: 50 }),
  }
)

Parámetro	Tipo	Descripción
`tipoDte`	`integer`	Código del tipo de DTE (ver tipos de DTE)
`cantidad`	`integer`	Cantidad de folios a solicitar (1-100)

Consultar inventario

curl https://api.example.com/api/v1/tenants/{tenantId}/folios \
  -H "Authorization: Bearer sk_live_..."

Respuesta:

[
  {
    "tipoDte": 33,
    "total": 500,
    "disponibles": 350,
    "estado": "activo",
    "porcentaje": 70
  },
  {
    "tipoDte": 61,
    "total": 100,
    "disponibles": 5,
    "estado": "activo",
    "porcentaje": 5
  }
]

Anular folios

Si necesitas anular un rango de folios no utilizados:

curl -X POST https://api.example.com/api/v1/tenants/{tenantId}/folios/void \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"tipoDte": 33, "desde": 100, "hasta": 150}'

Configura un webhook folio.low para recibir alertas cuando los folios estén por agotarse. Así puedes solicitar más automáticamente.

Cuánto demora, y por qué falla a veces

Solicitar folios demora entre 40 y 80 segundos. No es lentitud nuestra: el proveedor va al sitio del SII a pedirlos, y lo hace con un navegador automatizado. Por eso mismo, la operación falla de forma intermitente. Cuando pasa, el error viene del lado del SII o del navegador del proveedor, no de una validación:

timeout: Timed out receiving message from renderer

Reintentá. Un fallo de folios no significa que algo esté mal configurado: verificado el 2026-08-11, dos intentos seguidos fallaron con ese timeout y el tercero funcionó sin cambiar nada. El timeout del cliente está en 150 segundos para dejar margen.

Consultar cuántos folios hay disponibles es más rápido (~14s medidos) y no consume folios, así que sirve para verificar la configuración antes de pedir un CAF:

curl https://api.example.com/api/v1/tenants/{tenantId}/folios/disponibles?tipoDte=33 \
  -H "Authorization: Bearer sk_live_..."

Si eso responde, el certificado está autorizado para operar sobre ese RUT de empresa ante el SII. Si no, el problema es de autorización y no de folios.

Empezar

Flujos principales

Referencia

Solicitar folios

Consultar inventario

Anular folios

Cuánto demora, y por qué falla a veces

​Solicitar folios

​Consultar inventario

​Anular folios

​Cuánto demora, y por qué falla a veces

Solicitar folios

Consultar inventario

Anular folios

Cuánto demora, y por qué falla a veces