Obtener detalle de BTE emitida por folio

POST/api/v1/sii/bte/emitidas/documento/{folio}v1 · ESTABLE

POST /api/v1/sii/bte/emitidas/documento/{folio}

import requests
 
headers = {
    "X-API-Token": "sk_live_replace_with_your_token",
}
 
response = requests.post(
    "https://api.fiscalbridge.cl/api/v1/sii/bte/emitidas/documento/1234?periodo=202601",
    headers=headers,
)
response.raise_for_status()
print(response.json())

Obtener detalle completo de una BTE emitida por folio.

Consulta el SII para el periodo indicado (o mes actual si se omite), busca el documento con el folio solicitado y retorna sus datos completos (estado, fechas, receptor, montos, codigo). El RUT emisor se deriva de las credenciales auth, nunca del path.

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

credenciales SII del emisor en el body.

Quota: Consume 1 consulta | Peso: 2x

Parametros de ruta

Parametro	Tipo	Requerido	Descripcion
`folio`	integer	Si	Numero de folio de la BTE

Parametros de consulta

Parametro	Tipo	Default	Descripcion
`periodo`	string	mes actual	`YYYYMM` en el que buscar el folio

Body (JSON)

{
    "auth": {
        "pass": {"rut": "76.XXX.XXX-K", "clave": "clave_tributaria"}
    }
}

Respuesta exitosa (200)

{
    "numero": 1234,
    "estado": "VIGENTE",
    "fecha_emision": "15-01-2026",
    "emisor_rut": "76.XXX.XXX-K",
    "emisor_nombre": "EMPRESA EJEMPLO SPA",
    "fecha_recepcion": "15-01-2026",
    "receptor_rut": "12.345.678-9",
    "receptor_nombre": "Receptor Ejemplo",
    "bruto": 119000,
    "retencion": 15827,
    "total": 103173,
    "codigo": "ABC123"
}

Errores especificos

Codigo	error_code	Causa	Resolucion
400	`AUTH_ERROR`	Credenciales SII incorrectas	Revisar RUT/clave
400	`VALIDATION_ERROR`	Periodo con formato invalido	Usar `YYYYMM`
401	`HTTP_401`	API token ausente o invalido	Enviar `X-API-Token` valido
404	`HTTP_404`	Folio no existe en el periodo consultado	Ajustar `periodo` o revisar folio
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 retorno error	Reintentar
503	`SII_UNAVAILABLE`	SII en mantenimiento	Reintentar en 5 min

Notas

El endpoint busca el folio dentro del listado mensual; si el folio es de otro mes, pasar periodo.
El codigo retornado puede usarse en /emitidas/html/{codigo} para obtener el HTML impreso.

Parámetros

Header / Body

Tipo

Descripción

Requerido

folio

integer · path

Numero de folio de la BTE

Sí

periodo

string | null · query

Periodo `YYYYMM` (opcional, default: mes actual)

Cuerpo de la solicitud

Requerido. Content-Type: application/json.

{
  "auth": {
    "pass": {
      "clave": "string",
      "rut": "string"
    }
  }
}

Respuestas

200Successful Response

400Folio/periodo invalido o credenciales SII incorrectas

401API token ausente o invalido

403Sin scope `sii:read` o cuenta bloqueada

404Folio no encontrado en el periodo

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.

{
  "bruto": 0,
  "codigo": "",
  "emisor_nombre": "",
  "emisor_rut": "",
  "estado": "",
  "fecha_emision": "",
  "fecha_recepcion": "",
  "numero": 0,
  "receptor_nombre": "string",
  "receptor_rut": "string",
  "retencion": 0,
  "total": 0
}

Obtener detalle de BTE emitida por folio

On this page