Create

POST

/api/v1/return-shipments/b2b/create

This API creates a B2B return shipment for products being returned to the warehouse.

A return shipment can only be created when the original shipment has already been handed over to the carrier.

Upon successful creation, the system generates a unique return tracking code and initializes the return shipment with the Waiting for Receiving status.

Request

Authorization

Add parameter in header

Authorization

Example:

Authorization: ********************

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v1/return-shipments/b2b/create' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "warehouse_code": "ONF_WH_HCM_APD",
    "merchant_return_tracking_code_reference": "MRCR_1898877889_9878",
    "shipment_tracking_code": "OASB117431850",
    "return_items": [
        {
            "oasin": "OASIN1236217",
            "product_quantity": "5"
        },
        {
            "oasin": "OASIN1261341",
            "product_quantity": "5"
        },
        {
            "oasin": "OASIN1243180",
            "product_quantity": "5"
        },
        {
            "oasin": "OASIN1268325",
            "product_quantity": "5"
        }
    ],
    "return_reason": "Customer requested return",
    "vas": [
        "UNLOADING"
    ],
    "note": "This is a test return shipment",
    "estimated_arrival_time": 1782108584
}'

Response Example

{
    "data": {
        "created_time": 1783479964,
        "updated_time": 1783479964,
        "return_tracking_code": "OARSB233096861",
        "status_info": {
            "value": 100,
            "label": "Chờ nhận",
            "updated_time": 1783479964
        },
        "status": 100
    },
    "error": false,
    "error_code": null,
    "log_id": null,
    "messages": "OK",
    "total": 1,
    "version": "1.0.8"
}

Modified at 2026-07-08 03:47:03

Cancel

Get list