settings
La tienda, sus ajustes de contenido, sus páginas y sus menús en una consulta.
settings devuelve en una consulta la tienda, sus ajustes de contenido, sus páginas publicadas y sus menús activos. Trae lo mismo que GET /.
settings: StoreSettingsSnapshotDto!No recibe argumentos. Pídela una vez por página y reutilízala.
StoreSettingsSnapshotDto
| Campo | Tipo | Descripción |
|---|---|---|
schemaVersion | Int! | Versión del formato de la respuesta. |
generatedAt | DateTime! | Cuándo se armó la respuesta. |
store | StorefrontStoreDto! | La tienda. |
cms | CmsSnapshotDto! | Ajustes de contenido, páginas y menús. |
StorefrontStoreDto
| Campo | Tipo | Campo | Tipo |
|---|---|---|---|
id | String! | tenantId | String! |
sellerId | String | type | String! |
isActive | Boolean! | name | String! |
description | String! | logo | String |
icon | String | slug | String |
domain | String | domains | [String!]! |
timeZone | String! | countryCode | String! |
currency | String! | language | String! |
visibility | String! | businessSettings | StoreBusinessSettings! |
checkoutSettings | StoreCheckoutSettings! |
typeyvisibilityllegan como texto en camelCase, por ejemplomarketplaceypublic.businessSettingsycheckoutSettingstienen los mismos campos que enGET /.v1/ settings
CmsSnapshotDto
| Campo | Tipo | Descripción |
|---|---|---|
settings | CmsSiteSettingsDto! | Marca, SEO, contacto, analítica y scripts. |
pages | [CmsPageDetailsDto!]! | Páginas publicadas. |
menus | [CmsMenuDto!]! | Menús activos, ordenados por key. |
CmsSiteSettingsDto
| Campo | Tipo | Campos |
|---|---|---|
themeKey | String! | — |
branding | CmsBrandingSettingsDto! | logoDarkUrl, faviconUrl, socialImageUrl |
seo | CmsSeoSettingsDto! | siteName, metaTitle, metaDescription, titleTemplate, robotsIndex |
contact | CmsContactSettingsDto! | whatsapp y socialLinks, con instagram, facebook, tiktok, youtube y x |
tracking | CmsTrackingSettingsDto! | googleAnalyticsMeasurementId, metaPixelId, googleTagManagerContainerId |
customScripts | CmsCustomScriptsDto! | enabled, head, bodyEnd |
updatedOn | DateTime | — |
productBadges | CmsProductBadgesDto | showRatings, newDays, lowStock |
El logo de la tienda está en store.logo. En REST, productBadges solo llega con include=productBadges.
CmsMenuDto
| Campo | Tipo | Descripción |
|---|---|---|
key | String! | Clave del menú, como main o footer-1. |
name | String! | Nombre del menú. |
items | Any! | Enlaces del menú, como JSON. |
items llega completo: no se seleccionan sus campos. Cada enlace trae label, url, reference, order, target, visible y children.
- Los enlaces a productos y categorías publicados llegan con su URL vigente.
- Los enlaces a páginas sin publicar no llegan.
- La API no filtra por
visibleni ordena: omite los que tienenvisible: falsey ordena pororder. Ver Menús y contenido.
CmsPageDetailsDto
Cada página trae lo mismo que GET /: id, name, slug, channel, layout, version, settings, sections, status, hasPublishedVersion, publishedOn, publishedBy, createdOn, updatedOn, createdBy, updatedBy y lastModifiedBy.
- Cada sección trae
id,type,order,settingsyblocks. Cada bloque traeid,type,orderysettings. settingsde la página, de cada sección y de cada bloque esAny.channelystatusllegan como texto en camelCase.
Ejemplo
query Settings {
settings {
store { name currency language }
cms {
settings { seo { siteName robotsIndex } }
menus { key name items }
}
}
}curl --request POST "https://storefront.ecomiq.pe/graphql" \
--header "Content-Type: application/json" \
--header "x-Store-Domain: mi-tienda" \
--data-binary '{
"query": "query Settings { settings { store { name currency language } cms { settings { seo { siteName robotsIndex } } menus { key name items } } } }"
}'{
"data": {
"settings": {
"store": { "name": "Mi tienda", "currency": "PEN", "language": "es" },
"cms": {
"settings": { "seo": { "siteName": "Mi tienda", "robotsIndex": true } },
"menus": [
{
"key": "main",
"name": "Menú principal",
"items": [
{
"label": "Polos",
"url": "/categories/polos",
"reference": { "type": "category", "id": "7204558912004327982" },
"order": 1,
"visible": true,
"children": []
}
]
}
]
}
}
}
}Errores
| Código | Causa |
|---|---|
STORE_CONTEXT_REQUIRED | x-Store-Domain falta o no corresponde a una tienda. |
NOT_FOUND | La tienda no existe o está inactiva. |
Equivalente REST
GET / devuelve los mismos datos. Para los datos básicos de la tienda, usa store.
Última actualización: