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

Quản lý trả hàng & hoàn tiền

1. Luồng trạng thái trả hàng

2. Luồng gọi API trả hàng

2.1 Lấy danh sách và chi tiết đơn trả hàng​

API v2.returns.get_return_list: Bạn có thể lấy danh sách các yêu cầu trả hàng và hoàn tiền cho một shop. Mỗi yêu cầu sẽ trả về một return_sn là ID duy nhất. Người mua có thể gửi nhiều return_sn cho cùng một đơn hàng. Tham số return chứa order_sn là mã đơn hàng liên kết với yêu cầu trả hàng hoàn tiền này. Ngoài ra, API hỗ trợ lọc các loại yêu cầu trả hàng và hoàn tiền khác nhau, bao gồm trạng thái trả hàng, trạng thái thương lượng, trạng thái tải lên bằng chứng và trạng thái bồi thường người bán.

API v2.returns.get_return_detail: Dùng return_sn để lấy chi tiết đơn trả hàng.

API v2.returns.get_available_solutions: Lấy các giải pháp khả dụng được cung cấp cho người mua.

2.2 Chỉ hoàn tiền​

API v2.returns.confirm: Đồng ý với yêu cầu trả hàng của người mua, chỉ áp dụng cho loại Hoàn tiền toàn bộ khi người mua không cần trả lại sản phẩm. Sau khi đồng ý, trạng thái sẽ được cập nhật thành Accepted.

2.3 Trả hàng & Hoàn tiền (Không tranh chấp)​

v2.returns.offer: Người bán cung cấp phương án trả hàng để người mua lựa chọn.

v2.returns.accept_offer: Người bán chấp nhận phương án trả hàng do người mua đưa ra.

2.4 Trả hàng & Hoàn tiền (Có tranh chấp)​

Người bán có thể gọi API v2.returns.get_available_solution trước để xác định các tùy chọn cho đơn trả hàng, sau đó gọi API v2.returns.offer để người mua lựa chọn.

Người mua cũng sẽ cung cấp giải pháp cho người bán. Nếu người bán chấp nhận, có thể gọi v2.returns.accept_offer để chấp nhận. Nếu không chấp nhận được, có thể gọi v2.returns.dispute để khiếu nại lên Trung tâm Tranh chấp.

Hiện tại, Open API chỉ hỗ trợ tranh chấp ở hai trạng thái REQUESTED và PROCESSING.

2.4.1 Tranh chấp​

Nếu người bán có tranh chấp với yêu cầu trả hàng của người mua, có thể đến Trung tâm Tranh chấp để xử lý yêu cầu.

v2.returns.dispute: Được người bán dùng để chuyển đơn trả hàng lên trung tâm tranh chấp.

Sau khi tranh chấp được nêu ra, người bán có thể tải lên hình ảnh bằng chứng qua API, nhưng hiện chưa hỗ trợ tải video.

v2.returns.convert_image: Chuyển đổi hình ảnh.

v2.returns.upload_proof: Tải lên hình ảnh.

v2.returns.query_proof: Truy vấn hình ảnh đã tải lên.

3. Định nghĩa dữ liệu

ReturnStatus (Trạng thái trả hàng)​

  • REQUESTED
  • ACCEPTED
  • CANCELLED
  • JUDGING
  • CLOSED
  • PROCESSING
  • SELLER_DISPUTE

ReturnReason (Lý do trả hàng) và Reassessed Request Reason (Lý do yêu cầu đánh giá lại)​

  • NONE
  • NOT_RECEIPT
  • WRONG_ITEM
  • ITEM_DAMAGED
  • DIFFERENT_DESCRIPTION
  • MUTUAL_AGREE
  • OTHER
  • ITEM_WRONGDAMAGED (chỉ áp dụng cho Việt Nam)
  • CHANGE_MIND
  • ITEM_MISSING
  • EXPECTATION_FAILED
  • ITEM_FAKE
  • PHYSICAL_DMG
  • FUNCTIONAL_DMG

ReturnDisputeReason (Lý do tranh chấp trả hàng)​

Lý do

NON_RECEIPT: Tôi muốn từ chối khiếu nại chưa nhận hàng

OTHER: Tôi muốn từ chối yêu cầu

NOT_RECEIVED: Tôi đồng ý với yêu cầu trả hàng, nhưng tôi chưa nhận được sản phẩm

UNKNOWN

ReturnSolution (Giải pháp trả hàng)​

  • RETURN_REFUND
  • REFUND

NegotiationStatus (Trạng thái thương lượng)​

  • PENDING_RESPOND
  • PENDING_BUYER_RESPOND
  • TERMINATED

SellerProofStatus (Trạng thái bằng chứng người bán)​

  • PENDING
  • UPLOADED
  • OVERDUE

SellerCompensationStatus (Trạng thái bồi thường người bán)​

  • COMPENSATION_NOT_APPLICABLE
  • COMPENSATION_INITIAL_STAGE
  • COMPENSATION_PENDING_REQUEST
  • COMPENSATION_NOT_REQUIRED
  • COMPENSATION_REQUESTED
  • COMPENSATION_APPROVED
  • COMPENSATION_REJECTED
  • COMPENSATION_CANCELLED
  • COMPENSATION_NOT_ELIGIBLE

Loại yêu cầu trả hàng hoàn tiền​

  • 0: RR thông thường (RR được người mua nêu ra sau khi nhận hàng, dựa trên ngày giao hàng dự kiến/đã giao xong)
  • 1: RR trong quá trình vận chuyển (RR được người mua nêu ra khi hàng vẫn đang trên đường đến người mua)
  • 2: Trả hàng tại chỗ (RR được tài xế nêu ra sau khi người mua từ chối nhận hàng khi giao)

Loại xác thực​

  • seller_validation: Đối với các yêu cầu Trả hàng & Hoàn tiền kèm kiện hàng trả lại sẽ được giao đến người bán để xác thực và quyết định có hoàn tiền cho người mua hay khiếu nại tranh chấp
  • warehouse_validation: Đối với các yêu cầu Trả hàng & Hoàn tiền kèm kiện hàng trả lại sẽ được giao đến kho để xác thực và quyết định có hoàn tiền cho người mua hay khiếu nại tranh chấp

Trạng thái logistics ngược​

[Trả hàng thông thường]​

  • LOGISTICS_PENDING_ARRANGE: Đơn trả hàng đang chờ người dùng chọn phương thức vận chuyển. Áp dụng cho cả logistics tích hợp và không tích hợp.
  • LOGISTICS_READY: Người dùng đã chọn phương thức vận chuyển, đang chờ hệ thống tạo yêu cầu logistics. Số tracking chưa khả dụng. Áp dụng cho cả logistics tích hợp và không tích hợp.
  • LOGISTICS_REQUEST_CREATED: Yêu cầu logistics đã được tạo thành công. Số tracking đã khả dụng.
  • LOGISTICS_PICKUP_RETRY: Đơn vị vận chuyển bên thứ ba sẽ thực hiện thêm một lần nữa để lấy hàng từ người mua. Chỉ áp dụng cho logistics tích hợp vì được cập nhật bởi đơn vị vận chuyển bên thứ ba về Shopee.
  • LOGISTICS_PICKUP_FAILED: Đơn vị vận chuyển bên thứ ba đã không thể lấy hàng từ người mua. Chỉ áp dụng cho logistics tích hợp.
  • LOGISTICS_PICKUP_DONE: Đối với logistics tích hợp, nghĩa là hàng đã được đơn vị vận chuyển bên thứ ba lấy. Đối với logistics không tích hợp, nghĩa là người dùng đã nhập bằng chứng giao hàng.
  • LOGISTICS_DELIVERY_FAILED: Giao hàng đến người bán thất bại. Chỉ áp dụng cho logistics tích hợp.
  • LOGISTICS_LOST: Hàng đã được đánh dấu là mất. Chỉ áp dụng cho logistics tích hợp.
  • LOGISTICS_DELIVERY_DONE: Hàng đã được giao thành công đến người bán. Chỉ áp dụng cho logistics tích hợp.

[RR trong quá trình vận chuyển]​

  • Preparing (Đang chuẩn bị)
  • Delivered (Đã giao)
  • Delivery Failed (Giao hàng thất bại)
  • Lost (Mất hàng)

[Trả hàng tại chỗ]​

  • Preparing (Đang chuẩn bị)
  • Delivered (Đã giao)
  • Delivery Failed (Giao hàng thất bại)
  • Lost (Mất hàng)

Trạng thái logistics sau trả hàng​

Lưu ý chỉ áp dụng cho các kiện hàng trả lại từ kho đến người bán

  • POST_RETURN_LOGISTICS_REQUEST_CREATED: Yêu cầu logistics được tạo thành công kèm số tracking.
  • POST_RETURN_LOGISTICS_REQUEST_CANCELED: Yêu cầu logistics bị hủy bởi đội kho hàng
  • POST_RETURN_LOGISTICS_PICKUP_FAILED: Lấy hàng thất bại
  • POST_RETURN_LOGISTICS_PICKUP_RETRY: Lần thử tiếp theo để lấy hàng.
  • POST_RETURN_LOGISTICS_PICKUP_DONE: Lấy hàng thành công; đang trên đường đến đích.
  • POST_RETURN_LOGISTICS_DELIVERY_FAILED: Giao hàng thất bại. Tài xế sẽ trả hàng về kho.
  • POST_RETURN_LOGISTICS_DELIVERY_DONE: Giao hàng thành công
  • POST_RETURN_LOGISTICS_LOST: Hàng bị đánh dấu mất