Obtener resumen anual de BTE emitidas

POST/api/v1/sii/bte/emitidas/resumen/{anio}v1 · ESTABLE

POST /api/v1/sii/bte/emitidas/resumen/{anio}

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

Obtener resumen anual de BTE emitidas agrupado por mes.

Entrega totales agregados por mes (folios, vigentes, anuladas, bruto, retencion, total) y un consolidado anual. El RUT emisor 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 emisor en el body (auth.pass.rut / auth.pass.clave).

Quota: Consume 1 consulta | Peso: 2x (agregado anual)

Parametros de ruta

Parametro	Tipo	Requerido	Descripcion
`anio`	integer	Si	Año tributario (entre 2005 y 2100)

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)

{
    "anual": {
        "folio_inicial": 1,
        "folio_final": 1500,
        "vigentes": 1450,
        "anuladas": 50,
        "bruto": 125000000,
        "retencion": 16625000,
        "total": 108375000
    },
    "mensual": [
        {
            "mes_codigo": "01",
            "mes_glosa": "Enero",
            "folio_inicial": 1,
            "folio_final": 120,
            "vigentes": 115,
            "anuladas": 5,
            "bruto": 10000000,
            "retencion": 1330000,
            "total": 8670000
        }
    ]
}

Errores especificos

Codigo	error_code	Causa	Resolucion
400	`VALIDATION_ERROR`	`anio` fuera del rango 2005-2100	Ajustar el año a un valor valido
400	`AUTH_ERROR`	Credenciales SII incorrectas	Revisar RUT/clave
401	`HTTP_401`	API token ausente o invalido	Enviar `X-API-Token` valido
403	`INSUFFICIENT_SCOPE`	Token sin scope `sii:read`	Generar token con scope adecuado
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

Los montos estan en CLP, enteros o con decimales segun respuesta del SII.
La tabla mensual contiene hasta 12 filas (una por mes activo).
csv y html retornan el formato raw del SII (ISO-8859-1).

Parámetros

Header / Body

Tipo

Descripción

Requerido

anio

integer · path

Año de consulta en formato YYYY

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

400Año invalido 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

Forma de la respuesta

Código 200. Estructura del JSON devuelto.

{
  "anual": {
    "anuladas": 0,
    "bruto": 0,
    "folio_final": 0,
    "folio_inicial": 0,
    "retencion": 0,
    "total": 0,
    "vigentes": 0
  },
  "mensual": [
    {
      "anuladas": 0,
      "bruto": 0,
      "folio_final": 0,
      "folio_inicial": 0,
      "mes_codigo": "string",
      "mes_glosa": "string",
      "retencion": 0,
      "total": 0,
      "vigentes": 0
    }
  ]
}

Obtener resumen anual de BTE emitidas

On this page