Menu
Feedback
Start here
Tutorials
Developer portal

Known Issues
Support Rules
Troubleshooting

Frequently Asked Questions
Announcements
Tutorials
Tutorials
Explore in-depth tutorials for operating your VTEX store.
Tutorials
Promotions & taxes
Promotions
Configuring promotions for marketplaces
Configuring promotions for marketplaces
6 min read

The VTEX promotion module allows you to create different promotions, from the most traditional to the most innovative ones. However, there are some restrictions when choosing the type of promotion for VTEX marketplaces and external marketplaces. This tutorial explains how to define the promotions and conditions that will apply in each scenario.

Promotions available on marketplaces

Only the following regular promotions work on marketplaces:

  • Free shipping
  • Percentage shipping
  • Percentage price
  • Price tables

The settings available for VTEX marketplaces are different from the ones of external marketplaces. Therefore, promotions in other marketplace environments are slightly different.

Free and percentage shipping promotions

For this type of promotion, it is important to keep the following information in mind:

  • Some marketplaces use their own shipping table. This prevents a shipping promotion from being applied to an order since the marketplace does not consult the shipping rate listed on VTEX.
  • For the promotion to be applied to the shipping rate, the marketplace must simulate the shipping rate using the POST endpoint https://{accountName}.vtexcommercestable.com.br/api/fulfillment/pvt/orderForms/simulation?sc={salesChannel}&affiliateId={affiliateId}.
  • The promotion will not apply to the product price if the marketplace uses the List Freight Values endpoint of the Logistics API for checking shipping rates. This endpoint shows only the shipping rates listed on VTEX without considering promotions.
  • Sellers determine the discount limits that the marketplace can apply to the shipping rate. If the discount is greater than the established limit, the order will not be placed.

Percentage price promotions

For this type of promotion, it is important to keep the following information in mind:

  • Once the seller has created and activated the promotion, it does not send any notifications to the marketplace. It is up to the marketplace to check the promotional price.
  • For the promotion to be applied to the product price, the marketplace must simulate the SKU price using the Do OrderForm Simulation endpoint of the Checkout API.
  • The promotion will not apply to the product price if the marketplace uses the Get Price endpoint of the Pricing API for checking prices. This endpoint shows only the prices listed on VTEX without considering promotions.
  • Sellers determine the discount limits that the marketplace can apply to the total order value. If the discount is greater than the established limit, the order will not be placed. You can change your store’s settings in the Order authorization section.

Available settings

There are differences between the settings available for VTEX marketplaces and external marketplaces. See in the table below the features applicable in each case.

In the case of external integrations, configurations are unique to each marketplace, and it’s up to them to decide which features they will use.

SettingsDescriptionAvailable for VTEX marketplaces?Available for external marketplaces?
NamePromotion nameYesYes
StatusOption that defines if the promotion is active or inactive.YesYes
DescriptionThe internal description of the promotionYesYes
Allow combined promotionsMore than one promotion can be applied simultaneously, regardless of the discount type.YesYes
Nominal DiscountDiscount granted to the total cart price.YesYes
Expiration DateThe promotion’s date, start and end timeYesYes
Percentage shipping ratePercentage discount applied to the shipping rate.YesYes
Promotional price tableYou can use a price from the price table as a promotion. The promotional price of each SKU will be its corresponding price in the selected price table.YesYes
Service Level Agreement (SLA)Specification of all VTEX services. It includes all shipping types.YesNo
The delivery address ZIP Code mustThe discount applies if the ZIP Code follows the configured rules.YesNo
Applied to the BrandThe discount applies to the selected brands.YesYes
Applied to the CategoryThe discount applies to the selected categories.YesYes
Applied to the ProductThe discount applies to the selected products.YesYes
Applied to SKUsThe discount applies to the selected SKUs.YesYes
AffiliatesThe marketplace’s order identifier. The discount applies to the selected affiliates.YesYes
Sales channelsThe discount applies to a sales channel list.YesYes
Item price betweenSets the trade policies applicable to the promotion.YesYes

Promotions unavailable for marketplaces

Check the promotions that are not available for marketplaces:

  • Nominal discount
  • Maximum price per item
  • Nominal shipping
  • Maximum shipping
  • Gift
  • Nominal reward amount
  • Buy Together - Bundle
  • More for Less
  • Progressive Discount
  • Buy One Get One
  • Campaign Promotion

Unavailable settings

See below the settings that are not available for marketplaces:

NameDescription
Customer clusterDiscount given if the customer is part of the selected cluster.
Marketing tagsUsed to limit the promotion's activation if the order is placed through the VTEX Subscriptions module.
UTMsDiscount given depending on the value of a given UTM parameter.
Campaign audienceAllows you to segment your store's promotions by defining target audiences that meet specific criteria.
CouponsCode that allows promotions to be applied to the total cart amount.
Cart maximum or minimum total amountApplied based on the total cart amount, regardless of other promotions or shipping.
Number of installmentsDiscount given if the number of installments selected by the customer is within the specified range.
Restriction BINDiscount given if the card's BIN is among the specified numbers.
Payment methodDiscount given if the customer selects the same payment method as the one in the promotion.
First purchaseDiscount given on the customer's first purchase.
Aggregate purchase valueDiscount given if the customer's total purchase amount reaches the specified amount.
Apply with manual pricesAllows the promotion to be applied to products with prices manually added by telesales.
Price "from" and "to" are the same or Price "from" and "to" are differentRefers to the prices saved for that product.
Seller filterDefines which sellers the promotion will be applied to.
Maximum use of promotion per customerLimits the number of times each customer can receive the promotion.
Maximum use of promotion per storeLimits the number of times the promotion can be applied.
Maximum use of coupon per productLimits the number of times a coupon can be applied to a product.

Determining the context in which promotions will be applied

If necessary, you can segment promotions for specific marketplaces. You can obtain these results by using two selectors:

  • Trade policy: used when all target marketplaces share the same sales channel settings (catalog, price, and logistics).
  • Affiliate: used to select one or more specific marketplaces, even if they do not share the same sales channel settings.

Selection by trade policy

  1. Create a regular promotion.
  2. In the Sales Policy section, select the Equal to and Delivered by me (Other stores) options.
  3. Select the trade policies.
  4. Click on Save.

Selection by affiliates

  1. Create a regular promotion.
  2. Fill in the Affiliates field with the name of the affiliate related to the marketplace in question.
  3. In the Sales Policy section, select the Equal to and Delivered by me (Other stores) options.
  4. Click on Save.

Please remember to reindex all products included in the promotion after you’ve created it and at the beginning and end of the promotions. This will ensure that the prices of your products are up to date.

Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Was this helpful?
Yes
No
Suggest Edits (GitHub)
Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
On this page
Still got questions?
Ask the community
Find solutions and share ideas in the VTEX community.
Join our community
Request support from VTEX
For personalized assistance, contact our experts.
Open a support ticket
GithubDeveloper portalCommunityFeedback