store

store devuelve la tienda identificada por x-Store-Domain. Úsala para leer identidad, branding básico, modelo comercial, moneda e idioma sin solicitar el snapshot REST completo.

Firma

store: StorefrontStore!

La query no recibe argumentos y siempre devuelve StorefrontStore cuando el contexto de tienda puede resolverse.

Campos de StorefrontStore

Campo	Tipo	Descripción
`id`	`String!`	Identificador público opaco de la tienda.
`name`	`String!`	Nombre público de la tienda.
`description`	`String!`	Descripción pública; puede ser un string vacío.
`slug`	`String`	Slug asignado a la tienda, si existe.
`domain`	`String`	Dominio principal configurado, si existe.
`logo`	`String`	URL o referencia pública del logo, si existe.
`icon`	`String`	URL o referencia pública del icono, si existe.
`type`	`StoreType!`	Modelo comercial configurado para la tienda.
`currency`	`String!`	Código de moneda configurado, por ejemplo `PEN`.
`language`	`String!`	Código de idioma configurado, por ejemplo `es`.

Los campos sin ! pueden devolver null. Conserva id como string y no intentes interpretar su formato.

StoreType

type devuelve uno de estos valores exactos:

Valor	Modelo
`B2C`	Tienda online que vende su propio catálogo.
`MARKETPLACE`	Tienda en la que participan varios sellers.
`RETAIL`	Operación retail.
`B2B`	Operación mayorista o business-to-business.
`SOCIAL`	Operación de social commerce.
`HUB`	Hub que centraliza catálogo y stock para canales externos.
`RESTAURANT`	Operación de restaurante o comida.

Consulta

Store.graphql

query Store {
  store {
    id
    name
    description
    slug
    domain
    logo
    icon
    type
    currency
    language
  }
}

Esta operación no necesita variables.

cURL

Terminal

curl --request POST "https://storefront.ecomiq.pe/graphql" \
  --header "Content-Type: application/json" \
  --header "x-Store-Domain: mi-tienda" \
  --data-binary '{
    "query": "query Store { store { id name description slug domain logo icon type currency language } }"
  }'

Respuesta

GraphQL devuelve únicamente los campos solicitados:

Respuesta

{
  "data": {
    "store": {
      "id": "123",
      "name": "Tienda",
      "description": "Descripción",
      "slug": "tienda",
      "domain": null,
      "logo": null,
      "icon": null,
      "type": "MARKETPLACE",
      "currency": "PEN",
      "language": "es"
    }
  }
}

Errores

Código	Cuándo ocurre
`STORE_CONTEXT_REQUIRED`	`x-Store-Domain` no permite resolver una tienda.
`NOT_FOUND`	El contexto contiene un ID de tienda que ya no puede encontrarse.

Contexto ausente

{
  "errors": [
    {
      "message": "Store context is required.",
      "path": ["store"],
      "extensions": {
        "code": "STORE_CONTEXT_REQUIRED"
      }
    }
  ],
  "data": null
}

Consulta Errores GraphQL antes de usar data: una respuesta HTTP 200 todavía puede contener errors.

Equivalente REST

GET /v1/settings devuelve el snapshot público completo, incluidos checkout, tema, features, páginas y menús. Usa store cuando solo necesites los diez campos descritos en esta página.

store

En esta página