GET Lấy Tài Liệu Vận Chuyển Của Gói Hàng
Lấy Tài Liệu Vận Chuyển Của Gói Hàng Shop Scope bắt buộc: seller.fulfillment.basic Đối với các đơn hàng được vận chuyển bởi TikTok Shop, API này lấy URL của các tài liệu vận chuyển (nhãn vận chuyển và phiếu đóng gói) cho một gói hàng được chỉ định bởi package ID. API này chỉ áp dụng cho các đơn hàng "TikTok Shipping". Để lấy URL tài liệu vận chuyển qua API này, trước tiên hãy gọi "Ship Package" để vận chuyển gói hàng tương ứng. Phiên bản 202309
GET/fulfillment/202309/packages/{package_id}/shipping_documents
Request
Path
| Properties | Type | Description |
|---|---|---|
| package_id Required | string | TikTok Shop package ID. |
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Kiểu được cho phép: application/json |
| x-tts-access-token Required | string | Giá trị access_token của người bán từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy access_token của người bán. |
Query
| Properties | Type | Description |
|---|---|---|
| app_key Required | string | Mỗi app sẽ có một key duy nhất. Vui lòng sử dụng key cụ thể được gán cho app của bạn. |
| sign Required | string | Chữ ký được tạo bởi thuật toán gen. Khi bạn gửi các yêu cầu API đến TTS, bạn phải ký chúng để TTS có thể nhận diện người gửi. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). Timestamp này được sử dụng trên tất cả các yêu cầu API. Nhà phát triển có thể dùng để chuyển đổi sang giờ địa phương. |
| document_type Required | string | Các kiểu tài liệu có sẵn: - SHIPPING_LABEL: Trả về nhãn vận chuyển ở định dạng PDF theo mặc định.- PACKING_SLIP: Trả về phiếu đóng gói ở định dạng PDF theo mặc định.- SHIPPING_LABEL_AND_PACKING_SLIP: Trả về cả nhãn vận chuyển và phiếu đóng gói cho gói hàng, cả hai ở định dạng PDF theo mặc định. - SHIPPING_LABEL_PICTURE: Trả về nhãn vận chuyển ở định dạng PNG. - HAZMAT_LABEL: Trả về nhãn hàng nguy hiểm ở định dạng PDF theo mặc định. Bạn chỉ được sử dụng giá trị này khi có các mặt hàng nguy hiểm trong gói hàng. Khi bạn sử dụng giá trị này, document_size được cố định là A4, và bạn không cần chỉ định document_size.- INVOICE_LABEL: Chỉ dành cho thị trường Brazil, document_size được cố định là A6, và bạn không cần chỉ định document_size. Trả về nhãn hóa đơn ở định dạng PDF theo mặc định |
| document_size | string | Sử dụng trường này để chỉ định kích thước của tài liệu cần lấy. Tham số này chỉ áp dụng cho nhãn vận chuyển, phiếu lấy hàng và phiếu đóng gói ở định dạng PDF. Nó không áp dụng cho nhãn hàng nguy hiểm vì chúng được cố định là A4. Nếu bạn chỉ định SHIPPING_LABEL_PICTURE cho document_type, mọi giá trị được chỉ định trong document_size sẽ bị bỏ qua. Các giá trị có thể: - A6 (Mặc định)- A5 |
| document_format | string | Định dạng của tài liệu vận chuyển.Các giá trị có thể: - PDF (Mặc định)- ZPL (Chỉ dành cho thị trường BR và MX)Lưu ý: Không áp dụng cho kiểu tài liệu SHIPPING_LABEL_PICTURE. |
| shipping_period | string | Lấy nhãn vận chuyển từ các nhà cung cấp giao hàng chặng cuối được chỉ định cho các kịch bản xuyên biên giới.Các giá trị có thể: - DEFAULT (Mặc định)- LAST_MILE (Chỉ các dịch vụ xuyên biên giới theo mô hình 4PL với giải pháp kinh doanh 3PL cho vận chuyển chính và thông quan + 4PL cho giao hàng chặng cuối sẽ trả về nhãn vận chuyển chặng cuối; các lệnh gọi từ tất cả các kịch bản khác sẽ không hợp lệ.) |
| shop_cipher Required | string | Sử dụng thuộc tính này để truyền thông tin shop khi yêu cầu API. Việc không truyền đúng giá trị khi yêu cầu API cho các shop xuyên biên giới sẽ trả về phản hồi không chính xác. Lấy bằng API Get Authorization Shop |
Example
CurlGoNode.jsJavaEnable word wrap
Response Parameters
| Properties | Type | Description |
|---|---|---|
| code | int | Mã trạng thái thành công hoặc thất bại được trả về trong phản hồi API. |
| message | string | Các thông báo thành công hoặc thất bại được trả về trong phản hồi API. Lý do thất bại sẽ được mô tả trong thông báo. |
| request_id | string | Nhật ký yêu cầu |
| data | object | Thông tin trả về cụ thể |
Example
JSONEnable word wrap
Error Code
View common error codes
| Code | Message | | --- | --- | | 11006010 | Internal package status error, please try again later. | | 11034002 | This API is only applicable to TikTok Shipping orders. For seller shipping, please obtain the shipping label offline and upload it to TikTok Shop via API or Seller Center. | | 11034009 | Warehouse does not exist. | | 11034023 | Shipping document generation timeout error, please try again later. | | 11034025 | Internal package tag error, pleaser try again later. | | 11034037 | The shipping document is still being generated by the logistics provider, please try again later. | | 21008017 | This API is only applicable to TikTok Shipping orders. For seller shipping, please obtain the shipping label offline and upload it to TikTok Shop via API or Seller Center. | | 21008043 | This package is fulfilled by TikTok. Shipping documents cannot be printed. | | 21008109 | Unable to retrieve shipping information, please double check the order status. | | 21011001 | Package not found. If the error persists, please contact the platform for assistance. | | 21021010 | Package item has after-sale request, please process the after-sale request first. | | 21023022 | Unknown label print timeout error. If the error persists, please contact the platform for assistance. | | 21023034 | Internal package update error, please try again later. | | 21023035 | Please arrange shipment before retrieving the shipping document. | | 21023046 | Package has already been shipped. | | 21023059 | Package has already been cancelled. | | 21042102 | Documents couldn't be printed after the package has been pickup. | | 21042104 | Documents couldn't be printed before shipped.Please check shipping is arranged and try again. | | 36009003 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. |
Nội dung này có hữu ích không?Hữu ích
Không Hữu ích
PreviousNext