stable本次发布有变化全部展示
来自 TikTok Shop 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 Path: /fulfillment/202309/packages/{package_id}/ship
#§2 Method: [POST]
#§3 Function Description
Use this API to ship a package. There are two kinds of shipping options available: TikTok Shipping or Seller Shipping.
TikTok Shipping: Schedule a package handover time for TikTok Shipping carriers to pickup a package from seller.Seller Shipping: Seller arranges their own shipping, and uploads a tracking number andshipping_provider_id. Package ID can be obtained from Get Order Detail.In-store Pickup: Confirms shipment and notifies the buyer that the order is ready for pickup.
§4 Common Parameters
For common parameters, refer to How to call TikTok Shop APIs - Common Parameters
| Properties | Location | Type | Require | Sample | Properties description |
|---|---|---|---|---|---|
| shop_cipher | query | string | Y | GCP_XF90igAAAABh00qsWgtvOiGFNqyubMt3 | Use this property to pass shop information in requesting the API. Failure in passing the correct value when requesting the API for cross-border shops will return incorrect response. |
| Get by API Get Authorization Shop | |||||
| content-type | header | string | Y | application/json | Allowed type: application/json |
§5 Request Path Parameters
| Properties | Type | Require | Sample | Properties description |
|---|---|---|---|---|
| package_id | string | Y | 5433567853345 | TikTok Shop package ID. |
§6 Request Query Parameters
| Properties | Type | Require | Sample | Properties description |
|---|---|---|---|---|
| app_key | string | Y | 38abcd | Every single app will have a unique key. Please use the specific key assigned to your app. |
| sign | string | Y | 5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c | Signature generated by gen algorithm. When you send API requests to TTS, you must sign them so that TTS can identify the senders. |
| timestamp | int | Y | 1623812664 | Unix timestamp GMT (UTC+00:00). This timestamp is used across all API requests. Developers can use this convert to local time. |
§7 Request Body Parameters
| Properties | Type | Require | Sample | Properties description |
|---|---|---|---|---|
| handover_method | string | N | PICKUP | Possible values: |
PICKUP: A logistics carrier will pick up the package(s) from the seller's pickup address.DROP_OFF: The seller will need to drop off the package(s) to a designated location. | pickup_slot |object |N | |Pickup time slot. | ^start_time |int |N |1623812664 |The start date and time of the package pickup time slot. Unix timestamp. | ^end_time |int |N |1623812664 |The end date and time of the package pickup time slot. Unix timestamp. | self_shipment |object |N | |Only needed for merchant self-shipping packages. Check thedelivery_optionfield of Get Package Detail to see how to differentiate platform-logistics and self-shipping. Use theshipping_provider_idretrieved from Get Shipping Providers and upload the correspondingtracking_number. | ^tracking_number |string |Y |JX12345 |For package withSEND_BY_SELLERasdelivery_option(merchant self-shipping mode), you must input atracking_numberto call this API. | ^shipping_provider_id |string |Y |6617675021119438849 |For package withSEND_BY_SELLERasdelivery_option(merchant self-shipping mode), you must input ashipping_provider_idto call this API. Please use Get Shipping Providers to obtain theshipping_provider_id. |
§8 Request Sample
Query
https://open-api.tiktokglobalshop.com/fulfillment/202309/packages/5433567853345/ship?app_key=123abc&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c×tamp=1625484268&shop_cipher=ROW_RHkDDABBAAB8tKAVoAqsMTjsQZFLyNfY
Body
{"handover_method":"PICKUP","pickup_slot":{"start_time":1623812664,"end_time":1623812664},"self_shipment":{"tracking_number":"JX12345","shipping_provider_id":"6617675021119438849"}}
§9 Response Parameters
| Properties | Type | Sample | Properties description |
|---|---|---|---|
| code | int | 0 | The success or failure status code returned in API response. |
| message | string | Success | The success or failure messages returned in API response. Reasons of failure will be described in the message. |
| request_id | string | 202203070749000101890810281E8C70B7 | Request log |
| data | object | Specific return information |
§10 Response Sample
{"code":0,"data":{},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}
§11 Error Code
For common error codes, refer to How to call TikTok Shop APIs - Common Error Code
| 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 | not found error |
| 21001011 | System process error, please try again later. |
| 21001028 | The order is being processed. 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 | SellerFulfillUnitInReverseCannotOperate |
| 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. Please ensure you are providing the correct package ID and/or shop cipher. |
| 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. |
| 21042251 | Abnormal order status, item cannot be shipped. |