Listar BTE recibidas por periodo

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

POST /api/v1/sii/bte/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/bte/recibidas/documentos/202601",
    headers=headers,
)
response.raise_for_status()
print(response.json())

Listar BTE recibidas por periodo (anual, mensual o diario).

Obtiene el listado de boletas de terceros recibidas por el contribuyente autenticado. El nivel de agregacion depende del formato del periodo: anual entrega resumenes por mes, mensual/diario entrega documentos individuales. El RUT receptor 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 receptor en el body.

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

Parametros de ruta

Parametro	Tipo	Requerido	Descripcion
`periodo`	string	Si	`YYYY` (anual), `YYYYMM` (mensual) o `YYYYMMDD` (diario)

Parametros de consulta

Parametro	Tipo	Default	Descripcion
`formato`	string	`json`	`json` (default), `csv` o `html`
`csv_delimiter`	string	`;`	Delimitador cuando `formato=csv`
`pagina`	integer	`1`	Numero de pagina

Body (JSON)

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

Respuesta exitosa - periodo mensual/diario (200)

{
    "total_boletas": 3,
    "boletas_vigentes": 3,
    "boletas_anuladas": 0,
    "pagina": 1,
    "total_paginas": 1,
    "documentos": [
        {
            "numero": 5678,
            "estado": "VIGENTE",
            "fecha_emision": "10-01-2026",
            "emisor_rut": "77.777.777-7",
            "emisor_nombre": "Emisor Ejemplo",
            "fecha_recepcion": "10-01-2026",
            "bruto": 50000,
            "retencion": 6650,
            "total": 43350,
            "codigo": "XYZ789"
        }
    ],
    "totales": {
        "folio_inicial": 5678,
        "folio_final": 5680,
        "vigentes": 3,
        "anuladas": 0,
        "bruto": 150000,
        "retencion": 19950,
        "total": 130050
    },
    "message": null
}

Para periodo=YYYY retorna resumen anual (BTEResumenResponse con tabla mensual).

Errores especificos

Codigo	error_code	Causa	Resolucion
400	`AUTH_ERROR`	Credenciales SII incorrectas	Revisar RUT/clave
400	`VALIDATION_ERROR`	Periodo con formato invalido	Usar `YYYY`, `YYYYMM` o `YYYYMMDD`
401	`HTTP_401`	API token ausente o invalido	Enviar `X-API-Token` valido
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

Para periodos anuales (YYYY) usa resumen; para mensual/diario lista documentos.
En recibidas, el receptor_rut es el contribuyente autenticado, por lo que no aparece en los items.
csv retorna el formato raw del SII (ISO-8859-1), util para Excel.

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

any · query

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

pagina

integer · query

Numero de pagina (default 1)

Cuerpo de la solicitud

Requerido. Content-Type: application/json.

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

Respuestas

200Successful Response

400Periodo malformado o credenciales SII incorrectas

401API token ausente o invalido

403Sin scope `sii:read` o cuenta bloqueada

422Body con formato invalido

429Limite de tasa excedido

502Error en servicio SII upstream

503SII en mantenimiento

Listar BTE recibidas por periodo

On this page