POST Đánh Dấu Kiện Hàng Đã Gửi
Đánh Dấu Kiện Hàng Đã Gửi Shop Required scope: seller.fulfillment.basic API này hiện chỉ áp dụng cho các thị trường sau: US, UK, ES, IE, IT, DE, FR, JP. API này dành cho người bán tự thực hiện đơn hàng thông qua đơn vị vận chuyển do họ lựa chọn/ưa thích, và cho phép người bán tải lên thông tin kiện hàng hợp lệ (các mặt hàng trong kiện hàng, thông tin nhà cung cấp vận chuyển, và mã vận đơn) cho đơn hàng/dòng mặt hàng trong đơn hàng lên TikTok Shop. Sử dụng API Get Shipping Providers
để lấy shipping_provider_id của các nhà cung cấp vận chuyển. Version 202309
POST/fulfillment/202309/orders/{order_id}/packages
Request
Path
| Properties | Type | Description |
|---|---|---|
| order_id Required | string | Mã định danh duy nhất cho một đơn hàng TikTok Shop. |
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Loại được phép: application/json |
| x-tts-access-token Required | string | Giá trị seller access_token từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy seller access_token. |
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 yêu cầu API đến TTS, bạn phải ký chúng để TTS có thể xác định 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ể chuyển đổi giá trị này sang giờ địa phương. |
| shop_cipher Required | string | Sử dụng thuộc tính này để truyền thông tin shop khi gọi API. Việc không truyền đúng giá trị khi gọi 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 |
Body
| Properties | Type | Description |
|---|---|---|
| order_line_item_ids | []string | Danh sách các ID dòng mặt hàng trong đơn hàng. |
| tracking_number Required | string | Mã vận đơn. |
| shipping_provider_id Required | string | Sử dụng Get Shipping Provider API để lấy shipping_provider_id của các nhà cung cấp vận chuyển. |
| order_line_list | []object | Tham số mới này hoàn toàn tương thích ngược với trường oder_line_items_ids trước đó và ngoài ra còn hỗ trợ tách đơn hàng theo gói (bundle), hãy sử dụng các sub item tương ứng |
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 | 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 | Log 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 | | --- | --- | | 36009003 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. | | 11001027 | System timeout. If this error persists, please contact the platform for assistance. | | 11001031 | System process error, please try again later. | | 11005004 | warehouse not exist | | 11005010 | get lead time from card service error | | 11006005 | System process error, please try again later. | | 11006026 | System process error, please try again later. | | 11021009 | No available shipping services for this request. Please modify the package weight or check the recipient address. If the error persists, please contact the platform for assistance. | | 11028006 | This tracking number cannot be matched to any carrier, please check the tracking number and upload again. | | 11050001 | invalid param | | 21001001 | Invalid parameters. Please ensure you are passing the correct request parameter(s). | | 21001008 | System process error, please try again later. | | 21001011 | System process error, please try again later. | | 21001029 | rpc logistics_logistics_service_4b failed | | 21001043 | System process error, please try again later. | | 21001055 | System process error, please try again later. | | 21004012 | Tracking number has special characters, verify failed. | | 21004015 | Tracking number mismatch provider. | | 21004016 | Tracking number verify, not avalible logsitics service or provider | | 21004019 | Need invoice uploaded for all order before rts. | | 21004020 | Fulfillment Invoice status is not success, can not rts pkg. | | 21008025 | Seller cannot operate orders which are fulfilled by platform | | 21008042 | seller already print shipping label | | 21008044 | SellerFulfillUnitInReverseCannotOperate | | 21008099 | Package has been shipped. Please not ship the package again. | | 21008106 | This interface cannot be used in this region. | | 21008300 | System process error, please try again later. | | 21011001 | Package not found. If the error persists, please contact the platform for assistance. | | 21011003 | fulfill_unit action not allowed | | 21011004 | This API cannot be used to update package shipping information for packages that are not shipped by sellers. | | 21011006 | These orders are already shipped. | | 21011007 | Package item has after-sale request, please process the after-sale request first. | | 21011012 | not match trade rule | | 21011013 | not match logistics rule | | 21011020 | These orders are already shipped. | | 21011022 | Invalid tracking number or provider ID. Please double check and try again. | | 21011025 | Duplicate tracking number. | | 21011026 | fulfillment tracking no used times over limit | | 21011029 | order does not belong to fulfill unit | | 21011030 | fulfillment not allow update tracking no | | 21011033 | order already combined | | 21011036 | split same sku in Multi Package not allow. | | 21011046 | Order has combine, not allow split order | | 21011048 | There are multiple packages that can be shipped, please specify the order line that needs to be shipped. | | 21011050 | The tracking number can only be updated within a certain number of hours. | | 21011051 | The tracking number can only be updated once. | | 21021010 | Failed to ship. You may cancel the order without penalty by selecting the following reason: Unable to deliver to buyer address. | | 21022025 | A shipping label has already been purchased. | | 21022026 | Cannot purchase shipping label, please try again later. | | 21022028 | split pkg fail. | | 21022029 | System process error, please try again later. | | 21022030 | System process error, please try again later. | | 21032001 | fulfill unit status not allow to update pkg attr | | 21034006 | decision route occurs error | | 21034012 | tracking no has been used | | 21042056 | These orders are already shipped. | | 21042057 | These orders are not in the Awaiting shipment status. Couldn't create labels for them. |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext