SIIBTE

Obtener HTML de BTE emitida

Obtener representacion HTML de una BTE emitida.

POST /api/v1/sii/bte/emitidas/html/{codigo}
import requests
 
headers = {
    "X-API-Token": "sk_live_replace_with_your_token",
}
 
response = requests.post(
    "https://api.fiscalbridge.cl/api/v1/sii/bte/emitidas/html/:codigo",
    headers=headers,
)
response.raise_for_status()
print(response.json())

Obtener representacion HTML de una BTE emitida.

Devuelve la representacion HTML impresa (misma vista que el SII entrega en su portal) de la boleta identificada por 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

ParametroTipoRequeridoDescripcion
codigostringSiCodigo unico del documento BTE (del listado emitidas)

Body (JSON)

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

Respuesta exitosa (200)

Retorna HTML raw del SII con Content-Type: text/html. No es JSON.

Ejemplo en Python:

response = requests.post(url, headers={"X-API-Token": "..."}, json={"auth": {...}})
with open("bte.html", "w", encoding="utf-8") as f:
    f.write(response.text)

Errores especificos

Codigoerror_codeCausaResolucion
400AUTH_ERRORCredenciales SII incorrectasRevisar RUT/clave
401HTTP_401API token ausente o invalidoEnviar X-API-Token valido
404HTTP_404Codigo BTE no existe en el SIIVerificar con /emitidas/documentos
422VALIDATION_ERRORBody con formato invalidoRevisar errors[]
429SII_RATE_LIMIT / QUOTA_EXCEEDEDRate limitRespetar Retry-After
502SII_GATEWAY_ERRORSII no pudo generar el HTMLReintentar
503SII_UNAVAILABLESII en mantenimientoReintentar en 5 min

Notas

  • El HTML es generado on-demand por el SII; puede tardar 2-5 seg.
  • Solo descarga BTE propias (emitidas bajo el RUT autenticado).
  • Para version imprimible en PDF, renderizar el HTML con una libreria como weasyprint.

Parámetros

Header / Body
Tipo
Descripción
Requerido
codigo
string · path
Codigo unico del documento BTE (obtenido de `/emitidas/documentos`)

Cuerpo de la solicitud

Requerido. Content-Type: application/json.

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

Respuestas

200HTML del documento BTE
400Codigo invalido o credenciales SII incorrectas
401API token ausente o invalido
403Sin scope `sii:read` o cuenta bloqueada
404BTE no encontrada
422Body con formato invalido
429Limite de tasa excedido
502Error en servicio SII upstream
503SII en mantenimiento

Ejemplo de respuesta

Código 200.

null

On this page