مرتجعات الطرود

لا ينفذ مزود 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.

MethodPathPurpose
POST/v1/fulfillment/returnsCreate Return Request
GET/v1/fulfillment/returnsList Return Requests
GET/v1/fulfillment/returns/{return_id}Get Return Request
POST/v1/fulfillment/returns/{return_id}/confirmConfirm Return Request
POST/v1/fulfillment/returns/{return_id}/cancelCancel 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.

Get Support

Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days

Email support