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

Liên kết vận chuyển chặng đầu (First Mile Binding)

*Bài viết này chỉ áp dụng cho người bán xuyên biên giới.

Hiện tại, đối với người bán xuyên biên giới ở Trung Quốc đại lục và Hàn Quốc, Shopee cung cấp chức năng liên kết theo dõi chặng đầu. Bạn có thể tham khảo luồng gọi API dưới đây.

Thuật ngữ

Pick up (Lấy hàng tại nhà): Kênh thu gom hàng tận nơi, chỉ "logistics_channel_name": "shopee" ("logistics_channel_id": 813) hỗ trợ pick up.

Drop off (Giao hàng tại điểm): Giao đến các điểm nhận hàng của kênh, ngoại trừ "logistics_channel_name": "shopee"（"logistics_channel_id": 813）và "logistics_channel_name": "Self Deliver"（"logistics_channel_id": 0), các kênh khác bạn lấy được đều là drop off.

Self deliver (Tự giao hàng): Tự giao hàng, không sử dụng logistics bên thứ ba, "logistics_channel_name": "Self Deliver".

first_mile_tracking_number: Mã theo dõi chặng đầu

Thực hành tốt nhất

Đối với các phương thức vận chuyển chặng đầu khác nhau, có thể phân loại thành:

  • Pick up (Lấy hàng tại nhà)
  • Drop off (Giao hàng tại điểm)
  • Self deliver (Tự giao hàng)

Nhà phát triển có thể lấy danh sách kênh chặng đầu và các phương thức vận chuyển được hỗ trợ bởi các kênh tương ứng thông qua API first_mile.get_channel_list.

Đối với phương thức pick up:​

Bước 1: Tạo mã theo dõi chặng đầu qua API v2.first_mile.generate_first_mile_tracking_number và API v2.first_mile.get_tracking_number_list có thể được dùng để truy vấn danh sách mã theo dõi chặng đầu đã tạo.

Bước 2: API v2.first_mile.get_unbind_order_list cung cấp danh sách đơn hàng cần liên kết với mã theo dõi chặng đầu, sau đó vui lòng liên kết chúng qua API v2.first_mile.bind_first_mile_tracking_number. API v2.first_mile.get_detail có thể được dùng để truy vấn chi tiết mã theo dõi chặng đầu.

Bước 3: Gọi API v2.first_mile.get_waybill để in nhãn kiện hàng chặng đầu.

Đối với phương thức drop off:​

Bước 1: Người bán lấy mã theo dõi kênh ngoại tuyến.

Bước 2: Lấy danh sách đơn hàng cần liên kết với mã theo dõi chặng đầu qua API v2.first_mile.get_unbind_order_list và liên kết chúng qua API v2.first_mile.bind_first_mile_tracking_number. API v2.first_mile.get_detail có thể được dùng để truy vấn chi tiết mã theo dõi chặng đầu.

Đối với phương thức self deliver:​

Bước 1: Người bán lấy danh sách đơn hàng cần liên kết với mã theo dõi chặng đầu qua API v2.first_mile.get_unbind_order_list.

Bước 2: Tạo mã theo dõi chặng đầu qua API v2.first_mile.generate_first_mile_tracking_number và API v2.first_mile.get_tracking_number_list có thể được dùng để truy vấn danh sách mã theo dõi chặng đầu đã tạo. (shipping_method cần được tải lên là self-deliver, logistics_channel_id cần được tải lên null).

Q: Có được phép liên kết đơn hàng từ các shop khác nhau cho một mã theo dõi chặng đầu không?A: Có, nhưng hãy đảm bảo rằng các đơn hàng từ các shop khác nhau sử dụng cùng kho trung chuyển. Vì API có xác thực, khi gọi API v2.first_mile.bind_first_mile_tracking_number, mỗi lần chỉ có thể gọi cho đơn hàng của một shop, vì vậy hãy đảm bảo order_sn và shop_id khớp với nhau trong mỗi lần gọi.

Q: Trạng thái đơn hàng có thay đổi sau khi liên kết thành công không?

A: Có, sau khi liên kết chặng đầu thành công và được quét, trạng thái đơn hàng của tất cả các đơn hàng được liên kết sẽ được cập nhật từ PROCESSED thành SHIPPED.

Q: Tôi nên giao hàng và in vận đơn trước hay liên kết chặng đầu trước?

A: Thứ tự đúng là giao hàng trước, sau đó in vận đơn, rồi mới liên kết mã theo dõi chặng đầu cho đơn hàng.

Q: Làm thế nào để kiểm tra mã theo dõi chặng đầu của một đơn hàng?

A: Bạn có thể sử dụng API v2.logistics.get_tracking_number và tải lên tham số yêu cầu response_optional_fields: first_mile_tracking_number thì bạn có thể lấy mã theo dõi chặng đầu của một đơn hàng.

Q: Mã theo dõi chặng đầu (first_mile_tracking_number) ở trạng thái nào có thể được liên kết?

A: Bạn có thể truy vấn trạng thái mã theo dõi chặng đầu qua API v2.first_mile.get_detail.

  1. Nếu ship_method là pickup:
  • Nếu first_mile_tracking_number vừa được tạo, trạng thái là NOT_AVAILABLE, lúc đó đơn hàng có thể được liên kết.
  • Nếu trạng thái theo dõi first_mile_tracking_number là ORDER_RECEIVED, nghĩa là đã có đơn hàng được liên kết và bạn có thể tiếp tục liên kết các đơn hàng khác.
  • Nếu trạng thái first_mile_tracking_number là PICKED_UP, nghĩa là kiện hàng đã được kênh thu gom, không thể liên kết thêm đơn hàng nữa.
  • Nếu trạng thái first_mile_tracking_number là DELIVERED, nghĩa là kiện hàng đã đến kho, không thể liên kết thêm đơn hàng nữa.
  1. Nếu ship_method là drop off hoặc self-deliver: không có hạn chế về trạng thái.

Q: Phương thức self-deliver có vẫn cần gọi API để liên kết chặng đầu không?A: Có, ngay cả khi tự giao hàng là hành động giao hàng ngoại tuyến của người bán, bạn vẫn cần gọi API v2.first_mile.bind_first_mile_tracking_number để liên kết chặng đầu.

Q: Trong trạng thái nào tôi có thể hủy liên kết mã theo dõi chặng đầu cho một đơn hàng?

A: 1. Nếu ship_method là pick up, chỉ khi trạng thái first_mile_tracking_number là ORDER_RECEIVED mới có thể hủy liên kết.

  1. Nếu ship_method là drop off hoặc self-deliver, không có hạn chế về trạng thái first_mile_tracking_number.

Định nghĩa dữ liệu

Trạng thái mã theo dõi chặng đầu

  • ORDER_RECEIVED
  • PICKED_UP
  • DELIVERED

​