Documentation
Feedback
Guides
API Reference

Guides
CheckoutFeaturesEnable the Manual Price
Enable the Manual Price

At VTEX, stores can manually set the price of an item (SKU) when it is in the cart, on the product page on inStore, or is a subscription item. This feature is called Manual Price and can only be performed by some Admin VTEX user profiles.

Before starting to manually set prices in your store, the following information should be considered:

  • Item prices can be modified (increased/decreased) freely, without any kind of restriction. However, if the price is changed to a value that is outside the parameters defined in the Order Authorization feature, the order will not be invoiced.
  • Users with the following roles or permission will have access to modify the price of all items registered to your account (including all stores/sub-accounts):
    • Roles: Owner (Admin Super) or Call Center Operator (Telesales)
    • Permission: Shopping Cart Full Access

Manual Price activation

To use the Manual Price functionality in your store, you must first enable it. Then, follow the settings below:

  1. Make a GET request using the endpoint Get orderForm configuration.
  2. Make a POST request using the endpoint Update orderForm configuration with the same data obtained in the GET request, just modifying the value of the allowManualPrice parameter from null to true.
  3. Make a new GET request using the endpoint Get orderForm configuration to confirm activation.

Setting the price of an item manually

For each sales method, there is a different way of manually modifying the price. The list below describes the procedure for each of these methods:

Recording manual changes to item prices

All price changes made manually are recorded and the user responsible for the change can be identified. To verify the user responsible for modifying the price of an item, follow the steps below:

  1. Makes a GET request using the endpoint Get Order. You will need to provide the specific orderId on which the price was manually modified.
  2. Register the information available in the manualPriceAppliedBy property. It will bring up the user ID or the appKey used to make the change.
  3. Makes a GET request using the endpoint License Manager - Get User, filling in with the user ID or appKey, to obtain the data of the person responsible for the modification.

Example of information available in manualPriceAppliedBy property:

{"base64":"  ","img":{"width":522,"height":70,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":28479,"url":"https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@main/images/enable-the-manual-price-0.PNG"}}

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