Consultar estado de un folio

POST/api/v1/sii/dte/caf/estado/{emisor}/{dte}/{folio}v1 · ESTABLE

POST /api/v1/sii/dte/caf/estado/{emisor}/{dte}/{folio}

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

Consultar estado de un folio ante el SII.

Retorna si el folio esta disponible, utilizado, anulado o vencido, junto con metadata del CAF al que pertenece.

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`	integer	Si	Numero de folio a consultar

Parametros de consulta

Parametro	Tipo	Default	Descripcion
`ambiente`	string	`0`	`0` produccion, `1` certificacion
`formato`	string	`json`	`json` (default) o `html`

Respuesta exitosa (200)

{
    "success": true,
    "message": "Estado del folio consultado exitosamente",
    "data": {
        "folio": 1234,
        "estado": "utilizado",
        "fecha_autorizacion": "2026-01-15",
        "fecha_uso": "2026-01-20"
    }
}

Errores especificos

Codigo	error_code	Causa	Resolucion
400	`AUTH_ERROR`	Certificado SII invalido	Renovar certificado
401	`HTTP_401`	API token ausente o invalido	Enviar `X-API-Token` valido
404	`HTTP_404`	Folio no existe	Verificar folio
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í

folio

integer · path

Numero de folio

Sí

ambiente

string · query

`0` produccion, `1` certificacion

formato

string · query

`json` (default) o `html`

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

404Folio no encontrado

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