Price-Reductions

This interface enables partners to apply price reductions to the shipped products when there are product issues or customer dissatisfaction. Additionally, it's possible to view previously applied price reductions.

Preconditions

Checks before applying a price reduction:

• If a partner has been terminated more than 70 days ago, OTTO Market APIs are not accessible anymore.
• Price reductions can only be applied to the items that have been marked as SHIPPED and are not in state RETURNED.
• While applying a price reduction, the system retrieves the remaining receipt amount. Hence, the requested price reduction amount must be less than the remaining amount.

Price Reduction States

The price reduction can have different states. The possible values are:

• INITIATED
  Once the price reduction is created by the interface, it will be in state INITIATED. This state implies that the price reduction is pending for receipt generation. In these price reductions, receiptId and receiptNumber would be null.
• PROCESSED
  When receipts are generated for the price reduction, the state is updated to PROCESSED.
• REJECTED
  This state indicates that the price reduction failed the validation checks and was therefore not processed.
  e.g.
  • Price reduction applied on the positionItemId after it is marked as returned
  • Requested price reduction amount is greater than remaining receipt amount.

Glossary

• SalesOrderId - SalesOrderId for an item
• PositionItemId - SalesOrderPositionItemId for which the price reduction should be made.
• PriceReduction - An object having price reduction amount for a positionItemId.
• TotalPriceReduction - Sum of all the price reductions for a positionItemId.
• Links - Array of Object, which are related to the list. E.g. the link to the successive list used during paging.