# Buyer return orders

A **Buyer Return Order** represents the process of managing returns for items purchased by a customer. This API allows you to create, cancel, list, and retrieve return orders, offering the flexibility needed to handle customer returns efficiently and reliably.

## Key concepts

-   **Return Items:** Details the items being returned, including quantities, reasons, and actions to be taken.
    
-   **Order States:** Tracks the status of the return order, from creation to processing or closure.
    
-   **Product Kit:** A kit product is a composition of multiple atomic products. It has all the properties of a product (barcode, SKU, etc.), but physically consists of multiple atomic products.
    
-   **Atomic Product:** An atomic product is a single item and the fundamental entity that Melonn operates with.
    

## Buyer return order states

This table show the states a buyer return order could have. The states with the closed flag on true represents the end of lifecycle.

| **Code** | **Description** | **Closed** |
| --- | --- | --- |
| 1 | **Created** | false |
| 2 | **Cancelled** | true |
| 3 | **In transit** | false |
| 4 | **Received** | false |
| 5 | **Processing** | false |
| 6 | **Processed** | true |
| 7 | **Transport service requested** | false |
| 8 | **Delivered at warehouse by transport service** | false |

## Shipping methods

| Code | Name | **Description** |
| --- | --- | --- |
| 1 | Managed by melonn | Melonn manages transportation by generating a pickup service at the buyer's address. |
| 2 | Managed by buyer | The buyer is responsible for arranging transportation to return the item to the warehouse. |

## Reason catalog

| Code | **Description** |
| --- | --- |
| 1 | Wrong product |
| 2 | Damaged product |
| 3 | Buyer does not want the product any more |
| 4 | Change for other product |
| 5 | Additional product received by the buyer |

## Actions

| Code | **Description** |
| --- | --- |
| 1 | Return to stock |
| 2 | Return to seller |
| 3 | Discard |
| 4 | Donate |