Variáveis Globais

merchantData

Contém informações gerais sobre a loja, como domínio, tema e configurações.

CampoTipoDescrição
idIntegerID único da loja.
aliasStringApelido interno da loja.
domainStringDomínio principal da loja.
base_urlStringURL base da loja.
logo_urlStringURL do logotipo da loja.
has_mpBooleanIndica se há meios de pagamento habilitados.

merchantData.checkout

Contém informações sobre o processo de checkout.

CampoTipoDescrição
base_domainStringURL base do checkout.
skip_cartBooleanIndica se o carrinho é pulado no checkout.
itemsStringURL para obter os itens do carrinho.
items_jsonStringURL para obter os itens do carrinho em formato JSON.
redirect_toStringURL para redirecionamento ao carrinho.
ordersStringURL para histórico de pedidos do cliente.
store_tokenStringToken da loja para autenticação nas URLs do checkout.
default_cardStringCartão de crédito padrão do cliente, como Visa.
shopper_urlStringURL para a conta do cliente na loja.

merchantData.manifest

Contém dados específicos do manifesto da loja.

CampoTipoDescrição
nameStringNome completo da loja.
short_nameStringNome curto da loja, utilizado em interfaces com espaço limitado.
start_urlStringURL inicial para carregar a loja como um aplicativo web.
descriptionStringDescrição da loja.
langStringIdioma da loja, no formato ISO (ex: pt-BR).

merchantData.meta

Contém informações de metadados adicionais.

CampoTipoDescrição
titleStringTítulo da loja.
descriptionStringDescrição meta da loja para SEO.
iconsArrayLista de ícones usados pela loja.

merchantData.company

Contém informações da empresa responsável pela loja.

CampoTipoDescrição
person_typeStringTipo de pessoa física ou jurídica.
cnpjStringCNPJ da empresa (caso aplicável).
razao_socialStringRazão social da empresa.
nameStringNome fantasia ou comercial da loja.
cpfStringCPF (caso a loja seja registrada como pessoa física).
phoneStringTelefone da loja ou empresa.
whatsappArrayDados de contato do WhatsApp.
emailStringEndereço de e-mail de contato da loja.
addressArrayEndereço da empresa ou loja.
socialArrayRedes sociais da loja ou empresa.

sections

Contém detalhes sobre as seções da interface.

CampoTipoDescrição
section_aliasStringIdentificador único da seção, como header, footer, etc.
positionIntegerPosição da seção na interface, indicando sua ordem de apresentação.
orderIntegerOrdem específica para organização da seção em relação a outras.
visibleBooleanIndica se a seção está visível ao usuário.
paramsArrayParâmetros adicionais para a seção.

sorted_categories

Contém informações sobre categorias organizadas.

CampoTipoDescrição
idIntegerIdentificador único da categoria.
featuredBooleanIndica se a categoria é destacada.
parent_idIntegerID da categoria pai (ou null se for uma categoria principal).
is_parentBooleanIndica se a categoria é uma categoria pai.
nameStringNome da categoria.
slugStringIdentificador amigável para URL da categoria.
urlStringURL completa da categoria.
url_pathStringCaminho relativo para acesso direto à categoria, com parâmetros de ordenação incluídos.
pathStringCaminho completo de navegação da categoria, exibido no formato textual.
category_coverMixedURL da imagem de capa da categoria (ou null se não tiver uma).
orderIntegerOrdem de exibição da categoria em relação às outras.
childrenArrayLista de subcategorias, se houver.

Contém informações sobre categorias destacadas.

CampoTipoDescrição
idIntegerIdentificador único da categoria.
featuredBooleanIndica se a categoria é destacada.
parent_idIntegerID da categoria pai (ou null se for uma categoria principal).
is_parentBooleanIndica se a categoria é uma categoria pai.
nameStringNome da categoria.
slugStringIdentificador amigável para URL da categoria.
urlStringURL completa da categoria.
url_pathStringCaminho relativo para acesso direto à categoria, com parâmetros de ordenação incluídos.
pathStringCaminho completo de navegação da categoria, exibido no formato textual.
category_coverMixedURL da imagem de capa da categoria (ou null se não tiver uma).
orderIntegerOrdem de exibição da categoria em relação às outras.

categories

Contém informações sobre todas as categorias disponíveis.

CampoTipoDescrição
idIntegerIdentificador único da categoria.
featuredBooleanIndica se a categoria é destacada.
parent_idIntegerID da categoria pai (ou null se for uma categoria principal).
is_parentBooleanIndica se a categoria é uma categoria pai.
nameStringNome da categoria.
slugStringIdentificador amigável para URL da categoria.
urlStringURL completa da categoria.
url_pathStringCaminho relativo para acesso direto à categoria, com parâmetros de ordenação incluídos.
pathStringCaminho completo de navegação da categoria, exibido no formato textual.
category_coverMixedURL da imagem de capa da categoria (ou null se não tiver uma).
orderIntegerOrdem de exibição da categoria em relação às outras.
childrenArrayLista de subcategorias, se houver.

pageConfig

Contém informações sobre a configuração da página.

CampoTipoDescrição
pageStringNome da página atual (por exemplo, product).
themeArrayInformações sobre o tema da página.
sectionsArrayLista de seções da página, contendo detalhes sobre cada seção.

Variáveis na Página de Produto

product

Contém informações detalhadas sobre o produto.

CampoTipoDescrição
idIntegerIdentificador único do produto.
sku_idIntegerID do SKU do produto.
gift_valueFloatValor associado ao produto como presente, se aplicável.
simpleBooleanIndica se o produto é simples ou possui variações.
has_variationsBooleanIndica se o produto possui variações.
is_digitalBooleanIndica se o produto é digital.
warrantyIntegerGarantia do produto, em meses.
custom_shippingBooleanIndica se o produto possui frete personalizado.
shipping_priceFloatValor do frete, se personalizado.
nameStringNome do produto.
slugStringIdentificador amigável para URL do produto.
skuStringSKU do produto.
blocked_saleBooleanIndica se a venda do produto está bloqueada.
ratingFloatClassificação do produto.
total_approved_reviewsIntegerNúmero total de avaliações aprovadas.
urlStringURL completa do produto.
url_pathStringCaminho relativo do produto.
use_different_imagesBooleanIndica se o produto usa imagens diferentes para variações.
brandArrayInformações da marca do produto.
imagesArrayLista de URLs das imagens do produto.
pricesArrayInformações de preços e descontos do produto.
flagsArraySinais adicionais para o produto, como etiquetas especiais.
variationsArrayLista de variações disponíveis do produto.
skusArrayConjunto de SKUs adicionais associados ao produto.
extrasArrayInformações extras associadas ao produto.
textsArrayTextos adicionais relacionados ao produto, como descrição e instruções.
seoArrayInformações de SEO do produto, como título e meta descrições.
categoriesArrayCategorias às quais o produto pertence.
breadcrumbsArrayEstrutura de navegação para o produto (breadcrumb).

product.brand

Contém informações sobre a marca do produto.

CampoTipoDescrição
idIntegerIdentificador da marca.
nameStringNome da marca.
logo_urlStringURL do logotipo da marca (se disponível).

product.images

Contém URLs das imagens do produto.

CampoTipoDescrição
urlStringURL da imagem do produto.

product.prices

Contém informações sobre preços e descontos.

CampoTipoDescrição
currencyStringMoeda do preço.
price_costFloatCusto do produto.
price_cost_formatedStringCusto do produto formatado.
priceFloatPreço do produto.
price_formatedStringPreço do produto formatado.
price_saleFloatPreço de venda do produto.
price_sale_formatedStringPreço de venda formatado.
price_discountFloatPreço com desconto do produto.
price_discount_formatedStringPreço com desconto formatado.
has_promotionBooleanIndica se o produto tem promoção.
percent_discountFloatPercentual de desconto do produto.
billetArrayInformações sobre o preço do produto via boleto.
pixArrayInformações sobre o preço do produto via Pix.
installmentsArrayInformações sobre as parcelas do produto.

product.flags

Contém bandeiras adicionais para o produto.

CampoTipoDescrição
dataArrayLista de bandeiras adicionais para o produto.

product.variations

Contém variações disponíveis do produto.

CampoTipoDescrição
dataArrayLista de variações disponíveis do produto.

product.skus

Contém informações sobre SKUs adicionais.

CampoTipoDescrição
idIntegerIdentificador do SKU.
product_idIntegerID do produto associado ao SKU.
skuStringSKU do produto.
blocked_saleBooleanIndica se a venda do SKU está bloqueada.
titleStringTítulo do SKU.
availabilityIntegerDisponibilidade do SKU.
days_availability_formatedStringDisponibilidade formatada do SKU.
price_saleFloatPreço de venda do SKU.
price_discountFloatPreço com desconto do SKU.
combinationsStringCombinações disponíveis para o SKU.
orderIntegerOrdem de exibição do SKU.
total_in_stockIntegerTotal em estoque do SKU.
allow_sell_without_customizationBooleanIndica se é permitido vender sem personalização.

product.extras

Contém informações extras associadas ao produto.

CampoTipoDescrição
videoStringURL do vídeo relacionado ao produto.
total_in_stockIntegerTotal em estoque do produto.
for_giftBooleanIndica se o produto é para presente.

product.texts

Contém textos adicionais relacionados ao produto.

CampoTipoDescrição
descriptionStringDescrição do produto.
specificationsStringEspecificações do produto.
measuresStringMedidas do produto.

product.seo

Contém informações de SEO do produto.

CampoTipoDescrição
seo_titleStringTítulo SEO do produto.
seo_descriptionStringDescrição SEO do produto.
seo_keywordsStringPalavras-chave SEO do produto.
canonical_urlStringURL canônica do produto.

product.categories

Contém categorias às quais o produto pertence.

CampoTipoDescrição
idIntegerIdentificador da categoria.
nameStringNome da categoria.
parent_idIntegerID da categoria pai (se houver).
slugStringIdentificador amigável para URL da categoria.
url_pathStringCaminho relativo da categoria.

product.breadcrumbs

Contém estrutura de navegação para o produto (breadcrumb).

CampoTipoDescrição
idIntegerIdentificador da categoria de breadcrumb.
nameStringNome da categoria de breadcrumb.
url_pathStringCaminho relativo da categoria de breadcrumb.