{"section":"tutorials","requestedLocale":"en","requestedSlug":"configuring-price-divergence-rule","locale":"en","slug":"configuring-price-divergence-rule","path":"docs/en/tutorials/orders/orders-management-settings/configuring-price-divergence-rule.md","branch":"main","content":"When the price defined by the seller is different from the price offered by the marketplace, orders may not be processed correctly. On VTEX, the order authorization flow allows you to control and automatically approve these orders by configuring [Price Divergence rule](/en/docs/tutorials/price-divergence-rule). This article explains how sellers can create and edit Price Divergence rule and manually approve orders.\n\nWhen no Price Divergence rule is created, the VTEX platform will behave differently for each scenario below:\n\n- **Orders created through the Marketplace interface:** Will be automatically denied.\n- **Orders created via API:** Will be automatically denied if the `isCreatedAsync` field is not sent.\n- **Orders with Price Divergence related to manual discounts:** Will be automatically authorized.\n\nTo use the Order Authorization flow, in cases of price divergence, you need to send the `isCreatedAsync` field in the [Place Fulfillment order](https://developers.vtex.com/docs/api-reference/marketplace-protocol-external-marketplace-orders#post-/api/fulfillment/pvt/orders) API, regardless of the type of connector used. This scenario is valid for VTEX marketplaces, external marketplaces, [certified connectors (partners)](/en/docs/tutorials/marketplace-strategies-at-vtex#integrado-a-conector-certificado-parceiro), or [native connectors](/en/docs/tutorials/marketplace-strategies-at-vtex#integrado-a-conector-nativo-vtex).\n\nWhen a seller is integrated with a native connector, such as 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**.\n\nWe 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 prices are held until the Price Divergence rule is created.\n\n## Creating Price Divergence rule\n\nThe [Price Divergence rule](/en/docs/tutorials/price-divergence-rule) is composed of one or more order authorization rules, which correspond to ranges between 0% and 100% of the order price. The configuration is done so that each range is associated with an automatic processing action.\n\n> ℹ️ To create a Price Divergence rule, the user must have a Super Admin (Owner) or OMS Full role. To ensure security in the management of your operations, please refer to the article Best practices for secure user management.\n\nTo create a price divergence rule, follow the steps below:\n\n1. 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.\n2. In the _Price Divergence_ section, click `CREATE RULES`.\n3. On the new page, click `CREATE RULES`.\n\nYou will see the following screen:\n\n![print_01_EN](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/orders/orders-management-settings/configuring-price-divergence-rule_1.png)\n\nThe **All** tab displays all configured authorization rules.\n\nTo create the first authorization rule, click on **CREATE RULES**. A new tab named **1st rule** will be displayed. Clicking on this tab will display the configuration options.\n\n![print_02_EN](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/orders/orders-management-settings/configuring-price-divergence-rule_2.png)\n\nTo configure the **1st rule**, you can increase or decrease the divergence percentage by dragging the ends of the bar. The > sign determines the start of the range, and the < sign determines its end. The range can be from 0% to 100%.\n\nIf you create a single authorization rule and it is less than 100%, orders with price variation outside the configured limit will not be integrated.\n\nOnce you have defined the authorization rule range, select one of the following options:\n\n- **Automatically authorize:** Orders with a price difference within the defined range are automatically integrated.\n- **Automatically deny:** Orders with a price difference within the defined range are automatically rejected and are not integrated.\n- **Create a task in VTEX DO for approval:** For the configured range, the order is integrated, but remains in pending status, awaiting approval from an authorized user. In the **Authorized persons** field, you must enter the email addresses of the users who can [manually approve these orders](/en/docs/tutorials/configuring-price-divergence-rule#approving-orders-manually).\n\nTo configure a hierarchy of users responsible for approving orders, you must enter more than one email address and sort the registered users. You can change these users at any time by editing the order authorization rule. Please note that only users with the Super Admin (Owner) or OMS Full [roles](/en/docs/tutorials/roles) can edit the rule.\n\nTo create the **2nd rule**, click on the <i class=\"fas fa-plus\" aria-hidden=\"true\"></i> plus sign. The same applies to creating a third or fourth rule, and so on. Once you click on the icon, the following interface is displayed:\n\n![print_03_EN](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/orders/orders-management-settings/configuring-price-divergence-rule_3.png)\n\nConfigure the new authorization rule and, once you have configured all the rules you want, click on the **SAVE RULES** button. You will see the following message: _After saving, you can still edit or delete them at any time_. Click **OK** to confirm. Once this is done, the Price Divergence rule will be created.\n\n> ⚠️ Once the Price Divergence rule is created, it is applied to all marketplaces where you act as a seller.\n\n## Editing Price Divergence rule\n\nYou can edit Price Divergence rule at any time. To do this, log in to your VTEX Admin, go to **ORDERS > Order management > Order authorization > Price Divergence**, and click on **EDIT RULES**.\n\nOn this page, you can delete the price divergence rule by clicking on **DELETE RULES**. This causes all configured authorization rules to be permanently deleted.\n\n> ℹ️ This action cannot be undone. If you want to reapply the rules, you need to configure them again. The same applies to the authorization rules that make up the Price Divergence rule.\n\nOn the same page, in the **All** tab, you can see the list of all the order authorization rules created. To delete an authorization rule, click on the **DELETE RULE** button next to the rule you want to delete.\n\nIf you want to edit an authorization rule, click on the tab corresponding to the rule you want to modify. The process for editing a rule is the same as for [creating a Price Divergence rule](/en/docs/tutorials/configuring-price-divergence-rule#creating-price-divergence-rule).\n\nOnce you have made the desired changes, click on the **SAVE RULES** button, and then on **OK**.\n\n## Approving orders manually\n\nWhen an authorization rule is configured with the option _Create a task in VTEX DO for approval_, this means that at least one user has been assigned to manually approve the order. [Managing orders with price divergence](/en/docs/tutorials/price-divergence-rule#managing-orders-with-price-divergence) is similar to managing orders from any other sales channel, such as a physical store or ecommerce.\n\n> ⚠️ It is important to regularly track orders in **Orders** module. To do this, go to **Orders > All Orders**. If they require manual approval, orders with price divergence errors remain pending, awaiting approval by an authorized user, defined when the authorization rule was created. Having at least two users authorized to perform manual processing is a good practice.\n\nThere are two ways to manually approve an order with price divergence:\n\n- [Approving orders via OMS](/en/docs/tutorials/configuring-price-divergence-rule#approving-orders-via-order-management)\n- [Approving orders via VTEX DO](/en/docs/tutorials/configuring-price-divergence-rule#approving-orders-via-vtex-do)\n\n### Approving orders via Orders module\n\nThis is done on the [All Orders page](/en/docs/tutorials/all-orders). To do this, follow the steps below.\n\n1. In the VTEX Admin, go to **Orders > All Orders**, or type **All Orders** in the search bar at the top of the page.\n2. Click on the order with the status `Waiting for manual authorization`.\n3. Click on `Approve order`.\n\n### Approving orders via VTEX DO\n\nVTEX DO manages tasks created by the modules of the VTEX platform. It allows authorized users to manually perform tasks such as approving or canceling orders, among others. Learn more in the article [VTEX DO](/en/docs/tutorials/vtex-do-interface).\n\nTo approve an order with price divergence via VTEX DO, follow the steps below.\n\n1. In the VTEX Admin, go to **Orders > All Orders**, or type **All Orders** in the search bar at the top of the page.\n2. In the bottom right corner of the screen, click the VTEX DO component.\n3. Click the order pending approval.\n4. Click `Close`.\n5. Click the `Authorize` option.\n\n### Learn more\n\n- [Price Divergence rule](/en/docs/tutorials/price-divergence-rule)\n- [All Orders](/en/docs/tutorials/all-orders)\n- [Marketplace strategies on VTEX](/en/docs/tutorials/marketplace-strategies-at-vtex)"}