Acesso Comercial / Docs / Storefront / API
Ctrl K
OBJECT

Product

Representa um produto da loja com preço, imagens, variações, avaliações e parcelamento.

Usado em: clientproducts, clientProducts, featuredProducts, homeProductsByCategory, productsOnSale, highlightedProducts  |  product / products  |  TimercomponentsAffected.onSaleProduct

Campos

CampoTipoDescrição
idID!ID global Relay do produto.
titleString!Título do produto.
descriptionStringDescrição (pode conter HTML).
priceFloat!Preço atual em centavos.
originalPriceFloatPreço original (antes do desconto).
discountPercentageFloatPercentual de desconto aplicado.
images[Image]Imagens do produto.
availableQuantityIntQuantidade disponível em estoque.
isActiveBooleanSe o produto está ativo e visível.
skuStringCódigo SKU do produto.
weightFloatPeso em gramas.
variations[Product]Variações do produto (tamanhos, cores).
variationAttributes[VariationAttribute]Atributos de variação disponíveis.
categories[Category]Categorias do produto.
installmentsPrice[InstallmentEntry]Opções de parcelamento calculadas.
reviewSummaryReviewSummaryResumo das avaliações (total, média).

VariationAttribute

CampoTipoDescrição
nameString!Nome do atributo (ex: "Tamanho", "Cor").
values[String!]Valores disponíveis (ex: ["P", "M", "G"]).

InstallmentEntry

CampoTipoDescrição
installmentsInt!Número de parcelas.
valueFloat!Valor de cada parcela (em centavos).
Paginação: Produtos são retornados via Relay Connection. Use first/after para paginar. Veja PageInfo.

Query

GraphQL
query GetProducts($hostname: String!) {
  client(hostname: $hostname) {
    products(first: 8, sort: "price_asc") {
      edges {
        node {
          id
          title
          description
          price
          originalPrice
          discountPercentage
          images { url }
          availableQuantity
          sku
          categories { id name }
          variations {
            id
            title
            price
            variationAttributes { name values }
          }
          reviewSummary {
            averageStars
            totalReviews
          }
          installmentsPrice {
            installments
            value
          }
        }
      }
      pageInfo { hasNextPage endCursor }
    }
  }
}

Resposta

JSON
{
  "data": {
    "client": {
      "products": {
        "edges": [
          {
            "node": {
              "id": "UHJvZHVjdDphYmMx",
              "title": "Camiseta Premium",
              "description": "<p>Algodão 100%</p>",
              "price": 8990,
              "originalPrice": 12900,
              "discountPercentage": 30,
              "images": [
                { "url": "https://..." }
              ],
              "availableQuantity": 42,
              "sku": "CAM-001",
              "categories": [
                { "id": "Q2F0ZWdvcnk6abc1", "name": "Roupas" }
              ],
              "variations": [],
              "reviewSummary": {
                "averageStars": 4.8,
                "totalReviews": 15
              },
              "installmentsPrice": [
                { "installments": 3, "value": 2997 }
              ]
            }
          }
        ],
        "pageInfo": {
          "hasNextPage": true,
          "endCursor": "Y3Vyc29yOA=="
        }
      }
    }
  }
}