Help us improve our documentation! Tell us about your experience with this article by filling out this form.
The Prices module, also called Pricing, is a system responsible for the creation, editing and storing of your SKU pricing data. This overview article goes over what you can accomplish with Pricing, including relevant links to our developer documentation about this topic.
Understanding VTEX’s Pricing architecture
Prices represent your SKU sales value information. In VTEX, these prices are stored in price tables. In turn, these price tables can be applied to different contexts, like trade policies. These concepts are related as shown in the image below. Learn more about VTEX's pricing architecture in our Pricing system architecture article.
Importing prices from an ERP or Back office Integration
If your store has an ERP integration or another kind of integration for managing orders, it will be necessary to make an integration with VTEX’s platform. Defining prices for your SKUs is an important step when setting up your store. VTEX accounts are able to import prices through ERP integrations by following the guide linked below.
Managing Prices
There are several actions a VTEX store can perform on prices. In the next sections, you will find the main actions related to a store’s pricing management routine.
Before using our Pricing API Reference, check out our Pricing v2 - API Reference Overview for more details about rate limits.
️ Pricing v2 is the second generation of our pricing module, and is the only version currently available in VTEX. We have discontinued Pricing v1 in 2020 and our documentation refers to Pricing v2.
Creating base and fixed prices
An SKU's base price represents the SKU's reference price for all price tables. This means that if another price is not created for the SKU in another price table, it inherits the item's base price. Its value is calculated from multiplying the SKU's Cost Price with its Markup, or the desired profit margin for the SKU's sale.
The fixed price is an SKU's price for a specific price table that weighs more than any of the other pricing types, which results in the pricing module ignoring the other values when a fixed price is associated with an SKU.
Updating price tables
A Price table is a set of SKU prices that can be applied to a specific context. These tables store the price information that is displayed on a store's page. We can look at the price table as an entity that stores and delivers computed prices of its SKUs.
️ Master Data is used to connect a price table to a desired context
Managing fixed prices for price tables or trade policies (sales channels)
Trade policies , or sales channels, are used in VTEX to differentiate the catalog, prices and logistics settings for each sales channel connected to your store. You may use them, for example, if you want the same list of SKUs to have different prices in each marketplace where your store is selling.
Manage prices configured in price tables or in different trade policies (sales channels) through the endpoints below.
Deleting price by SKU
It is possible to use the following API calls to delete individual SKU prices.It is only possible to delete a price table by removing all of the prices inserted in it, and in sequence requesting it to our Support.
It is only possible to delete a price table by removing all of the prices inserted in it, and in sequence requesting it to our VTEX Support.
Retrieving pricing information
You can fetch information related to prices in multiple ways and about specific topics. To know more about retrieving prices' content, see the links below.
Computed prices
There are some criteria that the system takes into account when deciding what an SKU's selling price for a specific price table should be. This price is called the There are some criteria that the system takes into account when deciding what an SKU's selling price for a specific price table should be. This price is called the computed price
Pricing configuration and status
Retrieve information about your VTEX Admin's pricing configurations and Pricing status.
Additional settings (optional)
Besides setting up your basic pricing configurations, there are optional additional settings you can make to customize prices for different scenarios and applications in your ecommerce architecture. See the following links for more information.
Storefront customization
Edit your storefront with VTEX IO Store Framework to add basic or advanced components related to prices in your store.
Pricing simulation - B2B
There are multiple ways you can configure your B2B store with VTEX. The links below go over the different pricing settings required for B2B scenarios.
The Price Simulations API allows you to configure custom price selectors for B2B stores, based on the context set by the Orders Configuration app.
External marketplace integration
If you are an external marketplace that wishes to integrate with VTEX sellers, you can see the links below to learn how to get price information from sellers.