Saltar al contenido
Consultas

product

Detalle de un producto publicado por su slug, con variantes, relacionados y resumen de reseñas.

product devuelve el detalle de un producto publicado a partir del slug de su URL.

product(slug: String!): ProductDetail!

Argumentos

ArgumentoTipoRegla
slugString!Hasta 200 caracteres. Se recortan los espacios.

ProductDetail

CampoTipoDescripción
idString!ID del producto.
nameString!Nombre.
slugString!Slug.
urlString!Ruta pública del producto en la tienda.
descriptionString!Descripción.
productTypeString!Tipo de producto.
statusString!Estado.
imageUrlString!Imagen principal.
priceDecimal!Precio actual.
compareAtPriceDecimalPrecio antes del descuento.
isAvailableBoolean!true si se puede comprar.
totalInventoryInt!Stock total.
brandString!Marca.
categoryString!Categoría.
categoryIdStringID de la categoría.
tags[String!]!Etiquetas.
specifications[SpecItem!]!Especificaciones.
variants[VariantItem!]!Variantes.
images[ImageItem!]!Galería.
bundleItems[BundleItem!]!Componentes, si es un pack.
sizeGuideSizeGuideInfoGuía de tallas asignada.
priceTiers[ProductPriceTier!]!Precios por cantidad.
createdAtDateTimeFecha de creación.
updatedAtDateTimeFecha de la última actualización.
sellerProductSellerInfoVendedor, en un marketplace.
related(limit: Int! = 8)[ProductSummary!]!Productos relacionados; limit de 1 a 12. Mismo resultado que relatedProducts.
reviewSummaryProductReviewSummary!averageRating: Float y reviewCount: Int! de las reseñas aprobadas.

Tipos anidados

TipoCampos
SpecItemkey: String!, name: String!, value: String!, valueId: String, valueName: String, type: String!, color: String, imageUrl: String, unit: String
ImageItemurl: String!, name: String!, order: Int!, type: String!
ProductSellerInfoid: String!, name: String!, slug: String!
ProductPriceTiervariantId: String!, minQuantity: Int!, maxQuantity: Int, unitPrice: Decimal!

VariantItem

CampoTipoCampoTipo
idStringskuString!
statusString!priceDecimal!
compareAtPriceDecimalquantityInt!
isAvailableBooleanrequiresShippingBoolean!
options[SpecItem!]!images[ImageItem!]!

BundleItem

CampoTipoCampoTipo
productIdString!variantIdString!
productNameString!variantNameString
skuStringbrandString
imageUrlStringquantityInt!
availableInt!allowBackordersBoolean!
requiresShippingBoolean!

Guía de tallas

TipoCampos
SizeGuideInfoid: String!, name: String!, slug: String!, description: String, imageUrl: String, gender: String!, measurementType: String!, unit: String!, notes: String, rows: [SizeGuideRowInfo!]!
SizeGuideRowInfolabel: String!, sizeKey: String!, order: Int!, measurements: [SizeGuideMeasurementInfo!]!
SizeGuideMeasurementInfokey: String!, name: String!, min: Decimal, max: Decimal, value: Decimal, description: String

Ejemplo

Product.graphql
query Product($slug: String!) {
  product(slug: $slug) {
    id
    name
    slug
    description
    price
    compareAtPrice
    isAvailable
    brand
    category
    specifications { key name value }
    variants {
      id
      sku
      price
      compareAtPrice
      quantity
      isAvailable
      options { key name value }
      images { url name order }
    }
    images { url name order }
    sizeGuide {
      name
      unit
      rows {
        label
        measurements { name min max value }
      }
    }
    priceTiers { variantId minQuantity maxQuantity unitPrice }
    seller { id name slug }
    reviewSummary { averageRating reviewCount }
    related(limit: 4) { id name slug imageUrl price }
  }
}
Terminal
curl --request POST "https://storefront.ecomiq.pe/graphql" \
  --header "Content-Type: application/json" \
  --header "x-Store-Domain: mi-tienda" \
  --data-binary '{
    "query": "query Product($slug: String!) { product(slug: $slug) { id name slug description price compareAtPrice isAvailable brand category specifications { key name value } variants { id sku price compareAtPrice quantity isAvailable options { key name value } images { url name order } } images { url name order } sizeGuide { name unit rows { label measurements { name min max value } } } priceTiers { variantId minQuantity maxQuantity unitPrice } seller { id name slug } reviewSummary { averageRating reviewCount } related(limit: 4) { id name slug imageUrl price } } }",
    "variables": { "slug": "taza" }
  }'
Respuesta
{
  "data": {
    "product": {
      "id": "456",
      "name": "Taza",
      "slug": "taza",
      "description": "Taza de cerámica de 350 ml.",
      "price": 10,
      "compareAtPrice": null,
      "isAvailable": true,
      "brand": "Acme",
      "category": "Hogar",
      "specifications": [],
      "variants": [],
      "images": [],
      "sizeGuide": null,
      "priceTiers": [],
      "seller": null,
      "reviewSummary": { "averageRating": 4.5, "reviewCount": 12 },
      "related": [
        { "id": "789", "name": "Taza grande", "slug": "taza-grande", "imageUrl": "/taza-grande.jpg", "price": 12 }
      ]
    }
  }
}

Errores

CódigoCausa
BAD_USER_INPUTslug vacío o de más de 200 caracteres.
NOT_FOUNDEl producto no existe en la tienda o no está publicado.
STORE_CONTEXT_REQUIREDx-Store-Domain falta o no corresponde a una tienda.

Equivalente REST

GET /v1/products/{slug} devuelve el mismo producto.

Última actualización:

En esta página