v2.logistics.create_shipping_document

POST /api/v2/logistics/create_shipping_document

Dùng API này để tạo tác vụ in chứng từ vận chuyển cho từng đơn hàng hoặc gói hàng. API này chỉ khả dụng sau khi đã có mã vận đơn.

Đường dẫn Endpoint

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

Tên	Kiểu	Mẫu	Mô tả
partner_id	int	1	Partner ID được cấp khi đăng ký thành công. Bắt buộc cho mọi yêu cầu.
timestamp	timestamp	1610000000	Dù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_token	string	c09222e3fc40ffb25fc947f738b1abf1	Token truy cập API, dùng để 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_id	int	600000	Mã định danh duy nhất của Shopee cho một cửa hàng. Bắt buộc cho hầu hết các API.
sign	string	e318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2	Chữ 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 băm HMAC-SHA256. Chi tiết: https://open.shopee.com/documents?module=87&type=2&id=58&version=2

Tên	Kiểu	Bắt buộc	Mẫu	Mô tả
order_list	object[]	True		Danh sách đơn hàng cần tạo chứng từ vận chuyển. Giới hạn [1, 50].
order_sn	string	True	201118BCKPJQQ8	Mã định danh duy nhất của Shopee cho một đơn hàng.
package_number	string	False	2485710696837122445	Mã định danh duy nhất của Shopee cho gói hàng thuộc đơn hàng. Không nên điền chuỗi rỗng khi không có mã gói hàng.
tracking_number	string	False	SPXID02742637123B	Mã vận đơn của đơn hàng. Bắt buộc trừ kênh cho phép in trước khi sắp xếp vận chuyển.
shipping_document_type	string	False	NORMAL_AIR_WAYBILL	Loại chứng từ vận chuyển. Các giá trị có thể: NORMAL_AIR_WAYBILL, THERMAL_AIR_WAYBILL, NORMAL_JOB_AIR_WAYBILL, THERMAL_JOB_AIR_WAYBILL, THERMAL_UNPACKAGED_LABEL

Tên	Kiểu	Mẫu	Mô tả
request_id	string	5551ce8db5314c70a362dfe33544f074	Mã định danh cho yêu cầu API, dùng để theo dõi lỗi.
error	string	error_auth	Cho biết loại lỗi nếu có lỗi xảy ra. Để trống nếu không có lỗi.
message	string	Invalid 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.
warning	object[]		Thông báo cảnh báo cần lưu ý.
order_sn	string	201118BCKPJKW0	Mã định danh duy nhất của Shopee cho một đơn hàng.
package_number	string	12345678	Mã định danh duy nhất của Shopee cho gói hàng thuộc đơn hàng.
response	object		Thông tin chi tiết bạn đang truy vấn.
result_list	object[]		Danh sách kết quả.
order_sn	string	201118BCKPJQQ8	Mã định danh duy nhất của Shopee cho một đơn hàng.
package_number	string	2485710696837122445	Mã định danh duy nhất của Shopee cho gói hàng thuộc đơn hàng.
fail_error	string	logistics.order_not_exist	Cho biết loại lỗi nếu một phần tử gặp lỗi.
fail_message	string	The order_sn 201118BCKPJKW0 you provided is not exist. Please check	Cho biết chi tiết lỗi nếu một phần tử gặp lỗi.