At the present time we provide several solutions to update product information. Based on the product structure and TIKI policy related to product management, attributes, categories, legal, etc. Depending on the field you want to update, you need to use the corresponding API, to avoid unnecessary confusion. Please read carefully and use the correct API endpoint you need
Update price, quantity, and active status of one product
Update price, quantity, active example
PUT https://api.tiki.vn/integration/v2/products/updateSku
Update price, quantity, active request body
{
"original_sku" : "xxx-yyy-123",
"product_id": 2166152,
"price": 100000,
"active": 1,
"seller_warehouse": "1034, 1015",
"warehouse_quantities": [
{
"warehouse_id": 1034,
"qty_available": 17
},
{
"warehouse_id": 1015,
"qty_available": 18
}
]
}
This API use to update price, quantity, and active status.
Your request will be approved automatically. Note that in this API you can use your original SKU from your system or TIKI product id to update this product. You can update price only, active only or mix them up depend on your choice, …
Update price, quantity, and active status of multiple products (batch update)
Request
PUT https://api.tiki.vn/integration/v2.1/products/updateSkus
This new API for updating batching products that support multiple warehouses
Authentication
Bearer valid token of seller who owns the products
Request Body
{
"data": [
{
"product_id": 12345,
"price": 12000,
"status": 2,
"seller_warehouse": "1034, 1015",
"warehouse_quantities": [
{
"warehouse_id": 1034,
"qty_available": 17
},
{
"warehouse_id": 1015,
"qty_available": 18
}
]
},
{
"original_sku": "xxxxx-yyyy-1111",
"price": 9000,
"status": 1,
"seller_warehouse": "1034, 1015",
"warehouse_quantities": [
{
"warehouse_id": 1034,
"qty_available": 17
},
{
"warehouse_id": 1015,
"qty_available": 18
}
]
}
]
}
Params | Type | Mandatory | Description |
product_id | number | Y | id of product in TIKI system |
original_sku | string | Y | seller product code of product |
price | number | N | |
status | number | N | enum {1: enabled, 2: disabled, 3: hided} |
seller_warehouse | string | N | The array of warehouses of products wants to update. It uses to add, remove warehouses from product |
warehouse_quantities | array | N | The array of warehouses with qty available. Note you need to put the whole array warehouses of the product when update otherwise the missing warehouse will get qty available = 0 |
Note:
– With a product, you must use product_id or original_sku. If product_id is passed, we use product_id, otherwise, we use original_sku.
– You can update up to 20 products in 1 call
Response
{
"data": [
{
"is_success": true,
"product_id": 2386775,
"original_sku": "p12-12335-abc",
"code": "success",
"message": null
},
{
"is_success": false,
"product_id": 2386777,
"original_sku": "",
"code": "resource_illegal",
"message": [
"Seller price must be less than or equals listing price of master product"
]
}
]
}
Field name | Type | Description |
is_success | boolean | True if update product success, otherwise false |
product_id | number | |
original_sku | number | |
code | string | success if update done or an error code if failed. |
message | List<String> | List of reason why update failed. |
Update images and attributes of the product
Request
POST https://api.tiki.vn/integration/v2/requests/updateProductInfo
This API use to update attributes, image thumbnail and list images media of the product base on TIKI policy , those is shared value among all seller that seller this product so we need to review it
your request will be created as update product request.
Request body
{
"product_id": 2138351,
"attributes": {
"name": "Test product name",
"brand":"Test description",
},
"image": "https://images-na.ssl-images-amazon.com/images/I/71rBcMwMq4L._SS500_.jpg",
"images": [
"https://images-na.ssl-images-amazon.com/images/I/31%2BtDPe1XfL._SS500_.jpg",
"https://images-na.ssl-images-amazon.com/images/I/61vGd9wTrxL._SS500_.jpg",
"https://images-na.ssl-images-amazon.com/images/I/61sTz%2BhRd4L._SS500_.jpg",
"https://images-na.ssl-images-amazon.com/images/I/41gOwCRsQ7L._SS500_.jpg"
]
}
- You can tracking update product request via tracking endpoint
- You can get request detail as normal product request
The good news for you is the flow of updating product is simpler and faster than the flow of creating new product. Just by the time you drink a cup of coffee, your product has been updated
Update Original SKU of the product
Request
POST https://api.tiki.vn/integration/v2/products/updateOriginalSku
Request Body
{
"product_id" : 123456,
"original_sku" : "SELLER_SKU"
}
This API use to update original sku. ( sku from seller system )
Your request will be approved automatically.
Although updating the original sku is not recommended, we still provide a solution for you to update the original sku if needed.
khi tôi dùng api https://api.tiki.vn/integration/v2/requests/updateProductInfo có kèm image vs images thì tracking request có state là processing. Khi nào thì sẽ update được image cho product