# Opciones del receptor en el SII > Devuelve lo que el Facturador Gratuito del SII muestra al escribir el RUT del receptor de una factura: razón social, giros y direcciones (sucursales incluidas), cada una con su comuna y ciudad. {/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */} | | | | ------------------- | ----------------------------------------------------------------- | | **Tool ID** | `sii.receptor.opciones` | | **Nombre MCP** | `sii__receptor__opciones` | | **Conector** | `sii` | | **Plano** | `action` | | **Scope (permiso)** | `sii: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 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`](/docs/referencia/conexiones/estado-consultar). ## Qué hace [#qué-hace] Úsala cuando 'sii.dte.previsualizar' responda que el receptor tiene varios giros o direcciones: elige uno de cada uno y envíalos en el receptor; la comuna y la ciudad salen de la dirección elegida. Puedes acotar las direcciones con 'comuna'. Consulta en vivo con la sesión de la conexión, no guarda nada y no emite. Requiere la emisión autorizada en la conexión. ## Entrada [#entrada] | Campo | Tipo | Requerido | Descripción | | -------- | ------ | --------- | --------------------------------------------------------------------------- | | `rut` | string | sí | RUT del receptor, con dígito verificador. Acepta puntos y guion. | | `comuna` | string | no | Comuna para acotar las direcciones. Se compara sin mayúsculas, tildes ni ñ. |
JSON Schema de entrada ```json { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "rut": { "type": "string", "description": "RUT del receptor, con dígito verificador. Acepta puntos y guion." }, "comuna": { "description": "Comuna para acotar las direcciones. Se compara sin mayúsculas, tildes ni ñ.", "type": "string", "minLength": 1, "maxLength": 40 } }, "required": [ "rut" ] } ```
## Ejemplo [#ejemplo] ```bash title="curl" curl -X POST https://connect.emisso.ai/api/v1/tools/sii.receptor.opciones/execute \ -H "Authorization: Bearer connect_sk_…" \ -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \ -H "Content-Type: application/json" \ -d '{"input":{"rut":"76.123.456-0","comuna":"Temuco"}}' ``` ```json title="MCP · meta-tool execute" { "tool": "sii.receptor.opciones", "params": { "rut": "76.123.456-0", "comuna": "Temuco" }, "connectionId": "conn_9tKfR2mQx4Vb" } ``` **Salida esperada (200):** ```json { "data": { "rut": "76123456-0", "razonSocial": "COMERCIAL EJEMPLO S.A.", "giros": [ "VENTA AL POR MENOR DE ARTICULOS DE FERRE", "SERVICIOS DE PUBLICIDAD PRESTADOS POR EM" ], "direcciones": [ { "direccion": "AV. EJEMPLO 0457", "comuna": "TEMUCO", "ciudad": "TEMUCO" }, { "direccion": "CALLE EJEMPLO 2470 L - 1", "comuna": "TEMUCO", "ciudad": null } ] }, "meta": { "request_id": "req_…", "tool_id": "sii.receptor.opciones", "plane": "action", "latency_ms": 7410, "audit_status": "recorded" } } ``` > Después, previsualiza con receptor \{ rut, giro, direccion } usando textos de estas listas. Paso a paso en [Facturas 33 y 34](/docs/emitir/facturas). ## Salida [#salida] | Campo | Tipo | Requerido | Descripción | | | ------------------------- | --------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | | `rut` | string | sí | RUT consultado, canonizado como cuerpo-DV. | | | `razonSocial` | string | null | sí | Razón social que el SII tiene registrada, o null si no tiene datos de ese RUT. | | `giros` | lista de string | sí | Giros registrados, cortados a 40 caracteres como los muestra el SII. Si hay más de uno, elige el que corresponda y envíalo en receptor.giro. Vacío si el SII no tiene datos: entonces el giro se escribe. | | | `direcciones` | lista de objeto | sí | Direcciones registradas, sucursales incluidas, en el orden del SII (el primero no es el principal). Si se pidió una comuna, sólo las de esa comuna. | | | `direcciones[].direccion` | string | sí | Dirección tal como la tiene el SII. Envíala igual en receptor.direccion. | | | `direcciones[].comuna` | string | sí | Comuna de esa dirección; la previsualización la toma de aquí. | | | `direcciones[].ciudad` | string | null | sí | Ciudad de esa dirección, o null si el SII no la tiene: entonces hay que enviar receptor.ciudad. |
JSON Schema de salida ```json { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "rut": { "type": "string", "description": "RUT consultado, canonizado como cuerpo-DV." }, "razonSocial": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Razón social que el SII tiene registrada, o null si no tiene datos de ese RUT." }, "giros": { "type": "array", "items": { "type": "string" }, "description": "Giros registrados, cortados a 40 caracteres como los muestra el SII. Si hay más de uno, elige el que corresponda y envíalo en receptor.giro. Vacío si el SII no tiene datos: entonces el giro se escribe." }, "direcciones": { "type": "array", "items": { "type": "object", "properties": { "direccion": { "type": "string", "description": "Dirección tal como la tiene el SII. Envíala igual en receptor.direccion." }, "comuna": { "type": "string", "description": "Comuna de esa dirección; la previsualización la toma de aquí." }, "ciudad": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Ciudad de esa dirección, o null si el SII no la tiene: entonces hay que enviar receptor.ciudad." } }, "required": [ "direccion", "comuna", "ciudad" ], "additionalProperties": false }, "description": "Direcciones registradas, sucursales incluidas, en el orden del SII (el primero no es el principal). Si se pidió una comuna, sólo las de esa comuna." } }, "required": [ "rut", "razonSocial", "giros", "direcciones" ], "additionalProperties": false } ```
## 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_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. | 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](/docs/referencia/errores).