Skip to main content

Returns

When you have sent an ordered position item to the customer and the customer decided to return it, you can use this interface to report the returned position item. After accepting the returned position item, we can trigger the customer payment immediately. The interface allows you to inform us about the condition of the return and the reason for acceptance.

Acceptance reasons​

Acceptance reason is a set of values to tell us why you are accepting the return. This will help us to understand the business reason behind accepting returns. If you have already accepted a return, it cannot be rejected again afterwards. Here is a list of acceptance reasons:

  • RETURN_RECEIVED

  • CANCEL_REQUEST_BY_CUSTOMER

  • SHIPMENT_LOST

  • RETURN_LOST

  • STATUS_SENT_BY_ACCIDENT

  • REFUND_AFTER_AFFIDAVIT

  • COMPLAINT

  • UNDELIVERABLE

Reasons for rejection​

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 this interface allows you to post a reason in addition to the condition of the return.

Reasons for rejection are a set of values where you can tell us why you are rejecting the return. This will help us understand and reduce returns in bad conditon. However, if you feel you have changed your mind about a rejected return, you still have the option to accept the return afterwards. Here is a list of reasons for rejections:

  • WRONG_ITEM

  • EXCHANGE

  • ITEM_NOT_IN_THE_PARCEL

  • THIRD_PARTY_ITEM

  • DAMAGE_TO_THE_HYGIENE_SEAL

  • ITEM_DAMAGED

  • RETURN_PERIOD_EXCEEDED

Values for the condition​

We expect the following values for the condition:

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

Common Use Cases​

Accept the return for a sent position item​

If you get a return you want to accept, you can use this endpoint. Additionally you can provide the accept reason mentioned above, e.g. RETURN_RECEIVED and sent a value for the condition of the returned item, e.g. A.

POST /v3/returns/acceptance

Reject the return for a sent position item​

If you get a return you want to reject, you can use this endpoint. Additionally you can provide the reject reason mentioned above, e.g. WRONG_ITEM and sent a value for the condition of the returned item, e.g. A.

POST /v3/returns/acceptance

Get all the items filtered on return state​

If you want to get an overview of the states of returned positon items, you can use this endpoint, e.g. ANNOUNCED.

GET /v3/returns

Glossary​

  • Sales Order - The sales order is a customer's order with items from different partners.
  • Position Item - The position item is the physical product a customer has ordered and can be returned. A checkout with a product quantity greater than one will produce unique position items within the partner order and return.

ON THIS PAGE