POST Ship Package
Ship Package Shop Required scope: seller.fulfillment.basic Sử dụng API này để giao một package. Có hai loại tùy chọn vận chuyển khả dụng: TikTok Shipping hoặc Seller Shipping.
- TikTok Shipping: Lên lịch thời gian bàn giao package để các đơn vị vận chuyển TikTok Shipping đến lấy package từ seller.
- Seller Shipping: Seller tự sắp xếp vận chuyển và tải lên tracking number cùng shipping_provider_id. Package ID có thể lấy được từ Get Order Detail
. Version 202309
POST/fulfillment/202309/packages/{package_id}/ship
Request
Path
| Properties | Type | Description |
|---|---|---|
| package_id Required | string | TikTok Shop package ID. |
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Loại được phép: application/json |
| x-tts-access-token Required | string | Giá trị access_token của seller từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy access_token của seller. |
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 | Signature được tạo bởi thuật toán gen. Khi bạn gửi các API request đế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 API request. Developer có thể dùng cái này để chuyển đổi sang giờ địa phương. |
| shop_cipher Required | string | Sử dụng property 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ề response không chính xác. Lấy bằng API Get Authorization Shop |
Body
| Properties | Type | Description |
|---|---|---|
| handover_method | string | Các giá trị có thể có:- PICKUP: Một đơn vị vận chuyển sẽ đến lấy package từ địa chỉ lấy hàng của seller.- DROP_OFF: Seller sẽ cần mang package đến một địa điểm được chỉ định. |
| pickup_slot | object | Khung thời gian lấy hàng. |
| self_shipment | object | Chỉ cần thiết cho các package seller tự vận chuyển. Kiểm tra trường delivery_option của Get Package Detail để xem cách phân biệt platform-logistics và self-shipping. Sử dụng shipping_provider_id lấy được từ Get Shipping Providers và tải lên tracking_number 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 API response. |
| message | string | Các thông báo thành công hoặc thất bại được trả về trong API response. Lý do thất bại sẽ được mô tả trong message. |
| request_id | string | Request log |
| 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. | | 11001002 | invalid param. | | 11001031 | System process error, please try again later. | | 11006013 | Failed to ship package. Products under the Phones & Tablets category cannot be shipped together with other items in the same package. Please split the order. | | 11006014 | Failed to ship package. If you are shipping multiple products under the Phones & Tablets category, they must be shipped in individual packages. Please split the order to continue. | | 11006021 | Package has been shipped. Please not ship the package again. | | 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. | | 11021010 | The shipment failed due to an invalid postal code. Please ask the buyer to edit the address. If the address cannot be changed, you may cancel the order without penalty by selecting the following reason: Unable to deliver to buyer address. | | 11021011 | Fail to ship package because the product name is invalid. You may cancel the order without penalty by selecting the following reason: Unable to deliver to buyer address. | | 11021012 | illegal address | | 11021013 | The shipment failed because the delivery address is too long. Please ask the buyer to shorten the address. If the address cannot be changed, you may cancel the order without penalty by selecting the following reason: Unable to deliver to buyer address. | | 11021014 | product oversize | | 11021015 | Fail to ship package because the package is overweight. You may cancel the order without penalty by selecting the following reason: Unable to deliver to buyer address. | | 11021016 | Fail to ship package because the weight of the SKU exceeds the allowed limit. You may cancel the order without penalty by selecting the following reason: Unable to deliver to buyer address. | | 11021017 | Fail to ship package because the SKU dimensions exceed the allowed limits. You may cancel the order without penalty by selecting the following reason: Unable to deliver to buyer address. | | 11021018 | Fail to ship package because the number of items in the package exceeds the allowed limit. | | 11021019 | Fail to ship package because the package dimensions exceed the allowed limits. You may cancel the order without penalty by selecting the following reason: Unable to deliver to buyer address. | | 11021020 | Fail to ship package because the package's circumference exceeds the allowed limit. You may cancel the order without penalty by selecting the following reason: Unable to deliver to buyer address. | | 11021021 | Fail to ship package because the SKU name is invalid. You may cancel the order without penalty by selecting the following reason: Unable to deliver to buyer address. | | 11021022 | Fail to ship package because the longest dimension of the package exceeds the allowed limit. You may cancel the order without penalty by selecting the following reason: Unable to deliver to buyer address. | | 11021023 | Fail to ship package because the buyer and/or seller addresses are invalid. You may cancel the order without penalty by selecting the following reason: Unable to deliver to buyer address. | | 11021024 | Fail to ship package because the buyer recipient address is invalid. You may cancel the order without penalty by selecting the following reason: Unable to deliver to buyer address. | | 11021025 | Fail to ship package because the seller shipping address is invalid. You may cancel the order without penalty by selecting the following reason: Unable to deliver to buyer address. | | 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). | | 21001003 | System timeout. If the error persists, please contact the platform for assistance. | | 21001008 | System process error, please try again later. | | 21001011 | System process error, please try again later. | | 21004006 | Failed to ship. Please ensure an invoice is uploaded before shipping. | | 21004017 | ON DEMAND RTS NOT IN PICKUP TIME. | | 21004019 | Need invoice uploaded for all order before rts. | | 21004020 | Fulfillment Invoice status is not success, can not rts pkg. | | 21004024 | ship order failed due to platform limitations. | | 21008025 | Seller cannot operate orders which are fulfilled by platform | | 21008044 | Package item has after-sale request, please process the after-sale request first. | | 21008099 | Package has been shipped. Please not ship the package again. | | 21011001 | Package not found. If the error persists, please contact the platform for assistance. | | 21011003 | fulfill_unit action not allowed | | 21011007 | Package item has after-sale request, please process the after-sale request first. | | 21011008 | Package is not complete. If the error persists, please contact the platform for assistance. | | 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. | | 21011027 | Package has already been delivered. | | 21011028 | The package does not belong to the current shop. | | 21011030 | fulfillment not allow update tracking no. | | 21011040 | Package has already been shipped. | | 21011041 | Cannot complete the operation when order is cancelled. | | 21011050 | The tracking number can only be updated within a certain number of hours. | | 21011051 | The tracking number can only be updated once. | | 21011053 | Fail to ship package because the shipment time is outside of the pick-up time slot. | | 21011054 | No available shipping services for this request due to missing pick-up time slot. Please contact customer service for assistance. | | 21014009 | Failed to ship. You may cancel the order without penalty by selecting the following reason: Unable to deliver to buyer address. | | 21021010 | Failed to ship. You may cancel the order without penalty by selecting the following reason: Unable to deliver to buyer address. | | 21022029 | System process error, please try again later. | | 21022032 | match provider failed. | | 21034012 | tracking no has been used. | | 21042001 | System process error, please try again later. | | 21042067 | The logistics service provider couldn't process your order. | | 21042076 | System process error, please try again later. | | 21042227 | For pop 4pl（cross-border），the return warehouse for the shipping location has not been configured. |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext