tiktok.product.202309.global_products.global_product_id.publish
POST/product/202309/global_products/{global_product_id}/publishVia 360: POST https://partner.quantri360.com/v1/tiktok/product/202309/global_products/{global_product_id}/publish
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
CHỈ NGƯỜI BÁN TOÀN CẦU: Đăng sản phẩm toàn cầu thành sản phẩm địa phương ở các gian hàng đích; sản phẩm được gửi duyệt tại từng thị trường.
- Gọi qua /v1/tiktok/product/202309/global_products/{global_product_id}/publish 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. Tạo sản phẩm địa phương và gửi duyệt tại thị trường đích.
- HTTP 200 vẫn có thể có lỗi nghiệp vụ; kiểm code trước khi dùng kết quả.
- API hàng toàn cầu; gian hàng thường bị từ chối với mã 12052910 / 12052032.
Request
Endpoint
POST https://partner.quantri360.com/v1/tiktok/product/202309/global_products/{global_product_id}/publish
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 |
|---|---|---|---|---|---|
| global_product_id | path | string | Yes | 900000000000000001 | Mã sản phẩm toàn cầu. |
| publish_target | body | object[] | Yes | [{"region": "VN", "responsible_person_ids": ["900000000000000001"], "manufacturer_ids": ["900000000000000001"], "skus": [{"related_global_sku_id": "900000000000000001", "price": {"amount": "150000", "currency": "VND", "sale_price": "150000"}, "inventory": {"warehouse_id": "900000000000000001", "quantity": 1}, "fees": [{"type": "PFAND", "amount": "150000", "additional_attribute": "SINGLE_USE"}]}]}] | Danh sách gian hàng đích để đăng sản phẩm. |
| publish_target[].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. |
| publish_target[].responsible_person_ids | body | string[] | No | ["900000000000000001"] | Danh sách mã người chịu trách nhiệm. |
| publish_target[].manufacturer_ids | body | string[] | No | ["900000000000000001"] | Danh sách mã nhà sản xuất. |
| publish_target[].skus | body | object[] | Yes | [{"related_global_sku_id": "900000000000000001", "price": {"amount": "150000", "currency": "VND", "sale_price": "150000"}, "inventory": {"warehouse_id": "900000000000000001", "quantity": 1}, "fees": [{"type": "PFAND", "amount": "150000", "additional_attribute": "SINGLE_USE"}]}] | Các SKU biến thể; tối đa 300 tại EU, JP, UK, US, khu vực khác tối đa 100; nên đặt biến thể quan trọng nhất ở đầu. |
| publish_target[].skus[].related_global_sku_id | body | string | Yes | 900000000000000001 | Mã SKU toàn cầu tương ứng. |
| publish_target[].skus[].price | body | object | No | {"amount": "150000", "currency": "VND", "sale_price": "150000"} | Giá. |
| publish_target[].skus[].price.amount | body | string | No | 150000 | Số tiền. |
| publish_target[].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. |
| publish_target[].skus[].price.sale_price | body | string | No | 150000 | Giá hiển thị trước giảm giá. |
| publish_target[].skus[].inventory | body | object | No | {"warehouse_id": "900000000000000001", "quantity": 1} | Tồn kho theo từng kho. |
| publish_target[].skus[].inventory.warehouse_id | body | string | No | 900000000000000001 | Mã kho. |
| publish_target[].skus[].inventory.quantity | body | int | No | 1 | Số lượng; giới hạn: [1, 99,999]. |
| publish_target[].skus[].fees | body | object[] | No | [{"type": "PFAND", "amount": "150000", "additional_attribute": "SINGLE_USE"}] | Các khoản phí. |
| publish_target[].skus[].fees[].type | body | string | No | PFAND | Loại; giá trị liên quan: PFAND. |
| publish_target[].skus[].fees[].amount | body | string | No | 150000 | Số tiền. |
| publish_target[].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. |
Request examples
curl -s -X POST "https://partner.quantri360.com/v1/tiktok/product/202309/global_products/900000000000000001/publish" \
-H "Authorization: Bearer $KEY" \
-H "Content-Type: application/json" \
-d '{"publish_target":[{"region":"VN","responsible_person_ids":["900000000000000001"],"manufacturer_ids":["900000000000000001"],"skus":[{"related_global_sku_id":"900000000000000001","price":{"amount":"150000","currency":"VND","sale_price":"150000"},"inventory":{"warehouse_id":"900000000000000001","quantity":1},"fees":[{"type":"PFAND","amount":"150000","additional_attribute":"SINGLE_USE"}]}]}]}'
Python
import requests
KEY = "q360_live_..." # khóa API của brand
r = requests.post(
"https://partner.quantri360.com/v1/tiktok/product/202309/global_products/900000000000000001/publish",
params={},
json={
"publish_target": [
{
"region": "VN",
"responsible_person_ids": [
"900000000000000001"
],
"manufacturer_ids": [
"900000000000000001"
],
"skus": [
{
"related_global_sku_id": "900000000000000001",
"price": {
"amount": "150000",
"currency": "VND",
"sale_price": "150000"
},
"inventory": {
"warehouse_id": "900000000000000001",
"quantity": 1
},
"fees": [
{
"type": "PFAND",
"amount": "150000",
"additional_attribute": "SINGLE_USE"
}
]
}
]
}
]
},
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/202309/global_products/900000000000000001/publish');
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({"publish_target":[{"region":"VN","responsible_person_ids":["900000000000000001"],"manufacturer_ids":["900000000000000001"],"skus":[{"related_global_sku_id":"900000000000000001","price":{"amount":"150000","currency":"VND","sale_price":"150000"},"inventory":{"warehouse_id":"900000000000000001","quantity":1},"fees":[{"type":"PFAND","amount":"150000","additional_attribute":"SINGLE_USE"}]}]}]}),
});
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/202309/global_products/900000000000000001/publish' . '?' . 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, '{"publish_target":[{"region":"VN","responsible_person_ids":["900000000000000001"],"manufacturer_ids":["900000000000000001"],"skus":[{"related_global_sku_id":"900000000000000001","price":{"amount":"150000","currency":"VND","sale_price":"150000"},"inventory":{"warehouse_id":"900000000000000001","quantity":1},"fees":[{"type":"PFAND","amount":"150000","additional_attribute":"SINGLE_USE"}]}]}]}');
$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. | |
| products | object[] | Danh sách sản phẩm; giá trị liên quan: FAILED. | |
| region | string | 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. |
| shop_id | string | 900000000000000001 | Mã gian hàng đích. |
| skus | object[] | Danh sách SKU. | |
| related_global_sku_id | string | 900000000000000001 | Mã SKU toàn cầu tương ứng. |
| id | string | 900000000000000001 | Mã định danh. |
| seller_sku | string | SKU-MAU-01 | Mã SKU do người bán quản lý. |
| sale_attributes | object[] | Thuộc tính bán hàng. | |
| id | string | 900000000000000001 | Mã định danh. |
| value_id | string | 900000000000000001 | Mã giá trị. |
| id | string | 900000000000000001 | Mã định danh. |
| publish_result | object[] | Kết quả đăng. | |
| region | string | 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. |
| status | string | SUCCESS | Trạng thái; giá trị liên quan: SUCCESS, DRAFT, FAILED. |
| fail_reasons | object[] | Các lý do không đạt. | |
| message | string | Success | Thông báo kết quả. |
Response sample
{
"code": 0,
"message": "Success",
"request_id": "YEU_CAU_MINH_HOA",
"data": {
"products": [
{
"region": "VN",
"shop_id": "900000000000000001",
"skus": [
{
"related_global_sku_id": "900000000000000001",
"id": "900000000000000001",
"seller_sku": "SKU-MAU-01",
"sale_attributes": [
{
"id": "900000000000000001",
"value_id": "900000000000000001"
}
]
}
],
"id": "900000000000000001"
}
],
"publish_result": [
{
"region": "VN",
"status": "SUCCESS",
"fail_reasons": [
{
"message": "Success"
}
]
}
]
}
}
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