Listar BHE recibidas por periodo

POST/api/v1/sii/bhe/recibidas/documentos/{periodo}v1 · ESTABLE

POST /api/v1/sii/bhe/recibidas/documentos/{periodo}

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

Listar boletas de honorarios electronicas recibidas en un periodo.

Obtiene el listado de BHE recibidas por el contribuyente autenticado en el periodo indicado. El RUT receptor se deriva de las credenciales auth, nunca del path (previene IDOR).

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

credenciales SII del receptor en el body.

Quota: Consume 1 consulta | Peso: 2x

Parametros de ruta

Parametro	Tipo	Requerido	Descripcion
`periodo`	string	Si	`YYYY`, `YYYYMM` o `YYYYMMDD`

Parametros de consulta

Parametro	Tipo	Default	Descripcion
`formato`	string	`json`	`json` (estructurado) o `csv` (raw del SII)
`csv_delimiter`	string	`;`	Delimitador CSV
`pagina`	integer	—	Numero de pagina (1-indexed), para mensual/diario
`pagina_sig_codigo`	string	—	Cursor opaco del response anterior; `00000000000000` = ultima pagina

Respuesta exitosa (200)

{
    "success": true,
    "data": [
        {
            "codigo": "123456",
            "folio": 1234,
            "fecha": "2026-01-15",
            "emisor_rut": "12.345.678-9",
            "emisor_nombre": "EMISOR EJEMPLO",
            "emisor_comuna": "SANTIAGO",
            "monto_bruto": 119000,
            "estado": "N"
        }
    ],
    "total": 1,
    "n_boletas": 10,
    "pagina_sig_codigo": "00000000000002",
    "message": null
}

Nota: en periodo=YYYYMMDD el SII NO entrega el RUT del emisor (solo nombre). En periodo=YYYY se retornan resumenes agregados por mes (no boletas individuales).

Valores de `estado`

Codigo	Descripcion
`N`	Vigente
`S`	Anulada
`V`	Anulacion pendiente
`R`	Observada
`U`	Observada por SII

Errores especificos

Codigo	error_code	Causa	Resolucion
400	`AUTH_ERROR`	Credenciales SII incorrectas	Revisar RUT/clave
400	`VALIDATION_ERROR`	Periodo mal formado	Usar `YYYY`/`YYYYMM`/`YYYYMMDD`
401	`HTTP_401`	API token ausente o invalido	Enviar `X-API-Token` valido
429	`SII_RATE_LIMIT`	Rate limit	Respetar `Retry-After`
502	`SII_GATEWAY_ERROR`	Error del SII	Reintentar
503	`SII_UNAVAILABLE`	SII en mantenimiento	Reintentar en 5 min

Notas

La retencion del emisor solo esta disponible en consulta diaria.
Para paginacion: primera llamada sin pagina; siguientes con pagina + pagina_sig_codigo del response previo.

Parámetros

Header / Body

Tipo

Descripción

Requerido

periodo

string · path

Periodo: `YYYY` (anual), `YYYYMM` (mensual) o `YYYYMMDD` (diario)

Sí

csv_delimiter

string · query

Delimitador CSV cuando `formato=csv`

formato

string · query

Formato de respuesta: `json` (default), `csv`

pagina

integer | null · query

Numero de pagina (1-indexed)

pagina_sig_codigo

string | null · query

Codigo opaco para navegar a siguiente pagina (del response anterior)

Cuerpo de la solicitud

Requerido. Content-Type: application/json.

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

Respuestas

200Successful Response

400Credenciales SII invalidas o periodo malformado

401API token ausente o invalido

403Sin permisos o cuenta bloqueada

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": [],
  "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
}

Listar BHE recibidas por periodo

On this page