Consultar estados de folios por rango

POST/api/v1/sii/dte/caf/estados/{emisor}/{dte}/{folio_inicial}/{folio_final}/{estado}v1 · ESTABLE

POST /api/v1/sii/dte/caf/estados/{emisor}/{dte}/{folio_inicial}/{folio_final}/{estado}

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

Consultar estados de folios en un rango especifico.

Retorna la lista de folios del rango consultado que coinciden con el estado indicado. Util para auditoria y control de folios emitidos vs disponibles vs anulados.

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
`estado`	string	Si	Filtro: `disponible`, `utilizado`, `anulado`

Parametros de consulta

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

Respuesta exitosa (200)

Lista de CAFEstadoFolio:

{
    "success": true,
    "message": "Estados de folios obtenidos exitosamente",
    "data": [
        {
            "folio": 1,
            "estado": "utilizado",
            "fecha_uso": "2026-01-16"
        },
        {
            "folio": 2,
            "estado": "utilizado",
            "fecha_uso": "2026-01-17"
        }
    ]
}

Errores especificos

Codigo	error_code	Causa	Resolucion
400	`AUTH_ERROR`	Certificado SII invalido	Renovar certificado
400	`VALIDATION_ERROR`	Estado invalido	Usar `disponible`, `utilizado` o `anulado`
401	`HTTP_401`	API token ausente o invalido	Enviar `X-API-Token` valido
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

Parámetros

Header / Body

Tipo

Descripción

Requerido

dte

integer · path

Tipo DTE

Sí

emisor

string · path

RUT del emisor

Sí

estado

string · path

Estado a filtrar: `disponible`, `utilizado`, `anulado`

Sí

folio_final

integer · path

Ultimo folio del rango

Sí

folio_inicial

integer · path

Primer folio del rango

Sí

ambiente

string · query

`0` produccion, `1` certificacion

Cuerpo de la solicitud

Requerido. Content-Type: application/json.

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

Respuestas

200Successful Response

400Parametros invalidos o credenciales SII incorrectas

401API token ausente o invalido

403Sin scope `sii:read` 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"
}

Consultar estados de folios por rango

On this page