Listar sucursales de E-Boleta
Lista las sucursales de la empresa de la conexión tal como las muestra hoy E-Boleta del SII: código, dirección y comuna.
| Tool ID | sii.boleta_sucursales.listar |
| Nombre MCP | sii__boleta_sucursales__listar |
| Conector | sii |
| Plano | action |
| Scope (permiso) | sii:boletas:write |
| Auth | connection_credentials |
| Versión | 1 |
| Sensible | sí |
| Deprecado | no |
| Comportamiento | readOnly=true, destructive=false, idempotent=true, openWorld=true |
Requiere conexión. Indica cuál en cada llamada: header
X-Connect-Connectionen REST y campoconnectionIden elexecutede MCP. No hay resolución implícita, ni siquiera con una sola conexión activa: la conexión es la empresa. El id sale deconexiones.estado.consultar.
Qué hace
El código va en sucursal de sii.boleta.previsualizar cuando la empresa tiene más de una. No emite ni guarda nada. Requiere las boletas encendidas en la conexión (acceso de representante) y el permiso sii:boletas:write.
Entrada
Sin parámetros: envía {}.
JSON Schema de entrada
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {},
"additionalProperties": false
}Salida
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
sucursales | lista de objeto | sí | Las sucursales de la empresa de la conexión tal como las muestra E-Boleta hoy. |
sucursales[].codigo | entero | sí | Código SII de la sucursal (CdgSIISucur). |
sucursales[].direccion | string | sí | Dirección de la sucursal tal como la muestra E-Boleta. |
sucursales[].comuna | string | null | sí |
JSON Schema de salida
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"sucursales": {
"maxItems": 10000,
"type": "array",
"items": {
"type": "object",
"properties": {
"codigo": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "Código SII de la sucursal (CdgSIISucur)."
},
"direccion": {
"type": "string",
"maxLength": 1000,
"description": "Dirección de la sucursal tal como la muestra E-Boleta."
},
"comuna": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "null"
}
],
"description": "Comuna de la sucursal; null si E-Boleta no la informa."
}
},
"required": [
"codigo",
"direccion",
"comuna"
],
"additionalProperties": false
},
"description": "Las sucursales de la empresa de la conexión tal como las muestra E-Boleta hoy."
}
},
"required": [
"sucursales"
],
"additionalProperties": false
}Errores de esta tool
| Código | HTTP | Reintentable | Qué hacer |
|---|---|---|---|
connection_disabled | 403 | no | Reactívala en /connections o usa otra conexión del mismo sistema. |
connection_not_found | 404 | no | Usa uno de los connectionId que lista el error, o revisa la conexión en /connections. No hace falta reactivar nada. |
connection_credential_required | 428 | no | Crea un enlace con conexiones.enlace.crear (modo reconectar si la conexión ya existe) y pide a la persona que entregue la credencial de nuevo. No reintentes con la credencial anterior. |
connection_busy | 409 | sí | Espera unos segundos y reintenta. Es una espera transitoria: no necesitas volver a conectar ni ingresar la credencial otra vez. |
upstream_error | 502 | sí | Reintenta más tarde. Si persiste, el problema está en el sistema externo, no en tu integración. |
timeout | 504 | sí | Reintenta. Para sincronizaciones largas usa la vía asíncrona y consulta el estado del trabajo. |
sii_maximo_sesiones | 409 | no | Cierra tus sesiones en sii.cl o espera unos minutos y vuelve a intentar. No cambies la clave. |
Toda llamada puede devolver además los códigos transversales (validation_error, unauthorized, scope_not_granted, rate_limited, entre otros): el detalle vive en el catálogo de errores.
Preparar la anulación de una factura o boleta, o la corrección de montos de una factura, en el SII
Prepara en el Facturador Gratuito del SII la nota de crédito que anula un documento, o que corrige los montos de una factura, sin firmarla ni emitirla.
Descargar el PDF de una boleta
Descarga desde E-Boleta del SII el PDF oficial de una boleta 39 o 41 de la empresa de la conexión, por tipo, folio y fecha de emisión, y lo devuelve en base64 con su SHA-256 y con su enlace oficial de E-Boleta (pdfUrl).