Create return order

curl --location --request POST '/api/v1/public/return-orders/create' \ --header 'Authorization;' \ --header 'Content-Type: application/json' \ --data-raw '{ "order_tracking_code": "NHOV1908761573", "return_address": {{pickup_id}}, "reason_type": "wrong_item", "reason": "", "pickup": { "customer_id": null, "fullname": "Bùi Thị Hoài Thương", "phone": "+84961557476", "country": "VN", "email": "buithihoaithuong301@gmail.com", "address": "Số 9 Trà khúc", "zipcode": null, "province_id": 79, "district_id": 766, "ward_id": 26965 }, "return_items": [ { "sku": "MUOIXATAC", "sale_price": "200000.00", "return_quantity": 2 }, { "sku": "250204067", "sale_price": "30700000.00", "return_quantity": 1 } ], "config": { "delivery_service": "SOF_STD" }, "shipping_info": { "courier_integration_id": 172, "courier_id": 16, "shipping_fee": 0, "courier_tracking_code": "SPXVN045379876785" } }'

Request

Header Params

Authorization

string

required

Default:

Body Params application/json

order_tracking_code

string

required

return_address

integer

required

reason_type

string

required

item_missing : Missing item (Thiếu sản phẩm)
item_damaged : Item is damaged (Mặt hàng bị hư hỏng)
wrong_item : Wrong item delivered (Sai mặt hàng)
not_receipt : Item not received (Không nhận được)
warranty : Under warranty/insurance claim (Bảo hiểm)
different_description : Not as described (Mô tả khác)
mutual_agree : Return by mutual agreement (Thỏa thuận)
change_mind : Customer changed mind (Change mind)
expectation_failed : Did not meet expectations (Expectation failed)
item_fake : Counterfeit item (Hàng giả)
physical_dmg : Physical damage (Physical DMG)
functional_dmg : Functional damage (Functional DMG)
other : Other reason (Khác)

reason

string

optional

pickup

object

optional

To implement the logic where the customer_id field determines whether the other fields are mandatory or not, you can structure it as follows:
API Request Logic:
If customer_id is provided: Other fields such as fullname, phone, address, zipcode, province_name, district_name, and ward_name are optional.
If customer_id is null: Other fields (fullname, phone, address, zipcode, province_name, district_name, ward_name) are mandatory.

customer_id

integer

optional

If customer_id is null, the following fields are required

fullname

string

optional