Add Order Return

POST

/api/v2/public/order/return/add

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.omisell.com/api/v2/public/order/return/add' \
--header 'Seller-ID;' \
--header 'Country;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "order_number": "ODVN26090112AB34CD",
    "order_return_number": "RMA-2026-0001",
    "fail_reason": "Item damaged",
    "created_time": 1788300000,
    "return_items": [
        {
            "sku": "AT-COTTON-001-DO-M",
            "quantity": 1
        }
    ]
}'

Response Example

Real response captured from the live API. Personal data replaced with placeholders.

{
  "data": {
    "created_time": 0.0,
    "fail_reason": "Example return",
    "fail_reason_type": null,
    "omisell_order_number": "ODVN260814980325FB",
    "omisell_return_order_number": "RTNVN260814713258D7",
    "order_note": "Example product.",
    "order_number": "EXAMPLE-ORDER-0001",
    "return_catalogue_items": [
      {
        "order_item_id": 987654321,
        "catalogue_sku": "EXAMPLE-SKU-0001",
        "quantity": 1
      }
    ],
    "return_inventory_items": [],
    "return_order_number": "EXAMPLE-RETURN-0001",
    "seller_id": 27001999,
    "shop_id": 34251,
    "shop_name": "SANDBOX7413243897012717317",
    "status_id": 100,
    "status_name": "Đã gửi yêu cầu",
    "updated_time": 1786683323.0
  },
  "error": false,
  "error_code": 200,
  "attr_error": null,
  "messages": "",
  "request_id": "6a7e9fbad23299d2e7a4a25b"
}

Modified at 2026-11-03 04:22:17

Get Returns Order List

Get Return Order Detail