Listar sucursales de E-Boleta (beta)

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-Connection en REST, campo connectionId en el execute de MCP y en las opciones del SDK. No hay resolución implícita, ni siquiera con una sola conexión activa: la conexión es la empresa. El id sale de conexiones.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_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.

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.

Listar sucursales de E-Boleta (beta)

Qué hace

Entrada

Salida

Errores de esta tool

En esta página