PriceAdjustmentRequest document (Shop API 23.2)

Document representing a price adjustment request. Use the level and item_id properties to specify where you want the price adjustment to be added:

• If you specify order as the level, you do not have to specify an item_id. This indicates that the price adjustment should be added directly to basket.
• If you specify product as the level, the item_id that you specify is the item_id of the product item. This indicates that the price adjustment should be added to the product item.
• If you specify shipping as the level, item_id that you specify is the item_id of the shipping item. This indicates that the price adjustment is added to the shipping item.

You can use the item_text and reason_code properties to describe the price adjustment. The promotion_id property is optional. If you do not specify an id, one is automatically assigned (in the format 'dw.manual[n]', where [n] is 1, 2, 3...). If you specify an id, make sure that it is not already used for a price adjustment in the basket or for a promotion in the promotion engine. You need to specify the value of the price adjustment by defining a discount from which the price adjustment is calculated. The discount definition consists of a type and a value. The type amount describes a (unit) price discount, and its corresponding value (positive) defines the amount each unit is to be reduced. For example, for a $10 discount: { "discount" : {"type" : "amount", "value" : 10.00 }, ... } The type percentage describes a percentage discount, and its corresponding value (positive) defines the percentage reduction. For example, for a 5% discount: { "discount" : {"type" : "percentage", "value" : 5 }, ... } The type fixed_price describes a fixed price discount, and its corresponding value (positive) defines the resulting fixed price for the item. Only one fixed_price discount can be set for each item. For example, to fix a $15 price for the item: { "discount" : {"type" : "fixed_price", "value" : 15.00 }, ... } The type fixed_price is not applicable at the order level.