1. Home
  2. Docs
  3. Current
  4. Guides
  5. Products
  6. Update product information

Update product information

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)

HTTP 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

Example

{
    "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
                }
            ]
        }
    ]
}
ParamsTypeMandatoryDescription
product_idnumberYid of product in TIKI system
original_skustringYseller product code of product
pricenumberN
statusnumberNenum {1: enabled, 2: disabled, 3: hided}
seller_warehousestringNThe array of warehouses of products wants to update. It uses to add, remove warehouses from product
warehouse_quantitiesarrayNThe 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

Example

{
    "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 nameTypeDescription
is_successbooleanTrue if update product success, otherwise false
product_idnumber
original_skunumber
codestringsuccess if update done or an error code if failed.
messageList<String>List of reason why update failed.

Update images and attributes of the product

Update attributes, image , images example

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.

Update image , images 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

Update original sku example

POST https://api.tiki.vn/integration/v2/products/updateOriginalSku

Update original sku 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.

Was this article helpful to you? Yes 1 No

How can we help?

One thought on “Update product information

Leave a Reply

Your email address will not be published.