Solicitar folios CAF

POST/api/v1/sii/dte/caf/solicitar/{emisor}/{dte}/{cantidad}v1 · ESTABLE

POST /api/v1/sii/dte/caf/solicitar/{emisor}/{dte}/{cantidad}

import requests
 
headers = {
    "X-API-Token": "sk_live_replace_with_your_token",
}
 
response = requests.post(
    "https://api.fiscalbridge.cl/api/v1/sii/dte/caf/solicitar/:emisor/:dte/:cantidad",
    headers=headers,
)
response.raise_for_status()
print(response.json())

Solicitar folios CAF (Codigo de Asignacion de Folios) al SII.

El SII asigna un rango de folios autorizados que deben usarse para emitir documentos tributarios electronicos (DTE) del tipo indicado. El CAF contiene la firma electronica que valida cada folio ante el SII al momento de emitir.

Autenticacion requerida: API token en header X-API-Token con scope sii:write

certificado digital del emisor en el body bajo auth.cert.*: PEM (cert-data + pkey-data + passphrase opcional) o PFX (pfx-data + passphrase).

Quota: Consume 1 consulta | Peso: 5x (operacion critica de escritura)

Parametros de ruta

Parametro	Tipo	Requerido	Descripcion
`emisor`	string	Si	RUT del emisor (`XXXXXXXX-K`)
`dte`	integer	Si	Tipo DTE: `33`/`34` factura, `39`/`41` boleta, `52` guia, `56`/`61` notas
`cantidad`	integer	Si	Cantidad de folios a solicitar

Parametros de consulta

Parametro	Tipo	Default	Descripcion
`ambiente`	string	`0`	`0` produccion, `1` certificacion

Respuesta exitosa (200)

{
    "success": true,
    "message": "Solicitud CAF generada exitosamente",
    "data": {
        "folio_inicial": 1,
        "folio_final": 100,
        "fecha_autorizacion": "2026-01-15",
        "cantidad": 100
    }
}

Errores especificos

Codigo	error_code	Causa	Resolucion
400	`AUTH_ERROR`	Certificado SII invalido o expirado	Renovar certificado digital
400	`VALIDATION_ERROR`	Tipo DTE invalido o cantidad fuera de rango	Usar tipo y cantidad permitidos
401	`HTTP_401`	API token ausente o invalido	Enviar `X-API-Token` valido
403	`INSUFFICIENT_SCOPE`	Token sin scope `sii:write`	Generar token con scope adecuado
422	`VALIDATION_ERROR`	Body con formato invalido	Revisar `errors[]`
429	`SII_RATE_LIMIT` / `QUOTA_EXCEEDED`	Rate limit	Respetar `Retry-After`
502	`SII_GATEWAY_ERROR`	SII rechazo la solicitud	Revisar `details`

Notas

Los folios se asignan en rangos contiguos; el CAF debe guardarse para emitir documentos.
El SII impone limites diarios/mensuales segun el tipo de DTE y el historial del contribuyente.

Parámetros

Header / Body

Tipo

Descripción

Requerido

cantidad

integer · path

—

Sí

dte

integer · path

—

Sí

emisor

string · path

—

Sí

ambiente

string · query

`0` produccion, `1` certificacion

dry_run

string | null · query

Si es `true` (o `1`/`yes`/`on`), el endpoint valida el payload y retorna una respuesta de previsualización (mismo shape que la respuesta real) sin contactar al SII. Útil para validar requests sin consumir folios, cuota ni créditos.

Cuerpo de la solicitud

Requerido. Content-Type: application/json.

{
  "auth": {
    "cert": {
      "cert-data": "LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0t...",
      "passphrase": "mi_passphrase_segura",
      "pkey-data": "LS0tLS1CRUdJTiBSU0EgUFJJVkFURSBLRVkt..."
    }
  }
}

Respuestas

200Successful Response

400Emisor/tipo DTE/cantidad invalidos o credenciales SII incorrectas

401API token ausente o invalido

403Sin scope `sii:write` o cuenta bloqueada

422Body con formato invalido

429Limite de tasa excedido

502Error en servicio SII upstream

503SII en mantenimiento

Forma de la respuesta

Código 200. Estructura del JSON devuelto.

{
  "data": {
    "razon_social": "Empresa S.A.",
    "rut": "12.345.678-9"
  },
  "message": "Operación completada exitosamente",
  "success": true,
  "timestamp": "2025-12-01T12:00:00Z"
}

On this page