Upload Proof of Delivery File

POST

/fulfillment/202309/files/upload

This API is used for the seller to upload the proof of delivery file for a package, and to generate the URL of the corresponding file. The generated URL is used for the Update Package Delivery Status API.

This API only supports uploading qualification files in PDF format. The file size can not exceed 10MB.

Note: Only sellers utilizing the SOF (Seller Own Fleet) capability can use this API.

Authorizations

• accessToken

Parameters

Query Parameters

shop_cipher

required

string

Identifies the shop. Obtain it from the Get Authorized Shops API.

Request Body^required

Media typemultipart/form-data

object

data

required

PDF file data to be uploaded to TikTok Shop. Prerequisites：

• Only PDF file format is supported.
• Original file size must not exceed 10MB.

string format: binary

name

required

The name of the uploaded file. The file name must include the file type.

string

Responses

200

Success

Media typeapplication/json

object

code

Status code; 0 means success.

integer format: int64

message

Success or failure message.

string

request_id

Request log ID.

string

data

object

url

The URL returned from uploading the file that can be directly opened in a browser.

string

name

The name of the file.

string

Example

{
  "code": 0,
  "data": {
    "url": "https://maellane.bytedance.net/wsos_v2/oec_fulfillment_doc_tts/o",
    "name": "attachment_file.pdf"
  },
  "message": "Success",
  "request_id": "202203070749000101890810281E8C70B7"
}