# Leer la tienda Shopify > Datos de la tienda Shopify. {/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */} | | | | ------------------- | ----------------------------------------------------------------- | | **Tool ID** | `shopify.tienda.leer` | | **Nombre MCP** | `shopify__tienda__leer` | | **Conector** | `shopify` | | **Plano** | `action` | | **Scope (permiso)** | `shopify:pedidos` | | **Auth** | `connection_credentials` | | **Versión** | `1` | | **Sensible** | no | | **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] Trae dominio `.myshopify.com`, moneda, zona horaria, si los precios incluyen impuestos, los permisos que concedió y cuánto historial de pedidos alcanza. Connect consulta Shopify en vivo y no guarda nada: cada llamada lee la tienda de la conexión. ## Entrada [#entrada] Sin parámetros: envía `{}`.
JSON Schema de entrada ```json { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": {}, "additionalProperties": false } ```
## Ejemplo [#ejemplo] ```bash title="curl" curl -X POST https://connect.emisso.ai/api/v1/tools/shopify.tienda.leer/execute \ -H "Authorization: Bearer connect_sk_…" \ -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \ -H "Content-Type: application/json" \ -d '{"input":{}}' ``` ```json title="MCP · meta-tool execute" { "tool": "shopify.tienda.leer", "params": {}, "connectionId": "conn_9tKfR2mQx4Vb" } ``` **Salida esperada (200):** ```json { "data": { "tiendaId": "gid://shopify/Shop/48123456789", "nombre": "Andes Café", "dominioMyshopify": "andes-cafe.myshopify.com", "dominioPrincipal": "tienda.andescafe.cl", "moneda": "CLP", "monedasPresentacion": [ "CLP" ], "zonaHoraria": "America/Santiago", "impuestosIncluidos": true, "permisosConcedidos": [ "read_orders", "read_products", "read_inventory" ], "historial": { "completo": false, "diasDisponibles": 60 } }, "meta": { "request_id": "req_…", "tool_id": "shopify.tienda.leer", "plane": "action", "latency_ms": 7410, "audit_status": "recorded" } } ``` > Sin `read_all_orders`, Shopify solo deja ver los pedidos de los últimos 60 días. ## Salida [#salida] | Campo | Tipo | Requerido | Descripción | | | --------------------------- | --------------------------- | --------- | -------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | | `tiendaId` | string `^gid:\/\/shopify\/` | sí | Identificador de la tienda. Identificador global de Shopify (`gid://shopify/Shop/…`), texto. | | | `nombre` | string | null | sí | Nombre de la tienda. | | `dominioMyshopify` | string | sí | Dominio `\.myshopify.com`: la identidad de la conexión. | | | `dominioPrincipal` | string | null | sí | Dominio principal público de la tienda. | | `moneda` | string | sí | Moneda de la tienda (ISO 4217): la de todos los montos de Connect. | | | `monedasPresentacion` | lista de string | sí | Monedas en que la tienda puede cobrar a compradores. | | | `zonaHoraria` | string | null | sí | Zona horaria IANA de la tienda, por ejemplo `America/Santiago`. | | `impuestosIncluidos` | booleano | null | sí | true si los precios de la tienda incluyen impuestos. | | `permisosConcedidos` | lista de string | sí | Permisos de Shopify que la tienda concedió a la app. | | | `historial` | objeto | sí | Cuánto historial de pedidos alcanza esta conexión según los permisos concedidos en Shopify. | | | `historial.completo` | booleano | null | sí | true si la tienda concedió `read_all_orders` y se ve todo el historial; false si solo se ven los últimos 60 días; null si Shopify no informó los permisos. | | `historial.diasDisponibles` | entero | null | sí | 60 cuando el historial está limitado; null en otro caso. |
JSON Schema de salida ```json { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "tiendaId": { "type": "string", "pattern": "^gid:\\/\\/shopify\\/", "description": "Identificador de la tienda. Identificador global de Shopify (`gid://shopify/Shop/…`), texto." }, "nombre": { "anyOf": [ { "type": "string", "maxLength": 255 }, { "type": "null" } ], "description": "Nombre de la tienda." }, "dominioMyshopify": { "type": "string", "description": "Dominio `.myshopify.com`: la identidad de la conexión." }, "dominioPrincipal": { "anyOf": [ { "type": "string", "maxLength": 255 }, { "type": "null" } ], "description": "Dominio principal público de la tienda." }, "moneda": { "type": "string", "description": "Moneda de la tienda (ISO 4217): la de todos los montos de Connect." }, "monedasPresentacion": { "maxItems": 200, "type": "array", "items": { "type": "string" }, "description": "Monedas en que la tienda puede cobrar a compradores." }, "zonaHoraria": { "anyOf": [ { "type": "string", "maxLength": 64 }, { "type": "null" } ], "description": "Zona horaria IANA de la tienda, por ejemplo `America/Santiago`." }, "impuestosIncluidos": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "description": "true si los precios de la tienda incluyen impuestos." }, "permisosConcedidos": { "maxItems": 64, "type": "array", "items": { "type": "string" }, "description": "Permisos de Shopify que la tienda concedió a la app." }, "historial": { "type": "object", "properties": { "completo": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "description": "true si la tienda concedió `read_all_orders` y se ve todo el historial; false si solo se ven los últimos 60 días; null si Shopify no informó los permisos." }, "diasDisponibles": { "anyOf": [ { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" } ], "description": "60 cuando el historial está limitado; null en otro caso." } }, "required": [ "completo", "diasDisponibles" ], "additionalProperties": false, "description": "Cuánto historial de pedidos alcanza esta conexión según los permisos concedidos en Shopify." } }, "required": [ "tiendaId", "nombre", "dominioMyshopify", "dominioPrincipal", "moneda", "monedasPresentacion", "zonaHoraria", "impuestosIncluidos", "permisosConcedidos", "historial" ], "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. | | `connector_onboarding_required` | 428 | no | Lee el mensaje: dice qué falta. Se completa en el portal de ese sistema, no en Connect, y después la llamada funciona sin cambios. | | `connection_scope_not_enabled` | 403 | no | Pide a un owner/admin que habilite el scope en /connections para esa conexión, o usa otra que ya lo tenga activo. Cambiar la credencial del actor no resuelve este error. | | `rate_limited` | 429 | sí | Espera y reintenta con backoff exponencial. | | `upstream_unexpected_response` | 502 | no | No reintentes: la respuesta es determinista. Repórtalo con el request\_id para que actualicemos el conector. | | `external_resource_not_found` | 404 | no | Verifica el identificador con la tool de búsqueda del mismo sistema. Reintentar con el mismo identificador da el mismo resultado. | 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).