📣 Help us improve our documentation! Share your feedback 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.
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.
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.
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.
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.
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.
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.
- Create or Update Fixed Prices on a price table or trade policy
- Delete Fixed Prices on a price table or trade policy
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.
Deleting price tables
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.
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.
- Get rules for a price table
- Get all price tables and their rules
- List price tables
- Get Fixed Prices on a price table or trade policy
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.
Retrieve information about your VTEX Admin's pricing configurations and Pricing status.
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.
Edit your storefront with VTEX IO Store Framework to add basic or advanced components related to prices in your store.
- Store Framework basic components: Product Price app
- Displaying asynchronous prices
- Internationalizing product prices
- Translating the component - Adjusting price representations
- Enabling Manual Price in my store
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.
- Pricing Simulation Overview
- Get custom prices schema
- Create or update custom prices schema
- Update Order Configuration
- Get price association by ID
- Disassociate price association by ID
- Update price association by ID
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.
Updated 6 days ago