tiktok.product.202509.products.product_id.partial_edit
POST/product/202509/products/{product_id}/partial_editVia 360: POST https://partner.quantri360.com/v1/tiktok/product/202509/products/{product_id}/partial_edit
Write endpoint — changes data on TikTok Shop. The key must be created with "Allow write API calls" ticked, otherwise you get 403 write_not_allowed. Every call is logged.
Description
Sửa một phần thông tin sản phẩm không ở trạng thái FREEZE hoặc DELETED. Bản nội dung mới được gửi duyệt trước khi công bố.
- Gọi qua /v1/tiktok/product/202509/products/{product_id}/partial_edit với Authorization: Bearer <key>; dùng platform_shop_id khi có nhiều shop. 360 tự gắn app_key, shop_cipher, sign và access_token.
- API GHI: thay đổi dữ liệu thật trên TikTok Shop; cần key có quyền ghi (can_write) và gói mở module products. Thay đổi các trường sản phẩm được gửi và gửi duyệt lại.
- HTTP 200 vẫn có thể có lỗi nghiệp vụ; kiểm code trước khi dùng kết quả.
Request
Endpoint
POST https://partner.quantri360.com/v1/tiktok/product/202509/products/{product_id}/partial_edit
Authentication & shop
| Name | In | Type | Sample | Description |
|---|---|---|---|---|
| Authorization | header | header | Bearer q360_live_ab12cd34_… | Khóa API của brand (tạo ở mục API key). Bắt buộc với mọi request. Brand suy từ key — không truyền mã brand. |
| platform_shop_id | query | string | 100001 | Gian hàng (lấy ở GET /v1/platforms → shops[].platform_shop_id). BẮT BUỘC khi brand có > 1 gian hàng trên nền tảng; 360 bỏ tham số này trước khi chuyển tiếp. |
Request parameters
| Name | In | Type | Required | Sample | Description |
|---|---|---|---|---|---|
| product_id | path | string | Yes | 900000000000000001 | Mã sản phẩm. |
| auto_translate_enabled | body | bool | No | false | Tự động dịch. |
| brand_id | body | string | No | 900000000000000001 | Mã thương hiệu. |
| category_version | body | string | No | v2 | Phiên bản cây ngành hàng; v2 là cây 7 cấp tại Mỹ, EU, Đông Nam Á; v1 là cây 3 cấp mặc định cho khu vực khác; giá trị liên quan: US, EU, SEA. |
| certifications | body | object[] | No | [{"expiration_date": 1793494800, "files": [{"format": "PDF", "id": "900000000000000001", "name": "chungnhan.pdf"}], "id": "900000000000000001", "images": [{"uri": "anh-minh-hoa"}]}] | Chứng nhận sản phẩm; số phần tử tối đa: 10. |
| certifications[].expiration_date | body | int | No | 1793494800 | Thời điểm hết hạn chứng nhận; Unix giây UTC+0. |
| certifications[].files | body | object[] | No | [{"format": "PDF", "id": "900000000000000001", "name": "chungnhan.pdf"}] | Danh sách tệp. |
| certifications[].files[].format | body | string | Yes | Định dạng tệp. | |
| certifications[].files[].id | body | string | Yes | 900000000000000001 | Mã định danh. |
| certifications[].files[].name | body | string | Yes | chungnhan.pdf | Tên. |
| certifications[].id | body | string | Yes | 900000000000000001 | Mã định danh. |
| certifications[].images | body | object[] | No | [{"uri": "anh-minh-hoa"}] | Danh sách ảnh. |
| certifications[].images[].uri | body | string | Yes | anh-minh-hoa | URI ảnh đã tải lên; giá trị liên quan: CERTIFICATION_IMAGE. |
| description | body | string | No | <p>Sản phẩm minh họa.</p> | Mô tả HTML tối đa 10.000 ký tự. Tối đa 30 thẻ img, mỗi ảnh dưới 4000 px, có src, width, height; ảnh phải được tải lên trước. Một số thẻ được chuyển đổi để hiển thị, như table thành ảnh. Nên mô tả trên 300 ký tự và 3–5 điểm nổi bật, mỗi điểm dưới 250 ký tự; ảnh khuyến nghị 1600×1600 px; độ dài tối đa: 10,000. |
| external_product_id | body | string | No | 900000000000000001 | Mã sản phẩm trong hệ thống bên ngoài; độ dài tối đa: 999. |
| inventory_mode | body | string | No | SHARED | Chế độ tồn kho; SHARED dùng chung và phải nhất quán, EXCLUSIVE độc lập; mặc định EXCLUSIVE tại EU. |
| is_cod_allowed | body | bool | No | false | Cho phép thanh toán khi nhận hàng. |
| key_product_features | body | string[] | No | ["Minh họa"] | Điểm nổi bật hiển thị trên trang sản phẩm và dùng cho tìm kiếm; tối đa 5 mục, tổng 1500 ký tự. |
| listing_platforms | body | string[] | No | ["TIKTOK_SHOP"] | Nền tảng hiển thị cho người bán chuyển từ Tokopedia. Chỉ truyền một nền tảng sẽ ẩn sản phẩm ở nền tảng bị bỏ. Muốn ẩn cả hai dùng thao tác deactivate; giá trị liên quan: TIKTOK_SHOP, TOKOPEDIA, IMPORTANT. |
| locale | body | string | No | vi-VN | Mã ngôn ngữ hiển thị; mặc định theo gian hàng; giá trị liên quan: BCP, CZ, AT, BE, DE, GR, GB, IE, US, ES, MX, FR, HU, IT, JP, MY, NL, PL, BR, PT, TH, VN, CN. |
| main_images | body | object[] | No | [{"uri": "anh-minh-hoa"}] | Ảnh chính sản phẩm; dùng URI ảnh được tải lên trước; số phần tử tối đa: 9. |
| main_images[].uri | body | string | Yes | anh-minh-hoa | URI ảnh đã tải lên; giá trị liên quan: MAIN_IMAGE. |
| manufacturer_ids | body | string[] | No | ["900000000000000001"] | Danh sách mã nhà sản xuất. |
| package_dimensions | body | object | No | {"height": "Minh họa", "length": "Minh họa", "unit": "CENTIMETER", "width": "Minh họa"} | Kích thước sau đóng gói, ảnh hưởng phí giao hàng; không bắt buộc tại ID, TH, VN. |
| package_dimensions.height | body | string | Yes | Minh họa | Chiều cao. |
| package_dimensions.length | body | string | Yes | Minh họa | Chiều dài. |
| package_dimensions.unit | body | string | Yes | CENTIMETER | Đơn vị; giá trị liên quan: US, CENTIMETER, INCH, KILOGRAM. |
| package_dimensions.width | body | string | Yes | Minh họa | Chiều rộng. |
| package_weight | body | object | No | {"unit": "KILOGRAM", "value": "0.5"} | Khối lượng sau đóng gói; khai chính xác để tính phí giao hàng. Khối lượng được ưu tiên khi tính phí nếu bỏ kích thước kiện hàng. |
| package_weight.unit | body | string | Yes | KILOGRAM | Đơn vị; giá trị liên quan: US, KILOGRAM, POUND, BR, JP, MX, GRAM, CENTIMETER. |
| package_weight.value | body | string | Yes | 0.5 | Giá trị; giá trị liên quan: GRAM, KILOGRAM, POUND. |
| pod_info | body | object | No | {"pod_templates": [{"pod_template_id": "900000000000000001", "remark": "Minh họa", "sku_ids": ["900000000000000001"], "surfaces": [{"background_image": {"uri": "anh-minh-hoa"}, "custom_areas": [{"area_name": "Minh họa", "area_placement": {"height": "Minh họa", "rotate_degree": "Minh họa", "width": "Minh họa", "x_coordinate": "Minh họa", "y_coordinate": "Minh họa"}, "area_type": "TEXT", "external_area_id": "900000000000000001", "image_area": {"default_image": {"uri": "anh-minh-hoa"}, "min_height": 1, "min_width": 1}, "is_required": false, "text_area": {"align_type": "CENTER", "colors": ["Minh họa"], "default_text": "Minh họa", "fonts": ["Minh họa"], "max_text_length": 1}}], "external_surface_id": "900000000000000001", "mask_image": {"uri": "anh-minh-hoa"}, "surface_name": "Minh họa"}], "template_name": "Bảng kích cỡ minh họa"}]} | Thông tin sản phẩm in theo yêu cầu. |
| pod_info.pod_templates | body | object[] | No | [{"pod_template_id": "900000000000000001", "remark": "Minh họa", "sku_ids": ["900000000000000001"], "surfaces": [{"background_image": {"uri": "anh-minh-hoa"}, "custom_areas": [{"area_name": "Minh họa", "area_placement": {"height": "Minh họa", "rotate_degree": "Minh họa", "width": "Minh họa", "x_coordinate": "Minh họa", "y_coordinate": "Minh họa"}, "area_type": "TEXT", "external_area_id": "900000000000000001", "image_area": {"default_image": {"uri": "anh-minh-hoa"}, "min_height": 1, "min_width": 1}, "is_required": false, "text_area": {"align_type": "CENTER", "colors": ["Minh họa"], "default_text": "Minh họa", "fonts": ["Minh họa"], "max_text_length": 1}}], "external_surface_id": "900000000000000001", "mask_image": {"uri": "anh-minh-hoa"}, "surface_name": "Minh họa"}], "template_name": "Bảng kích cỡ minh họa"}] | Các mẫu in theo yêu cầu. |
| pod_info.pod_templates[].pod_template_id | body | string | No | 900000000000000001 | Mã mẫu in theo yêu cầu. |
| pod_info.pod_templates[].remark | body | string | No | Minh họa | Ghi chú. |
| pod_info.pod_templates[].sku_ids | body | string[] | No | ["900000000000000001"] | Danh sách mã SKU. |
| pod_info.pod_templates[].surfaces | body | object[] | No | [{"background_image": {"uri": "anh-minh-hoa"}, "custom_areas": [{"area_name": "Minh họa", "area_placement": {"height": "Minh họa", "rotate_degree": "Minh họa", "width": "Minh họa", "x_coordinate": "Minh họa", "y_coordinate": "Minh họa"}, "area_type": "TEXT", "external_area_id": "900000000000000001", "image_area": {"default_image": {"uri": "anh-minh-hoa"}, "min_height": 1, "min_width": 1}, "is_required": false, "text_area": {"align_type": "CENTER", "colors": ["Minh họa"], "default_text": "Minh họa", "fonts": ["Minh họa"], "max_text_length": 1}}], "external_surface_id": "900000000000000001", "mask_image": {"uri": "anh-minh-hoa"}, "surface_name": "Minh họa"}] | Các bề mặt in. |
| pod_info.pod_templates[].surfaces[].background_image | body | object | No | {"uri": "anh-minh-hoa"} | Ảnh nền. |
| pod_info.pod_templates[].surfaces[].background_image.uri | body | string | No | anh-minh-hoa | URI ảnh đã tải lên; giá trị liên quan: CUSTOMIZATION_IMAGE. |
| pod_info.pod_templates[].surfaces[].custom_areas | body | object[] | No | [{"area_name": "Minh họa", "area_placement": {"height": "Minh họa", "rotate_degree": "Minh họa", "width": "Minh họa", "x_coordinate": "Minh họa", "y_coordinate": "Minh họa"}, "area_type": "TEXT", "external_area_id": "900000000000000001", "image_area": {"default_image": {"uri": "anh-minh-hoa"}, "min_height": 1, "min_width": 1}, "is_required": false, "text_area": {"align_type": "CENTER", "colors": ["Minh họa"], "default_text": "Minh họa", "fonts": ["Minh họa"], "max_text_length": 1}}] | Các vùng tùy chỉnh. |
| pod_info.pod_templates[].surfaces[].custom_areas[].area_name | body | string | No | Minh họa | Tên vùng. |
| pod_info.pod_templates[].surfaces[].custom_areas[].area_placement | body | object | No | {"height": "Minh họa", "rotate_degree": "Minh họa", "width": "Minh họa", "x_coordinate": "Minh họa", "y_coordinate": "Minh họa"} | Vị trí vùng. |
| pod_info.pod_templates[].surfaces[].custom_areas[].area_placement.height | body | string | No | Minh họa | Chiều cao. |
| pod_info.pod_templates[].surfaces[].custom_areas[].area_placement.rotate_degree | body | string | No | Minh họa | Góc xoay. |
| pod_info.pod_templates[].surfaces[].custom_areas[].area_placement.width | body | string | No | Minh họa | Chiều rộng. |
| pod_info.pod_templates[].surfaces[].custom_areas[].area_placement.x_coordinate | body | string | No | Minh họa | Tọa độ ngang. |
| pod_info.pod_templates[].surfaces[].custom_areas[].area_placement.y_coordinate | body | string | No | Minh họa | Tọa độ dọc. |
| pod_info.pod_templates[].surfaces[].custom_areas[].area_type | body | string | No | TEXT | Loại vùng; giá trị liên quan: TEXT, IMAGE. |
| pod_info.pod_templates[].surfaces[].custom_areas[].external_area_id | body | string | No | 900000000000000001 | Mã vùng trong hệ thống bên ngoài. |
| pod_info.pod_templates[].surfaces[].custom_areas[].image_area | body | object | No | {"default_image": {"uri": "anh-minh-hoa"}, "min_height": 1, "min_width": 1} | Vùng ảnh; giá trị liên quan: IMAGE. |
| pod_info.pod_templates[].surfaces[].custom_areas[].image_area.default_image | body | object | No | {"uri": "anh-minh-hoa"} | Ảnh mặc định. |
| pod_info.pod_templates[].surfaces[].custom_areas[].image_area.default_image.uri | body | string | No | anh-minh-hoa | URI ảnh đã tải lên; giá trị liên quan: CUSTOMIZATION_IMAGE. |
| pod_info.pod_templates[].surfaces[].custom_areas[].image_area.min_height | body | int | No | 1 | Chiều cao tối thiểu. |
| pod_info.pod_templates[].surfaces[].custom_areas[].image_area.min_width | body | int | No | 1 | Chiều rộng tối thiểu. |
| pod_info.pod_templates[].surfaces[].custom_areas[].is_required | body | bool | No | false | Có bắt buộc hay không. |
| pod_info.pod_templates[].surfaces[].custom_areas[].text_area | body | object | No | {"align_type": "CENTER", "colors": ["Minh họa"], "default_text": "Minh họa", "fonts": ["Minh họa"], "max_text_length": 1} | Vùng văn bản; giá trị liên quan: TEXT. |
| pod_info.pod_templates[].surfaces[].custom_areas[].text_area.align_type | body | string | No | CENTER | Kiểu căn chỉnh; giá trị liên quan: LEFT, CENTER, RIGHT. |
| pod_info.pod_templates[].surfaces[].custom_areas[].text_area.colors | body | string[] | No | ["Minh họa"] | Các màu. |
| pod_info.pod_templates[].surfaces[].custom_areas[].text_area.default_text | body | string | No | Minh họa | Văn bản mặc định. |
| pod_info.pod_templates[].surfaces[].custom_areas[].text_area.fonts | body | string[] | No | ["Minh họa"] | Các phông chữ. |
| pod_info.pod_templates[].surfaces[].custom_areas[].text_area.max_text_length | body | int | No | 1 | Độ dài văn bản tối đa. |
| pod_info.pod_templates[].surfaces[].external_surface_id | body | string | No | 900000000000000001 | Mã bề mặt trong hệ thống bên ngoài. |
| pod_info.pod_templates[].surfaces[].mask_image | body | object | No | {"uri": "anh-minh-hoa"} | Ảnh mặt nạ. |
| pod_info.pod_templates[].surfaces[].mask_image.uri | body | string | No | anh-minh-hoa | URI ảnh đã tải lên; giá trị liên quan: CUSTOMIZATION_IMAGE. |
| pod_info.pod_templates[].surfaces[].surface_name | body | string | No | Minh họa | Tên bề mặt. |
| pod_info.pod_templates[].template_name | body | string | No | Bảng kích cỡ minh họa | Tên mẫu bảng kích cỡ. |
| product_attributes | body | object[] | No | [{"id": "900000000000000001", "values": [{"id": "900000000000000001", "name": "Minh họa", "metric_standard_info": {"id": "900000000000000001", "metric_value_module_infos": [{"id": "900000000000000001", "value": "Minh họa", "unit_id": "900000000000000001"}]}}]}] | Thuộc tính sản phẩm; điền đủ thuộc tính bắt buộc của ngành hàng. |
| product_attributes[].id | body | string | Yes | 900000000000000001 | Mã định danh. |
| product_attributes[].values | body | object[] | Yes | [{"id": "900000000000000001", "name": "Minh họa", "metric_standard_info": {"id": "900000000000000001", "metric_value_module_infos": [{"id": "900000000000000001", "value": "Minh họa", "unit_id": "900000000000000001"}]}}] | Các giá trị. |
| product_attributes[].values[].id | body | string | No | 900000000000000001 | Mã định danh. |
| product_attributes[].values[].name | body | string | No | Minh họa | Tên; độ dài tối đa: 2000. |
| product_attributes[].values[].metric_standard_info | body | object | No | {"id": "900000000000000001", "metric_value_module_infos": [{"id": "900000000000000001", "value": "Minh họa", "unit_id": "900000000000000001"}]} | Thông tin chuẩn đo lường. |
| product_attributes[].values[].metric_standard_info.id | body | string | No | 900000000000000001 | Mã định danh. |
| product_attributes[].values[].metric_standard_info.metric_value_module_infos | body | object[] | No | [{"id": "900000000000000001", "value": "Minh họa", "unit_id": "900000000000000001"}] | Thông tin các thành phần số đo. |
| product_attributes[].values[].metric_standard_info.metric_value_module_infos[].id | body | string | No | 900000000000000001 | Mã định danh. |
| product_attributes[].values[].metric_standard_info.metric_value_module_infos[].value | body | string | No | Minh họa | Giá trị. |
| product_attributes[].values[].metric_standard_info.metric_value_module_infos[].unit_id | body | string | No | 900000000000000001 | Mã đơn vị. |
| replicated_products | body | object[] | No | [{"inventory_mode": "SHARED", "region": "VN", "skus": [{"external_sku_id": "900000000000000001", "id": "900000000000000001", "inventory": [{"quantity": 1, "warehouse_id": "900000000000000001"}], "price": {"currency": "VND", "sale_price": "150000"}, "seller_sku": "SKU-MAU-01"}]}] | Chỉ đồng bộ các trường được sửa. Đổi mã/tên thuộc tính bán hàng bắt buộc đồng bộ kèm seller_sku nguồn và đầy đủ thông tin tương ứng. SKU mới có thể chọn đồng bộ bằng seller_sku và thông tin tương ứng. Thay đổi chung có thể chọn đồng bộ bằng replicated_products.region. |
| replicated_products[].inventory_mode | body | string | No | SHARED | Chế độ tồn kho; SHARED dùng chung và phải nhất quán, EXCLUSIVE độc lập; mặc định EXCLUSIVE tại EU. |
| replicated_products[].region | body | string | Yes | VN | Thị trường; giá trị liên quan: AT, BE, CZ, DE, ES, FR, GB, GR, HU, IE, IT, JP, MY, NL, PH, PO, PT, SG, TH, US, VN, MX. |
| replicated_products[].skus | body | object[] | No | [{"external_sku_id": "900000000000000001", "id": "900000000000000001", "inventory": [{"quantity": 1, "warehouse_id": "900000000000000001"}], "price": {"currency": "VND", "sale_price": "150000"}, "seller_sku": "SKU-MAU-01"}] | Danh sách SKU. |
| replicated_products[].skus[].external_sku_id | body | string | No | 900000000000000001 | Mã SKU trong hệ thống bên ngoài; độ dài tối đa: 999. |
| replicated_products[].skus[].id | body | string | No | 900000000000000001 | Mã định danh. |
| replicated_products[].skus[].inventory | body | object[] | No | [{"quantity": 1, "warehouse_id": "900000000000000001"}] | Tồn kho theo từng kho. |
| replicated_products[].skus[].inventory[].quantity | body | int | No | 1 | Số lượng; giới hạn: [1, 999,999]. |
| replicated_products[].skus[].inventory[].warehouse_id | body | string | No | 900000000000000001 | Mã kho. |
| replicated_products[].skus[].price | body | object | Yes | {"currency": "VND", "sale_price": "150000"} | Giá. |
| replicated_products[].skus[].price.currency | body | string | Yes | VND | Mã tiền tệ; giá trị liên quan: BRL, CZK, EUR, GBP, HUF, IDR, JPY, MXN, MYR, PHP, PLN, SGD, THB, USD, VND. |
| replicated_products[].skus[].price.sale_price | body | string | Yes | 150000 | Giá hiển thị trước giảm giá. |
| replicated_products[].skus[].seller_sku | body | string | No | SKU-MAU-01 | Mã SKU do người bán quản lý. |
| responsible_person_ids | body | string[] | No | ["900000000000000001"] | Danh sách mã người chịu trách nhiệm. |
| save_mode | body | string | No | AS_DRAFT | AS_DRAFT lưu nháp, LISTING gửi đăng, mặc định LISTING. Thay đổi cần duyệt chỉ công bố sau duyệt; giá và tồn kho áp dụng ngay. Không lưu nháp khi DELETED hoặc PENDING/FREEZE trên bất kỳ nền tảng nào. Khi lưu nháp sau đăng, inventory không được lưu; giá trị liên quan: AS_DRAFT, LISTING, DELETED, PENDING, FREEZE, SKU. |
| scheduled_sale | body | object | No | {"is_enabled_scheduled_sale": false, "schedule_sale_time": 1793494800} | Cấu hình bán theo lịch. |
| scheduled_sale.is_enabled_scheduled_sale | body | bool | Yes | false | Bật bán theo lịch. |
| scheduled_sale.schedule_sale_time | body | int | Yes | 1793494800 | Thời điểm bắt đầu bán theo lịch. |
| search_terms | body | string[] | No | ["Minh họa"] | Từ khóa tìm kiếm không hiển thị với khách; phải phù hợp mô tả, tối đa 15 từ khóa và tổng 250 ký tự. |
| size_chart | body | object | No | {"image": {"uri": "anh-minh-hoa"}, "template": {"id": "900000000000000001"}} | Bảng kích cỡ sản phẩm; có thể bắt buộc hoặc không được hỗ trợ tùy ngành hàng. Nếu ngành không hỗ trợ thì nội dung gửi sẽ bị bỏ qua. |
| size_chart.image | body | object | No | {"uri": "anh-minh-hoa"} | Ảnh. |
| size_chart.image.uri | body | string | Yes | anh-minh-hoa | URI ảnh đã tải lên; giá trị liên quan: SIZE_CHART_IMAGE. |
| size_chart.template | body | object | No | {"id": "900000000000000001"} | Mẫu. |
| size_chart.template.id | body | string | Yes | 900000000000000001 | Mã định danh. |
| skus | body | object[] | No | [{"external_list_prices": [{"amount": "150000", "currency": "VND", "source": "SHOPIFY_COMPARE_AT_PRICE"}], "external_sku_id": "900000000000000001", "external_urls": [""], "extra_identifier_codes": ["Minh họa"], "fees": [{"additional_attribute": "SINGLE_USE", "amount": "150000", "type": "PFAND"}], "id": "900000000000000001", "identifier_code": {"code": 0, "type": "GTIN"}, "inventory": [{"backorder_quantity": 1, "handling_time": 1793494800, "quantity": 1, "warehouse_id": "900000000000000001"}], "list_price": {"amount": "150000", "currency": "VND"}, "pre_sale": {"fulfillment_type": {"handling_duration_days": 1, "release_date": 1}, "type": "PRE_ORDER"}, "price": {"amount": "150000", "currency": "VND", "sale_price": "150000"}, "sales_attributes": [{"id": "900000000000000001", "name": "Minh họa", "sku_img": {"uri": "anh-minh-hoa"}, "supplementary_sku_images": [{"uri": "anh-minh-hoa"}], "value_id": "900000000000000001", "value_name": "Minh họa"}], "seller_sku": "SKU-MAU-01", "sku_dimensions": {"height": "Minh họa", "length": "Minh họa", "unit": "CENTIMETER", "width": "Minh họa"}, "sku_unit_count": "Minh họa", "sku_weight": {"unit": "KILOGRAM", "value": "0.5"}}] | Các SKU biến thể; tối đa 300 tại BR, EU, MX, JP, UK, US, khu vực khác tối đa 100; nên đặt biến thể quan trọng nhất ở đầu. |
| skus[].external_list_prices | body | object[] | No | [{"amount": "150000", "currency": "VND", "source": "SHOPIFY_COMPARE_AT_PRICE"}] | Giá niêm yết bên ngoài. |
| skus[].external_list_prices[].amount | body | string | Yes | 150000 | Số tiền; giới hạn: [0.01, 7600]. |
| skus[].external_list_prices[].currency | body | string | Yes | VND | Mã tiền tệ; giá trị liên quan: USD. |
| skus[].external_list_prices[].source | body | string | Yes | SHOPIFY_COMPARE_AT_PRICE | Nguồn; giá trị liên quan: SHOPIFY_COMPARE_AT_PRICE. |
| skus[].external_sku_id | body | string | No | 900000000000000001 | Mã SKU trong hệ thống bên ngoài; độ dài tối đa: 999. |
| skus[].external_urls | body | string[] | No | [""] | Các địa chỉ bên ngoài. |
| skus[].extra_identifier_codes | body | string[] | No | ["Minh họa"] | Các mã định danh bổ sung; giá trị liên quan: X. |
| skus[].fees | body | object[] | No | [{"additional_attribute": "SINGLE_USE", "amount": "150000", "type": "PFAND"}] | Các khoản phí. |
| skus[].fees[].additional_attribute | body | string | No | SINGLE_USE | Thuộc tính bổ sung; giá trị liên quan: SINGLE_USE, NOT_APPLICABLE, REUSABLE. |
| skus[].fees[].amount | body | string | No | 150000 | Số tiền. |
| skus[].fees[].type | body | string | No | PFAND | Loại; giá trị liên quan: PFAND. |
| skus[].id | body | string | No | 900000000000000001 | Mã định danh. |
| skus[].identifier_code | body | object | No | {"code": 0, "type": "GTIN"} | Mã định danh bổ sung. |
| skus[].identifier_code.code | body | string | No | 0 | Mã kết quả; 0 là thành công; giá trị liên quan: X. |
| skus[].identifier_code.type | body | string | No | GTIN | Loại; giá trị liên quan: GTIN, EAN, UPC, ISBN, JAN. |
| skus[].inventory | body | object[] | No | [{"backorder_quantity": 1, "handling_time": 1793494800, "quantity": 1, "warehouse_id": "900000000000000001"}] | Tồn kho theo từng kho; giá trị liên quan: AS_DRAFT. |
| skus[].inventory[].backorder_quantity | body | int | No | 1 | Số lượng hàng đặt trước. |
| skus[].inventory[].handling_time | body | int | No | 1793494800 | Thời gian xử lý hàng đặt trước. |
| skus[].inventory[].quantity | body | int | Yes | 1 | Số lượng; giới hạn: [1, 99,999]. |
| skus[].inventory[].warehouse_id | body | string | Yes | 900000000000000001 | Mã kho. |
| skus[].list_price | body | object | No | {"amount": "150000", "currency": "VND"} | Giá niêm yết. |
| skus[].list_price.amount | body | string | Yes | 150000 | Số tiền; giới hạn: [0.01, 7600]. |
| skus[].list_price.currency | body | string | Yes | VND | Mã tiền tệ; giá trị liên quan: USD. |
| skus[].pre_sale | body | object | No | {"fulfillment_type": {"handling_duration_days": 1, "release_date": 1}, "type": "PRE_ORDER"} | Cấu hình bán trước. |
| skus[].pre_sale.fulfillment_type | body | object | No | {"handling_duration_days": 1, "release_date": 1} | Hình thức hoàn tất đơn. |
| skus[].pre_sale.fulfillment_type.handling_duration_days | body | int | No | 1 | Số ngày xử lý; giá trị liên quan: MADE_TO_ORDER, PRE_ORDER, CUSTOM. |
| skus[].pre_sale.fulfillment_type.release_date | body | int | No | 1 | Ngày phát hành; giá trị liên quan: PRE_ORDER. |
| skus[].pre_sale.type | body | string | No | PRE_ORDER | Loại; giá trị liên quan: PRE_ORDER, MADE_TO_ORDER, US, CUSTOM, UK, EU, SEA, JP, LATAM. |
| skus[].price | body | object | No | {"amount": "150000", "currency": "VND", "sale_price": "150000"} | Giá. |
| skus[].price.amount | body | string | No | 150000 | Số tiền. |
| skus[].price.currency | body | string | Yes | VND | Mã tiền tệ; giá trị liên quan: BRL, CZK, EUR, GBP, HUF, IDR, JPY, MXN, MYR, PHP, PLN, SGD, THB, USD, VND. |
| skus[].price.sale_price | body | string | No | 150000 | Giá hiển thị trước giảm giá. |
| skus[].sales_attributes | body | object[] | No | [{"id": "900000000000000001", "name": "Minh họa", "sku_img": {"uri": "anh-minh-hoa"}, "supplementary_sku_images": [{"uri": "anh-minh-hoa"}], "value_id": "900000000000000001", "value_name": "Minh họa"}] | Thuộc tính bán hàng tạo biến thể. |
| skus[].sales_attributes[].id | body | string | No | 900000000000000001 | Mã định danh. |
| skus[].sales_attributes[].name | body | string | No | Minh họa | Tên; độ dài tối đa: 20. |
| skus[].sales_attributes[].sku_img | body | object | No | {"uri": "anh-minh-hoa"} | Ảnh biến thể. |
| skus[].sales_attributes[].sku_img.uri | body | string | Yes | anh-minh-hoa | URI ảnh đã tải lên; giá trị liên quan: ATTRIBUTE_IMAGE. |
| skus[].sales_attributes[].supplementary_sku_images | body | object[] | No | [{"uri": "anh-minh-hoa"}] | Ảnh SKU bổ sung. |
| skus[].sales_attributes[].supplementary_sku_images[].uri | body | string | Yes | anh-minh-hoa | URI ảnh đã tải lên; giá trị liên quan: ATTRIBUTE_IMAGE. |
| skus[].sales_attributes[].value_id | body | string | No | 900000000000000001 | Mã giá trị. |
| skus[].sales_attributes[].value_name | body | string | No | Minh họa | Tên giá trị; độ dài tối đa: 50. |
| skus[].seller_sku | body | string | No | SKU-MAU-01 | Mã SKU do người bán quản lý. |
| skus[].sku_dimensions | body | object | No | {"height": "Minh họa", "length": "Minh họa", "unit": "CENTIMETER", "width": "Minh họa"} | Kích thước SKU. |
| skus[].sku_dimensions.height | body | string | Yes | Minh họa | Chiều cao. |
| skus[].sku_dimensions.length | body | string | Yes | Minh họa | Chiều dài. |
| skus[].sku_dimensions.unit | body | string | Yes | CENTIMETER | Đơn vị; giá trị liên quan: SKU, US, CENTIMETER, INCH, KILOGRAM. |
| skus[].sku_dimensions.width | body | string | Yes | Minh họa | Chiều rộng. |
| skus[].sku_unit_count | body | string | No | Minh họa | Số đơn vị trong SKU; giới hạn: [0.01, 99,999.9999]. |
| skus[].sku_weight | body | object | No | {"unit": "KILOGRAM", "value": "0.5"} | Khối lượng SKU. |
| skus[].sku_weight.unit | body | string | Yes | KILOGRAM | Đơn vị; giá trị liên quan: SKU, US, KILOGRAM, POUND, BR, JP, MX, GRAM, CENTIMETER. |
| skus[].sku_weight.value | body | string | Yes | 0.5 | Giá trị. |
| subscribe_info_edit | body | object | No | {"discount_details": [{"discount_level": "REGULAR", "discount_value": 1}], "subscribe_status": "ENABLED"} | Thông tin mua định kỳ cần sửa. |
| subscribe_info_edit.discount_details | body | object[] | No | [{"discount_level": "REGULAR", "discount_value": 1}] | Chi tiết giảm giá. |
| subscribe_info_edit.discount_details[].discount_level | body | string | No | REGULAR | Mức giảm giá; giá trị liên quan: FIRST_ORDER. |
| subscribe_info_edit.discount_details[].discount_value | body | int | No | 1 | Giá trị giảm giá. |
| subscribe_info_edit.subscribe_status | body | string | No | ENABLED | Trạng thái mua định kỳ; giá trị liên quan: NOT_ENABLED. |
| title | body | string | No | Áo thun cotton cổ tròn minh họa | Tiêu đề sản phẩm; DE, ES, FR, IE, IT, JP, UK, US dài 1–255 ký tự; BR, MX dài 1–300; khu vực khác 25–255 ký tự. |
| video | body | object | No | {"id": "900000000000000001"} | Video giới thiệu sản phẩm; khuyến nghị tỷ lệ 1:1, độ phân giải HD 720p trở lên, dài 20–60 giây. |
| video.id | body | string | Yes | 900000000000000001 | Mã định danh. |
| is_blind_box | body | bool | No | false | Sản phẩm hộp mù. |
Request examples
curl -s -X POST "https://partner.quantri360.com/v1/tiktok/product/202509/products/900000000000000001/partial_edit" \
-H "Authorization: Bearer $KEY" \
-H "Content-Type: application/json" \
-d '{"auto_translate_enabled":false,"brand_id":"900000000000000001","category_version":"v2","certifications":[{"expiration_date":1793494800,"files":[{"format":"PDF","id":"900000000000000001","name":"chungnhan.pdf"}],"id":"900000000000000001","images":[{"uri":"anh-minh-hoa"}]}],"description":"<p>Sản phẩm minh họa.</p>","external_product_id":"900000000000000001","inventory_mode":"SHARED","is_cod_allowed":false,"key_product_features":["Minh họa"],"listing_platforms":["TIKTOK_SHOP"],"locale":"vi-VN","main_images":[{"uri":"anh-minh-hoa"}],"manufacturer_ids":["900000000000000001"],"package_dimensions":{"height":"Minh họa","length":"Minh họa","unit":"CENTIMETER","width":"Minh họa"},"package_weight":{"unit":"KILOGRAM","value":"0.5"},"pod_info":{"pod_templates":[{"pod_template_id":"900000000000000001","remark":"Minh họa","sku_ids":["900000000000000001"],"surfaces":[{"background_image":{"uri":"anh-minh-hoa"},"custom_areas":[{"area_name":"Minh họa","area_placement":{"height":"Minh họa","rotate_degree":"Minh họa","width":"Minh họa","x_coordinate":"Minh họa","y_coordinate":"Minh họa"},"area_type":"TEXT","external_area_id":"900000000000000001","image_area":{"default_image":{"uri":"anh-minh-hoa"},"min_height":1,"min_width":1},"is_required":false,"text_area":{"align_type":"CENTER","colors":["Minh họa"],"default_text":"Minh họa","fonts":["Minh họa"],"max_text_length":1}}],"external_surface_id":"900000000000000001","mask_image":{"uri":"anh-minh-hoa"},"surface_name":"Minh họa"}],"template_name":"Bảng kích cỡ minh họa"}]},"product_attributes":[{"id":"900000000000000001","values":[{"id":"900000000000000001","name":"Minh họa","metric_standard_info":{"id":"900000000000000001","metric_value_module_infos":[{"id":"900000000000000001","value":"Minh họa","unit_id":"900000000000000001"}]}}]}],"replicated_products":[{"inventory_mode":"SHARED","region":"VN","skus":[{"external_sku_id":"900000000000000001","id":"900000000000000001","inventory":[{"quantity":1,"warehouse_id":"900000000000000001"}],"price":{"currency":"VND","sale_price":"150000"},"seller_sku":"SKU-MAU-01"}]}],"responsible_person_ids":["900000000000000001"],"save_mode":"AS_DRAFT","scheduled_sale":{"is_enabled_scheduled_sale":false,"schedule_sale_time":1793494800},"search_terms":["Minh họa"],"size_chart":{"image":{"uri":"anh-minh-hoa"},"template":{"id":"900000000000000001"}},"skus":[{"external_list_prices":[{"amount":"150000","currency":"VND","source":"SHOPIFY_COMPARE_AT_PRICE"}],"external_sku_id":"900000000000000001","external_urls":[""],"extra_identifier_codes":["Minh họa"],"fees":[{"additional_attribute":"SINGLE_USE","amount":"150000","type":"PFAND"}],"id":"900000000000000001","identifier_code":{"code":0,"type":"GTIN"},"inventory":[{"backorder_quantity":1,"handling_time":1793494800,"quantity":1,"warehouse_id":"900000000000000001"}],"list_price":{"amount":"150000","currency":"VND"},"pre_sale":{"fulfillment_type":{"handling_duration_days":1,"release_date":1},"type":"PRE_ORDER"},"price":{"amount":"150000","currency":"VND","sale_price":"150000"},"sales_attributes":[{"id":"900000000000000001","name":"Minh họa","sku_img":{"uri":"anh-minh-hoa"},"supplementary_sku_images":[{"uri":"anh-minh-hoa"}],"value_id":"900000000000000001","value_name":"Minh họa"}],"seller_sku":"SKU-MAU-01","sku_dimensions":{"height":"Minh họa","length":"Minh họa","unit":"CENTIMETER","width":"Minh họa"},"sku_unit_count":"Minh họa","sku_weight":{"unit":"KILOGRAM","value":"0.5"}}],"subscribe_info_edit":{"discount_details":[{"discount_level":"REGULAR","discount_value":1}],"subscribe_status":"ENABLED"},"title":"Áo thun cotton cổ tròn minh họa","video":{"id":"900000000000000001"},"is_blind_box":false}'
Python
import requests
KEY = "q360_live_..." # khóa API của brand
r = requests.post(
"https://partner.quantri360.com/v1/tiktok/product/202509/products/900000000000000001/partial_edit",
params={},
json={
"auto_translate_enabled": False,
"brand_id": "900000000000000001",
"category_version": "v2",
"certifications": [
{
"expiration_date": 1793494800,
"files": [
{
"format": "PDF",
"id": "900000000000000001",
"name": "chungnhan.pdf"
}
],
"id": "900000000000000001",
"images": [
{
"uri": "anh-minh-hoa"
}
]
}
],
"description": "<p>Sản phẩm minh họa.</p>",
"external_product_id": "900000000000000001",
"inventory_mode": "SHARED",
"is_cod_allowed": False,
"key_product_features": [
"Minh họa"
],
"listing_platforms": [
"TIKTOK_SHOP"
],
"locale": "vi-VN",
"main_images": [
{
"uri": "anh-minh-hoa"
}
],
"manufacturer_ids": [
"900000000000000001"
],
"package_dimensions": {
"height": "Minh họa",
"length": "Minh họa",
"unit": "CENTIMETER",
"width": "Minh họa"
},
"package_weight": {
"unit": "KILOGRAM",
"value": "0.5"
},
"pod_info": {
"pod_templates": [
{
"pod_template_id": "900000000000000001",
"remark": "Minh họa",
"sku_ids": [
"900000000000000001"
],
"surfaces": [
{
"background_image": {
"uri": "anh-minh-hoa"
},
"custom_areas": [
{
"area_name": "Minh họa",
"area_placement": {
"height": "Minh họa",
"rotate_degree": "Minh họa",
"width": "Minh họa",
"x_coordinate": "Minh họa",
"y_coordinate": "Minh họa"
},
"area_type": "TEXT",
"external_area_id": "900000000000000001",
"image_area": {
"default_image": {
"uri": "anh-minh-hoa"
},
"min_height": 1,
"min_width": 1
},
"is_required": False,
"text_area": {
"align_type": "CENTER",
"colors": [
"Minh họa"
],
"default_text": "Minh họa",
"fonts": [
"Minh họa"
],
"max_text_length": 1
}
}
],
"external_surface_id": "900000000000000001",
"mask_image": {
"uri": "anh-minh-hoa"
},
"surface_name": "Minh họa"
}
],
"template_name": "Bảng kích cỡ minh họa"
}
]
},
"product_attributes": [
{
"id": "900000000000000001",
"values": [
{
"id": "900000000000000001",
"name": "Minh họa",
"metric_standard_info": {
"id": "900000000000000001",
"metric_value_module_infos": [
{
"id": "900000000000000001",
"value": "Minh họa",
"unit_id": "900000000000000001"
}
]
}
}
]
}
],
"replicated_products": [
{
"inventory_mode": "SHARED",
"region": "VN",
"skus": [
{
"external_sku_id": "900000000000000001",
"id": "900000000000000001",
"inventory": [
{
"quantity": 1,
"warehouse_id": "900000000000000001"
}
],
"price": {
"currency": "VND",
"sale_price": "150000"
},
"seller_sku": "SKU-MAU-01"
}
]
}
],
"responsible_person_ids": [
"900000000000000001"
],
"save_mode": "AS_DRAFT",
"scheduled_sale": {
"is_enabled_scheduled_sale": False,
"schedule_sale_time": 1793494800
},
"search_terms": [
"Minh họa"
],
"size_chart": {
"image": {
"uri": "anh-minh-hoa"
},
"template": {
"id": "900000000000000001"
}
},
"skus": [
{
"external_list_prices": [
{
"amount": "150000",
"currency": "VND",
"source": "SHOPIFY_COMPARE_AT_PRICE"
}
],
"external_sku_id": "900000000000000001",
"external_urls": [
""
],
"extra_identifier_codes": [
"Minh họa"
],
"fees": [
{
"additional_attribute": "SINGLE_USE",
"amount": "150000",
"type": "PFAND"
}
],
"id": "900000000000000001",
"identifier_code": {
"code": 0,
"type": "GTIN"
},
"inventory": [
{
"backorder_quantity": 1,
"handling_time": 1793494800,
"quantity": 1,
"warehouse_id": "900000000000000001"
}
],
"list_price": {
"amount": "150000",
"currency": "VND"
},
"pre_sale": {
"fulfillment_type": {
"handling_duration_days": 1,
"release_date": 1
},
"type": "PRE_ORDER"
},
"price": {
"amount": "150000",
"currency": "VND",
"sale_price": "150000"
},
"sales_attributes": [
{
"id": "900000000000000001",
"name": "Minh họa",
"sku_img": {
"uri": "anh-minh-hoa"
},
"supplementary_sku_images": [
{
"uri": "anh-minh-hoa"
}
],
"value_id": "900000000000000001",
"value_name": "Minh họa"
}
],
"seller_sku": "SKU-MAU-01",
"sku_dimensions": {
"height": "Minh họa",
"length": "Minh họa",
"unit": "CENTIMETER",
"width": "Minh họa"
},
"sku_unit_count": "Minh họa",
"sku_weight": {
"unit": "KILOGRAM",
"value": "0.5"
}
}
],
"subscribe_info_edit": {
"discount_details": [
{
"discount_level": "REGULAR",
"discount_value": 1
}
],
"subscribe_status": "ENABLED"
},
"title": "Áo thun cotton cổ tròn minh họa",
"video": {
"id": "900000000000000001"
},
"is_blind_box": False
},
headers={"Authorization": f"Bearer {KEY}"},
timeout=60,
)
print(r.status_code)
print(r.json())Node.js
const KEY = 'q360_live_...'; // khóa API của brand
const url = new URL('https://partner.quantri360.com/v1/tiktok/product/202509/products/900000000000000001/partial_edit');
for (const [k, v] of Object.entries({})) url.searchParams.set(k, typeof v === 'object' ? JSON.stringify(v) : String(v));
const r = await fetch(url, {
method: 'POST',
headers: { Authorization: `Bearer ${KEY}`, 'Content-Type': 'application/json' },
body: JSON.stringify({"auto_translate_enabled":false,"brand_id":"900000000000000001","category_version":"v2","certifications":[{"expiration_date":1793494800,"files":[{"format":"PDF","id":"900000000000000001","name":"chungnhan.pdf"}],"id":"900000000000000001","images":[{"uri":"anh-minh-hoa"}]}],"description":"<p>Sản phẩm minh họa.</p>","external_product_id":"900000000000000001","inventory_mode":"SHARED","is_cod_allowed":false,"key_product_features":["Minh họa"],"listing_platforms":["TIKTOK_SHOP"],"locale":"vi-VN","main_images":[{"uri":"anh-minh-hoa"}],"manufacturer_ids":["900000000000000001"],"package_dimensions":{"height":"Minh họa","length":"Minh họa","unit":"CENTIMETER","width":"Minh họa"},"package_weight":{"unit":"KILOGRAM","value":"0.5"},"pod_info":{"pod_templates":[{"pod_template_id":"900000000000000001","remark":"Minh họa","sku_ids":["900000000000000001"],"surfaces":[{"background_image":{"uri":"anh-minh-hoa"},"custom_areas":[{"area_name":"Minh họa","area_placement":{"height":"Minh họa","rotate_degree":"Minh họa","width":"Minh họa","x_coordinate":"Minh họa","y_coordinate":"Minh họa"},"area_type":"TEXT","external_area_id":"900000000000000001","image_area":{"default_image":{"uri":"anh-minh-hoa"},"min_height":1,"min_width":1},"is_required":false,"text_area":{"align_type":"CENTER","colors":["Minh họa"],"default_text":"Minh họa","fonts":["Minh họa"],"max_text_length":1}}],"external_surface_id":"900000000000000001","mask_image":{"uri":"anh-minh-hoa"},"surface_name":"Minh họa"}],"template_name":"Bảng kích cỡ minh họa"}]},"product_attributes":[{"id":"900000000000000001","values":[{"id":"900000000000000001","name":"Minh họa","metric_standard_info":{"id":"900000000000000001","metric_value_module_infos":[{"id":"900000000000000001","value":"Minh họa","unit_id":"900000000000000001"}]}}]}],"replicated_products":[{"inventory_mode":"SHARED","region":"VN","skus":[{"external_sku_id":"900000000000000001","id":"900000000000000001","inventory":[{"quantity":1,"warehouse_id":"900000000000000001"}],"price":{"currency":"VND","sale_price":"150000"},"seller_sku":"SKU-MAU-01"}]}],"responsible_person_ids":["900000000000000001"],"save_mode":"AS_DRAFT","scheduled_sale":{"is_enabled_scheduled_sale":false,"schedule_sale_time":1793494800},"search_terms":["Minh họa"],"size_chart":{"image":{"uri":"anh-minh-hoa"},"template":{"id":"900000000000000001"}},"skus":[{"external_list_prices":[{"amount":"150000","currency":"VND","source":"SHOPIFY_COMPARE_AT_PRICE"}],"external_sku_id":"900000000000000001","external_urls":[""],"extra_identifier_codes":["Minh họa"],"fees":[{"additional_attribute":"SINGLE_USE","amount":"150000","type":"PFAND"}],"id":"900000000000000001","identifier_code":{"code":0,"type":"GTIN"},"inventory":[{"backorder_quantity":1,"handling_time":1793494800,"quantity":1,"warehouse_id":"900000000000000001"}],"list_price":{"amount":"150000","currency":"VND"},"pre_sale":{"fulfillment_type":{"handling_duration_days":1,"release_date":1},"type":"PRE_ORDER"},"price":{"amount":"150000","currency":"VND","sale_price":"150000"},"sales_attributes":[{"id":"900000000000000001","name":"Minh họa","sku_img":{"uri":"anh-minh-hoa"},"supplementary_sku_images":[{"uri":"anh-minh-hoa"}],"value_id":"900000000000000001","value_name":"Minh họa"}],"seller_sku":"SKU-MAU-01","sku_dimensions":{"height":"Minh họa","length":"Minh họa","unit":"CENTIMETER","width":"Minh họa"},"sku_unit_count":"Minh họa","sku_weight":{"unit":"KILOGRAM","value":"0.5"}}],"subscribe_info_edit":{"discount_details":[{"discount_level":"REGULAR","discount_value":1}],"subscribe_status":"ENABLED"},"title":"Áo thun cotton cổ tròn minh họa","video":{"id":"900000000000000001"},"is_blind_box":false}),
});
console.log(r.status, await r.json());PHP
<?php
$key = 'q360_live_...'; // khóa API của brand
$url = 'https://partner.quantri360.com/v1/tiktok/product/202509/products/900000000000000001/partial_edit' . '?' . http_build_query([]);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $key, 'Content-Type: application/json']);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{"auto_translate_enabled":false,"brand_id":"900000000000000001","category_version":"v2","certifications":[{"expiration_date":1793494800,"files":[{"format":"PDF","id":"900000000000000001","name":"chungnhan.pdf"}],"id":"900000000000000001","images":[{"uri":"anh-minh-hoa"}]}],"description":"<p>Sản phẩm minh họa.</p>","external_product_id":"900000000000000001","inventory_mode":"SHARED","is_cod_allowed":false,"key_product_features":["Minh họa"],"listing_platforms":["TIKTOK_SHOP"],"locale":"vi-VN","main_images":[{"uri":"anh-minh-hoa"}],"manufacturer_ids":["900000000000000001"],"package_dimensions":{"height":"Minh họa","length":"Minh họa","unit":"CENTIMETER","width":"Minh họa"},"package_weight":{"unit":"KILOGRAM","value":"0.5"},"pod_info":{"pod_templates":[{"pod_template_id":"900000000000000001","remark":"Minh họa","sku_ids":["900000000000000001"],"surfaces":[{"background_image":{"uri":"anh-minh-hoa"},"custom_areas":[{"area_name":"Minh họa","area_placement":{"height":"Minh họa","rotate_degree":"Minh họa","width":"Minh họa","x_coordinate":"Minh họa","y_coordinate":"Minh họa"},"area_type":"TEXT","external_area_id":"900000000000000001","image_area":{"default_image":{"uri":"anh-minh-hoa"},"min_height":1,"min_width":1},"is_required":false,"text_area":{"align_type":"CENTER","colors":["Minh họa"],"default_text":"Minh họa","fonts":["Minh họa"],"max_text_length":1}}],"external_surface_id":"900000000000000001","mask_image":{"uri":"anh-minh-hoa"},"surface_name":"Minh họa"}],"template_name":"Bảng kích cỡ minh họa"}]},"product_attributes":[{"id":"900000000000000001","values":[{"id":"900000000000000001","name":"Minh họa","metric_standard_info":{"id":"900000000000000001","metric_value_module_infos":[{"id":"900000000000000001","value":"Minh họa","unit_id":"900000000000000001"}]}}]}],"replicated_products":[{"inventory_mode":"SHARED","region":"VN","skus":[{"external_sku_id":"900000000000000001","id":"900000000000000001","inventory":[{"quantity":1,"warehouse_id":"900000000000000001"}],"price":{"currency":"VND","sale_price":"150000"},"seller_sku":"SKU-MAU-01"}]}],"responsible_person_ids":["900000000000000001"],"save_mode":"AS_DRAFT","scheduled_sale":{"is_enabled_scheduled_sale":false,"schedule_sale_time":1793494800},"search_terms":["Minh họa"],"size_chart":{"image":{"uri":"anh-minh-hoa"},"template":{"id":"900000000000000001"}},"skus":[{"external_list_prices":[{"amount":"150000","currency":"VND","source":"SHOPIFY_COMPARE_AT_PRICE"}],"external_sku_id":"900000000000000001","external_urls":[""],"extra_identifier_codes":["Minh họa"],"fees":[{"additional_attribute":"SINGLE_USE","amount":"150000","type":"PFAND"}],"id":"900000000000000001","identifier_code":{"code":0,"type":"GTIN"},"inventory":[{"backorder_quantity":1,"handling_time":1793494800,"quantity":1,"warehouse_id":"900000000000000001"}],"list_price":{"amount":"150000","currency":"VND"},"pre_sale":{"fulfillment_type":{"handling_duration_days":1,"release_date":1},"type":"PRE_ORDER"},"price":{"amount":"150000","currency":"VND","sale_price":"150000"},"sales_attributes":[{"id":"900000000000000001","name":"Minh họa","sku_img":{"uri":"anh-minh-hoa"},"supplementary_sku_images":[{"uri":"anh-minh-hoa"}],"value_id":"900000000000000001","value_name":"Minh họa"}],"seller_sku":"SKU-MAU-01","sku_dimensions":{"height":"Minh họa","length":"Minh họa","unit":"CENTIMETER","width":"Minh họa"},"sku_unit_count":"Minh họa","sku_weight":{"unit":"KILOGRAM","value":"0.5"}}],"subscribe_info_edit":{"discount_details":[{"discount_level":"REGULAR","discount_value":1}],"subscribe_status":"ENABLED"},"title":"Áo thun cotton cổ tròn minh họa","video":{"id":"900000000000000001"},"is_blind_box":false}');
$res = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status, "\n", $res;Response
Response fields (as returned by TikTok Shop)
| Name | Type | Sample | Description |
|---|---|---|---|
| code | int | 0 | Mã kết quả; 0 là thành công. |
| message | string | Success | Thông báo kết quả. |
| request_id | string | YEU_CAU_MINH_HOA | Mã yêu cầu để tra cứu lỗi. |
| data | object | Dữ liệu. | |
| audit | object | Thông tin duyệt. | |
| status | string | AUDITING | Trạng thái; giá trị liên quan: NONE, AUDITING, APPROVED. |
| product_id | string | 900000000000000001 | Mã sản phẩm. |
| skus | object[] | Danh sách SKU. | |
| external_sku_id | string | 900000000000000001 | Mã SKU trong hệ thống bên ngoài. |
| fees | object[] | Các khoản phí. | |
| additional_attribute | string | SINGLE_USE | Thuộc tính bổ sung; giá trị liên quan: SINGLE_USE, NOT_APPLICABLE, REUSABLE. |
| amount | string | 150000 | Số tiền. |
| type | string | PFAND | Loại; giá trị liên quan: PFAND. |
| id | string | 900000000000000001 | Mã định danh. |
| sales_attributes | object[] | Thuộc tính bán hàng tạo biến thể. | |
| id | string | 900000000000000001 | Mã định danh. |
| value_id | string | 900000000000000001 | Mã giá trị. |
| seller_sku | string | SKU-MAU-01 | Mã SKU do người bán quản lý. |
Response sample
{
"code": 0,
"message": "Success",
"request_id": "YEU_CAU_MINH_HOA",
"data": {
"audit": {
"status": "AUDITING"
},
"product_id": "900000000000000001",
"skus": [
{
"external_sku_id": "900000000000000001",
"fees": [
{
"additional_attribute": "SINGLE_USE",
"amount": "150000",
"type": "PFAND"
}
],
"id": "900000000000000001",
"sales_attributes": [
{
"id": "900000000000000001",
"value_id": "900000000000000001"
}
],
"seller_sku": "SKU-MAU-01"
}
]
}
}
Get started
- Sign up for Partner
- Enable a data type of the Sản phẩm group on the platform page
- Create an API key (tick the TikTok Shop channel)
- Call it as in the examples above