Listar BHE emitidas por periodo

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

Listar boletas de honorarios electronicas emitidas en un periodo.

Obtiene el listado de BHE emitidas por el contribuyente autenticado en el periodo indicado. El nivel de agregacion depende del formato del periodo: anual entrega resumenes por mes, mensual/diario entrega boletas individuales.

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

• credenciales SII del emisor en el body (auth.pass.rut / auth.pass.clave). El RUT emisor se deriva de las credenciales, nunca del path (previene IDOR).

Quota: Consume 1 consulta | Peso: 2x (listado con paginacion server-side)

Parametros de ruta

Parametros de consulta

Body (JSON)

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

Respuesta exitosa - periodo mensual/diario (200)

{
    "success": true,
    "data": [
        {
            "codigo": "123456",
            "folio": 1234,
            "fecha": "2026-01-15",
            "receptor_rut": "12.345.678-9",
            "receptor_nombre": "NOMBRE EJEMPLO",
            "monto_bruto": 119000,
            "retencion": 15827,
            "monto_liquido": 103173,
            "estado": "vigente"
        }
    ],
    "total": 1,
    "n_boletas": 1,
    "pagina_sig_codigo": null,
    "message": null
}

Respuesta exitosa - periodo anual (200)

Retorna BHEResumenAnual con montos agregados por mes:

{
    "success": true,
    "data": [
        {"mes": 1, "cantidad": 5, "monto_total": 500000},
        {"mes": 2, "cantidad": 8, "monto_total": 820000}
    ],
    "total": 12,
    "message": null
}

Si el contribuyente no registra boletas, data es [] y message indica la ausencia.

Errores especificos

Paginacion BHE

El response incluye n_boletas (total histórico) y pagina_sig_codigo (código opaco para la siguiente página). Cuando pagina_sig_codigo es null o 00000000000000, no hay mas paginas.

Notas

• El RUT emisor es el que autentica — no se puede consultar BHE de otro contribuyente via este endpoint.
• Los montos estan en CLP, enteros.
• csv retorna el formato raw del SII (ISO-8859-1), util para importar en Excel.

Parámetros

Cuerpo de la solicitud

Requerido. Content-Type: application/json.

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

Respuestas

Forma de la respuesta

Código 200. Estructura del JSON devuelto.

{
  "data": [],
  "message": "string",
  "n_boletas": 0,
  "pagina_sig_codigo": "string",
  "paginacion": {
    "pagina_actual": 0,
    "pagina_sig_codigo": "string",
    "pagina_siguiente": 0,
    "total_registros": 0
  },
  "success": true,
  "total": 0
}