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 IDsii.boleta_sucursales.listar
Nombre MCPsii__boleta_sucursales__listar
Conectorsii
Planoaction
Scope (permiso)sii:boletas:write
Authconnection_credentials
Versión1
Sensiblesí
Deprecadono
ComportamientoreadOnly=true, destructive=false, idempotent=true, openWorld=true

Requiere conexión. Indica cuál en cada llamada: header X-Connect-Connection en REST y campo connectionId en el execute de MCP. 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

CampoTipoRequeridoDescripción
sucursaleslista de objetosíLas sucursales de la empresa de la conexión tal como las muestra E-Boleta hoy.
sucursales[].codigoenterosíCódigo SII de la sucursal (CdgSIISucur).
sucursales[].direccionstringsíDirección de la sucursal tal como la muestra E-Boleta.
sucursales[].comunastringnullsí
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ódigoHTTPReintentableQué hacer
connection_disabled403noReactívala en /connections o usa otra conexión del mismo sistema.
connection_not_found404noUsa uno de los connectionId que lista el error, o revisa la conexión en /connections. No hace falta reactivar nada.
connection_credential_required428noCrea 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_busy409síEspera unos segundos y reintenta. Es una espera transitoria: no necesitas volver a conectar ni ingresar la credencial otra vez.
upstream_error502síReintenta más tarde. Si persiste, el problema está en el sistema externo, no en tu integración.
timeout504síReintenta. Para sincronizaciones largas usa la vía asíncrona y consulta el estado del trabajo.
sii_maximo_sesiones409noCierra 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.

En esta página