POST Fulfillment Upload Delivery File
Tải lên tệp giao hàng Fulfillment Shop Required scope: seller.fulfillment.basic API này được người bán sử dụng để tải lên tệp bằng chứng giao hàng cho một kiện hàng, và để tạo URL của tệp tương ứng. URL được tạo ra sẽ được dùng cho Update Package Delivery Status API
.
API này chỉ hỗ trợ tải lên các tệp chứng từ ở định dạng PDF. Kích thước tệp không được vượt quá 10MB.
Lưu ý: Chỉ những người bán sử dụng năng lực SOF (Seller Own Fleet) mới có thể dùng API này. Version 202309
POST/fulfillment/202309/files/upload
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Kiểu cho phép: multipart/form-data |
| x-tts-access-token Required | string | Giá trị access_token của người bán từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy access_token của người bán. |
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ể nhận diện người gửi. |
| timestamp Required | int | Dấu thời gian Unix GMT (UTC+00:00). Dấu thời gian này được dùng trên tất cả các yêu cầu API. Nhà phát triển có thể dùng nó để chuyển đổi 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 |
| category_asset_cipher | string | Định danh đối tác được dùng trong các yêu cầu API. Lấy giá trị này bằng cách sử dụng Get Authorized Category Assets API. |
Body
| Properties | Type | Description |
|---|---|---|
| data Required | file | Dữ liệu tệp PDF cần tải lên TikTok Shop. Điều kiện tiên quyết：- Chỉ hỗ trợ định dạng tệp PDF.- Kích thước tệp gốc không được vượt quá 10MB. |
| name Required | string | Tên của tệp được tải lên. Tên tệp phải bao gồm loại tệp. |
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 | Nhật ký 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 | | --- | --- | | 12038002 | Tệp tải lên không hợp lệ. Vui lòng đảm bảo bạn đang truyền đúng dữ liệu tệp. | | 12038004 | Loại tệp không hợp lệ. Vui lòng đảm bảo bạn đang cung cấp một tệp PDF. | | 12038005 | Kích thước tệp không hợp lệ. Vui lòng đảm bảo tệp của bạn nhỏ hơn 10MB. |
Is this content helpful?Helpful
Not Helpful
PreviousNext