مرتجعات الطرود
لا ينفذ مزود HTTP الحالي للمستودع هذه العمليات في الإنتاج. تأكد من توفرها عبر support@hiobuy.com قبل الاستخدام. تُحتفظ بالمخططات والأمثلة التالية كمرجع للتوافق.
Request returning a warehouse package (or selected items) to the Chinese seller when goods are damaged, wrong, or otherwise not shippable outbound.
Requires warehouse fulfillment.
| Method | Path | Purpose |
|---|---|---|
| POST | /v1/fulfillment/returns | Create Return Request |
| GET | /v1/fulfillment/returns | List Return Requests |
| GET | /v1/fulfillment/returns/{return_id} | Get Return Request |
| POST | /v1/fulfillment/returns/{return_id}/confirm | Confirm Return Request |
| POST | /v1/fulfillment/returns/{return_id}/cancel | Cancel Return Request |
IDs use ret_*. Statuses: PENDING · RETURNED · CANCELLED.
دورة الحياة
Create
Creates a request to return a warehouse package or selected items to the seller. HioBuy will calculate the applicable handling and domestic return shipping fees before the return is processed.
Required: package_id, reason, items[], seller_return. Optional: remark. Clients must not submit fees.
Confirm
Confirms the current return fee and authorizes HioBuy to process the return to the seller.
{
"fee_amount": 18,
"currency": "CNY"
}Mismatch → RETURN_FEE_CHANGED. Repeat confirm is idempotent.
Related
Get Support
Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days