POST Update Package Shipping Info
Update Package Shipping Info Shop Required scope: seller.fulfillment.basic If the seller entered an incorrect tracking number, this API allows the seller to update the tracking number and shipping provider for a package that has already been shipped. Attention: This API is only applicable to orders (or packages) shipped by the seller. It is only used to update the tracking number and shipping provider for packages that have already been shipped. Version 202309
POST/fulfillment/202309/packages/{package_id}/shipping_info/update
Request
Path
| Properties | Type | Description |
|---|---|---|
| package_id Required | string | TikTok Shop package ID. |
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Allowed type: application/json |
| x-tts-access-token Required | string | The seller access_token value from Get Access Token, when user_type = 0. Follow this guide to get seller access_token. |
Query
| Properties | Type | Description |
|---|---|---|
| app_key Required | string | Every single app will have a unique key. Please use the specific key assigned to your app. |
| sign Required | string | Signature generated by gen algorithm. When you send API requests to TTS, you must sign them so that TTS can identify the senders. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). This timestamp is used across all API requests. Developers can use this convert to local time. |
| shop_cipher Required | string | 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 |
Body
| Properties | Type | Description |
|---|---|---|
| tracking_number Required | string | The shipment tracking number provided by the carrier. |
| shipping_provider_id Required | string | Identifies the carrier that will deliver the package. Please call the Get Shipping Providers API to retrieve the available shipping provider(s). |
Example
CurlGoNode.jsJavaEnable word wrap
Response Parameters
| Properties | Type | Description |
|---|---|---|
| code | int | The success or failure status code returned in API response. |
| message | string | The success or failure messages returned in API response. Reasons of failure will be described in the message. |
| request_id | string | Request log |
| data | object | Specific return information |
Example
JSONEnable word wrap
Error Code
View common error codes
| Code | Message | | --- | --- | | 10007002 | Current order is not a merchant blind box order. | | 36009003 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. | | 21011001 | Package not found. If the error persists, please contact the platform for assistance. | | 21011004 | This API cannot be used to update package shipping information for packages that are not shipped by sellers. | | 21011007 | Package item has after-sale request, please process the after-sale request first. | | 21011022 | Invalid tracking number or provider ID. Please double check and try again. | | 21011028 | The package does not belong to the current shop. | | 21011030 | Package has already been delivered. If you would still like to update the tracking number, please contact the platform for assistance. | | 21011042 | Cannot complete the operation when order is cancelled. | | 21011043 | The package has not been shipped yet. | | 21011049 | Due to platform rule limitations, you are unable to update the tracking number. | | 21011050 | The tracking number can only be updated within a certain number of hours. | | 21011051 | The tracking number can only be updated once. | | 21011052 | The tracking number can only be updated a limited number of times. | | 25001010 | A return request has already been completed, or the order has already been cancelled. |
Is this content helpful?Helpful
Not Helpful
PreviousNext