| description Required | string | Mô tả sản phẩm ở định dạng HTML.Lưu ý:- Nội dung phải tuân theo cú pháp HTML. Tất cả các thẻ HTML đều được chấp nhận nhưng để tối ưu hiển thị trên trang chi tiết sản phẩm của TikTok Shop, hệ thống sẽ tự động chuyển đổi một số thẻ thành các định dạng thay thế, chẳng hạn như hiển thị thẻ dưới dạng hình ảnh.- Độ dài tối đa: 10.000 ký tự.- Hướng dẫn về hình ảnh: Bạn phải sử dụng URL hình ảnh của TikTok Shop. Tối đa 30 thẻ ![]() , mỗi thẻ dưới 4000px với các thuộc tính src, width và height.Khuyến nghị: - Nếu bạn đang đồng bộ một mô tả có sẵn từ nền tảng khác, hãy bao gồm toàn bộ mô tả nguồn HTML ở đây.- Cung cấp mô tả chi tiết, lý tưởng là trên 300 ký tự.- Bao gồm 3-5 điểm bán hàng chính, mỗi điểm dưới 250 ký tự, kèm theo hình ảnh hỗ trợ.- Sử dụng kích thước hình ảnh 1600x1600 px.
| category_id Required | string | ID của danh mục của sản phẩm này. Nó phải là một danh mục lá tương ứng với loại cây danh mục được chỉ định trong thuộc tính category_version. Sử dụng Get Categories API để lấy các danh mục khả dụng. Lưu ý:- Tham khảo TikTok Shop Academy để biết thông tin về các hạn chế danh mục sản phẩm.- Đối với thị trường US, nếu bạn đang tạo sản phẩm trong các danh mục INVITE_ONLY, bạn phải gửi một đơn đăng ký riêng thông qua Qualification Center trên TikTok Shop Seller Center để được cấp quyền truy cập. Nếu không, dù sản phẩm vượt qua kiểm duyệt, sản phẩm vẫn sẽ không được đăng bán và không khả dụng cho người mua. (Trạng thái sản phẩm sẽ là PENDING và trạng thái kiểm duyệt sẽ là PRE_APPROVED)- Đối với thị trường Indonesia, để đăng bán một sản phẩm trên cả TikTok Shop và Tokopedia, bạn chỉ được sử dụng các danh mục có sẵn trên cả hai nền tảng. | | brand_id | string | ID của thương hiệu của sản phẩm này. Sử dụng Get Brands API để lấy danh sách các thương hiệu khả dụng cho một shop.Lưu ý: Các thương hiệu chưa được cấp phép sẽ không được hiển thị trên TikTok Shop. | | main_images Required | []object | Danh sách hình ảnh hiển thị trong thư viện hình ảnh sản phẩm.- Số lượng tối đa: 9- Sắp xếp các URI hình ảnh của bạn theo thứ tự mà chúng sẽ xuất hiện trên TikTok Shop.- Kích thước hình ảnh: [300x300 px, 4000x4000 px]Khuyến nghị:- Sử dụng tối thiểu 5 hình ảnh.- Hình ảnh đầu tiên nên có nền trắng. Sử dụng Optimize Images API để đổi nền sang màu trắng. | | skus Required | []object | Danh sách các Stock Keeping Unit (SKU) dùng để nhận diện các biến thể riêng biệt của sản phẩm.Lưu ý:- Số SKU tối đa cho BR, EU, JP, MX, UK, US: 300- Số SKU tối đa cho các khu vực khác: 100Khuyến nghị: Đặt biến thể quan trọng nhất ở đầu mảng. | | title Required | string | Tiêu đề sản phẩm. Độ dài tiêu đề:- DE, ES, FR, IE, IT, JP, UK, US: [1, 255] - BR, MX: [1, 300] - Các khu vực khác: [25, 255] | | is_cod_allowed | bool | Một cờ cho biết có hiển thị tùy chọn thanh toán Cash On Delivery (COD) trong quá trình thanh toán hay không. Sử dụng Get Category Rules API để kiểm tra xem COD có được hỗ trợ cho danh mục sản phẩm của bạn hay không.Chỉ áp dụng cho các thị trường sau:- Người bán toàn cầu: MY, PH, SA, TH, VN- Người bán địa phương: ID, MY, PH, SA, TH, VNLưu ý: Nếu COD không được hỗ trợ, việc đăng bán sẽ thất bại nếu bạn đặt giá trị này là true. | | certifications | []object | Danh sách chứng nhận cho sản phẩm của bạn.Số lượng tối đa: 10Theo hướng dẫn của TikTok Shop, chứng nhận là bắt buộc đối với một số danh mục sản phẩm bị hạn chế. Lấy các yêu cầu chứng nhận cho sản phẩm của bạn từ Get Category Rules API. Tham khảo Chính sách Sản phẩm Bị hạn chế của TikTok Shop để biết thông tin về các hạn chế danh mục sản phẩm. | | package_weight | object | Trọng lượng của gói sản phẩm.Lưu ý:- Trọng lượng gói của tất cả các sản phẩm là bắt buộc theo mặc định, ngoại trừ các sản phẩm thuộc danh mục Virtual Products. Get Categories API ví dụ Digital Games.- Cung cấp trọng lượng được đo sau khi đóng gói sản phẩm.- Giá trị này ảnh hưởng đến chi phí vận chuyển, vì vậy điều quan trọng là đảm bảo các kích thước chính xác. Bất kỳ sai lệch nào trong phép đo đều có thể dẫn đến phí vận chuyển phát sinh.- Trọng lượng gói sẽ được ưu tiên hơn kích thước gói trong việc tính phí nếu phí dựa trên trọng lượng cao hơn. | | product_attributes | []object | Danh sách các thuộc tính chung (ví dụ: nhà sản xuất, quốc gia xuất xứ, chất liệu sử dụng) mô tả sản phẩm như một tổng thể, bất kể biến thể. Quan trọng: Các thuộc tính khả dụng để sử dụng được hệ thống xác định dựa trên danh mục được gán cho sản phẩm, trong đó một số là bắt buộc. Bạn phải cung cấp các thuộc tính sản phẩm được đánh dấu là is_required trong phản hồi của Get Attributes API để tránh thất bại khi đăng bán. | | size_chart | object | Chi tiết số đo của sản phẩm để giúp người mua tìm đúng kích cỡ.Lưu ý: - Đối với một số danh mục sản phẩm, bảng kích cỡ có thể là bắt buộc hoặc không được hỗ trợ. Sử dụng Get Category Rules API để kiểm tra các yêu cầu.- Nếu bảng kích cỡ không được hỗ trợ, dù bạn có cung cấp bảng kích cỡ ở đây, bảng kích cỡ sẽ không được lưu.- Cung cấp một ID mẫu bảng kích cỡ của TikTok Shop hoặc một hình ảnh bảng kích cỡ; nếu cung cấp cả hai, ID sẽ được ưu tiên. | | package_dimensions | object | Kích thước của gói sản phẩm.Lưu ý:- Cung cấp kích thước được đo sau khi đóng gói sản phẩm.- Các giá trị này ảnh hưởng đến chi phí vận chuyển, vì vậy điều quan trọng là đảm bảo các kích thước chính xác. Bất kỳ sai lệch nào trong phép đo đều có thể dẫn đến phí vận chuyển phát sinh.- Tùy chọn cho các khu vực ID, TH, VN. | | external_product_id | string | Một định danh bên ngoài được sử dụng trong một nền tảng thương mại điện tử bên ngoài. Định danh này được dùng để liên kết sản phẩm giữa TikTok Shop và nền tảng thương mại điện tử bên ngoài. Độ dài tối đa: 999 ký tự | | delivery_option_ids | []string | Trường này chỉ được trả về cho các tài khoản người bán ở các khu vực sau:- ID- MX- MY- PH- SG- TH- VNĐối với tất cả các khu vực khác, trường này KHÔNG được sử dụng và sẽ KHÔNG được xử lý nếu được truyền cho các thao tác create, edit hoặc partial edit. Các ID tùy chọn giao hàng tùy chỉnh áp dụng cho sản phẩm này nếu bạn muốn ghi đè các tùy chọn giao hàng kho mặc định. Để lấy các ID tùy chọn khả dụng, hãy gọi Get Warehouse Delivery Options với scope=PRODUCT.Lưu ý: Để trống trường này để kế thừa các tùy chọn giao hàng mặc định được cấu hình cho kho. | | video | object | Một video giới thiệu hoặc quảng bá sản phẩm để hiển thị cho sản phẩm của bạn.Khuyến nghị:- Tỷ lệ khung hình: 1:1 - Độ phân giải: HD 720p hoặc cao hơn- Thời lượng: 20 - 60 giây | | primary_combined_product_id | string | Nếu sản phẩm này được liên kết với một virtual bundle, giá trị này là ID của sản phẩm chính trong bundle.Lưu ý: Chỉ bắt buộc đối với các sản phẩm virtual bundle. | | manufacturer_ids | []string | Danh sách các ID nhà sản xuất được phân tách bằng dấu phẩy. Lấy các ID từ Search Manufacturers API.Lưu ý: Chỉ áp dụng cho thị trường EU trong một số danh mục nhất định. Sử dụng Get Category Rules API để kiểm tra các yêu cầu. | | responsible_person_ids | []string | Danh sách các ID người chịu trách nhiệm được phân tách bằng dấu phẩy. Lấy các ID từ Search Responsible Persons API.Lưu ý: Chỉ áp dụng cho thị trường EU trong một số danh mục nhất định. Sử dụng Get Category Rules API để kiểm tra các yêu cầu. | | listing_platforms | []string | Các nền tảng để đăng bán sản phẩm.Các giá trị có thể có:- TOKOPEDIA- TIKTOK_SHOPMặc định: TIKTOK_SHOPChỉ áp dụng cho những người bán đã chuyển từ Tokopedia. | | shipping_insurance_requirement | string | Yêu cầu mua bảo hiểm vận chuyển áp đặt lên người mua đối với sản phẩm.Các giá trị có thể có:- REQUIRED: Bảo hiểm vận chuyển là bắt buộc và người mua không thể từ chối.- OPTIONAL: Người mua có thể chọn mua bảo hiểm vận chuyển thông qua nền tảng.- NOT_SUPPORTED: Bảo hiểm vận chuyển không được hỗ trợ cho sản phẩm.Mặc định: OPTIONALChỉ áp dụng nếu các nền tảng đăng bán bao gồm TOKOPEDIA. | | is_pre_owned | bool | Một cờ để cho biết sản phẩm có phải là hàng đã qua sử dụng hay không.Chỉ áp dụng nếu TOKOPEDIA là nền tảng đăng bán duy nhất.Lưu ý: Để đăng bán các sản phẩm đã qua sử dụng trên nền tảng TikTok Shop, vui lòng chỉ định ID của một trong các danh mục sản phẩm đã qua sử dụng được chỉ định (ví dụ: túi hàng hiệu, vali và phụ kiện đã qua sử dụng) trong category_id. | | minimum_order_quantity | int | Số lượng đặt hàng tối thiểu cho sản phẩm.Phạm vi hợp lệ: [1, 20]Chỉ áp dụng cho thị trường Indonesia và một số người bán được chọn ở các thị trường SEA khác. Liên hệ với người quản lý tài khoản của bạn để biết thêm thông tin về việc được cấp quyền truy cập trường này. | | shipping_template_id | string | Định danh của mẫu vận chuyển sẽ được gán cho sản phẩm | | option | object | option | | scheduled_sale | object | Cấu hình đăng bán theo lịch cho sản phẩm, bao gồm việc đăng bán theo lịch có được bật hay không và thời gian đăng bán theo lịch. | | search_terms | []string | Các từ khóa tìm kiếm (ST words). Các từ ST sẽ không được hiển thị cho người tiêu dùng; chúng chỉ được sử dụng trong các công cụ tìm kiếm để tăng trọng số tìm kiếm của bạn và thu hút nhiều lưu lượng hơn. Vui lòng đảm bảo rằng các từ ST nhất quán với mô tả sản phẩm, với tối đa 15 từ khóa và tổng cộng không quá 250 ký tự. | | key_product_features | []string | Các tính năng chính của sản phẩm. Chúng sẽ được hiển thị trong mô-đun Product highlight trên trang chi tiết sản phẩm và sẽ được các công cụ tìm kiếm sử dụng để tăng trọng số tìm kiếm của bạn nhằm thu hút nhiều lưu lượng hơn. Tổng số mục không được vượt quá 5 và tổng số ký tự không được vượt quá 1500. | | product_tag_operations | []object | nhãn sản phẩm để nhận diện loại sản phẩm đặc biệt ví dụ "AUCTION" | | locale | string | Các mã locale BCP-47 để hiển thị thông tin danh mục.Mặc định: Locale mặc định của shop của bạn.Các giá trị có thể có:- cs-CZ- de-AT- de-BE- de-DE- el-GR- en-GB- en-IE- en-US- es-ES- es-MX- fr-FR- fr-BE- hu-HU- id-ID- it-IT- ja-JP- ms-MY- nl-NL- nl-BE- pl-PL- pt-BR- pt-PT- th-TH- vi-VN- zh-CN |
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 message. | | 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
|
| --- | --- |
| 12001000 | product api internal error |
| 12019006 | product description is invalid |
| 12019011 | product package weight is invalid |
| 12019095 | pre_sale.fulfillment_type is missing or empty. |
| 12019097 | pre_sale.fulfillment_type.release_date must be set to a non-zero value. |
| 12019098 | pre_sale.fulfillment_type.handling_duration_days must be set to a non-zero value. |
| 12019099 | The specified pre_sale.type is not supported in your region. Refer to the API documentation for details. |
| 12019121 | calculate price error |
| 12052003 | Incorrect parcel height format |
| 12052004 | Incorrect parcel width format |
| 12052005 | Incorrect parcel length format |
| 12052023 | Category does not exist |
| 12052024 | Category is not final category |
| 12052084 | The provided currency is not available for this shop/region. |
| 12052220 | This category is prohibited or unsupported on TikTok Shop. Select another category. |
| 12052223 | This category is restricted. To sell in this category, apply through the Qualification Center in Seller Center. |
| 12052226 | This category is restricted. To sell in this category, apply through the Qualification Center in Seller Center. |
| 12052300 | product main image uri illegal |
| 12052356 | The number of 'supplementary_sku_images' for the sales attribute value exceeds the maximum limit. |
| 12052357 | 'supplementary_sku_images' is only allowed when 'sku_img' is specified. Add an image to 'sku_img' and try again. |
| 12052446 | Category is not open in this market |
| 12052520 | product sale property image uri illegal |
| 12052650 | product qualification image uri illegal |
| 12052670 | The size chart image URI is invalid. Note: API users must use the URI generated by the Upload Product Image API. |
| 12052700 | The seller is inactive. |
| 12052722 | The image URI does not exist in TikTok Shop. |
| 12052881 | identity internal error |
| 36009003 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. |
| 12052910 | Invalid input parameters. Refer to the API documentation for details. |
| 12052915 | package weight unit and dimension unit miss match. |
| 12052916 | The package unit is not supported in the current region. |
| 12052931 | The title must follow these formatting rules: it cannot contain HTML escape characters (e.g., ), emojis, or ASCII control characters (e.g., ). It also cannot consist solely of symbols (e.g., //// or !@#$$$&), nor can it have more than 9 consecutive repeated characters (e.g., aaaaaaaaa or 111111111). |
| 12052932 | The description must follow these formatting rules: it cannot contain HTML escape characters (e.g., ), emojis, or ASCII control characters (e.g., \u007F). It also cannot consist solely of symbols (e.g., //// or !@#$$$&), nor can it have more than 9 consecutive repeated characters (e.g., aaaaaaaaa or 111111111). |
| 12052933 | Sales attribute names must follow these formatting rules: it cannot contain HTML escape characters (e.g., ), emojis, or ASCII control characters (e.g., ). It also cannot consist solely of symbols (e.g., //// or !@#$$$&), nor can it have more than 9 consecutive repeated characters (e.g., aaaaaaaaa or 111111111). |
| 12052934 | Sales attribute value names must follow these formatting rules: it cannot contain HTML escape characters (e.g., ), emojis, or ASCII control characters (e.g., \u007F). It also cannot consist solely of symbols (e.g., //// or !@#$$$&), nor can it have more than 9 consecutive repeated characters (e.g., aaaaaaaaa or 111111111). |
| 12052935 | Product attribute value names must follow these formatting rules: it cannot contain HTML escape characters (e.g., ), emojis, or ASCII control characters (e.g., \u007F). It also cannot consist solely of symbols (e.g., //// or !@#$$$&), nor can it have more than 9 consecutive repeated characters (e.g., aaaaaaaaa or 111111111). |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext
|