OTTO Market API documentation

Interface for partner returns

You will need the following interfaces to report a return that the customer has sent to you.

In principle, you will accept a return, so that we can trigger the customer payment immediately. It would be great if you would also inform us about the condition of the return.

In the rare case (e.g. if the return does not correspond to the correct article) that you do not want to accept a return, you also have the option to reject the return. In this case we would like to receive a reason in addition to the condition of the return.

We expect the following values for the condition:

  • A for "in original packaging"
  • B for "in mint condition"
  • C for "slightly used"
  • D for "heavily used"
  • E for "mistake (Delivery incomplete, not available,...)"


This changelog will document all relevant changes in our interface. Kudos to



  • nothing


  • nothing


  • rename salesOrderPositionItemId to positionItemId and salesOrderPositionItems to positionItems


  • nothing
Imprint | Privacy policy | Datenschutz