VI | EN
Message us on Messenger
Developer resources

Partial Edit Product — TikTok Shop API

tiktok.product.202509.products.product_id.partial_edit · call it through Quantri360 with one API key for your own accounts / assets that you connected and authorized — 360 handles request signing and refreshing the authorization you granted.

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

NameInTypeSampleDescription
AuthorizationheaderheaderBearer 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_idquerystring100001Gian 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

NameInTypeRequiredSampleDescription
product_idpathstringYes900000000000000001Mã sản phẩm.
auto_translate_enabledbodyboolNofalseTự động dịch.
brand_idbodystringNo900000000000000001Mã thương hiệu.
category_versionbodystringNov2Phiê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.
certificationsbodyobject[]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_datebodyintNo1793494800Thời điểm hết hạn chứng nhận; Unix giây UTC+0.
certifications[].filesbodyobject[]No[{"format": "PDF", "id": "900000000000000001", "name": "chungnhan.pdf"}]Danh sách tệp.
certifications[].files[].formatbodystringYesPDFĐịnh dạng tệp.
certifications[].files[].idbodystringYes900000000000000001Mã định danh.
certifications[].files[].namebodystringYeschungnhan.pdfTên.
certifications[].idbodystringYes900000000000000001Mã định danh.
certifications[].imagesbodyobject[]No[{"uri": "anh-minh-hoa"}]Danh sách ảnh.
certifications[].images[].uribodystringYesanh-minh-hoaURI ảnh đã tải lên; giá trị liên quan: CERTIFICATION_IMAGE.
descriptionbodystringNo<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_idbodystringNo900000000000000001Mã sản phẩm trong hệ thống bên ngoài; độ dài tối đa: 999.
inventory_modebodystringNoSHAREDChế độ 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_allowedbodyboolNofalseCho phép thanh toán khi nhận hàng.
key_product_featuresbodystring[]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_platformsbodystring[]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.
localebodystringNovi-VNMã 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_imagesbodyobject[]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[].uribodystringYesanh-minh-hoaURI ảnh đã tải lên; giá trị liên quan: MAIN_IMAGE.
manufacturer_idsbodystring[]No["900000000000000001"]Danh sách mã nhà sản xuất.
package_dimensionsbodyobjectNo{"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.heightbodystringYesMinh họaChiều cao.
package_dimensions.lengthbodystringYesMinh họaChiều dài.
package_dimensions.unitbodystringYesCENTIMETERĐơn vị; giá trị liên quan: US, CENTIMETER, INCH, KILOGRAM.
package_dimensions.widthbodystringYesMinh họaChiều rộng.
package_weightbodyobjectNo{"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.unitbodystringYesKILOGRAMĐơn vị; giá trị liên quan: US, KILOGRAM, POUND, BR, JP, MX, GRAM, CENTIMETER.
package_weight.valuebodystringYes0.5Giá trị; giá trị liên quan: GRAM, KILOGRAM, POUND.
pod_infobodyobjectNo{"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_templatesbodyobject[]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_idbodystringNo900000000000000001Mã mẫu in theo yêu cầu.
pod_info.pod_templates[].remarkbodystringNoMinh họaGhi chú.
pod_info.pod_templates[].sku_idsbodystring[]No["900000000000000001"]Danh sách mã SKU.
pod_info.pod_templates[].surfacesbodyobject[]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_imagebodyobjectNo{"uri": "anh-minh-hoa"}Ảnh nền.
pod_info.pod_templates[].surfaces[].background_image.uribodystringNoanh-minh-hoaURI ảnh đã tải lên; giá trị liên quan: CUSTOMIZATION_IMAGE.
pod_info.pod_templates[].surfaces[].custom_areasbodyobject[]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_namebodystringNoMinh họaTên vùng.
pod_info.pod_templates[].surfaces[].custom_areas[].area_placementbodyobjectNo{"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.heightbodystringNoMinh họaChiều cao.
pod_info.pod_templates[].surfaces[].custom_areas[].area_placement.rotate_degreebodystringNoMinh họaGóc xoay.
pod_info.pod_templates[].surfaces[].custom_areas[].area_placement.widthbodystringNoMinh họaChiều rộng.
pod_info.pod_templates[].surfaces[].custom_areas[].area_placement.x_coordinatebodystringNoMinh họaTọa độ ngang.
pod_info.pod_templates[].surfaces[].custom_areas[].area_placement.y_coordinatebodystringNoMinh họaTọa độ dọc.
pod_info.pod_templates[].surfaces[].custom_areas[].area_typebodystringNoTEXTLoại vùng; giá trị liên quan: TEXT, IMAGE.
pod_info.pod_templates[].surfaces[].custom_areas[].external_area_idbodystringNo900000000000000001Mã vùng trong hệ thống bên ngoài.
pod_info.pod_templates[].surfaces[].custom_areas[].image_areabodyobjectNo{"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_imagebodyobjectNo{"uri": "anh-minh-hoa"}Ảnh mặc định.
pod_info.pod_templates[].surfaces[].custom_areas[].image_area.default_image.uribodystringNoanh-minh-hoaURI ảnh đã tải lên; giá trị liên quan: CUSTOMIZATION_IMAGE.
pod_info.pod_templates[].surfaces[].custom_areas[].image_area.min_heightbodyintNo1Chiều cao tối thiểu.
pod_info.pod_templates[].surfaces[].custom_areas[].image_area.min_widthbodyintNo1Chiều rộng tối thiểu.
pod_info.pod_templates[].surfaces[].custom_areas[].is_requiredbodyboolNofalseCó bắt buộc hay không.
pod_info.pod_templates[].surfaces[].custom_areas[].text_areabodyobjectNo{"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_typebodystringNoCENTERKiểu căn chỉnh; giá trị liên quan: LEFT, CENTER, RIGHT.
pod_info.pod_templates[].surfaces[].custom_areas[].text_area.colorsbodystring[]No["Minh họa"]Các màu.
pod_info.pod_templates[].surfaces[].custom_areas[].text_area.default_textbodystringNoMinh họaVăn bản mặc định.
pod_info.pod_templates[].surfaces[].custom_areas[].text_area.fontsbodystring[]No["Minh họa"]Các phông chữ.
pod_info.pod_templates[].surfaces[].custom_areas[].text_area.max_text_lengthbodyintNo1Độ dài văn bản tối đa.
pod_info.pod_templates[].surfaces[].external_surface_idbodystringNo900000000000000001Mã bề mặt trong hệ thống bên ngoài.
pod_info.pod_templates[].surfaces[].mask_imagebodyobjectNo{"uri": "anh-minh-hoa"}Ảnh mặt nạ.
pod_info.pod_templates[].surfaces[].mask_image.uribodystringNoanh-minh-hoaURI ảnh đã tải lên; giá trị liên quan: CUSTOMIZATION_IMAGE.
pod_info.pod_templates[].surfaces[].surface_namebodystringNoMinh họaTên bề mặt.
pod_info.pod_templates[].template_namebodystringNoBảng kích cỡ minh họaTên mẫu bảng kích cỡ.
product_attributesbodyobject[]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[].idbodystringYes900000000000000001Mã định danh.
product_attributes[].valuesbodyobject[]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[].idbodystringNo900000000000000001Mã định danh.
product_attributes[].values[].namebodystringNoMinh họaTên; độ dài tối đa: 2000.
product_attributes[].values[].metric_standard_infobodyobjectNo{"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.idbodystringNo900000000000000001Mã định danh.
product_attributes[].values[].metric_standard_info.metric_value_module_infosbodyobject[]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[].idbodystringNo900000000000000001Mã định danh.
product_attributes[].values[].metric_standard_info.metric_value_module_infos[].valuebodystringNoMinh họaGiá trị.
product_attributes[].values[].metric_standard_info.metric_value_module_infos[].unit_idbodystringNo900000000000000001Mã đơn vị.
replicated_productsbodyobject[]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_modebodystringNoSHAREDChế độ 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[].regionbodystringYesVNThị 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[].skusbodyobject[]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_idbodystringNo900000000000000001Mã SKU trong hệ thống bên ngoài; độ dài tối đa: 999.
replicated_products[].skus[].idbodystringNo900000000000000001Mã định danh.
replicated_products[].skus[].inventorybodyobject[]No[{"quantity": 1, "warehouse_id": "900000000000000001"}]Tồn kho theo từng kho.
replicated_products[].skus[].inventory[].quantitybodyintNo1Số lượng; giới hạn: [1, 999,999].
replicated_products[].skus[].inventory[].warehouse_idbodystringNo900000000000000001Mã kho.
replicated_products[].skus[].pricebodyobjectYes{"currency": "VND", "sale_price": "150000"}Giá.
replicated_products[].skus[].price.currencybodystringYesVNDMã 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_pricebodystringYes150000Giá hiển thị trước giảm giá.
replicated_products[].skus[].seller_skubodystringNoSKU-MAU-01Mã SKU do người bán quản lý.
responsible_person_idsbodystring[]No["900000000000000001"]Danh sách mã người chịu trách nhiệm.
save_modebodystringNoAS_DRAFTAS_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_salebodyobjectNo{"is_enabled_scheduled_sale": false, "schedule_sale_time": 1793494800}Cấu hình bán theo lịch.
scheduled_sale.is_enabled_scheduled_salebodyboolYesfalseBật bán theo lịch.
scheduled_sale.schedule_sale_timebodyintYes1793494800Thời điểm bắt đầu bán theo lịch.
search_termsbodystring[]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_chartbodyobjectNo{"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.imagebodyobjectNo{"uri": "anh-minh-hoa"}Ảnh.
size_chart.image.uribodystringYesanh-minh-hoaURI ảnh đã tải lên; giá trị liên quan: SIZE_CHART_IMAGE.
size_chart.templatebodyobjectNo{"id": "900000000000000001"}Mẫu.
size_chart.template.idbodystringYes900000000000000001Mã định danh.
skusbodyobject[]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_pricesbodyobject[]No[{"amount": "150000", "currency": "VND", "source": "SHOPIFY_COMPARE_AT_PRICE"}]Giá niêm yết bên ngoài.
skus[].external_list_prices[].amountbodystringYes150000Số tiền; giới hạn: [0.01, 7600].
skus[].external_list_prices[].currencybodystringYesVNDMã tiền tệ; giá trị liên quan: USD.
skus[].external_list_prices[].sourcebodystringYesSHOPIFY_COMPARE_AT_PRICENguồn; giá trị liên quan: SHOPIFY_COMPARE_AT_PRICE.
skus[].external_sku_idbodystringNo900000000000000001Mã SKU trong hệ thống bên ngoài; độ dài tối đa: 999.
skus[].external_urlsbodystring[]No[""]Các địa chỉ bên ngoài.
skus[].extra_identifier_codesbodystring[]No["Minh họa"]Các mã định danh bổ sung; giá trị liên quan: X.
skus[].feesbodyobject[]No[{"additional_attribute": "SINGLE_USE", "amount": "150000", "type": "PFAND"}]Các khoản phí.
skus[].fees[].additional_attributebodystringNoSINGLE_USEThuộc tính bổ sung; giá trị liên quan: SINGLE_USE, NOT_APPLICABLE, REUSABLE.
skus[].fees[].amountbodystringNo150000Số tiền.
skus[].fees[].typebodystringNoPFANDLoại; giá trị liên quan: PFAND.
skus[].idbodystringNo900000000000000001Mã định danh.
skus[].identifier_codebodyobjectNo{"code": 0, "type": "GTIN"}Mã định danh bổ sung.
skus[].identifier_code.codebodystringNo0Mã kết quả; 0 là thành công; giá trị liên quan: X.
skus[].identifier_code.typebodystringNoGTINLoại; giá trị liên quan: GTIN, EAN, UPC, ISBN, JAN.
skus[].inventorybodyobject[]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_quantitybodyintNo1Số lượng hàng đặt trước.
skus[].inventory[].handling_timebodyintNo1793494800Thời gian xử lý hàng đặt trước.
skus[].inventory[].quantitybodyintYes1Số lượng; giới hạn: [1, 99,999].
skus[].inventory[].warehouse_idbodystringYes900000000000000001Mã kho.
skus[].list_pricebodyobjectNo{"amount": "150000", "currency": "VND"}Giá niêm yết.
skus[].list_price.amountbodystringYes150000Số tiền; giới hạn: [0.01, 7600].
skus[].list_price.currencybodystringYesVNDMã tiền tệ; giá trị liên quan: USD.
skus[].pre_salebodyobjectNo{"fulfillment_type": {"handling_duration_days": 1, "release_date": 1}, "type": "PRE_ORDER"}Cấu hình bán trước.
skus[].pre_sale.fulfillment_typebodyobjectNo{"handling_duration_days": 1, "release_date": 1}Hình thức hoàn tất đơn.
skus[].pre_sale.fulfillment_type.handling_duration_daysbodyintNo1Số ngày xử lý; giá trị liên quan: MADE_TO_ORDER, PRE_ORDER, CUSTOM.
skus[].pre_sale.fulfillment_type.release_datebodyintNo1Ngày phát hành; giá trị liên quan: PRE_ORDER.
skus[].pre_sale.typebodystringNoPRE_ORDERLoại; giá trị liên quan: PRE_ORDER, MADE_TO_ORDER, US, CUSTOM, UK, EU, SEA, JP, LATAM.
skus[].pricebodyobjectNo{"amount": "150000", "currency": "VND", "sale_price": "150000"}Giá.
skus[].price.amountbodystringNo150000Số tiền.
skus[].price.currencybodystringYesVNDMã 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_pricebodystringNo150000Giá hiển thị trước giảm giá.
skus[].sales_attributesbodyobject[]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[].idbodystringNo900000000000000001Mã định danh.
skus[].sales_attributes[].namebodystringNoMinh họaTên; độ dài tối đa: 20.
skus[].sales_attributes[].sku_imgbodyobjectNo{"uri": "anh-minh-hoa"}Ảnh biến thể.
skus[].sales_attributes[].sku_img.uribodystringYesanh-minh-hoaURI ảnh đã tải lên; giá trị liên quan: ATTRIBUTE_IMAGE.
skus[].sales_attributes[].supplementary_sku_imagesbodyobject[]No[{"uri": "anh-minh-hoa"}]Ảnh SKU bổ sung.
skus[].sales_attributes[].supplementary_sku_images[].uribodystringYesanh-minh-hoaURI ảnh đã tải lên; giá trị liên quan: ATTRIBUTE_IMAGE.
skus[].sales_attributes[].value_idbodystringNo900000000000000001Mã giá trị.
skus[].sales_attributes[].value_namebodystringNoMinh họaTên giá trị; độ dài tối đa: 50.
skus[].seller_skubodystringNoSKU-MAU-01Mã SKU do người bán quản lý.
skus[].sku_dimensionsbodyobjectNo{"height": "Minh họa", "length": "Minh họa", "unit": "CENTIMETER", "width": "Minh họa"}Kích thước SKU.
skus[].sku_dimensions.heightbodystringYesMinh họaChiều cao.
skus[].sku_dimensions.lengthbodystringYesMinh họaChiều dài.
skus[].sku_dimensions.unitbodystringYesCENTIMETERĐơn vị; giá trị liên quan: SKU, US, CENTIMETER, INCH, KILOGRAM.
skus[].sku_dimensions.widthbodystringYesMinh họaChiều rộng.
skus[].sku_unit_countbodystringNoMinh họaSố đơn vị trong SKU; giới hạn: [0.01, 99,999.9999].
skus[].sku_weightbodyobjectNo{"unit": "KILOGRAM", "value": "0.5"}Khối lượng SKU.
skus[].sku_weight.unitbodystringYesKILOGRAMĐơn vị; giá trị liên quan: SKU, US, KILOGRAM, POUND, BR, JP, MX, GRAM, CENTIMETER.
skus[].sku_weight.valuebodystringYes0.5Giá trị.
subscribe_info_editbodyobjectNo{"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_detailsbodyobject[]No[{"discount_level": "REGULAR", "discount_value": 1}]Chi tiết giảm giá.
subscribe_info_edit.discount_details[].discount_levelbodystringNoREGULARMức giảm giá; giá trị liên quan: FIRST_ORDER.
subscribe_info_edit.discount_details[].discount_valuebodyintNo1Giá trị giảm giá.
subscribe_info_edit.subscribe_statusbodystringNoENABLEDTrạng thái mua định kỳ; giá trị liên quan: NOT_ENABLED.
titlebodystringNoÁo thun cotton cổ tròn minh họaTiê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ự.
videobodyobjectNo{"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.idbodystringYes900000000000000001Mã định danh.
is_blind_boxbodyboolNofalseSả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)

NameTypeSampleDescription
codeint0Mã kết quả; 0 là thành công.
messagestringSuccessThông báo kết quả.
request_idstringYEU_CAU_MINH_HOAMã yêu cầu để tra cứu lỗi.
dataobjectDữ liệu.
auditobjectThông tin duyệt.
statusstringAUDITINGTrạng thái; giá trị liên quan: NONE, AUDITING, APPROVED.
product_idstring900000000000000001Mã sản phẩm.
skusobject[]Danh sách SKU.
external_sku_idstring900000000000000001Mã SKU trong hệ thống bên ngoài.
feesobject[]Các khoản phí.
additional_attributestringSINGLE_USEThuộc tính bổ sung; giá trị liên quan: SINGLE_USE, NOT_APPLICABLE, REUSABLE.
amountstring150000Số tiền.
typestringPFANDLoại; giá trị liên quan: PFAND.
idstring900000000000000001Mã định danh.
sales_attributesobject[]Thuộc tính bán hàng tạo biến thể.
idstring900000000000000001Mã định danh.
value_idstring900000000000000001Mã giá trị.
seller_skustringSKU-MAU-01Mã 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

  1. Sign up for Partner
  2. Enable a data type of the Sản phẩm group on the platform page
  3. Create an API key (tick the TikTok Shop channel)
  4. Call it as in the examples above