Descargar PDF de BHE emitida

POST/api/v1/sii/bhe/emitidas/pdf/{codigo}v1 · ESTABLE

POST /api/v1/sii/bhe/emitidas/pdf/{codigo}

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

Descargar PDF de una boleta de honorarios electronica emitida.

Devuelve el archivo PDF binario de la BHE 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

Parametro	Tipo	Requerido	Descripcion
`codigo`	string	Si	Codigo unico del documento BHE (del listado emitidas)

Body (JSON)

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

Respuesta exitosa (200)

Stream binario con Content-Type: application/pdf. No retorna JSON — el cliente debe guardar el contenido en un archivo .pdf.

Ejemplo en Python:

response = requests.post(url, headers={"X-API-Token": "..."}, json={"auth": {...}})
with open("bhe.pdf", "wb") as f:
    f.write(response.content)

Errores especificos

Codigo	error_code	Causa	Resolucion
400	`AUTH_ERROR`	Credenciales SII incorrectas	Revisar RUT/clave
401	`HTTP_401`	API token ausente o invalido	Enviar `X-API-Token` valido
404	`HTTP_404`	Codigo BHE no existe en el SII	Verificar codigo con `/emitidas/documentos`
429	`SII_RATE_LIMIT`	Rate limit del SII	Respetar `Retry-After`
502	`SII_GATEWAY_ERROR`	SII no pudo generar el PDF	Reintentar
503	`SII_UNAVAILABLE`	SII en mantenimiento	Reintentar en 5 min

Notas

El PDF es generado on-demand por el SII; puede tardar 2-5 seg.
Solo descarga BHE propias (emitidas bajo el RUT autenticado).

Parámetros

Header / Body

Tipo

Descripción

Requerido

codigo

string · path

Codigo unico del documento BHE (obtenido de `/emitidas/documentos`)

Sí

Cuerpo de la solicitud

Requerido. Content-Type: application/json.

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

Respuestas

200PDF binario (`application/pdf`)

400Codigo invalido o credenciales SII incorrectas

401API token ausente o invalido

403Sin permisos o cuenta bloqueada

404BHE 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