O schema geral da API é disponibilizado através do Playground. Nele é possível verificar os campos disponíveis, seus tipos e descrições.

Schema Types

Table of Contents

Query (QueryRoot)

FieldArgumentTypeDescription
autocompleteAutocomplete

Get query completion suggestion.

limitInt
partnerAccessTokenString

The partner access token.

queryString
bannersBannersConnection

List of banners.

afterString

Returns the elements in the list that come after the specified cursor.

bannerIds[Long!]

Filter the list by specific banner ids.

beforeString

Returns the elements in the list that come before the specified cursor.

firstInt

Returns the first n elements from the list.

lastInt

Returns the last n elements from the list.

partnerAccessTokenString
sortDirectionSortDirection!
sortKeyBannerSortKeys!
brandsBrandsConnection

List of brands

afterString

Returns the elements in the list that come after the specified cursor.

beforeString

Returns the elements in the list that come before the specified cursor.

brandInputBrandFilterInput

Brand input

firstInt

Returns the first n elements from the list.

lastInt

Returns the last n elements from the list.

sortDirectionSortDirection!
sortKeyBrandSortKeys!
categoriesCategoriesConnection

List of categories.

afterString

Returns the elements in the list that come after the specified cursor.

beforeString

Returns the elements in the list that come before the specified cursor.

categoryIds[Long!]

Filter the list by specific category ids.

firstInt

Returns the first n elements from the list.

lastInt

Returns the last n elements from the list.

sortDirectionSortDirection!
sortKeyCategorySortKeys!
checkoutCheckout

Get info from the checkout cart corresponding to the given ID.

checkoutIdString!

The cart ID used for checkout operations.

contentsContentsConnection

List of contents.

afterString

Returns the elements in the list that come after the specified cursor.

beforeString

Returns the elements in the list that come before the specified cursor.

contentIds[Long!]

Filter the list by specific content ids.

firstInt

Returns the first n elements from the list.

lastInt

Returns the last n elements from the list.

sortDirectionSortDirection!
sortKeyContentSortKeys!
customerCustomer

Get informations about a customer from the store.

customerAccessTokenString

The customer access token.

hotsiteSingleHotsite

Retrieve a single hotsite. A hotsite consists of products, banners and contents.

hotsiteIdLong
urlString
hotsitesHotsitesConnection

List of the shop's hotsites. A hotsite consists of products, banners and contents.

afterString

Returns the elements in the list that come after the specified cursor.

beforeString

Returns the elements in the list that come before the specified cursor.

firstInt

Returns the first n elements from the list.

hotsiteIds[Long!]

Filter the list by specific hotsite ids.

lastInt

Returns the last n elements from the list.

partnerAccessTokenString
sortDirectionSortDirection!
sortKeyHotsiteSortKeys!
menuGroups[MenuGroup]

List of menu groups.

partnerAccessTokenString
positionString
urlString!
nodeNode
idID!
nodes[Node]
ids[ID!]!
partnersPartnersConnection

List of partners.

afterString

Returns the elements in the list that come after the specified cursor.

beforeString

Returns the elements in the list that come before the specified cursor.

firstInt

Returns the first n elements from the list.

lastInt

Returns the last n elements from the list.

names[String]

Filter the list by specific names.

priceTableIds[Int!]

Filter the list by specific price table ids.

sortDirectionSortDirection!
sortKeyPartnerSortKeys!
productSingleProduct

Retrieve a product by the given id.

partnerAccessTokenString

The partner access token.

productIdLong!

The product ID.

productOptions ÔÜá´©ÅProductOption

Options available for the given product.

ÔÜá´©Å DEPRECATED

Use the product query.

productIdLong!
productRecommendations[Product]

Retrieve a list of recommended products by product id.

algorithmProductRecommendationAlgorithm!

Algorithm type.

partnerAccessTokenString

The partner access token.

productIdLong!

The product identifier.

quantityInt!

The number of product recommendations.

productsProductsConnection

Retrieve a list of products by specific filters.

afterString

Returns the elements in the list that come after the specified cursor.

beforeString

Returns the elements in the list that come before the specified cursor.

filtersProductExplicitFiltersInput!

The product filters to apply.

firstInt

Returns the first n elements from the list.

lastInt

Returns the last n elements from the list.

partnerAccessTokenString

The partner access token.

sortDirectionSortDirection!
sortKeyProductSortKeys!
scripts[Script]

Retrieve a list of scripts.

nameString

The script name.

pageType[ScriptPageType!]

The script page type list.

positionScriptPosition

The script position.

urlString

Url for available scripts.

searchSearch

Search products with cursor pagination.

operationOperation!

The operation to perform between quuery terms.

partnerAccessTokenString

The partner access token.

queryString

The search query.

shippingQuotes[ShippingQuote]

Get the shipping quotes by providing CEP and checkout or product identifier.

cepCEP

CEP to get the shipping quotes.

checkoutIdUuid

Checkout identifier to get the shipping quotes.

productVariantIdLong

Product identifier to get the shipping quotes.

shopShop

Store informations

shopSettings[ShopSetting]

Store settings

settingNames[String]

Setting names

uriUri

Get the URI kind.

urlString!

Mutation

FieldArgumentTypeDescription
checkoutAddProductCheckout

Add products to an existing checkout

inputCheckoutProductInput!

Params to add products to an existing checkout

checkoutRemoveProductCheckout

Remove products from an existing checkout

inputCheckoutProductInput!

Params to remove products from an existing checkout

createCheckoutCheckout

Create a new checkout

products[CheckoutProductItemInput]
createNewsletterRegisterNewsletterNode

Register an email in the newsletter.

inputNewsletterInput!
createProductReviewReview

Adds a review to a product variant.

inputReviewCreateInput!
customerAccessTokenCreateCustomerAccessToken

Creates a new customer access token with an expiration time.

inputCustomerAccessTokenInput!
customerAccessTokenRenewCustomerAccessToken

Renews the expiration time of a customer access token. The token must not be expired.

customerAccessTokenString!
updateAddressCustomerAddressNode

Change an existing address

addressCustomerAddressInput!
customerAccessTokenString!
idID

The customer address unique identifier.

wishlistAddProduct[Product]

Adds a product to the customer's wishlist.

customerAccessTokenString!

A customer's access token

productIdLong!

ID of the product to be added to the customer's wishlist

wishlistRemoveProduct[Product]

Removes a product from the customer's wishlist.

customerAccessTokenString!

A customer's access token

productIdLong!

ID of the product to be removed from the customer's wishlist

Objects

Attribute

Attributes available for the variant products from the given productId.

FieldArgumentTypeDescription
attributeIdLong!

The id of the attribute.

displayTypeString

The display type of the attribute.

idID

The node unique identifier.

nameString

The name of the attribute.

typeString

The type of the attribute.

values[AttributeValue]

The values of the attribute.

AttributeMatrix

FieldArgumentTypeDescription
columnAttributeMatrixInfo

Information about the column attribute.

data[[AttributeMatrixProduct]]

The matrix products data. List of rows.

rowAttributeMatrixInfo

Information about the row attribute.

AttributeMatrixInfo

FieldArgumentTypeDescription
displayTypeString
nameString
values[AttributeMatrixRowColumnInfoValue]

AttributeMatrixProduct

FieldArgumentTypeDescription
availableBoolean!
productVariantIdLong!
stockLong!

AttributeMatrixRowColumnInfoValue

FieldArgumentTypeDescription
printUrlString
valueString

AttributeSelection

Attributes available for the variant products from the given productId.

FieldArgumentTypeDescription
canBeMatrixBoolean!

Check if the current product attributes can be rendered as a matrix.

matrixAttributeMatrix

Informations about the attribute matrix.

selectedVariantProductVariant

The selected variant given the current input filters. Variant may be from brother product Id.

selections[AttributeSelectionOption]

Attributes available for the variant products from the given productId.

AttributeSelectionOption

Attributes available for the variant products from the given productId.

FieldArgumentTypeDescription
attributeIdLong!

The id of the attribute.

displayTypeString

The display type of the attribute.

nameString

The name of the attribute.

values[AttributeSelectionOptionValue]

The values of the attribute.

varyByParentBoolean!

If the attributes varies by parent.

AttributeSelectionOptionValue

FieldArgumentTypeDescription
aliasString
availableBoolean!
printUrlString
selectedBoolean!
valueString

The value of the attribute.

AttributeValue

Attributes values with variants

FieldArgumentTypeDescription
productVariants[ProductVariant]

Product variants that have the attribute.

valueString

The value of the attribute.

Autocomplete

Get query completion suggestion.

FieldArgumentTypeDescription
products[Product]

Suggested products based on the current query.

suggestions[String]

List of possible query completions.

Banner

A banner is usually an image used to show sales, highlight products, announcements or to redirect to another page or hotsite on click.

FieldArgumentTypeDescription
altTextString

Banner's alternative text.

bannerIdLong!

Banner unique identifier.

bannerNameString

Banner's name.

bannerUrlString

URL where the banner is stored.

creationDateDateTime

The date the banner was created.

displayOnAllPagesBoolean!

Field to check if the banner should be displayed on all pages.

displayOnCategoriesBoolean!

Field to check if the banner should be displayed on category pages.

displayOnSearchesBoolean!

Field to check if the banner should be displayed on search pages.

displayOnWebsiteBoolean!

Field to check if the banner should be displayed on the website.

displayToPartnersBoolean!

Field to check if the banner should be displayed to partners.

heightInt

The banner's height in px.

idID

The node unique identifier.

openNewTabBoolean!

Field to check if the banner URL should open in another tab on click.

orderInt!

The displaying order of the banner.

positionString

The displaying position of the banner.

searchTerms[String]

A list of terms to display the banner on search.

titleString

The banner's title.

urlOnClickString

URL to be redirected on click.

widthInt

The banner's width in px.

BannersConnection

A connection to a list of items.

FieldArgumentTypeDescription
edges[BannersEdge!]

A list of edges.

nodes[Banner]

A flattened list of the nodes.

pageInfoPageInfo!

Information to aid in pagination.

BannersEdge

An edge in a connection.

FieldArgumentTypeDescription
cursorString!

A cursor for use in pagination.

nodeBanner

The item at the end of the edge.

BestInstallment

FieldArgumentTypeDescription
discountBoolean!

Wether the installment has discount.

displayNameString

The custom display name of the best installment plan option.

feesBoolean!

Wether the installment has fees.

nameString

The name of the best installment plan option.

numberInt!

The number of installments.

valueDecimal!

The value of the installment.

Brand

Informations about brands and its products.

FieldArgumentTypeDescription
activeBoolean!

If the brand is active at the platform.

aliasString

The alias for the brand's hotsite.

brandIdLong!

Brand unique identifier.

createdAtDateTime!

The date the brand was created in the database.

idID

The node unique identifier.

nameString

The brand's name.

productsProductsConnection

A list of products from the brand.

afterString

Returns the elements in the list that come after the specified cursor.

beforeString

Returns the elements in the list that come before the specified cursor.

firstInt

Returns the first n elements from the list.

lastInt

Returns the last n elements from the list.

partnerAccessTokenString
sortDirectionSortDirection!
sortKeyProductSortKeys!
updatedAtDateTime!

The last update date.

urlCarrosselString

A web address to be redirected.

urlLinkString

A web address linked to the brand.

urlLogoString

The url of the brand's logo.

BrandsConnection

A connection to a list of items.

FieldArgumentTypeDescription
edges[BrandsEdge!]

A list of edges.

nodes[Brand]

A flattened list of the nodes.

pageInfoPageInfo!

Information to aid in pagination.

totalCountInt!

BrandsEdge

An edge in a connection.

FieldArgumentTypeDescription
cursorString!

A cursor for use in pagination.

nodeBrand

The item at the end of the edge.

Breadcrumb

Informations about breadcrumb.

FieldArgumentTypeDescription
linkString

Breadcrumb link.

textString

Breadcrumb text.

CategoriesConnection

A connection to a list of items.

FieldArgumentTypeDescription
edges[CategoriesEdge!]

A list of edges.

nodes[Category]

A flattened list of the nodes.

pageInfoPageInfo!

Information to aid in pagination.

CategoriesEdge

An edge in a connection.

FieldArgumentTypeDescription
cursorString!

A cursor for use in pagination.

nodeCategory

The item at the end of the edge.

Category

Categories are used to arrange your products into different sections by similarity.

FieldArgumentTypeDescription
categoryIdLong!

Category unique identifier.

children[Category]

A list of child categories, if it exists.

descriptionString

A description to the category.

displayMenuBoolean!

Field to check if the category is displayed in the store's menu.

hotsiteAliasString

The hotsite alias.

hotsiteUrlString

The URL path for the category.

idID

The node unique identifier.

imageUrlString

The url to access the image linked to the category.

imageUrlLinkString

The web address to access the image linked to the category.

nameString

The category's name.

parentCategory

The parent category, if it exists.

parentCategoryIdLong!

The parent category unique identifier.

positionInt!

The position the category will be displayed.

productsProductsConnection

A list of products associated with the category.

afterString

Returns the elements in the list that come after the specified cursor.

beforeString

Returns the elements in the list that come before the specified cursor.

firstInt

Returns the first n elements from the list.

lastInt

Returns the last n elements from the list.

partnerAccessTokenString
sortDirectionSortDirection!
sortKeyProductSortKeys!
urlLinkString

A web address linked to the category.

Checkout

FieldArgumentTypeDescription
cepInt

The CEP.

checkoutIdUuid!

The checkout unique identifier.

couponString

The coupon for discounts.

idID

The node unique identifier.

loginString
products[CheckoutProductNode]

A list of products associated with the checkout.

shippingFeeDecimal!

The shipping fee.

subtotalDecimal!

The subtotal value.

totalDecimal!

The total value.

updateDateDateTime!

The last update date.

urlString

Url for the current checkout id.

CheckoutProductAttributeNode

FieldArgumentTypeDescription
nameString

The attribute name

typeInt!

The attribute type

valueString

The attribute value

CheckoutProductNode

FieldArgumentTypeDescription
ajustedPriceDecimal!

The product adjusted price

brandString

The product brand

categoryString

The product category

giftBoolean!

The product is a gift

googleCategory[String]

The product Google category

imageUrlString

The product URL image

informations[String]

The product informations

installmentFeeBoolean!

The product installment fee

installmentValueDecimal!

The product installment value

listPriceDecimal!

The product list price

nameString

The product name

numberOfInstallmentsInt!

The product number of installments

priceDecimal!

The product price

productAttributes[CheckoutProductAttributeNode]

The product attributes

productIdLong!

The product unique identifier.

productVariantIdLong!

The product variant unique identifier.

quantityInt!

The product quantity

shippingDeadlineCheckoutShippingDeadlineNode

The product shipping deadline

skuString

The product SKU

urlString

The product URL

CheckoutShippingDeadlineNode

FieldArgumentTypeDescription
deadlineInt!

The shipping deadline

descriptionString

The shipping description

secondDescriptionString

The shipping second description

secondTitleString

The shipping second title

titleString

The shipping title

Content

Contents are used to show things to the user.

FieldArgumentTypeDescription
contentString

The content in html to be displayed.

contentIdLong!

Content unique identifier.

creationDateDateTime

The date the content was created.

heightInt

The content's height in px.

idID

The node unique identifier.

positionString

The content's position.

searchTerms[String]

A list of terms to display the content on search.

titleString

The content's title.

widthInt

The content's width in px.

ContentsConnection

A connection to a list of items.

FieldArgumentTypeDescription
edges[ContentsEdge!]

A list of edges.

nodes[Content]

A flattened list of the nodes.

pageInfoPageInfo!

Information to aid in pagination.

ContentsEdge

An edge in a connection.

FieldArgumentTypeDescription
cursorString!

A cursor for use in pagination.

nodeContent

The item at the end of the edge.

Customer

A customer from the store.

FieldArgumentTypeDescription
birthDateDateTime!

Customer's birth date.

businessPhoneNumberString

Customer's business phone number.

cnpjString

Taxpayer identification number for businesses.

companyNameString

Entities legal name.

cpfString

Brazilian individual taxpayer registry identification.

creationDateDateTime!

Creation Date.

customerIdLong!

Customer's unique identifier.

customerNameString

Customer's name.

customerTypeString

Indicates if it is a natural person or company profile.

deliveryAddressCustomerAddressNode

Customer's delivery address.

emailString

Customer's email address.

genderString

Customer's gender.

idID

The node unique identifier.

mobilePhoneNumberString

Customer's mobile phone number.

ordersStatisticsCustomerOrdersStatistics

Statistics about the orders the customer made in a specific timeframe.

dateGteDateTime

Filter que customer orders by date greater than or equal the specified date.

dateLtDateTime

Filter que customer orders by date lesser than the specified date.

onlyPaidOrdersBoolean!

Toggle to apply the statistics only on orders with paid status.

partnerIdLong

The partner id which the order was made with.

partners[CustomerPartnerNode]

Get info about the associated partners.

phoneNumberString

Customer's phone number.

residencialAddressCustomerAddressNode

Customer's residencial address.

responsibleNameString

Responsible's name.

rgString

Registration number Id.

stateRegistrationString

State registration number.

updateDateDateTime!

Date of the last update.

wishlistwishlist

Customer wishlist.

CustomerAccessToken

FieldArgumentTypeDescription
tokenString
validUntilDateTime!

CustomerAddressNode

FieldArgumentTypeDescription
activeBoolean!

If the address is active or not.

addressDetailsString

Address details.

addressNumberString

Address number.

cepString

zip code.

cityString

address city.

countryString

Country.

emailString

The email of the customer address.

idID

The node unique identifier.

nameString

The name of the customer address.

neighborhoodString

Address neighborhood.

phoneString

The phone of the customer address.

referencePointString

Address reference point.

stateString

State.

streetString

Address street.

CustomerOrdersStatistics

FieldArgumentTypeDescription
productsQuantityInt!

The number of products the customer made from the number of orders.

quantityInt!

The number of orders the customer made.

CustomerPartnerNode

FieldArgumentTypeDescription
aliasString

The partner alias.

nameString

The partner's name.

partnerAccessTokenString

The partner's access token.

Customization

Some products can have customizations, such as writing your name on it or other predefined options.

FieldArgumentTypeDescription
costDecimal!

Cost of customization.

customizationIdLong!

Customization unique identifier.

groupNameString

Customization group's name.

idID

The node unique identifier.

nameString

The customization's name.

orderInt!

Priority order of customization.

typeString

Type of customization.

values[String]

Value of customization.

Hotsite

A hotsite is a group of products used to organize them or to make them easier to browse.

FieldArgumentTypeDescription
banners[Banner]

A list of banners associated with the hotsite.

contents[Content]

A list of contents associated with the hotsite.

endDateDateTime

The hotsite will be displayed until this date.

expressionString

Expression used to associate products to the hotsite.

hotsiteIdLong!

Hotsite unique identifier.

idID

The node unique identifier.

nameString

The hotsite's name.

pageSizeInt!

Set the quantity of products displayed per page.

productsProductsConnection

A list of products associated with the hotsite.

afterString

Returns the elements in the list that come after the specified cursor.

beforeString

Returns the elements in the list that come before the specified cursor.

firstInt

Returns the first n elements from the list.

lastInt

Returns the last n elements from the list.

sortDirectionSortDirection!
sortKeyProductSortKeys!
sortingHotsiteSorting

Sorting information to be used by default on the hotsite.

startDateDateTime

The hotsite will be displayed from this date.

subtypeHotsiteSubtype

The subtype of the hotsite.

templateString

The template used for the hotsite.

urlString

The hotsite's URL.

HotsiteSorting

FieldArgumentTypeDescription
directionSortDirection
fieldProductSortKeys

HotsitesConnection

A connection to a list of items.

FieldArgumentTypeDescription
edges[HotsitesEdge!]

A list of edges.

nodes[Hotsite]

A flattened list of the nodes.

pageInfoPageInfo!

Information to aid in pagination.

HotsitesEdge

An edge in a connection.

FieldArgumentTypeDescription
cursorString!

A cursor for use in pagination.

nodeHotsite

The item at the end of the edge.

Image

Informations about an image of a product.

FieldArgumentTypeDescription
fileNameString

The name of the image file.

miniBoolean!

Check if the image is used for the product main image.

orderInt!

Numeric order the image should be displayed.

printBoolean!

Check if the image is used for the product prints only.

urlString

The url to retrieve the image

Information

Information registred to the product.

FieldArgumentTypeDescription
idLong!

The information id.

titleString

The information title.

typeString

The information type.

valueString

The information value.

Installment

FieldArgumentTypeDescription
discountBoolean!

Wether the installment has discount.

feesBoolean!

Wether the installment has fees.

numberInt!

The number of installments.

valueDecimal!

The value of the installment.

InstallmentPlan

FieldArgumentTypeDescription
displayNameString

The custom display name of this installment plan.

installments[Installment]

List of the installments.

nameString

The name of this installment plan.

Menu

Informations about menu items.

FieldArgumentTypeDescription
cssClassString

Menu css class to apply.

idID

The node unique identifier.

imageUrlString

Menu image url address.

levelInt!

Menu hierarchy level.

linkString

Menu link address.

menuGroupIdInt!

Menu group identifier.

menuIdInt!

Menu identifier.

nameString!

Menu name.

openNewTabBoolean!

Menu hierarchy level.

orderInt!

Menu position order.

parentMenuIdInt

Parent menu identifier.

textString

Menu extra text.

MenuGroup

Informations about menu groups.

FieldArgumentTypeDescription
idID

The node unique identifier.

imageUrlString

Menu group image url.

menuGroupIdInt!

Menu group identifier.

menus[Menu]

List of menus associated with the current group

nameString

Menu group name.

partnerIdInt

Menu group partner id.

positionString

Menu group position.

NewsletterNode

FieldArgumentTypeDescription
createDateDateTime!

Newsletter creation date.

emailString

The newsletter receiver email.

nameString

The newsletter receiver name.

updateDateDateTime

Newsletter update date.

PageInfo

Information about pagination in a connection.

FieldArgumentTypeDescription
endCursorString

When paginating forwards, the cursor to continue.

hasNextPageBoolean!

Indicates whether more edges exist following the set defined by the clients arguments.

hasPreviousPageBoolean!

Indicates whether more edges exist prior the set defined by the clients arguments.

startCursorString

When paginating backwards, the cursor to continue.

Partner

Partners are used to assign specific products or price tables depending on its scope.

FieldArgumentTypeDescription
aliasString

The partner alias.

endDateDateTime!

The partner is valid until this date.

idID

The node unique identifier.

logoUrlString

The pertner logo's URL.

nameString

The partner's name.

originString

The partner's origin.

partnerAccessTokenString

The partner's access token.

partnerIdLong!

Partner unique identifier.

portfolioIdInt!

Portfolio identifier assigned to this partner.

priceTableIdInt!

Price table identifier assigned to this partner.

startDateDateTime!

The partner is valid from this date.

typeString

The type of scoped the partner is used.

PartnersConnection

A connection to a list of items.

FieldArgumentTypeDescription
edges[PartnersEdge!]

A list of edges.

nodes[Partner]

A flattened list of the nodes.

pageInfoPageInfo!

Information to aid in pagination.

PartnersEdge

An edge in a connection.

FieldArgumentTypeDescription
cursorString!

A cursor for use in pagination.

nodePartner

The item at the end of the edge.

PriceRange

Range of prices for this product.

FieldArgumentTypeDescription
quantityInt!

The quantity of products in this range.

rangeString

The price range.

PriceTable

FieldArgumentTypeDescription
discountPercentageDecimal!

The amount of discount in percentage.

idLong!

The id of this price table.

listPriceDecimal

The listed regular price of this table.

priceDecimal!

The current working price of this table.

Prices

The prices of the product.

FieldArgumentTypeDescription
bestInstallmentBestInstallment

The best installment option available.

discountPercentageDecimal!

The amount of discount in percentage.

discountedBoolean!

Wether the current price is discounted.

installmentPlans[InstallmentPlan]

List of the possibles installment plans.

listPriceDecimal

The listed regular price of the product.

multiplicationFactorFloat!

The multiplication factor used for items that are sold by quantity.

priceDecimal!

The current working price.

priceTables[PriceTable]

List of the product different price tables.

Only returned when using the partnerAccessToken or public price tables.

Product

A product represents an item for sale in the store.

FieldArgumentTypeDescription
addToCartFromSpotBoolean

Check if the product can be added to cart directly from spot.

aliasString

The product url alias.

attributes[ProductAttribute]

List of the product attributes.

availableBoolean

Field to check if the product is available in stock.

averageRatingInt

The product average rating. From 0 to 5.

conditionString

The product condition.

createdAtDateTime

The product creation date.

deadlineInt

The product delivery deadline.

displayBoolean

Check if the product should be displayed.

displayOnlyPartnerBoolean

Check if the product should be displayed only for partners.

displaySearchBoolean

Check if the product should be displayed on search.

eanString

The product's unique EAN.

freeShippingBoolean

Check if the product offers free shipping.

idID

The node unique identifier.

images[Image]

List of the product images.

heightInt

The height of the image the url will return.

widthInt

The width of the image the url will return.

informations[Information]

List of the product insformations.

mainVariantBoolean

Check if its the main variant.

minimumOrderQuantityInt

The product minimum quantity for an order.

newReleaseBoolean

Check if the product is a new release.

numberOfVotesInt

The number of votes that the average rating consists of.

parentIdLong

Parent product unique identifier.

pricesPrices

The product prices.

productBrandProductBrand

Summarized informations about the brand of the product.

productCategories[ProductCategory]

Summarized informations about the categories of the product.

productIdLong

Product unique identifier.

productNameString

The product name.

productSubscriptionProductSubscription

Summarized informations about the subscription of the product.

productVariantIdLong

Variant unique identifier.

promotions[Promotion]

List of promotions this product belongs to.

similarProducts[SimilarProduct]

List of similar products.

skuString

The product's unique SKU.

spotAttributes[String]

The values of the spot attribute.

spotInformationString

The product spot information.

spotlightBoolean

Check if the product is on spotlight.

stockLong

The available stock at the default distribution center.

stocks[Stock]

List of the product stocks on different distribution centers.

subscriptionGroups[SubscriptionGroup]

List of subscription groups this product belongs to.

telesalesBoolean

Check if the product is a telesale.

updatedAtDateTime

The product last update date.

variantNameString

The variant name.

ProductAggregations

FieldArgumentTypeDescription
filters[SearchFilter]

List of product filters which can be used to filter subsequent queries.

maximumPriceDecimal!

Minimum price of the products.

minimumPriceDecimal!

Maximum price of the products.

priceRanges[PriceRange]

List of price ranges for the selected products.

ProductAttribute

The attributes of the product.

FieldArgumentTypeDescription
attributeIdLong!

The id of the attribute.

displayTypeString

The display type of the attribute.

idID

The node unique identifier.

nameString

The name of the attribute.

typeString

The type of the attribute.

valueString

The value of the attribute.

ProductBrand

FieldArgumentTypeDescription
aliasString

The hotsite url alias fot this brand.

idLong!

The brand id.

logoUrlString

The url that contains the brand logo image.

nameString

The name of the brand.

ProductCategory

Information about the category of a product.

FieldArgumentTypeDescription
activeBoolean!

Wether the category is currently active.

googleCategoriesString

The categories in google format.

hierarchyString

The category hierarchy.

idInt!

The id of the category.

mainBoolean!

Wether this category is the main category for this product.

nameString

The category name.

urlString

The category hotsite url alias.

ProductCollectionSegment

FieldArgumentTypeDescription
items[Product]
pageInt!
pageSizeInt!
totalCountInt!

ProductOption

Options available for the given product.

FieldArgumentTypeDescription
attributes[Attribute]

A list of attributes available for the given product and its variants.

filter[AttributeFilterInput]
customizations[Customization]

A list of customizations available for the given products.

idID

The node unique identifier.

ProductSubscription

FieldArgumentTypeDescription
discountDecimal!

The amount of discount if this product is sold as a subscription.

priceDecimal

The price of the product when sold as a subscription.

subscriptionOnlyBoolean!

Wether this product is sold only as a subscrition.

ProductVariant

Product variants that have the attribute.

FieldArgumentTypeDescription
aliasString

The product alias.

availableBoolean

Field to check if the product is available in stock.

idID

The node unique identifier.

images[Image]

The product's images.

heightInt

The height of the image the url will return.

widthInt

The width of the image the url will return.

pricesPrices

The product prices.

productIdLong

Product unique identifier.

productVariantIdLong

Variant unique identifier.

stockLong

The available stock at the default distribution center.

ProductsConnection

A connection to a list of items.

FieldArgumentTypeDescription
edges[ProductsEdge!]

A list of edges.

nodes[Product]

A flattened list of the nodes.

pageInfoPageInfo!

Information to aid in pagination.

totalCountInt!

ProductsEdge

An edge in a connection.

FieldArgumentTypeDescription
cursorString!

A cursor for use in pagination.

nodeProduct

The item at the end of the edge.

Promotion

Information about promotions of a product.

FieldArgumentTypeDescription
contentString

The promotion html content.

idLong!

The promotion id.

stampString

The stamp of the promotion.

titleString

The promotion title.

Review

A product review written by a customer.

FieldArgumentTypeDescription
customerString

The reviewer name.

emailString

The reviewer e-mail.

ratingInt!

The review rating.

reviewString

The review content.

reviewDateDateTime!

The review date.

SEO

Entity SEO information.

FieldArgumentTypeDescription
contentString

Content of SEO.

httpEquivString

Equivalent SEO type for HTTP.

nameString

Name of SEO.

schemeString

Scheme for SEO.

typeString

Type of SEO.

Script

Returns the scripts registered in the script manager.

FieldArgumentTypeDescription
contentString

The script content.

nameString

The script name.

pageTypeScriptPageType!

The script page type.

positionScriptPosition!

The script position.

priorityInt!

The script priority.

Search

Search for relevant products to the searched term.

FieldArgumentTypeDescription
aggregationsProductAggregations

Aggregations from the products.

banners[Banner]

A list of banners displayed in search pages.

breadcrumbs[Breadcrumb]

List of search breadcrumbs.

contents[Content]

A list of contents displayed in search pages.

forbiddenTermforbiddenTerm

Information about forbidden term.

productsProductsConnection

A cursor based paginated list of products from the search.

afterString

Returns the elements in the list that come after the specified cursor.

beforeString

Returns the elements in the list that come before the specified cursor.

filters[ProductFilterInput]

List of filters. Check filters result for available inputs.

firstInt

Returns the first n elements from the list.

lastInt

Returns the last n elements from the list.

maximumPriceDecimal

Maximum price filter.

minimumPriceDecimal

Minimum price filter.

onlyMainVariantBoolean!

Toggle the return of only main variants.

sortDirectionSortDirection!
sortKeyProductSearchSortKeys!
productsByOffsetProductCollectionSegment

An offset based paginated list of products from the search.

filters[ProductFilterInput]

List of filters. Check filters result for available inputs.

limitInt!

The number of products to return.

maximumPriceDecimal

Maximum price filter.

minimumPriceDecimal

Minimum price filter.

offsetInt!

The offset used to paginate.

onlyMainVariantBoolean!

Toggle the return of only main variants.

sortDirectionSortDirection!
sortKeyProductSearchSortKeys!
redirectUrlString

Redirection url in case a term in the search triggers a redirect.

searchTimeString

Time taken to perform the search.

SearchFilter

Aggregated filters of a list of products.

FieldArgumentTypeDescription
fieldString

The name of the field.

originString

The origin of the field.

values[SearchFilterItem]

List of the values of the field.

SearchFilterItem

Details of a filter value.

FieldArgumentTypeDescription
nameString

The name of the value.

quantityInt!

The quantity of product with this value.

ShippingProduct

The product informations related to the shipping.

FieldArgumentTypeDescription
productVariantIdInt!

The product unique identifier.

valueFloat!

The shipping value related to the product.

ShippingQuote

A shipping quote.

FieldArgumentTypeDescription
deadlineInt!

The shipping deadline.

idID

The node unique identifier.

nameString

The shipping name.

products[ShippingProduct]

The products related to the shipping.

shippingQuoteIdUuid!

The shipping quote unique identifier.

typeString

The shipping type.

valueFloat!

The shipping value.

Shop

Informations about the store.

FieldArgumentTypeDescription
checkoutUrlString

Checkout URL

mainUrlString

Store main URL

mobileCheckoutUrlString

Mobile checkout URL

mobileUrlString

Mobile URL

nameString

Store name

ShopSetting

Store setting.

FieldArgumentTypeDescription
nameString

Setting name

valueString

Setting value

SimilarProduct

Information about a similar product.

FieldArgumentTypeDescription
aliasString

The url alias of this similar product.

imageString

The file name of the similar product image.

nameString

The name of the similar product.

SingleHotsite

A hotsite is a group of products used to organize them or to make them easier to browse.

FieldArgumentTypeDescription
aggregationsProductAggregations

Aggregations from the products.

banners[Banner]

A list of banners associated with the hotsite.

breadcrumbs[Breadcrumb]

A list of breadcrumbs for the hotsite.

contents[Content]

A list of contents associated with the hotsite.

endDateDateTime

The hotsite will be displayed until this date.

expressionString

Expression used to associate products to the hotsite.

hotsiteIdLong!

Hotsite unique identifier.

idID

The node unique identifier.

nameString

The hotsite's name.

pageSizeInt!

Set the quantity of products displayed per page.

productsProductsConnection

A list of products associated with the hotsite. Cursor pagination.

afterString

Returns the elements in the list that come after the specified cursor.

beforeString

Returns the elements in the list that come before the specified cursor.

filters[ProductFilterInput]

List of filters. Check filters result for available inputs.

firstInt

Returns the first n elements from the list.

lastInt

Returns the last n elements from the list.

maximumPriceDecimal

Maximum price filter.

minimumPriceDecimal

Minimum price filter.

onlyMainVariantBoolean!

Toggle the return of only main variants.

partnerAccessTokenString

The partner access token.

sortDirectionSortDirection
sortKeyProductSortKeys
productsByOffsetProductCollectionSegment

A list of products associated with the hotsite. Offset pagination.

filters[ProductFilterInput]

List of filters. Check filters result for available inputs.

limitInt!

The number of products to return.

maximumPriceDecimal

Maximum price filter.

minimumPriceDecimal

Minimum price filter.

offsetInt!

The offset used to paginate.

onlyMainVariantBoolean!

Toggle the return of only main variants.

partnerAccessTokenString

The partner access token.

sortDirectionSortDirection
sortKeyProductSortKeys
seo[SEO]

A list of SEO contents associated with the hotsite.

sortingHotsiteSorting

Sorting information to be used by default on the hotsite.

startDateDateTime

The hotsite will be displayed from this date.

subtypeHotsiteSubtype

The subtype of the hotsite.

templateString

The template used for the hotsite.

urlString

The hotsite's URL.

SingleProduct

A product represents an item for sale in the store.

FieldArgumentTypeDescription
addToCartFromSpotBoolean

Check if the product can be added to cart directly from spot.

aliasString

The product url alias.

attributeSelectionsAttributeSelection

Information about the possible selection attributes.

selected[AttributeFilterInput]
attributes[ProductAttribute]

List of the product attributes.

availableBoolean

Field to check if the product is available in stock.

averageRatingInt

The product average rating. From 0 to 5.

breadcrumbs[Breadcrumb]

List of product breadcrumbs.

buyTogether[SingleProduct]

Buy together products.

conditionString

The product condition.

createdAtDateTime

The product creation date.

customizations[Customization]

A list of customizations available for the given products.

deadlineInt

The product delivery deadline.

displayBoolean

Check if the product should be displayed.

displayOnlyPartnerBoolean

Check if the product should be displayed only for partners.

displaySearchBoolean

Check if the product should be displayed on search.

eanString

The product's unique EAN.

freeShippingBoolean

Check if the product offers free shipping.

idID

The node unique identifier.

images[Image]

List of the product images.

heightInt

The height of the image the url will return.

widthInt

The width of the image the url will return.

informations[Information]

List of the product insformations.

mainVariantBoolean

Check if its the main variant.

minimumOrderQuantityInt

The product minimum quantity for an order.

newReleaseBoolean

Check if the product is a new release.

numberOfVotesInt

The number of votes that the average rating consists of.

parentIdLong

Parent product unique identifier.

pricesPrices

The product prices.

productBrandProductBrand

Summarized informations about the brand of the product.

productCategories[ProductCategory]

Summarized informations about the categories of the product.

productIdLong

Product unique identifier.

productNameString

The product name.

productSubscriptionProductSubscription

Summarized informations about the subscription of the product.

productVariantIdLong

Variant unique identifier.

promotions[Promotion]

List of promotions this product belongs to.

reviews[Review]

List of customer reviews for this product.

seo[SEO]

Product SEO informations.

similarProducts[SimilarProduct]

List of similar products.

skuString

The product's unique SKU.

spotAttributes[String]

The values of the spot attribute.

spotInformationString

The product spot information.

spotlightBoolean

Check if the product is on spotlight.

stockLong

The available stock at the default distribution center.

stocks[Stock]

List of the product stocks on different distribution centers.

subscriptionGroups[SubscriptionGroup]

List of subscription groups this product belongs to.

telesalesBoolean

Check if the product is a telesale.

updatedAtDateTime

The product last update date.

variantNameString

The variant name.

Stock

Information about a product stock in a particular distribution center.

FieldArgumentTypeDescription
idLong!

The id of the distribution center.

itemsLong!

The number of physical items in stock at this DC.

nameString

The name of the distribution center.

SubscriptionGroup

FieldArgumentTypeDescription
recurringTypes[SubscriptionRecurringType]

The recurring types for this subscription group.

statusString

The status name of the group.

statusIdInt!

The status id of the group.

subscriptionGroupIdLong!

The subscription group id.

subscriptionOnlyBoolean!

Wether the product is only avaible for subscription.

SubscriptionRecurringType

FieldArgumentTypeDescription
daysInt!

The number of days of the recurring type.

nameString

The recurring type display name.

recurringTypeIdLong!

The recurring type id.

Uri

Node of URI Kind.

FieldArgumentTypeDescription
hotsiteSubtypeHotsiteSubtype

The origin of the hotsite.

kindUriKind!

Path kind.

partnerSubtypePartnerSubtype

The partner subtype.

productAliasString

Product alias.

productCategoriesIds[Int!]

Product categories IDs.

redirectCodeString

Redirect status code.

redirectUrlString

Url to redirect.

forbiddenTerm

Informations about a forbidden search term.

FieldArgumentTypeDescription
suggestedString

The suggested search term instead.

textString

The text to display about the term.

wishlist

FieldArgumentTypeDescription
products[Product]

Wishlist products.

Inputs

AttributeFilterInput

FieldTypeDescription
attributeIdLong!
valueString!

AttributeInput

Input to specify which attributes to match.

FieldTypeDescription
id[Long!]

The attribute Ids to match.

name[String]

The attribute name to match.

type[String]

The attribute type to match.

value[String]

The attribute value to match

BrandFilterInput

Filter brand results based on giving attributes.

FieldTypeDescription
brandIds[Long!]

Its unique identifier (you may provide a list of IDs if needed).

names[String]

The set of brand names which the result item name must be included in.

CheckoutCustomizationInput

FieldTypeDescription
customizationIdLong!
valueString

CheckoutProductInput

FieldTypeDescription
idUuid!
products[CheckoutProductItemInput]!

CheckoutProductItemInput

FieldTypeDescription
customization[CheckoutCustomizationInput]
productVariantIdLong!
quantityInt!
subscriptionCheckoutSubscriptionInput

CheckoutSubscriptionInput

FieldTypeDescription
recurringTypeIdInt!
subscriptionGroupIdLong!

CustomerAccessTokenInput

The input to authenticate a user.

FieldTypeDescription
emailString!
passwordString!

CustomerAddressInput

FieldTypeDescription
addressDetailsString
addressNumberString
cepCEP
cityString
countryCountryCode
emailEmailAddress
nameString
neighborhoodString
phoneString
referencePointString
stateString
streetString

NewsletterInput

FieldTypeDescription
emailString!
nameString!
recaptchaTokenString!

PricesInput

Input to specify the range of prices to return.

FieldTypeDescription
discountedBoolean

Return only products where the listed price is more than the price.

price_gteDecimal

The product price must be greater than or equal to.

price_lteDecimal

The product price must be lesser than or equal to.

ProductExplicitFiltersInput

Filter product results based on giving attributes.

FieldTypeDescription
attributesAttributeInput

The set of attributes do filter.

availableBoolean

Choose if you want to retrieve only the available products in stock.

brandId[Long!]

The set of brand IDs which the result item brand ID must be included in.

categoryId[Long!]

The set of category IDs which the result item category ID must be included in.

ean[String]

The set of EANs which the result item EAN must be included.

hasImagesBoolean

Retrieve the product variant only if it contains images.

mainVariantBoolean

Retrieve the product variant only if it is the main product variant.

pricesPricesInput

The set of prices to filter.

productId[Long!]

The product unique identifier (you may provide a list of IDs if needed).

productVariantId[Long!]

The product variant unique identifier (you may provide a list of IDs if needed).

sku[String]

The set of SKUs which the result item SKU must be included.

stock_gteLong

Show products with a quantity of available products in stock greater than or equal to the given number.

stock_lteLong

Show products with a quantity of available products in stock less than or equal to the given number.

updatedAt_gteString

Retrieve products which the last update date is greater than or equal to the given date.

updatedAt_lteString

Retrieve products which the last update date is less than or equal to the given date.

ProductFilterInput

Custom attribute defined on store's admin may also be used as a filter.

FieldTypeDescription
fieldString!

The attribute name.

values[String]!

The set of values which the result filter item value must be included in.

ReviewCreateInput

Review input parameters.

FieldTypeDescription
emailString!

The reviewer's email.

nameString!

The reviewer's name.

productVariantIdLong!

The product variant id to add the review to.

ratingInt!

The review rating.

recaptchaTokenString!

The google recatpcha token.

reviewString!

The review content.

Enums

ApplyPolicy

ValueDescription
BEFORE_RESOLVER
AFTER_RESOLVER

BannerSortKeys

Define the banner attribute which the result set will be sorted on.

ValueDescription
ID

The banner's unique identifier.

CREATION_DATE

The banner's creation date.

BrandSortKeys

Define the brand attribute which the result set will be sorted on.

ValueDescription
ID

The brand unique identifier.

NAME

The brand name.

CategorySortKeys

Define the category attribute which the result set will be sorted on.

ValueDescription
ID

The category unique identifier.

NAME

The category name.

ContentSortKeys

Define the content attribute which the result set will be sorted on.

ValueDescription
ID

The content's unique identifier.

CreationDate

The content's creation date.

HotsiteSortKeys

Define the hotsite attribute which the result set will be sorted on.

ValueDescription
ID

The hotsite id.

NAME

The hotsite name.

URL

The hotsite url.

HotsiteSubtype

ValueDescription
CATEGORY

Hotsite created from a category.

BRAND

Hotsite created from a brand.

PORTFOLIO

Hotsite created from a portfolio.

BUY_LIST

Hotsite created from a buy list (lista de compra).

Operation

Types of operations to perform between query terms.

ValueDescription
AND

Performs AND operation between query terms.

OR

Performs OR operation between query terms.

PartnerSortKeys

Define the partner attribute which the result set will be sorted on.

ValueDescription
ID

The partner unique identifier.

NAME

The partner name.

PartnerSubtype

ValueDescription
OPEN

Partner 'open' subtype.

CLOSED

Partner 'closed' subtype.

CLIENT

Partner 'client' subtype.

ProductRecommendationAlgorithm

ValueDescription
DEFAULT

ProductSearchSortKeys

Define the product attribute which the result set will be sorted on.

ValueDescription
RELEVANCE

The relevance that the search engine gave to the possible result item based on own criteria.

NAME

The product name.

SALES

The sales number on a period of time.

PRICE

The product variant price.

DISCOUNT

The applied discount to the product variant price.

RANDOM

Sort in a random way.

RELEASE_DATE

The date the product was released.

STOCK

The quantity in stock of the product variant.

ProductSortKeys

Define the product attribute which the result set will be sorted on.

ValueDescription
NAME

The product name.

SALES

The sales number on a period of time.

PRICE

The product variant price.

DISCOUNT

The applied discount to the product variant price.

RANDOM

Sort in a random way.

RELEASE_DATE

The date the product was released.

STOCK

The quantity in stock of the product variant.

ScriptPageType

ValueDescription
ALL
HOME
SEARCH
CATEGORY
BRAND
PRODUCT

ScriptPosition

ValueDescription
HEADER_START
HEADER_END
BODY_START
BODY_END
FOOTER_START
FOOTER_END

SortDirection

Define the sort orientation of the result set.

ValueDescription
ASC

The results will be sorted in an ascending order.

DESC

The results will be sorted in an descending order.

UriKind

ValueDescription
PRODUCT
HOTSITE
REDIRECT
NOT_FOUND
PARTNER

Scalars

Boolean

The Boolean scalar type represents true or false.

CEP

Represents a CEP

CountryCode

String representing a country code

DateTime

The DateTime scalar represents an ISO-8601 compliant date time type.

Decimal

The built-in Decimal scalar type.

EmailAddress

The EmailAddress scalar type constitutes a valid email address, represented as a UTF-8 character sequence. The scalar follows the specification defined by the HTML Spec https://html.spec.whatwg.org/multipage/input.html#valid-e-mail-address.

Float

The Float scalar type represents signed double-precision fractional values as specified by IEEE 754.

ID

The ID scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as "4") or integer (such as 4) input value will be accepted as an ID.

Int

The Int scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.

Long

The Long scalar type represents non-fractional signed whole 64-bit numeric values. Long can represent values between -(2^63) and 2^63 - 1.

String

The String scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.

Uuid

Interfaces

Node

FieldArgumentTypeDescription
idID