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

v2.returns.get_reverse_tracking_info

GET /api/v2/returns/get_reverse_tracking_info

Get reverse and post-return logistics information of return request. For Normal RR, return complete reverse logistics information, for In-transit RR and Return-on-the-Spot, only return latest reverse logistics status, without providing complete reverse logistics information. For seller_validation, only one segment of reverse (buyer to seller), use tracking_info, for warehouse_validation, two segment of reverse (buyer to warehouse and warehouse to seller), use post_return_logistics_tracking_info.

Đường dẫn Endpoint​

URL: https://partner.shopeemobile.com/api/v2/returns/get_reverse_tracking_info

Tham số chung​

NameTypeSampleDescription
partner_idint1Partner ID được gán khi đăng ký thành công. Bắt buộc cho tất cả các yêu cầu.
timestamptimestamp1610000000Dùng để chỉ định thời điểm gửi yêu cầu. Bắt buộc cho tất cả các yêu cầu. Hết hạn sau 5 phút.
access_tokenstringc09222e3fc40ffb25fc947f738b1abf1Token dùng để truy cập API, xác định quyền của bạn. Có thể dùng nhiều lần và hết hạn sau 4 giờ.
shop_idint600000Mã định danh duy nhất của Shopee cho một cửa hàng. Tham số bắt buộc cho hầu hết các API.
signstringe318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2Chữ ký được tạo từ partner_id, đường dẫn api, timestamp, access_token, shop_id và partner_key qua thuật toán HMAC-SHA256. Chi tiết: https://open.shopee.com/documents?module=87&type=2&id=58&version=2

Tham số Request​

NameTypeRequiredSampleDescription
return_snstringTrue2206150VT13E3MQShopee's unique identifier for a return/refund request (serial number of return).

Tham số Response​

NameTypeSampleDescription
errorstringCho biết loại lỗi nếu xảy ra. Trống nếu không có lỗi.
messagestringCho biết chi tiết lỗi nếu xảy ra. Trống nếu không có lỗi.
request_idstringd52ca43b277a4f9292fb8be658bfd33dMã định danh của yêu cầu API dùng để theo dõi lỗi.
responseobject
return_snstring2206150VT13E3MQShopee's unique identifier for a return/refund request (serial number of return).
return_refund_request_typeint320Cho biết loại yêu cầu hoàn trả/hoàn tiền: 0: RR Thông thường 1: RR Đang vận chuyển 2: Hoàn trả Tại Chỗ. Xem thêm Định nghĩa Dữ liệu - Return Refund Request Type.
validation_typestringseller_validationCho biết người bán hay kho hàng sẽ nhận kiện hàng hoàn trả từ người mua và xác nhận tình trạng: - seller_validation - warehouse_validation. Xem thêm Định nghĩa Dữ liệu - ValidationType.
reverse_logistics_statusstringLOGISTICS_REQUEST_CREATEDCho biết trạng thái logistics ngược mới nhất của yêu cầu hoàn trả, đề cập đến trạng thái hiện tại của người mua gửi kiện hàng về điểm xác nhận (người bán hoặc kho hàng), bao gồm RR Thông thường, RR Đang vận chuyển và Hoàn trả Tại Chỗ. Xem "Định nghĩa Dữ liệu - ReverseLogisticsStatus". Lưu ý: Nếu validation_type = seller_validation, chỉ có một đoạn logistics ngược (người mua gửi kiện hàng trực tiếp về người bán). Dùng các trường reverse_logistics_status, reverse_logistics_update_time, tracking_number và tracking_info để lấy thông tin theo dõi.
reverse_logistics_update_timetimestamp1740728119Thời gian cập nhật cuối cùng của trạng thái logistics ngược bao gồm RR Thông thường, RR Đang vận chuyển và Hoàn trả Tại Chỗ. Lưu ý: Nếu validation_type = seller_validation, chỉ có một đoạn logistics ngược. Dùng các trường reverse_logistics_status, reverse_logistics_update_time, tracking_number và tracking_info để lấy thông tin theo dõi.
estimated_delivery_date_maxtimestamp1740728121Ngày giao hàng tối đa ước tính cho logistics ngược. Được Shopee Logistics Services tính sau khi người mua gửi hàng nếu có dữ liệu lịch sử từ 3PL. Lưu ý: Chỉ khả dụng cho RR Thông thường với logistics ngược tích hợp.
estimated_delivery_date_mintimestamp1740626000Ngày giao hàng tối thiểu ước tính cho logistics ngược. Được Shopee Logistics Services tính sau khi người mua gửi hàng nếu có dữ liệu lịch sử từ 3PL. Lưu ý: Chỉ khả dụng cho RR Thông thường với logistics ngược tích hợp.
tracking_numberstringMY257829361436JMã theo dõi cho logistics ngược (mã theo dõi logistics khi người mua gửi hàng trở lại). Lưu ý: - Chỉ khả dụng cho RR Thông thường với logistics ngược tích hợp. - Nếu validation_type = seller_validation, chỉ có một đoạn logistics ngược. Dùng các trường reverse_logistics_status, reverse_logistics_update_time, tracking_number và tracking_info để lấy thông tin theo dõi.
tracking_infoobject[]Danh sách thông tin theo dõi chi tiết cho logistics ngược. Lưu ý: - Chỉ khả dụng cho RR Thông thường với logistics ngược tích hợp, với thông tin theo dõi được 3PL đẩy về Shopee. - Nếu validation_type = seller_validation, chỉ có một đoạn logistics ngược. Dùng các trường reverse_logistics_status, reverse_logistics_update_time, tracking_number và tracking_info.
update_timetimestamp1740728119Thời điểm thông tin logistics ngược được cập nhật cho RR Thông thường, được đẩy từ 3PL về Shopee.
tracking_descriptionstringParcel has been picked up by our logistics partnerMô tả thông tin theo dõi logistics ngược cho RR Thông thường, được 3PL đẩy về Shopee.
epop_image_liststring[]["https://cf.shopee.sg/file/4ecbb6fa567e42c1b1e02993ad53df12"]Image URLs of electronic proof of pickup (ePOP) after return parcel has been picked up from the buyer for Normal RR.
epod_image_liststring[]["https://cf.shopee.sg/file/4ecbb6fa567e42c1b1e02993ad53df12"]Image URLs of electronic proof of delivery (ePOD) after return parcel has been delivered to the seller for Normal RR.
post_return_logistics_statusstringTrạng thái logistics sau hoàn trả, đề cập đến trạng thái hiện tại của kho hàng gửi kiện hàng hoàn trả về người bán trong chế độ xác nhận kho hàng. Xem "Định nghĩa Dữ liệu - Post Return Logistics Status". Lưu ý: Chỉ khả dụng cho RR Thông thường với return_solution = 0 (Hoàn trả và Hoàn tiền) và validation_type = warehouse_validation, khi kho hàng gửi kiện hàng về người bán bằng logistics ngược tích hợp. Có hai đoạn logistics ngược: đoạn 1 người mua gửi về kho, đoạn 2 kho gửi về người bán. Đối với Hoàn trả Xuyên biên giới, API trả về thông tin cả hai đoạn nếu đoạn 2 tồn tại. Đối với Hoàn trả Nội địa, API ưu tiên và chỉ trả về thông tin đoạn 2.
post_return_logistics_update_timetimestampThời gian cập nhật cuối cùng của trạng thái logistics sau hoàn trả khi kho hàng gửi kiện hàng về người bán. Lưu ý: Chỉ khả dụng cho RR Thông thường với return_solution = 0 và validation_type = warehouse_validation với logistics ngược tích hợp.
rts_tracking_numberstringMã theo dõi cho logistics sau hoàn trả (mã theo dõi khi kho hàng gửi kiện hàng về người bán). RTS là viết tắt của "Return to Seller". Lưu ý: Chỉ khả dụng cho RR Thông thường với return_solution = 0 và validation_type = warehouse_validation với logistics ngược tích hợp.
post_return_logistics_tracking_infoobject[]Chỉ khả dụng cho RR Thông thường với return_solution = 0 (Hoàn trả và Hoàn tiền) và validation_type = warehouse_validation, khi kho hàng gửi kiện hàng về người bán bằng logistics ngược tích hợp. Trong trường hợp này, thông tin theo dõi logistics từ kho về người bán được gọi là "post-return logistics", được 3PL đẩy về Shopee.
update_timetimestampThời điểm thông tin logistics ngược được cập nhật cho RR Thông thường từ kho hàng đến người bán, được đẩy từ 3PL về Shopee.
tracking_descriptionstringMô tả thông tin theo dõi logistics ngược cho RR Thông thường từ kho hàng đến người bán, được 3PL đẩy về Shopee. Khớp với mô tả theo dõi hiển thị cho người bán trên trang chi tiết hoàn trả/hoàn tiền của Seller Center.
epop_image_liststring[]Image URLs of electronic proof of pickup (ePOP) after return parcel has been picked up from the warehouse for Normal RR with warehouse validation.
epod_image_liststring[]Image URLs of electronic proof of delivery (ePOD) after return parcel has been delivered to the seller for Normal RR with warehouse validation.