# 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.



{/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */}

|                     |                                                                   |
| ------------------- | ----------------------------------------------------------------- |
| **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`](../conexiones/estado-consultar).

## Qué hace [#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 [#entrada]

Sin parámetros: envía `{}`.

<details>
  <summary>
    JSON Schema de entrada
  </summary>

  ```json
  {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {},
    "additionalProperties": false
  }
  ```
</details>

## Salida [#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í                                                                             | Comuna de la sucursal; null si E-Boleta no la informa. |

<details>
  <summary>
    JSON Schema de salida
  </summary>

  ```json
  {
    "$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
  }
  ```
</details>

## Errores de esta tool [#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](../errores).