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

v2.logistics.create_booking_shipping_document

POST /api/v2/logistics/create_booking_shipping_document

Sử dụng API này để tạo tác vụ tài liệu vận chuyển cho từng booking. API này chỉ khả dụng sau khi đã lấy được mã theo dõi.

Đường dẫn Endpoint

URL: https://partner.shopeemobile.com/api/v2/logistics/create_booking_shipping_document

Tham số chung

NameTypeSampleDescription
partner_idint1Partner ID được cấp khi đăng ký thành công. Bắt buộc cho mọi yêu cầu.
timestamptimestamp1610000000Dùng để xác định thời điểm của yêu cầu. Bắt buộc cho mọi yêu cầu. Hết hạn sau 5 phút.
access_tokenstringc09222e3fc40ffb25fc947f738b1abf1Token truy cập API, dùng để xác định quyền truy cập của bạn. Có thể sử dụng nhiều lần và hết hạn sau 4 giờ.
shop_idint600000Mã định danh duy nhất của cửa hàng trên Shopee. 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 thông 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
booking_listobject[]TrueDanh sách các booking cần lấy. Giới hạn [1,50]
booking_snstringTrue201201E81SYYKEMã định danh duy nhất của booking trên Shopee.
tracking_numberstringFalseSPXID02742637123BMã theo dõi của booking. Bắt buộc trừ kênh cho phép in trước khi sắp xếp vận chuyển.
shipping_document_typestringFalseNORMAL_AIR_WAYBILLLoại tài liệu vận chuyển. Các giá trị: NORMAL_AIR_WAYBILL,THERMAL_AIR_WAYBILL,NORMAL_JOB_AIR_WAYBILL,THERMAL_JOB_AIR_WAYBILL

Tham số Response

NameTypeSampleDescription
request_idstringa8e1b94f51d64540bf5762abe7783073Mã định danh của yêu cầu API để theo dõi lỗi.
errorstringcommon.error_authCho biết loại lỗi nếu có lỗi xảy ra. Để trống nếu không có lỗi.
messagestringInvalid access_token.Cho biết chi tiết lỗi nếu có lỗi xảy ra. Để trống nếu không có lỗi.
warningobject[]Cho biết thông báo cảnh báo bạn cần lưu ý.
booking_snstring201201E81SYYKEMã định danh duy nhất của booking trên Shopee.
responseobjectThông tin chi tiết bạn đang truy vấn.
result_listobject[]Danh sách kết quả.
booking_snstring201201E81SYYKEMã định danh duy nhất của booking trên Shopee.
fail_errorstringlogistics.booking_not_existCho biết loại lỗi nếu một phần tử gặp lỗi.
fail_messagestringThe booking_sn 201201V81SYYDG you provided is not exist.Cho biết chi tiết lỗi nếu một phần tử gặp lỗi.