Chuyển tới nội dung chính

(12) Thay đổi trạng thái trả hàng

1. Tình huống kích hoạt

Webhook thay đổi trạng thái trả hàng được kích hoạt khi return_status của một đơn hàng thay đổi:

  • BUYER khởi tạo yêu cầu trả hàng hoặc hoàn tiền và đang chờ SELLER xem xét: RETURN_OR_REFUND_REQUEST_PENDING
  • SELLER từ chối yêu cầu trả hàng hoặc hoàn tiền của BUYER: REFUND_OR_RETURN_REQUEST_REJECT
  • Yêu cầu trả hàng được chấp thuận và SELLER đang chờ BUYER trả lại các mặt hàng đã được duyệt: AWAITING_BUYER_SHIP. Nếu BUYER không gửi các mặt hàng cho SELLER trước thời hạn, yêu cầu sẽ tự động bị đóng.
  • Để trả các mặt hàng cho SELLER, BUYER gửi kiện hàng thành công hoặc BUYER gửi kiện hàng và tải lên mã vận đơn: BUYER_SHIPPED_ITEM
  • SELLER từ chối yêu cầu hoàn tiền cho việc trả hàng: REJECT_RECEIVE_PACKAGE
  • SELLER chấp nhận yêu cầu hoàn tiền hoặc thực hiện hoàn tiền cho việc trả hàng: RETURN_OR_REFUND_REQUEST_SUCCESS
  • BUYER hoặc SYSTEM đóng yêu cầu trả hàng hoặc hoàn tiền: RETURN_OR_REFUND__REQUEST_CANCELLED
  • Việc trả hàng hoặc hoàn tiền thành công: RETURN_OR_REFUND_REQUEST_COMPLETE

Ngoài ra, BUYER có thể yêu cầu một mặt hàng thay thế giống hệt thay vì hoàn tiền:

  • BUYER khởi tạo yêu cầu thay thế và đang chờ SELLER xem xét: REPLACEMENT_REQUEST_PENDING
  • SELLER từ chối yêu cầu thay thế của BUYER: REPLACEMENT_REQUEST_REJECT
  • SELLER quyết định hoàn tiền cho BUYER mà không thay thế: REPLACEMENT_REQUEST_REFUND_SUCCESS
  • BUYER hủy yêu cầu thay thế: REPLACEMENT_REQUEST_CANCEL
  • SELLER chấp thuận yêu cầu thay thế: REPLACEMENT_REQUEST_COMPLETE

2. Các tham số nghiệp vụ dữ liệu

ParameterDescriptionSample
order_idMã định danh của một đơn hàng TikTok Shop577087614418520388
return_roleNgười dùng yêu cầu trả hàng hoặc hoàn tiền, với các giá trị có thể có: * BUYER * SELLER * SYSTEMBUYER
return_typeLoại yêu cầu trả hàng hoặc hoàn tiền, với các giá trị có thể có: * REFUND * REPLACEMENT * RETURN_AND_REFUNDREFUND
return_statusTrạng thái trả hàng cho một yêu cầu, với các giá trị có thể có: * AWAITING_BUYER_SHIP * BUYER_SHIPPED_ITEM * REFUND_OR_RETURN_REQUEST_REJECT * REJECT_RECEIVE_PACKAGE * REPLACEMENT_REQUEST_CANCEL * REPLACEMENT_REQUEST_COMPLETE * REPLACEMENT_REQUEST_PENDING * REPLACEMENT_REQUEST_REFUND_SUCCESS * REPLACEMENT_REQUEST_REJECT * RETURN_OR_REFUND_REQUEST_CANCEL * RETURN_OR_REFUND_REQUEST_COMPLETE * RETURN_OR_REFUND_REQUEST_PENDING * RETURN_OR_REFUND_REQUEST_SUCCESSRETURN_OR_REFUND_REQUEST_PENDING
return_idMã định danh của một lần trả hàng cụ thể4035318504086604100
create_timeThời điểm yêu cầu được tạo.1627587600
update_timeThời điểm trạng thái đơn trả hàng được cập nhật, được biểu diễn dưới dạng Unix timestamp (giây).1627587600

Ví dụ sự kiện​

JSONWord Wrap

{
"type": 12,
"tts_notification_id": "7327112393057371910",
"shop_id": "7494049642642441621",
"timestamp": 1644412885,
"data": {
"order_id": "576486316948490001",
"return_role": "BUYER",
"return_type": "REFUND",
"return_status": "RETURN_OR_REFUND_REQUEST_PENDING",
"return_id": "576486316948490001",
"create_time": 1627587600
"update_time": 1644412885
}
}