Descargar archivo CAF autorizado

POST/api/v1/sii/dte/descargar/caf/{emisor}/{dte}/{folio_inicial}/{folio_final}/{fecha_autorizacion}v1 · ESTABLE

POST /api/v1/sii/dte/descargar/caf/{emisor}/{dte}/{folio_inicial}/{folio_final}/{fecha_autorizacion}

import requests
 
headers = {
    "X-API-Token": "sk_live_replace_with_your_token",
}
 
response = requests.post(
    "https://api.fiscalbridge.cl/api/v1/sii/dte/descargar/caf/76192083-9/33/1/100/2026-01-15",
    headers=headers,
)
response.raise_for_status()
print(response.json())

Descargar archivo XML del CAF autorizado.

Descarga el archivo CAF (Codigo de Asignacion de Folios) previamente autorizado por el SII para un rango de folios. El archivo contiene la firma electronica que valida cada folio al emitir DTE.

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

certificado digital del emisor en el body.

Quota: Consume 1 consulta | Peso: 2x

Parametros de ruta

Parametro	Tipo	Requerido	Descripcion
`emisor`	string	Si	RUT del emisor
`dte`	integer	Si	Tipo DTE
`folio_inicial`	integer	Si	Primer folio del rango
`folio_final`	integer	Si	Ultimo folio del rango
`fecha_autorizacion`	string	Si	Fecha autorizacion `AAAA-MM-DD`

Parametros de consulta

Parametro	Tipo	Default	Descripcion
`ambiente`	string	`0`	`0` produccion, `1` certificacion
`formato`	string	`base64`	`base64` (JSON con metadata) o `xml` (passthrough binario)

Respuesta exitosa - formato base64 (200)

{
    "filename": "CAF_76192083-9_33_1-100.xml",
    "contentType": "application/xml",
    "sizeBytes": 4521,
    "contentBase64": "PD94bWwgdmVyc2lvbj0iMS4w..."
}

Respuesta exitosa - formato xml (200)

XML binario con Content-Type: application/xml y Content-Disposition: attachment; filename=CAF_*.xml.

Errores especificos

Codigo	error_code	Causa	Resolucion
400	`AUTH_ERROR`	Certificado SII invalido	Renovar certificado
400	`VALIDATION_ERROR`	Fecha con formato invalido	Usar `AAAA-MM-DD`
401	`HTTP_401`	API token ausente o invalido	Enviar `X-API-Token` valido
404	`HTTP_404`	CAF no existe para el rango/fecha	Verificar datos en `/caf/solicitudes`
429	`SII_RATE_LIMIT` / `QUOTA_EXCEEDED`	Rate limit	Respetar `Retry-After`
502	`SII_GATEWAY_ERROR`	SII retorno error	Reintentar
503	`SII_UNAVAILABLE`	SII en mantenimiento	Reintentar en 5 min

Notas

El CAF es necesario para emitir DTE con folios autorizados.
Guarde el XML en almacenamiento seguro: contiene la firma electronica.

Parámetros

Header / Body

Tipo

Descripción

Requerido

dte

integer · path

Tipo DTE

Sí

emisor

string · path

RUT del emisor

Sí

fecha_autorizacion

string · path

Fecha autorizacion `AAAA-MM-DD`

Sí

folio_final

integer · path

Folio final del rango

Sí

folio_inicial

integer · path

Folio inicial del rango

Sí

ambiente

string · query

`0` produccion, `1` certificacion

formato

any · query

`base64` (default, JSON) o `xml` (binary XML passthrough)

Cuerpo de la solicitud

Requerido. Content-Type: application/json.

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

Respuestas

200CAF. Por defecto (`formato=base64`) JSON con `FileBase64Response`. Con `formato=xml` XML binario.

400Parametros invalidos o credenciales SII incorrectas

401API token ausente o invalido

403Sin scope `sii:read` o cuenta bloqueada

404CAF no encontrado para el rango solicitado

422Body con formato invalido

429Limite de tasa excedido

502Error en servicio SII upstream

503SII en mantenimiento

Descargar archivo CAF autorizado

On this page