When a seller uses a marketplace to sell their products, sometimes there is a difference between the price configured on VTEX and the one offered by the marketplace, resulting in orders with prices that are different from the seller's expectations. This situation can occur in any type of marketplace: VTEX marketplaces, external marketplaces, certified connectors (partners) and native connectors.
To optimize the processing of orders with price difference errors, you can use the Order authorization flow and configure a Price Divergence rule. In the VTEX Admin, go to Store Settings > Orders > Order Authorization, or type Order Authorization in the search bar at the top of the page.
Once the Price Divergence rule is created, it is applied to all marketplaces.
The Price Divergence rule is composed of one or more order authorization rules. Each authorization rule corresponds to a percentage range of the order price and can vary from 0% to 100%. You must associate one of three actions with each authorization rule:
- Automatically authorize: Orders with a price difference within the defined range are automatically integrated.
- Automatically deny: Orders with a price difference within the defined range are automatically rejected and are not integrated.
- Create a task in VTEX DO for approval: For price differences within the defined range, the order is integrated but needs to be manually approved by an authorized user.
When the Price Divergence rule configuration was not made, orders with price divergence errors are automatically approved. This applies to VTEX marketplaces, external marketplaces, and certified connectors (partners), but not to native connectors.
When a seller is integrated with a native connector, Amazon, but has not configured a Price Divergence rule, orders with price difference errors remain pending until the rule is created. You can track them in your VTEX Admin by clicking on Marketplace > Connections > Orders.
Once the Price Divergence rule is created, orders from integrations with native connectors that have a price difference will be displayed in All Orders page.
We recommend that the seller creates the Price Divergence rule before configuring the integration with a native connector. Not following this recommendation does not prevent the integration from being configured, however, orders with divergent values are held until the Price Divergence rule is configured.
User approval
On the VTEX platform, roles ensure security in the management of your operation by restricting employee access to necessary actions within the platform. Please refer to the article Best practices for secure user management.
To create a Price Divergence rule, the user must have a Super Admin (Owner) or OMS Full role. The same applies to users responsible for manually approving orders with price differences.
Managing orders with price divergence
You can track orders integrated using the Price Divergence rule in the VTEX Admin by clicking on Orders > All Orders.
It is important to regularly track orders in the Orders module. Orders that need to be manually approved remain in pending status until being approved by an authorized user.