Listar BTE emitidas por periodo

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

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

Listar BTE emitidas en un periodo mensual o diario.

Obtiene el listado de boletas de terceros emitidas por el contribuyente autenticado, con metadata del periodo (total, vigentes, anuladas) y totales agregados. El RUT emisor se deriva de las credenciales (auth.pass.rut) — 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 (listado con paginacion server-side)

Parametros de ruta

Parametro	Tipo	Requerido	Descripcion
`periodo`	string	Si	`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`

Body (JSON)

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

Respuesta exitosa (200)

{
    "total_boletas": 25,
    "boletas_vigentes": 24,
    "boletas_anuladas": 1,
    "pagina": 1,
    "total_paginas": 1,
    "documentos": [
        {
            "numero": 1234,
            "estado": "VIGENTE",
            "fecha_emision": "15-01-2026",
            "emisor_rut": "76.XXX.XXX-K",
            "emisor_nombre": "EMPRESA EJEMPLO SPA",
            "receptor_rut": "12.345.678-9",
            "receptor_nombre": "Receptor Ejemplo",
            "bruto": 119000,
            "retencion": 15827,
            "total": 103173,
            "codigo": "ABC123"
        }
    ],
    "totales": {
        "folio_inicial": 1210,
        "folio_final": 1234,
        "vigentes": 24,
        "anuladas": 1,
        "bruto": 2975000,
        "retencion": 395675,
        "total": 2579325
    },
    "message": null
}

Si no hay documentos, documentos es [] y message indica la ausencia.

Errores especificos

Codigo	error_code	Causa	Resolucion
400	`AUTH_ERROR`	Credenciales SII incorrectas	Revisar RUT/clave
400	`VALIDATION_ERROR`	Periodo con formato invalido	Usar `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 resumen anual usar POST /emitidas/resumen/{anio} en su lugar.
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 `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`

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

On this page