Documentação para Web Designers

Crie seus próprios layouts na Nuvem Shop

Product

Este objeto traz as informações referentes aos produtos da loja.

  • name: Nome do produto.
  • price: Preço do produto em centavos (dessa forma, se o preço for de R$100,00 o valor de price será 10000). Se compare_at_price está setado, price representa o preço promocional do produto.
  • compare_at_price: O preço original que se vendia o produto, em centavos. O valor será false caso não haja um valor promocional (e portanto o preço do produto está definido em price).
  • display_price: true se há algum valor definido para o produto.
  • min_price: O preço mínimo de todas as Product_Variant do produto, em centavos (dessa forma, se o preço for de R$100,00 o valor de min_price será 10000). null se nenhuma variável possui preço.
  • max_price: O preço máximo de todas as Product_Variant do produto, em centavos (dessa forma, se o preço for de R$100,00 o valor de max_price será 10000). null se nenhuma variável possui preço.
  • canonical_url: URL canônica do producto.
  • social_url: URL social do produto, que deve ser usada ao compartilhar o produto no Facebook, Twitter, Pinterest etc...
  • description: Descrição do produto.
  • stock_control: true caso o controle de estoque está sendo controlado pela NumveShop.
  • stock: Estoque do produto.
  • weight: Peso do produto.
  • weight_unit: Unidade de medida de peso. No momento, o valor será sempre KG.
  • sku: SKU do produto.
  • tags: Array que contém os tags do producto.
  • currency: Código ISO 4217 da moeda que mostra o preço do produto (ARS = Pesos Argentinos, BRL = Reais etc).
  • images: Array de objetos Product_Image que contém as imagens do produto.
  • images_count: Quantidade de imagens do produto.
  • featured_image: Objeto Product_Image com a imagem principal do produto.
  • variations: Array de objetos Variation que contém as variações do produto (Exemplo: cor, tamanho etc).
  • default_options: Array que contém os valores padrão para as variações do produto.
  • other_images: Array de objetos Product_Image que contém as imagens secundárias do produto (ou seja, todas menos a primeira).
  • installments: Número máximo de parcelas do pagamento disponível para o produto. Retorna 0 se não houver a possibilidade de parcelamento. (disponível apenas no Brasil)
  • category: Devolve o objeto Category da categoria onde o produto se encontra.
  • variants_object: Array de objetos com todas as variações possíveis do objeto. Por exemplo: se temos uma camiseta disponível nas cores branca e preta e nos tamanhos P, M e G temos 6 variações possíveis do produto (Branca P, branca M, branca G, preta P, preta M e preta G). É utilizado quando por exemplo queremos saber qual é o estoque disponível para um variação específica (será que temos uma camiseta preta tamanho G?). Cada variação contém:
    • price_short: retorna o preço da variação e o símbolo da moeda. Se compare_at_price_short está setado, esta propriedade utiliza o preço promocional.
    • price_long: retorna o preço da variação, o símbolo da moeda além do Código ISO 4217 da moeda. Assim como o price_short, se compare_at_price_long estiver setado, a propriedade traz o preço promocional.
    • compare_at_price_short: Texto com o preço de venda não promocional da variação acompanhado com o símbolo da moeda.
    • compare_at_price_long: Texto com o preço não promocional, o símbolo da moeda e o Código ISO 4217 da moeda.
    • stock: Estoque da variação.
    • sku: SKU da variação.
    • available: true se há estoque disponível para essa variação do produto
    • contact: true se o valor do produto só é disponilizado através de contato com a loja.
    • option0: Texto com o valor da primeira propriedade da variação.
    • option1: Texto com o valor da segunda propriedade da variação, se existir.
    • option2: Texto com valor da terceira propriedade da variação, se existir.
  • seo_title: Título para SEO.
  • seo_description: Descrição para SEO.
  • handle: URL do produto.