If it is the first time you come to integrate with us, please take a look at our tutorial documents first.

The table below lists APIs that can be used for product management.

API name	Description
Get categories	Return the summary list of categories in integration system
Get category detail	Retrieve detail of a single categories
Get category attributes	Retrieve list of category attributes
Get attribute values	Retrieve list valid value of select/multiselect attribute
Get option attribute labels	Retrieve list valid option label for product which having multi variants
Create Product Request	Create new a product request
Tracking latest product request	Tracking latest request
Tracking a product request	Retrieve detail of a single request
Replay a product request	Replay process of a single request from the beginning
Update variant price/quantity/active	Update price/quantity/active of a product intermediately
Update product info	Update description, attributes, image/images via update product request
Update product original sku	Update original sku (seller sku) intermediately
Batch update seller products	Batch update price/status/quantity for seller_simple products
Get latest products	Get all of product (approved request) order by created_at desc (latest product)
Get hidden products	Get all of hidden product
Get a product	Get a product with product_id from TIKI system
Get a product by original sku	Get a product by original sku
Get latest product request ‘s info	Get all of product requests order by created_at desc (latest request)
Get a product request info	Get a request with request_id from TIKI system
Get a product request info by track id	Get a product match with seller original sku
Delete a product request	Delete a created product request base on request_id of TIKI system
Get TIKI warehouses	Get the TIKI’s warehouse list
Get required documents	Get all required documents
Get brand by name	Get brand information by name

Get categories

HTTP Request

GET

https://api.tiki.vn/integration/v2/categories

Return the summary list of categories in integration system

Request

Parameter	Type	Mandatory	Description
name	string	N	a part of name
parent	number	N	parent id
isPrimary	boolean	N
isCrossBorder	boolean	N	default false.

Example

GET https://api.tiki.vn/integration/v2/categories?name=a&parent=320

{
    "data": [
        {
            "id": 623,
            "name": "Art & Photography",
            "description": "null",
            "parent_id": 320,
            "is_primary": false,
            "is_product_listing_enabled": true,
            "no_license_seller_enabled": false
        },
        {
            "id": 27,
            "name": "Biographies & Memoirs",
            "description": "Biographies & Memoirs",
            "parent_id": 320,
            "is_primary": false,
            "is_product_listing_enabled": true,
            "no_license_seller_enabled": false
        },
        {
            "id": 4,
            "name": "Business & Economics",
            "description": "All kinds of books related to business and investing: management, finance, entrepreneurs, startup, skills, sales, etc.",
            "parent_id": 320,
            "is_primary": false,
            "is_product_listing_enabled": true,
            "no_license_seller_enabled": false
        },
        {
            "id": 614,
            "name": "How-to - Self Help",
            "description": "null",
            "parent_id": 320,
            "is_primary": false,
            "is_product_listing_enabled": true,
            "no_license_seller_enabled": false
        },
        {
            "id": 7,
            "name": "Children's Books",
            "description": "All kinds of books for children to learn, entertain and have fun such as graphic books, children stories, fairy tales, comics, etc.",
            "parent_id": 320,
            "is_primary": false,
            "is_product_listing_enabled": true,
            "no_license_seller_enabled": false
        },
        {
            "id": 282,
            "name": "Dictionary",
            "description": "",
            "parent_id": 320,
            "is_primary": false,
            "is_product_listing_enabled": true,
            "no_license_seller_enabled": false
        },
        {
            "id": 5308,
            "name": "Education - Teaching",
            "description": "null",
            "parent_id": 320,
            "is_primary": false,
            "is_product_listing_enabled": true,
            "no_license_seller_enabled": false
        },
        {
            "id": 9,
            "name": "Fiction - Literature",
            "description": "Fictions, novels, chicklit, poem and more",
            "parent_id": 320,
            "is_primary": false,
            "is_product_listing_enabled": true,
            "no_license_seller_enabled": false
        },
        {
            "id": 6445,
            "name": "Magazines",
            "description": "English Magazines",
            "parent_id": 320,
            "is_primary": true,
            "is_product_listing_enabled": true,
            "no_license_seller_enabled": false
        },
        {
            "id": 218,
            "name": "Medical Books",
            "description": null,
            "parent_id": 320,
            "is_primary": true,
            "is_product_listing_enabled": true,
            "no_license_seller_enabled": false
        },
        {
            "id": 28,
            "name": "Parenting & Relationships",
            "description": "Parenting & Relationships",
            "parent_id": 320,
            "is_primary": false,
            "is_product_listing_enabled": true,
            "no_license_seller_enabled": false
        },
        {
            "id": 5309,
            "name": "Reference",
            "description": "Reference books",
            "parent_id": 320,
            "is_primary": false,
            "is_product_listing_enabled": true,
            "no_license_seller_enabled": false
        },
        {
            "id": 269,
            "name": "Science - Technology",
            "description": "null",
            "parent_id": 320,
            "is_primary": false,
            "is_product_listing_enabled": true,
            "no_license_seller_enabled": false
        },
        {
            "id": 632,
            "name": "History, Politics & Social Sciences",
            "description": "null",
            "parent_id": 320,
            "is_primary": false,
            "is_product_listing_enabled": true,
            "no_license_seller_enabled": false
        },
        {
            "id": 32,
            "name": "Travel & Holiday",
            "description": "Travel & Holiday",
            "parent_id": 320,
            "is_primary": false,
            "is_product_listing_enabled": true,
            "no_license_seller_enabled": false
        },
        {
            "id": 21,
            "name": "Cookbooks, Food & Wine",
            "description": "null",
            "parent_id": 320,
            "is_primary": false,
            "is_product_listing_enabled": true,
            "no_license_seller_enabled": false
        }
    ]
}

---

Response

Field	Type	Description
id	number
name	string
description	string
parent_id	number	parent category id
is_primary	boolean	category is primary or not. we can only create products on primary category
is_product_listing_enabled	boolean	category enable product listing or not. we can only create products on categories which have this value is true
no_license_seller_enabled	boolean	category enable for seller without license can create product or not

Get category detail

GET

https://api.tiki.vn/integration/v2/categories/{categoryId}

Request

Parameter	Type	Mandatory	Description
categoryId	number	Y
includeParents	boolean	N

Example

GET https://api.tiki.vn/integration/v2/categories/20?includeParents=true

Response

{
    "id": 20,
    "name": "Entrepreneurship - Small Business",
    "description": "Books for entrepreneurs",
    "parents": [
        {
            "id": 2,
            "name": "Root yyy",
            "parent_id": 1
        },
        {
            "id": 4,
            "name": "Economics",
            "parent_id": 320
        },
        {
            "id": 20,
            "name": "Entrepreneurship - Small Business",
            "parent_id": 4
        },
        {
            "id": 320,
            "name": "English Books",
            "parent_id": 8322
        },
        {
            "id": 8322,
            "name": "Nhà Sách Tiki.vn",
            "parent_id": 2
        }
    ],
    "parent_id": 4,
    "is_primary": true,
    "is_product_listing_enabled": true,
    "no_license_seller_enabled": false
}

Get category attributes

GET

https://api.tiki.vn/integration/v2/categories/{categoryId}/attributes

Request

Parameter	Type	Mandatory	Description
categoryId	number	Y

Example

GET https://api.tiki.vn/integration/v2/categories/20/attributes

Response

{
    "data": [
        {
            "id": 2249,
            "code": "all_time_quantity_sold",
            "description": "",
            "display_name": "Số lượng sản phẩm đã bán",
            "display_name_en": "All_time_quantity_sold",
            "is_required": false,
            "default_value": "",
            "input_type": "text",
            "data_type": "varchar",
            "description_en": null
        },
        {
            "id": 498,
            "code": "author",
            "description": null,
            "display_name": "Tác giả",
            "display_name_en": "Author",
            "is_required": false,
            "default_value": null,
            "input_type": "multiselect",
            "data_type": "varchar",
            "description_en": null
        },
        {
            "id": 1300,
            "code": "book_cover",
            "description": "",
            "display_name": "Loại bìa",
            "display_name_en": "Book cover type",
            "is_required": false,
            "default_value": null,
            "input_type": "select",
            "data_type": "int",
            "description_en": null
        },
        {
            "id": 799,
            "code": "bulky",
            "description": "",
            "display_name": "Sản phẩm của bạn có phải là Hàng Cồng Kềnh không?",
            "display_name_en": "Is bulky product?",
            "is_required": false,
            "default_value": "false",
            "input_type": "boolean",
            "data_type": "int",
            "description_en": null
        }
    ]
}

Get attribute values

GET

https://api.tiki.vn/integration/v2/attributes/{attributeId}/values

Request

Parameter	Type	Mandatory	Description
attributeId	number	Y
q	string	N	substring of attribute value
page	number	N	paging info. Default 1
limit	number	N	paging info. Default 20

Example

https://api.tiki.vn/integration/v2/attributes/540/values?q=phong

Response

{
    "data": [
        {
            "id": 4509607,
            "value": "Báo Thiếu Niên Tiền Phong",
            "position": 0,
            "attribute_code": "publisher_vn"
        },
        {
            "id": 704931,
            "value": "BÁO TIỀN PHONG",
            "position": 0,
            "attribute_code": "publisher_vn"
        },
        {
            "id": 18877,
            "value": "Cẩm Phong Books",
            "position": 0,
            "attribute_code": "publisher_vn"
        },
        {
            "id": 155760,
            "value": "Công ty Cổ Phần Học Viện Phong Thủy Ngũ Hành",
            "position": null,
            "attribute_code": "publisher_vn"
        },
        {
            "id": 19026,
            "value": "Công ty Kỳ Vân Phong",
            "position": 0,
            "attribute_code": "publisher_vn"
        },
        {
            "id": 858143,
            "value": "Công ty TNHH Phòng khám Happy Baby",
            "position": 0,
            "attribute_code": "publisher_vn"
        },
        {
            "id": 723525,
            "value": "Công ty TNHH thương mại dịch vụ Hoàng Phong",
            "position": 0,
            "attribute_code": "publisher_vn"
        },
        {
            "id": 4515693,
            "value": "Công ty TNHH Thương mại dịch vụ văn phòng phẩm Như Ý",
            "position": 0,
            "attribute_code": "publisher_vn"
        },
        {
            "id": 683475,
            "value": "Công Ty TNHH Thương Mại Văn Phòng Phẩm Song Ngân ",
            "position": 0,
            "attribute_code": "publisher_vn"
        },
        {
            "id": 779055,
            "value": "Công ty TNHH văn phòng phẩm  Hoàng Hà",
            "position": 0,
            "attribute_code": "publisher_vn"
        },
        {
            "id": 4249947,
            "value": "Công Ty TNHH Văn Phòng Phẩm Năng Động",
            "position": 0,
            "attribute_code": "publisher_vn"
        },
        {
            "id": 673519,
            "value": "CÔNG TY TNHH VĂN PHÒNG PHẨM VI VA",
            "position": 0,
            "attribute_code": "publisher_vn"
        },
        {
            "id": 4259281,
            "value": "Công Ty TNHH VN Đại Phong",
            "position": 0,
            "attribute_code": "publisher_vn"
        },
        {
            "id": 113663,
            "value": "Công ty TNHH Đầu Tư Thương Mại Sản Xuất Phong Vân",
            "position": null,
            "attribute_code": "publisher_vn"
        },
        {
            "id": 701689,
            "value": "Cty Phong Cách Teen",
            "position": 0,
            "attribute_code": "publisher_vn"
        },
        {
            "id": 3212833,
            "value": "Cty TNHH Đầu tư và phát triển Giáo dục Đại Đức Phong",
            "position": 0,
            "attribute_code": "publisher_vn"
        },
        {
            "id": 674991,
            "value": "Cty Văn Phòng Sáng Tạo (Stacom)",
            "position": 0,
            "attribute_code": "publisher_vn"
        },
        {
            "id": 3799103,
            "value": "Cửa Hàng Văn Phòng Phẩm Tiến Đạt",
            "position": 0,
            "attribute_code": "publisher_vn"
        },
        {
            "id": 442217,
            "value": "Hải Phòng",
            "position": 0,
            "attribute_code": "publisher_vn"
        },
        {
            "id": 2452637,
            "value": "Hoa Học Trò - Báo Tiền Phong",
            "position": 0,
            "attribute_code": "publisher_vn"
        }
    ],
    "paging": {
        "total": 29,
        "per_page": 20,
        "current_page": 1,
        "last_page": 2,
        "from": 1,
        "to": 20
    }
}

Get option attribute labels

HTTP Request

GET

https://api.tiki.vn/integration/v2/categories/{categoryId}/optionLabels

Parameter	Type	Mandatory	Description
categoryId	number	Y

Example

GET https://api.tiki.vn/integration/v2/categories/1795/optionLabels

Response

{
    "data": [
        {
            "option_label": "Màu"
        },
        {
            "option_label": "20Pro"
        },
        {
            "option_label": "Dung lượng"
        },
        {
            "option_label": "Kích cỡ"
        },
        {
            "option_label": "Màu sắc"
        }
    ]
}

Create Product Request (v2.0)

⚠️ Deprecate from 2022 January 05

Create new product request

HTTP Request

POST https://api.tiki.vn/integration/v2/requests

Simple product example:

{
  "category_id": 21458,
  "name": "Disney Women's MK2106 Mickey Mouse White Bracelet Watch with Rhinestones",
  "description": "<style>rn#productDetails_techSpec_section_2{width:70%;}rn#prodDetails .prodDetSectionEntry {width: 50%!important;white-space: normal;word-wrap: break-word;}rntable.a-keyvalue th {background-color: #f3f3f3;}rntable.a-keyvalue td, table.a-keyvalue th {padding: 7px 14px 6px;border-top: 1px solid #e7e7e7;}rn#prodDetails th {text-align: left;}rntable.a-keyvalue{border-bottom: 1px solid #e7e7e7;}rn</style><div id="prodDetails"><table id="productDetails_techSpec_section_2" class="a-keyvalue prodDetTable" role="presentation"><tbody><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Item Shape</th><td class="a-size-base">Round</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Display Type</th><td class="a-size-base">Analog</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Case material</th><td class="a-size-base">Metal</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Case diameter</th><td class="a-size-base">37 millimeters</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Band Material</th><td class="a-size-base">metal-alloy</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Band length</th><td class="a-size-base">Women&#039;s Standard</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Band width</th><td class="a-size-base">18 millimeters</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Band Color</th><td class="a-size-base">White</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Dial color</th><td class="a-size-base">White</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Bezel material</th><td class="a-size-base">Metal</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Brand, Seller, or Collection Name</th><td class="a-size-base">Disney</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Model number</th><td class="a-size-base">MK2106</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Part Number</th><td class="a-size-base">MK2106</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Case Thickness</th><td class="a-size-base">9.3 millimeters</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Special features</th><td class="a-size-base">includes a seconds-hand</td></tr></tbody></table></div><p></p><p>White bracelet watch featuring rhinestone-accented bezel and mother-of-pearl dial with sparkling Mickey Mouse design</p><p>37-mm metal case with glass dial window</p><p>Quartz movement with analog display</p><p>Metal alloy bracelet with jewelry-clasp closure</p><p>Not water resistant</p><p><p>Great timepiece for Disney Mickey Mouse fans! This spray white bracelet watch features round case with clear rhinestone accented, genuine white Mother-Of-Pearl dial, Arabic number 12,3,9 and dots display and jewelry clasp. Cute rhinestone accented Mickey Mouse image on dial. It is also powered by quartz movement that tells you the accurate time. It is casual and fashionable that is nice for everyday wear.</p></p>",
  "market_price": 1,
  "attributes": {
    "bulky": 1,
    "origin": "my",
    "product_top_features": "White bracelet watch featuring rhinestone-accented bezel and mother-of-pearl dial with sparkling Mickey Mouse designn37-mm metal case with glass dial windownQuartz movement with analog displaynMetal alloy bracelet with jewelry-clasp closurenNot water resistantn",
    "brand": "Disney",
    "case_diameter": "37 millimeters",
    "filter_case_diameter": "37 millimeters",
    "band_material": "metal-alloy",
    "filter_band_material": "metal-alloy",
    "brand_origin": "viet nam",
    "require_expiry_date": 1
  },
  "image": "https://images-na.ssl-images-amazon.com/images/I/715uwlmCWsL.jpg",
  "images": [
    "https://images-na.ssl-images-amazon.com/images/I/6110JInm%2BBL.jpg",
    "https://images-na.ssl-images-amazon.com/images/I/41FuQMh3FUL.jpg"
  ],
  "option_attributes": [],
  "variants": [
    {
      "sku": "B0055QD0EC11",
      "price": 984000,
      "market_price": 984000,
      "inventory_type": "cross_border",
      "seller_warehouse": "1054,1233",
      "quantity": 100,
      "brand_origin": "viet nam",
      "image": "https://images-na.ssl-images-amazon.com/images/I/715uwlmCWsL.jpg",
      "images": [
        "https://images-na.ssl-images-amazon.com/images/I/6110JInm%2BBL.jpg",
        "https://images-na.ssl-images-amazon.com/images/I/41FuQMh3FUL.jpg"
      ]
    }
  ],
  "meta_data": {
     "is_auto_turn_on": false
   }
}

Configurable product example:

{
  "category_id": 21458,
  "name": "Disney Women's MK2106 Mickey Mouse White Bracelet Watch with Rhinestones",
  "description": "<style>rn#productDetails_techSpec_section_2{width:70%;}rn#prodDetails .prodDetSectionEntry {width: 50%!important;white-space: normal;word-wrap: break-word;}rntable.a-keyvalue th {background-color: #f3f3f3;}rntable.a-keyvalue td, table.a-keyvalue th {padding: 7px 14px 6px;border-top: 1px solid #e7e7e7;}rn#prodDetails th {text-align: left;}rntable.a-keyvalue{border-bottom: 1px solid #e7e7e7;}rn</style><div id="prodDetails"><table id="productDetails_techSpec_section_2" class="a-keyvalue prodDetTable" role="presentation"><tbody><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Item Shape</th><td class="a-size-base">Round</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Display Type</th><td class="a-size-base">Analog</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Case material</th><td class="a-size-base">Metal</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Case diameter</th><td class="a-size-base">37 millimeters</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Band Material</th><td class="a-size-base">metal-alloy</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Band length</th><td class="a-size-base">Women&#039;s Standard</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Band width</th><td class="a-size-base">18 millimeters</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Band Color</th><td class="a-size-base">White</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Dial color</th><td class="a-size-base">White</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Bezel material</th><td class="a-size-base">Metal</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Brand, Seller, or Collection Name</th><td class="a-size-base">Disney</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Model number</th><td class="a-size-base">MK2106</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Part Number</th><td class="a-size-base">MK2106</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Case Thickness</th><td class="a-size-base">9.3 millimeters</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Special features</th><td class="a-size-base">includes a seconds-hand</td></tr></tbody></table></div><p></p><p>White bracelet watch featuring rhinestone-accented bezel and mother-of-pearl dial with sparkling Mickey Mouse design</p><p>37-mm metal case with glass dial window</p><p>Quartz movement with analog display</p><p>Metal alloy bracelet with jewelry-clasp closure</p><p>Not water resistant</p><p><p>Great timepiece for Disney Mickey Mouse fans! This spray white bracelet watch features round case with clear rhinestone accented, genuine white Mother-Of-Pearl dial, Arabic number 12,3,9 and dots display and jewelry clasp. Cute rhinestone accented Mickey Mouse image on dial. It is also powered by quartz movement that tells you the accurate time. It is casual and fashionable that is nice for everyday wear.</p></p>",
  "market_price": 1,
  "attributes": {
    "bulky": 1,
    "origin": "my",
    "product_top_features": "White bracelet watch featuring rhinestone-accented bezel and mother-of-pearl dial with sparkling Mickey Mouse designn37-mm metal case with glass dial windownQuartz movement with analog displaynMetal alloy bracelet with jewelry-clasp closurenNot water resistantn",
    "brand": "Disney",
    "case_diameter": "37 millimeters",
    "filter_case_diameter": "37 millimeters",
    "band_material": "metal-alloy",
    "filter_band_material": "metal-alloy",
    "brand_origin": "viet nam",
    "require_expiry_date": 1
  },
  "image": "https://images-na.ssl-images-amazon.com/images/I/715uwlmCWsL.jpg",
  "images": [
    "https://images-na.ssl-images-amazon.com/images/I/6110JInm%2BBL.jpg",
    "https://images-na.ssl-images-amazon.com/images/I/41FuQMh3FUL.jpg"
  ],
  "option_attributes": [
    "color"
  ],
  "variants": [
    {
      "sku": "B0055QD0EC11",
      "price": 984000,
      "market_price": 984000,
      "option1": "Black",
      "inventory_type": "cross_border",
      "seller_warehouse": "1054,1233",
      "quantity": 100,
      "brand_origin": "viet nam",
      "image": "https://images-na.ssl-images-amazon.com/images/I/715uwlmCWsL.jpg",
      "images": [
        "https://images-na.ssl-images-amazon.com/images/I/6110JInm%2BBL.jpg",
        "https://images-na.ssl-images-amazon.com/images/I/41FuQMh3FUL.jpg"
      ]
    }
  ],
  "meta_data": {
     "is_auto_turn_on": false
   }
}

Notes: To understand the relation between variant and it’s product parent please read the detail from: Variant Notes: Your product request on Sandbox will get auto approved by our scripts if it change to awaiting_approve state, so you can process testing integration flow with product endpoints. But it’s not true on production

Request

You must complete all required attribute from category, all others can be ignored or pass null value

Headers	Content-type	application/json
tiki-api	seller token key (contact Tiki supporter)
Path Parameters	Name	Type	Mandatory	Example	Description
Body Parameters	Namespace	Field	Type	Mandatory	Example	Description
	Root	Product(*)	Y	below	product detail to create

Response

Response body:

{
    "track_id": "c3587ec50976497f837461e0c2ea3da5",
    "state": "queuing"
}

Field	Type	Example	Description
track_id	String	c3587ec50976497f837461e0c2ea3da5	track_id to tracking this request
state	String	queuing	current state of your request

Exception Case:

Configurable Product have invalid payload (missing option2 value & price in sku2)

Request body

{
  "category_id": 1846,
  "name": "Samsung Galaxy Note 10+",
  "description": "this is description",
  "market_price": 10000000,
  "attributes": {
    "ram": "16GB",
    "ram_type": "Built-in",
    "bus": "1666hz",
    "camera": "",
    "audio_technology": "",
    "hard_drive": "",
    "connection_port": "",
    "brand": "Samsung"
  },
  "image": "http://cdn.fptshop.com.vn/Uploads/Originals/2019/8/9/637009754161317464_samsung-galaxy-note-10-plus-1.jpg",
  "images": [
    "http://cdn.fptshop.com.vn/Uploads/Originals/2019/8/9/637009754161387464_samsung-galaxy-note-10-plus-9.jpg",
    "http://cdn.fptshop.com.vn/Uploads/Originals/2019/8/9/637009754164217464_samsung-galaxy-note-10-plus.jpg"
  ],
  "option_attributes": [
    "color",
    "storage"
  ],
  "variants": [
    {
      "sku": "sku1",
      "quantity": 21,
      "option1": "Black",
      "option2": "32GB",
      "price": 10000001,
      "inventory_type": "cross_border",
      "seller_warehouse": "1054,1233",
      "image": "https://cdn.fptshop.com.vn/Uploads/Originals/2019/8/8/637008711602926121_SS-note-10-pl-den-1-1.png",
      "images": [
        "https://cdn.fptshop.com.vn/Uploads/Originals/2019/8/8/637008619323404785_SS-note-10-pl-den-2.png",
        "https://cdn.fptshop.com.vn/Uploads/Originals/2019/8/8/637008619327294396_SS-note-10-pl-den-4.png"
      ]
    },
    {
      "sku": "sku2",
      "quantity": 22,
      "option1": "White",
      "inventory_type": "cross_border",
      "seller_warehouse": "1054,1233",
      "image": "https://cdn.fptshop.com.vn/Uploads/Originals/2019/8/8/637008710284136121_SS-note-10-pl-trang-1-1.png",
      "images": [
        "https://cdn.fptshop.com.vn/Uploads/Originals/2019/8/8/637008624715439429_SS-note-10-pl-trang-2.png",
        "https://cdn.fptshop.com.vn/Uploads/Originals/2019/8/8/637008624715279445_SS-note-10-pl-trang-3.png"
      ]
    }
  ]
}

Response body:

{
    "errors": [
        "variants don't match with option_attributes => variants option2 missing",
        "variants should have price > 0"
    ]
}

HTTP Code	message	Description
500	Internal server error	having error in server, can’t serving
400	Bad request	missing header or required params
401	Unauthorized	your tiki-api token is not valid
404	Not found	Attributes not found for category_id in payload
422	Unprocessable Entity	Payload is missing or invalid field
429	Too Many Requests	Your rate limit is exceed

Create Product Request (v2.1)

HTTP Request

POST

https://api.tiki.vn/integration/v2.1/requests

Create new product request. The new version API support multiple warehouse stock.

Simple product example:

{
  "category_id": 21458,
  "name": "Disney Women's MK2106 Mickey Mouse White Bracelet Watch with Rhinestones",
  "description": "<style>rn#productDetails_techSpec_section_2{width:70%;}rn#prodDetails .prodDetSectionEntry {width: 50%!important;white-space: normal;word-wrap: break-word;}rntable.a-keyvalue th {background-color: #f3f3f3;}rntable.a-keyvalue td, table.a-keyvalue th {padding: 7px 14px 6px;border-top: 1px solid #e7e7e7;}rn#prodDetails th {text-align: left;}rntable.a-keyvalue{border-bottom: 1px solid #e7e7e7;}rn</style><div id="prodDetails"><table id="productDetails_techSpec_section_2" class="a-keyvalue prodDetTable" role="presentation"><tbody><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Item Shape</th><td class="a-size-base">Round</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Display Type</th><td class="a-size-base">Analog</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Case material</th><td class="a-size-base">Metal</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Case diameter</th><td class="a-size-base">37 millimeters</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Band Material</th><td class="a-size-base">metal-alloy</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Band length</th><td class="a-size-base">Women&#039;s Standard</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Band width</th><td class="a-size-base">18 millimeters</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Band Color</th><td class="a-size-base">White</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Dial color</th><td class="a-size-base">White</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Bezel material</th><td class="a-size-base">Metal</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Brand, Seller, or Collection Name</th><td class="a-size-base">Disney</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Model number</th><td class="a-size-base">MK2106</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Part Number</th><td class="a-size-base">MK2106</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Case Thickness</th><td class="a-size-base">9.3 millimeters</td></tr><tr><th class="a-color-secondary a-size-base prodDetSectionEntry">Special features</th><td class="a-size-base">includes a seconds-hand</td></tr></tbody></table></div><p></p><p>White bracelet watch featuring rhinestone-accented bezel and mother-of-pearl dial with sparkling Mickey Mouse design</p><p>37-mm metal case with glass dial window</p><p>Quartz movement with analog display</p><p>Metal alloy bracelet with jewelry-clasp closure</p><p>Not water resistant</p><p><p>Great timepiece for Disney Mickey Mouse fans! This spray white bracelet watch features round case with clear rhinestone accented, genuine white Mother-Of-Pearl dial, Arabic number 12,3,9 and dots display and jewelry clasp. Cute rhinestone accented Mickey Mouse image on dial. It is also powered by quartz movement that tells you the accurate time. It is casual and fashionable that is nice for everyday wear.</p></p>",
  "market_price": 1,
  "attributes": {
    "bulky": 1,
    "origin": "my",
    "product_top_features": "White bracelet watch featuring rhinestone-accented bezel and mother-of-pearl dial with sparkling Mickey Mouse designn37-mm metal case with glass dial windownQuartz movement with analog displaynMetal alloy bracelet with jewelry-clasp closurenNot water resistantn",
    "brand": "Disney",
    "case_diameter": "37 millimeters",
    "filter_case_diameter": "37 millimeters",
    "band_material": "metal-alloy",
    "filter_band_material": "metal-alloy",
    "brand_origin": "viet nam",
    "require_expiry_date": 1
  },
  "image": "https://images-na.ssl-images-amazon.com/images/I/715uwlmCWsL.jpg",
  "images": [
    "https://images-na.ssl-images-amazon.com/images/I/6110JInm%2BBL.jpg",
    "https://images-na.ssl-images-amazon.com/images/I/41FuQMh3FUL.jpg"
  ],
  "option_attributes": [],
  "variants": [
    {
      "sku": "B0055QD0EC11",
      "min_code": 124235,
      "price": 984000,
      "market_price": 984000,
      "inventory_type": "cross_border",
      "seller_warehouse": "1054,1233",
      "warehouse_stocks": [
                {
                    "warehouseId": 1054,
                    "qtyAvailable": 3
                },
                {
                    "warehouseId": 1233,
                    "qtyAvailable": 5
                }
            ],
      "brand_origin": "viet nam",
      "image": "https://images-na.ssl-images-amazon.com/images/I/715uwlmCWsL.jpg",
      "images": [
        "https://images-na.ssl-images-amazon.com/images/I/6110JInm%2BBL.jpg",
        "https://images-na.ssl-images-amazon.com/images/I/41FuQMh3FUL.jpg"
      ]
    }
  ],
  "meta_data": {
     "is_auto_turn_on": false
   }
}

Configurable product example:

{
    "category_id": 21458,
    "name": "Disney Women's MK2106 Mickey Mouse White Bracelet Watch with Rhinestones",
    "description": "this is description",
    "market_price": 100000,
    "attributes": {
        "bulky": 0,
        "origin": "american",
        "brand_origin": "casio",
        "product_top_features": "White bracelet watch featuring rhinestone-accented bezel and mother-of-pearl dial with sparkling Mickey Mouse designn37-mm metal case with glass dial windownQuartz movement with analog displaynMetal alloy bracelet with jewelry-clasp closurenNot water resistantn",
        "brand": "Disney",
        "case_diameter": "37 millimeters",
        "filter_case_diameter": "37 millimeters",
        "band_material": "metal-alloy",
        "filter_band_material": "metal-alloy"
    },
    "image": "https://images-na.ssl-images-amazon.com/images/I/715uwlmCWsL.jpg",
    "images": [
        "https://images-na.ssl-images-amazon.com/images/I/6110JInm%2BBL.jpg",
        "https://images-na.ssl-images-amazon.com/images/I/41FuQMh3FUL.jpg"
    ],
    "option_attributes": [
        "size",
        "color"
    ],
    "variants": [
        {
            "sku": "B0055QD0EC2",
            "min_code": 12847234,
            "price": 99000,
            "option1": "XL",
            "option2": "red",
            "inventory_type": "cross_border",
            "seller_warehouse": "1054,1233",
            "warehouse_stocks": [
                {
                    "warehouseId": 1054,
                    "qtyAvailable": 3
                },
                {
                    "warehouseId": 1233,
                    "qtyAvailable": 5
                }
            ],
            "image": "https://images-na.ssl-images-amazon.com/images/I/715uwlmCWsLBY.jpg"
        },
        {
            "sku": "B0055QD0EC3",
            "min_code": 124723424,
            "price": 99000,
            "option1": "L",
            "option2": "red",
            "inventory_type": "cross_border",
            "seller_warehouse": "1054,1233",
            "warehouse_stocks": [
                {
                    "warehouseId": 1054,
                    "qtyAvailable": 31
                },
                {
                    "warehouseId": 1233,
                    "qtyAvailable": 15
                }
            ],
            "image": "https://images-na.ssl-images-amazon.com/images/I/715uwlmCWsLBX.jpg"
        }
    ],
      "certificate_files": [
          {
              "url": "https://i.pinimg.com/236x/16/83/c3/1683c385af85d756f8fab83a93d48063.jpg",
              "type": "brand"
          },
          {
              "url": "https://kenh14cdn.com/2020/7/15/legialinhmeo672472714514751590239205770621637245080975n-15948258251531626115845.jpg",
              "type": "category",
              "document_id": 17
          },
          {
              "url": "https://i.pinimg.com/236x/16/83/c3/1683c385af85d756f8fab83a93d48063.jpg",
              "type": "category",
              "document_id": 18
          }
      ],
      "meta_data": {
        "is_auto_turn_on": false
      }
}

Notes: To understand the relation between variant and it’s product parent please read the detail from: Variant Notes: Your product request on Sandbox will get auto approved by our scripts if it change to awaiting_approve state, so you can process testing integration flow with product endpoints. But it’s not true on production

Request

You must complete all required attribute from category, all others can be ignored or pass null value

Headers	Content-type	application/json
tiki-api	seller token key (contact Tiki supporter)
Path Parameters	Name	Type	Mandatory	Example	Description
Body Parameters	Namespace	Field	Type	Mandatory	Example	Description
	Root	Product(*)	Y	below	product detail to create

Response

Response body:

{
    "track_id": "c3587ec50976497f837461e0c2ea3da5",
    "state": "queuing"
}

Field	Type	Example	Description
track_id	String	c3587ec50976497f837461e0c2ea3da5	track_id to tracking this request
state	String	queuing	current state of your request

Exception Case:

Configurable Product have invalid payload (missing option2 value & price in sku2)

Request body

{
  "category_id": 1846,
  "name": "Samsung Galaxy Note 10+",
  "description": "this is description",
  "market_price": 10000000,
  "attributes": {
    "ram": "16GB",
    "ram_type": "Built-in",
    "bus": "1666hz",
    "camera": "",
    "audio_technology": "",
    "hard_drive": "",
    "connection_port": "",
    "brand": "Samsung"
  },
  "image": "http://cdn.fptshop.com.vn/Uploads/Originals/2019/8/9/637009754161317464_samsung-galaxy-note-10-plus-1.jpg",
  "images": [
    "http://cdn.fptshop.com.vn/Uploads/Originals/2019/8/9/637009754161387464_samsung-galaxy-note-10-plus-9.jpg",
    "http://cdn.fptshop.com.vn/Uploads/Originals/2019/8/9/637009754164217464_samsung-galaxy-note-10-plus.jpg"
  ],
  "option_attributes": [
    "color",
    "storage"
  ],
  "variants": [
    {
      "sku": "sku1",
      "warehouse_stocks": [
                {
                    "warehouseId": 1054,
                    "qtyAvailable": 3
                },
                {
                    "warehouseId": 1233,
                    "qtyAvailable": 5
                }
            ],
      "option1": "Black",
      "option2": "32GB",
      "price": 10000001,
      "inventory_type": "cross_border",
      "seller_warehouse": "1054,1233",
      "image": "https://cdn.fptshop.com.vn/Uploads/Originals/2019/8/8/637008711602926121_SS-note-10-pl-den-1-1.png",
      "images": [
        "https://cdn.fptshop.com.vn/Uploads/Originals/2019/8/8/637008619323404785_SS-note-10-pl-den-2.png",
        "https://cdn.fptshop.com.vn/Uploads/Originals/2019/8/8/637008619327294396_SS-note-10-pl-den-4.png"
      ]
    },
    {
      "sku": "sku2",
      "warehouse_stocks": [
                {
                    "warehouseId": 1054,
                    "qtyAvailable": 3
                },
                {
                    "warehouseId": 1233,
                    "qtyAvailable": 15
                }
            ],
      "option1": "White",
      "inventory_type": "cross_border",
      "seller_warehouse": "1054,1233",
      "image": "https://cdn.fptshop.com.vn/Uploads/Originals/2019/8/8/637008710284136121_SS-note-10-pl-trang-1-1.png",
      "images": [
        "https://cdn.fptshop.com.vn/Uploads/Originals/2019/8/8/637008624715439429_SS-note-10-pl-trang-2.png",
        "https://cdn.fptshop.com.vn/Uploads/Originals/2019/8/8/637008624715279445_SS-note-10-pl-trang-3.png"
      ]
    }
  ]
}

Response body:

{
    "errors": [
        "variants don't match with option_attributes => variants option2 missing",
        "variants should have price > 0"
    ]
}

HTTP Code	message	Description
500	Internal server error	having error in server, can’t serving
400	Bad request	missing header or required params
401	Unauthorized	your tiki-api token is not valid
404	Not found	Attributes not found for category_id in payload
422	Unprocessable Entity	Payload is missing or invalid field
429	Too Many Requests	Your rate limit is exceed

Tracking latest product request

HTTP Request

GET

https://api.tiki.vn/integration/v2/tracking

Tracking latest request of user (via token)

Response body:

[
  {
    "track_id": "097c43fb664448eba4dfb410b323b615",
    "state": "approved",
    "reason": "",
    "request_id": "1121456196340384958"
  },
  {
    "track_id": "06e9fffedf3b4a179ccca85d2aa6f70b",
    "state": "awaiting_approve",
    "reason": "",
    "request_id": "1121448919994696893"
  },
  {
    "track_id": "4cd90cf9294047c9984c1a7f6a1c67de",
    "state": "approved",
    "reason": "",
    "request_id": "1121447935453136060"
  },
  {
    "track_id": "8c526ef8f8504f30ad330682d07a10a7",
    "state": "rejected",
    "reason": "{"errors":[{"code":420,"data":null,"description":"Product code B0055QD0EC2 is not unique","msg":"Mã seller product không duy nhất","msg_eng":"Seller product code is not unique"}],"message":"Mã seller product không duy nhất","trace_id":null}"
  }
]

Request

Headers	Content-type	application/json
	tiki-api	seller token key (contact Tiki supporter)
Path Parameters	Name	Type	Mandatory	Example	Description
Query Parameters	Name	Type	Mandatory	Example	Description
	limit	Integer	N	50	return up to this many requests
	created_at_min	String	N	2019-06-27 10:47:34	Show request created after date (format as example)
	created_at_max	String	N	2019-06-27 10:47:34	Show request created before date (format as example)
	updated_at_min	String	N	2019-06-27 10:47:34	Show request updated after date (format as example)
	updated_at_max	String	N	2019-06-27 10:47:34	Show request created before date (format as example)

Response

Field	Type	Description
root	List<Request>	list filtered request match with request params

Entity : Request

Field	Type	Example	Description	Note
track_id	String	c3587ec50976497f837461e0c2ea3da5	track_id to tracking this request
state	String	processing	current state of your request
reason	String	Image does not match product name	the reason why your request is rejected	only rejected request have reason
request_id	String	1121447935453136060	request_id when product request created successfully	once product request created successfully

State list

State	Description
queuing	request is in queue, waiting for processing
processing	request is transforming to tiki format
drafted	TIKI product request created, ready to review
bot_awaiting_approve	TIKI reviewing request by bot
md_awaiting_approve	TIKI reviewing required document ( by category )
awaiting_approve	request waiting for approving, we need to take a look
approved	request is approved, product created successfully
rejected	request is rejected, use tracking API for more information
deleted	request is deleted, no more available in system

Exception Case

HTTP Code	message	Description
500	Internal server error	having error in server, can’t serving
400	Bad request	missing header or required params
401	Unauthorized	your tiki-api token is not valid
429	Too Many Requests	Your rate limit is exceed

---

Tracking a product request

HTTP Request

GET

https://api.tiki.vn/integration/v2/tracking/{track_id}

Retrieve detail of a single request

Response body:

{
  "track_id": "4cd90cf9294047c9984c1a7f6a1c67de",
  "request_id": "1121447935453136060",
  "state": "approved",
  "reason": ""
}

Request

Headers	Content-type	application/json
	tiki-api	seller token key ( contact Tiki supporter )
Path Parameters	Name	Type	Mandatory	Example	Description
	track_id	String	Y	c3587ec50976497f837461e0c2ea3da5	track_id of request get from product API

Response

Field	Type	Example	Description	Note
track_id	String	c3587ec50976497f837461e0c2ea3da5	track_id to tracking this request
state	String	processing	current state of your request
reason	String	Image does not match product name	the reason why your request is rejected	only rejected request have reason
request_id	String	2150725160607	request_id when product request created successfully	once product request created successfully

State list

State	Description
queuing	request is in queue, waiting for processing
processing	request is transforming to tiki format
drafted	TIKI product request created, ready to review
bot_awaiting_approve	TIKI reviewing request by bot
md_awaiting_approve	TIKI reviewing required document ( by category )
awaiting_approve	request waiting for approving, we need to take a look
approved	request is approved, product created successfully
rejected	request is rejected, use tracking API for more information
deleted	request is deleted, no more available in system

Exception Case

HTTP Code	message	Description
500	Internal server error	having error in server, can’t serving
400	Bad request	missing header or required params
401	Unauthorized	your tiki-api token is not valid
404	Not found	track_id is invalid
429	Too Many Requests	Your rate limit is exceed

---

Replay a product request

HTTP Request

POST

https://api.tiki.vn/integration/v2/tracking/{track_id}/replay

Replay process of a product request from the beginning

Response body:

{
  "track_id": "4cd90cf9294047c9984c1a7f6a1c67de",
  "state": "queuing"
}

Request

Headers	Content-type	application/json
	tiki-api	seller token key ( contact Tiki supporter )
Path Parameters	Name	Type	Mandatory	Example	Description
	track_id	String	Y	4cd90cf9294047c9984c1a7f6a1c67de	track_id of request get from product API

Response

Field	Type	Example	Description	Note
track_id	String	4cd90cf9294047c9984c1a7f6a1c67de	track_id to tracking this request
state	String	queuing	current state of your request

Exception Case

HTTP Code	message	Description
500	Internal server error	having error in server, can’t serving
400	Bad request	missing header or required params
401	Unauthorized	your tiki-api token is not valid
404	Not found	track_id is invalid
429	Too Many Requests	Your rate limit is exceed

---

Update variant price/quantity/active (v2.0)

⚠️ Deprecate from 2022 January 05

Update non validate fields like price/quantity/active of a created product.

It can update by your original_sku OR product_id in TIKI system.

Note: With products which contained by TIKI warehouse (inventory_type = instock), seller can not update stock info.

See request body for more details.

HTTP Request

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

Header

Key	Description
tiki-api	seller token key (contact Tiki supporter)

Request body

{
  "original_sku" : "xxx-yyy-123",
  "product_id": 2166152,
  "price": 100000,
  "quantity": 20,
  "active": 1
}

Name	Type	Mandatory	Example	Default value	Description
Variant
_original_sku	String	N	xxx-yyy-123	N/A	The original sku from your side system
_product_id	String	N	2166152	N/A	The product id in TIKI system
_price	Integer	N	10000	N/A	product’s new price
_quantity	String	N	10	N/A	product’s new quantity
_active	Integer	N	1	N/A	product ‘s new status (1=active / 0=inactive)

Response

{
   "state": "approved"
}

Field	Type	Example	Description
state	String	approved	your product is updated successfully

Exception Case

{
    "errors": [
        "Price is not valid because less than ten percent listing price"
    ]
}

HTTP Code	message	Description
500	Internal server error	having error in server, can’t serving
400	Bad request	your request is invalid
401	Unauthorized	your tiki-api token is not valid
403	Forbidden	your tiki-api token do not have permission to perform
422	Unprocessable Entity	your request body have invalid value
429	Too Many Requests	Your rate limit is exceed

Update variant price/quantity/active (v2.1)

HTTP Request

PUT

https://api.tiki.vn/integration/v2.1/products/updateSku

The new API update non validate fields like price/quantity/active of a created product. That support multiple warehouse stock

It can update by your original_sku OR product_id in TIKI system.

Note: With products which contained by TIKI warehouse (inventory_type = instock), seller can not update stock info.

See request body for more details.

PUT https://api.tiki.vn/integration/v2.1/products/updateSku

{
  "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
         }
  ]
}

Response body:

{
   "state": "approved"
}

Header

Key	Description
tiki-api	seller token key (contact Tiki supporter)

Request body

Name	Type	Mandatory	Example	Default value	Description
Variant
_original_sku	String	N	xxx-yyy-123	N/A	The original sku from your side system
_product_id	String	N	2166152	N/A	The product id in TIKI system
_price	Integer	N	10000	N/A	product’s new price
_seller_warehouse	String	N	1022,1023	N/A	list seller ware house
_warehouse_quantities	array	N		N/A	list of warehouse_id and quantity available on this warehouse.
_active	Integer	N	1	N/A	product ‘s new status (1=active / 0=inactive)

Response

Field	Type	Example	Description
state	String	approved	your product is updated successfully

Example:

{
    "errors": [
        "Price is not valid because less than ten percent listing price"
    ]
}

Exception Case

HTTP Code	message	Description
500	Internal server error	having error in server, can’t serving
400	Bad request	your request is invalid
401	Unauthorized	your tiki-api token is not valid
403	Forbidden	your tiki-api token do not have permission to perform
422	Unprocessable Entity	your request body have invalid value
429	Too Many Requests	Your rate limit is exceed

Batch update seller products (v2.0)

⚠️ Deprecate from 2022 January 05

HTTP Request

PUT https://api.tiki.vn/integration/v2/products/updateSkus

Authentication

Bearer valid token of seller who owns the products

Request Body

Example

{
    "data": [
        {
            "product_id": 12345,
            "price": 12000,
            "status": 2,
            "quantity": 10
        },
        {
            "original_sku": "xxxxx-yyyy-1111",
            "price": 9000,
            "status": 1,
            "quantity": 20
        }
    ]
}

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}
quantity	number	N

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 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.

Batch update seller products (v2.1)

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
                }
            ]
        }
    ]
}

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

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 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.

Get latest products (v2.0)

⚠️ Deprecate from 2022 January 05

HTTP Request

GET https://api.tiki.vn/integration/v2/products

Get all of product (approved request) order by created_at desc (latest product)

Example

GET https://api.tiki.vn/integration/v2/products

Response body

{
  "data": [
    {
      "sku": "4833677185901",
      "master_sku": "2629421073875",
      "master_id": 2088335,
      "super_sku": "",
      "super_id": 0,
      "name": "test product name",
      "entity_type": "seller_simple",
      "type": "simple",
      "price": 20000,
      "created_at": "2019-12-09 15:25:36",
      "created_by": "admin@tiki.vn",
      "product_id": 2088336,
      "original_sku": "YOUR_ORIGINAL_SKU_123",
      "market_price": 20000,
      "version": 5,
      "thumbnail": "https://uat.tikicdn.com/ts/product/83/f7/55/81986fa898d5b864f08de0186ad0f4e1.jpg",
      "images": [
        {
          "id": 47932612,
          "url": "https://uat.tikicdn.com/ts/product/83/f7/55/81986fa898d5b864f08de0186ad0f4e1.jpg",
          "path": "product/83/f7/55/81986fa898d5b864f08de0186ad0f4e1.jpg",
          "position": 0,
          "width": 1200,
          "height": 1200
        }
      ],
      "categories": [
        {
          "id": 1789,
          "name": "Điện Thoại - Máy Tính Bảng",
          "url_key": "dien-thoai-may-tinh-bang",
          "is_primary": false
        },
        {
          "id": 1795,
          "name": "Điện thoại smartphone",
          "url_key": "dien-thoai-smartphone",
          "is_primary": true
        }
      ]
    }
  ],
  "paging": {
    "total": 1,
    "current_page": 1,
    "from": 0,
    "to": 20,
    "per_page": 20,
    "last_page": 1
  }
}

Request

Headers	Content-type	application/json
	tiki-api	seller token key (contact Tiki supporter)
Body Parameters	Name	Type	Mandatory	Description
	name	String	N	name of product (full text search)
	active	Integer	N	current active of products that you want to filter ( 1 = active , 0 = inactive )
	category_id	Integer	N	id of the primary category you want to filter
	include	List	N	extra information you want to add to product ( ex : inventory )
	page	Integer	N	move to the page you choose in the data set, default 1
	limit	Integer	N	number result per page, default 20
	created_from_date	String	N	products created_at >= this time
	created_to_date	String	N	products created_at <= this time
	updated_from_date	String	N	products updated_at >= this time
	updated_to_date	String	N	products updated_at <= this time

Response

Field	Type	Example	Description
data	List<Product>	see more detail below	list query result
paging	Paging	see more detail below	page information of this query

Exception Case

HTTP Code	message	Description
500	Internal server error	having error in server, can’t serving
400	Bad request	your request is invalid
429	Too Many Requests	Your rate limit is exceed

Get latest products (v2.1)

HTTP Request

GET

https://api.tiki.vn/integration/v2.1/products

Get all of product (approved request) order by created_at desc (latest product). The new version API support multiple warehouse stock.

Example

GET https://api.tiki.vn/integration/v2.1/products?include=inventory

Response body

{
  "data": [
    {
      "sku": "4833677185901",
      "master_sku": "2629421073875",
      "master_id": 2088335,
      "super_sku": "",
      "super_id": 0,
      "name": "test product name",
      "entity_type": "seller_simple",
      "type": "simple",
      "price": 20000,
      "created_at": "2019-12-09 15:25:36",
      "created_by": "admin@tiki.vn",
      "product_id": 2088336,
      "original_sku": "YOUR_ORIGINAL_SKU_123",
      "market_price": 20000,
      "version": 5,
      "thumbnail": "https://uat.tikicdn.com/ts/product/83/f7/55/81986fa898d5b864f08de0186ad0f4e1.jpg",
      "images": [
        {
          "id": 47932612,
          "url": "https://uat.tikicdn.com/ts/product/83/f7/55/81986fa898d5b864f08de0186ad0f4e1.jpg",
          "path": "product/83/f7/55/81986fa898d5b864f08de0186ad0f4e1.jpg",
          "position": 0,
          "width": 1200,
          "height": 1200
        }
      ],
      "categories": [
        {
          "id": 1789,
          "name": "Điện Thoại - Máy Tính Bảng",
          "url_key": "dien-thoai-may-tinh-bang",
          "is_primary": false
        },
        {
          "id": 1795,
          "name": "Điện thoại smartphone",
          "url_key": "dien-thoai-smartphone",
          "is_primary": true
        }
      ],
      "inventory": {
          "inventory_type": "backorder",
          "fulfillment_type": "tiki_delivery",
          "warehouse_stocks": [
              {
                  "warehouse_id": 1034,
                  "quantity": 37,
                  "quantity_available": 37,
                  "quantity_sellable": 37,
                  "quantity_reserved": -37
              }
          ]
      }
    }
  ],
  "paging": {
    "total": 1,
    "current_page": 1,
    "from": 0,
    "to": 20,
    "per_page": 20,
    "last_page": 1
  }
}

Request

Headers	Content-type	application/json
	tiki-api	seller token key (contact Tiki supporter)
Body Parameters	Name	Type	Mandatory	Description
	name	String	N	name of product (full text search)
	active	Integer	N	current active of products that you want to filter ( 1 = active , 0 = inactive )
	category_id	Integer	N	id of the primary category you want to filter
	include	List	N	extra information you want to add to product ( ex : inventory )
	page	Integer	N	move to the page you choose in the data set, default 1
	limit	Integer	N	number result per page, default 20
	created_from_date	String	N	products created_at >= this time
	created_to_date	String	N	products created_at <= this time
	updated_from_date	String	N	products updated_at >= this time
	updated_to_date	String	N	products updated_at <= this time

Response

Field	Type	Example	Description
data	List<Product>	see more detail below	list query result
paging	Paging	see more detail below	page information of this query

Exception Case

HTTP Code	message	Description
500	Internal server error	having error in server, can’t serving
400	Bad request	your request is invalid
429	Too Many Requests	Your rate limit is exceed

Get hidden products

GET

https://api.tiki.vn/integration/v2/products/getHiddenSkus

Request

Parameter	Type	Mandatory	Description
name	String	N
created_at_from	String	N	format `yyyy-MM-dd HH:mm:ss`
created_at_to	String	N	format `yyyy-MM-dd HH:mm:ss`
updated_at_from	String	N	format `yyyy-MM-dd HH:mm:ss`
updated_at_to	String	N	format `yyyy-MM-dd HH:mm:ss`
page	number	N	paging option, default 1
limit	number	N	paging option, default 20

Response

{
    "data": [
        {
            "id": 125172435,
            "sku": "9982366363741",
            "name": "Áo Khoác Nỉ Bông Chống Nắng Thêu STR Hàn Quốc Nam NữFRESHIP RẺ ĐẸP, Áo Hoodie Kiểu Thun Tay Dài Unisex Couple Jackets - COMBO2 QUẦN LEGGING - L",
            "master_id": 125172430,
            "master_sku": "1443430133268",
            "super_id": 125172289,
            "super_sku": "5713502838956",
            "original_sku": "11",
            "type": "simple",
            "entity_type": "seller_simple",
            "price": 149000,
            "market_price": 149000,
            "version": 11,
            "created_at": "2021-09-22 14:21:03",
            "created_by": "xxuongchuyensidam@gmail.com",
            "updated_at": "2021-09-22 14:23:26",
            "active": "0",
            "is_hidden": true
        },
        {
            "id": 125172425,
            "sku": "7645303871968",
            "name": "Áo Khoác Nỉ Bông Chống Nắng Thêu STR Hàn Quốc Nam NữFRESHIP RẺ ĐẸP, Áo Hoodie Kiểu Thun Tay Dài Unisex Couple Jackets - COMBO2 QUẦN LEGGING - M",
            "master_id": 125172419,
            "master_sku": "2814820551891",
            "super_id": 125172289,
            "super_sku": "5713502838956",
            "original_sku": "10",
            "type": "simple",
            "entity_type": "seller_simple",
            "price": 149000,
            "market_price": 149000,
            "version": 12,
            "created_at": "2021-09-22 14:21:03",
            "created_by": "xxuongchuyensidam@gmail.com",
            "updated_at": "2021-09-22 14:24:01",
            "active": "0",
            "is_hidden": true
        },
        {
            "id": 125172405,
            "sku": "2245547824694",
            "name": "Áo Khoác Nỉ Bông Chống Nắng Thêu STR Hàn Quốc Nam NữFRESHIP RẺ ĐẸP, Áo Hoodie Kiểu Thun Tay Dài Unisex Couple Jackets - KEM ÁO KHOÁC HOODIE - L",
            "master_id": 125172398,
            "master_sku": "1204222324398",
            "super_id": 125172289,
            "super_sku": "5713502838956",
            "original_sku": "8",
            "type": "simple",
            "entity_type": "seller_simple",
            "price": 89000,
            "market_price": 149000,
            "version": 11,
            "created_at": "2021-09-22 14:21:03",
            "created_by": "xxuongchuyensidam@gmail.com",
            "updated_at": "2021-09-22 14:23:26",
            "active": "0",
            "is_hidden": true
        },
        {
            "id": 125172394,
            "sku": "9896597093465",
            "name": "Áo Khoác Nỉ Bông Chống Nắng Thêu STR Hàn Quốc Nam NữFRESHIP RẺ ĐẸP, Áo Hoodie Kiểu Thun Tay Dài Unisex Couple Jackets - KEM ÁO KHOÁC HOODIE - M",
            "master_id": 125172389,
            "master_sku": "6851111580195",
            "super_id": 125172289,
            "super_sku": "5713502838956",
            "original_sku": "7",
            "type": "simple",
            "entity_type": "seller_simple",
            "price": 89000,
            "market_price": 149000,
            "version": 12,
            "created_at": "2021-09-22 14:21:03",
            "created_by": "xxuongchuyensidam@gmail.com",
            "updated_at": "2021-09-22 14:23:26",
            "active": "0",
            "is_hidden": true
        },
        {
            "id": 125172370,
            "sku": "2377858171044",
            "name": "Áo Khoác Nỉ Bông Chống Nắng Thêu STR Hàn Quốc Nam NữFRESHIP RẺ ĐẸP, Áo Hoodie Kiểu Thun Tay Dài Unisex Couple Jackets - TRẮNG ÁO KHOÁC HOODI - L",
            "master_id": 125172362,
            "master_sku": "7635608980967",
            "super_id": 125172289,
            "super_sku": "5713502838956",
            "original_sku": "5",
            "type": "simple",
            "entity_type": "seller_simple",
            "price": 89000,
            "market_price": 149000,
            "version": 11,
            "created_at": "2021-09-22 14:21:03",
            "created_by": "xxuongchuyensidam@gmail.com",
            "updated_at": "2021-09-22 14:23:26",
            "active": "0",
            "is_hidden": true
        }
    ],
    "paging": {
        "total": 10000,
        "per_page": 5,
        "current_page": 1,
        "last_page": 2000,
        "from": 1,
        "to": 5
    }
}

Get a product (v2.0)

⚠️ Deprecate from 2022 January 05

GET

https://api.tiki.vn/integration/v2/products/{productId}

Request

Parameter	Type	Mandatory	Description
productId	Integer	Y	product_id of TIKI system
includes	String	N	Get more details fields. It can be seller,categories,inventory,attributes,images

Response body

Field	Type	Description
root	Product	Product details

Example

GET https://api.tiki.vn/integration/v2/products/12345?includes=seller,categories

Response body

{
    "id": 12345,
    "sku": "8935086810576",
    "name": "Hạt Giống Tâm Hồn 1- Kèm CD",
    "master_id": 324683,
    "master_sku": "2438445414768",
    "super_id": 0,
    "active": 1,
    "is_hidden": false,
    "type": "simple",
    "entity_type": "seller_simple",
    "price": 27000,
    "market_price": 27000,
    "version": 45,
    "created_at": "2017-02-25 21:14:25",
    "updated_at": "2021-02-04 10:01:01",
    "thumbnail": "https://uat.tikicdn.com/cache/280x280/ts/h/g/hgth_-_1_1.jpg",
    "seller": {
        "id": 1,
        "name": "Tiki Trading",
        "code": "TIKI",
        "logo": "http://uat.tikicdn.com/ts/seller/0e/9d/fd/61dfb9c92f03fefbb799e829e4b54e67.jpg",
        "slug": "tiki",
        "status": 1,
        "store_id": 1,
        "listdata_id": 632463,
        "vat_limit_supported": 0,
        "is_all_vat_supported": 0
    },
    "attributes": {
        "price_restore": 14000.0,
        "small_image": "/h/g/hgth_-_1_1.jpg",
        "plastic_cover_suitable": 1,
        "support_p24h": 0,
        "gift_message_available": "4",
        "custom_design": "4",
        "specifications": [
            {
                "id": 2077,
                "name": "General",
                "attributes": [
                    {
                        "id": 59,
                        "code": "sku",
                        "name": "Sku",
                        "display_name": "SKU",
                        "data_type": "static",
                        "input_type": "text",
                        "value": "8935086810576"
                    }
                ],
                "sort_order": 1
            },
            {
                "id": 2079,
                "name": "Thông tin chi tiết",
                "attributes": [
                    {
                        "id": 497,
                        "code": "dimensions",
                        "name": "Kích thước",
                        "display_name": "Kích thước",
                        "data_type": "text",
                        "input_type": "textarea",
                        "value": "13 x 20.5"
                    }
                ],
                "sort_order": 3
            }
        ],
        "cover": "Bìa mềm",
        "price": 27000.0,
        "supplier": {
            "id": 1453707,
            "value": " CÔNG TY CỔ PHẦN HỒNG LAM"
        },
        "special_from_date": "2017-02-17T09:22:00.000+00:00",
        "image": "/h/g/hgth_-_1_1.jpg",
        "enable_googlecheckout": 1,
        "thumbnail": "/h/g/hgth_-_1_1.jpg",
        "small_image_label": "4",
        "meta_title": "Hạt giống tâm hồn tập 1 - Kèm CD | Original",
        "visibility": 3,
        "support_cod": 1,
        "author": "4043",
        "vat": {
            "id": 1461703,
            "value": "0"
        },
        "weight": 200.0,
        "rma_status": 1331477,
        "thumbnail_label": "4",
        "is_free_gift": 1305065,
        "require_expiry_date": 0,
        "meta_description": "Hạt Giống Tâm Hồn 1- Kèm CD - Hạt Giống Tâm Hồn Tập 1 - Cho Lòng Dũng Cảm và Tình Yêu Cuộc Sống“Thân tặng tất cả những người đang trăn trở, đang vượt qua những khó khăn, ... | Original",
        "unit": {
            "id": 1461637,
            "value": "292769"
        },
        "number_of_page": "168",
        "meta_keyword": "Hạt giống tâm hồn tập 1 - Cho lòng dũng cảm và tình yêu cuộc sống, Kèm CD",
        "name": "Hạt Giống Tâm Hồn 1- Kèm CD",
        "image_label": "4",
        "translated_by": "First News",
        "location_number": "4",
        "status": 1,
        "edition": "4",
        "description": "<p style="text-align: justify;" _mce_style="text-align: justify;"><strong>Hạt Giống Tâm Hồn Tập 1 - Cho Lòng Dũng Cảm và Tình Yêu Cuộc Sống</strong><br></p><p style="text-align: justify;" _mce_style="text-align: justify;"><span style="font-size: small;" _mce_style="font-size: small;"><em>“Thân tặng tất cả những người đang trăn trở, đang vượt qua những khó khăn, thử thách tinh thần và niềm tin trong cuộc sống để đạt được ước mơ của mình”.</em></span> </p><p style="text-align: justify;" _mce_style="text-align: justify;"><span _mce_style="font-size: small;" style="font-size: small;">Cuộc sống chúng ta ra sao, luôn ngập tràn sợ hãi và oán hờn hay chấp nhận và vui sống để vươn lên sẽ tùy thuộc vào cách ta đối mặt với những khó khăn thử thách ta gặp trên con đường như thế nào.</span></p>rn<p style="text-align: justify;" _mce_style="text-align: justify;"><span style="font-size: small;" _mce_style="font-size: small;">Hai tập <em>“ <strong>Hạt giống tâm hồn cho lòng dũng cảm và tình yêu cuộc sống</strong>”</em> do First News thực hiện trong bộ sách <em>Hạt giống tâm hồn </em>này sẽ là người bạn đồng hành cùng độc giả vượt qua những khó khăn thử thách trong cuộc sống thường ngày như nỗi mất mát, nỗi đau tổn thương tinh thần, tình cảm, niềm tin, bệnh tật, những thăng trầm trên bước đường theo đuổi ước mơ của cuộc đời hay vươn lên cho cuộc sống tốt đẹp hơn.</span></p>rn<p style="text-align: justify;" _mce_style="text-align: justify;"><span style="font-size: small;" _mce_style="font-size: small;">Qua những sự kiện bất hạnh, những câu chuyện bình thường, những người bình dị, các câu chuyện đều nhấn mạnh đến tinh thần vượt lên, chiến thắng chứ không phải những điều lạ thường. bạn có thể bắt gặp câu chuyện của chính mình, của những người xung quanh hay của những người hoàn toàn xa lạ... để suy gẫm, chiêm nghiệm, khám phá và tìm thấy câu châm ngôn cuộc sống của mình!</span></p><p style="text-align: justify;" _mce_style="text-align: justify;"><span style="font-size: small;" _mce_style="font-size: small;"><strong>Mời bạn đón đọc.</strong><br></span></p>",
        "giftwrap": 1,
        "bao_sach_kho": 20750,
        "page_layout": "4",
        "publication_date": "2008-03-31T07:00:00.000+00:00",
        "is_recurring": 0,
        "special_to_date": "2017-02-28T23:59:00.000+00:00",
        "options_container": "container2",
        "url_path": "h-t-gi-ng-tam-h-n-1-kem-cd-p324683.html",
        "subtitles": "10947",
        "cost": 0.0,
        "publisher_vn": 1329031,
        "is_fresh": 0,
        "url_key": "h-t-gi-ng-tam-h-n-1-kem-cd-p324683",
        "po_type": 1329021,
        "manufacturer_book_vn": 1327858,
        "special_price": 27000.0,
        "dimensions": "13 x 20.5"
    },
    "images": [
        {
            "id": 12348871,
            "url": "https://uat.tikicdn.com/ts/h/g/hgth_-_1_1.jpg",
            "path": "/h/g/hgth_-_1_1.jpg",
            "position": 1
        }
    ],
    "categories": [
        {
            "id": 2,
            "name": "Root yyy",
            "url_key": "default-category",
            "is_primary": false
        },
        {
            "id": 316,
            "name": "Sách Tiếng Việt",
            "url_key": "sach-tieng-viet",
            "is_primary": true
        }
    ],
    "inventory": {
        "inventory_type": "instock",
        "fulfillment_type": "tiki_delivery",
        "quantity": 20,
        "quantity_available": 0,
        "quantity_reserved": -20,
        "quantity_sellable": 20
    }
}

Get a product (v2.1)

The new version API support multiple warehouse stock.

GET

https://api.tiki.vn/integration/v2.1/products/{productId}

Request

Parameter	Type	Mandatory	Description
productId	Integer	Y	product_id of TIKI system
includes	String	N	Get more details fields. It can be seller,categories,inventory,attributes,images

Response body

Field	Type	Description
root	Product	Product details

Example

GET https://api.tiki.vn/integration/v2.1/products/12345?includes=seller,categories

Response body

{
    "id": 12345,
    "sku": "8935086810576",
    "name": "Hạt Giống Tâm Hồn 1- Kèm CD",
    "master_id": 324683,
    "master_sku": "2438445414768",
    "super_id": 0,
    "active": 1,
    "is_hidden": false,
    "type": "simple",
    "entity_type": "seller_simple",
    "price": 27000,
    "market_price": 27000,
    "version": 45,
    "created_at": "2017-02-25 21:14:25",
    "updated_at": "2021-02-04 10:01:01",
    "thumbnail": "https://uat.tikicdn.com/cache/280x280/ts/h/g/hgth_-_1_1.jpg",
    "seller": {
        "id": 1,
        "name": "Tiki Trading",
        "code": "TIKI",
        "logo": "http://uat.tikicdn.com/ts/seller/0e/9d/fd/61dfb9c92f03fefbb799e829e4b54e67.jpg",
        "slug": "tiki",
        "status": 1,
        "store_id": 1,
        "listdata_id": 632463,
        "vat_limit_supported": 0,
        "is_all_vat_supported": 0
    },
    "attributes": {
        "price_restore": 14000.0,
        "small_image": "/h/g/hgth_-_1_1.jpg",
        "plastic_cover_suitable": 1,
        "support_p24h": 0,
        "gift_message_available": "4",
        "custom_design": "4",
        "specifications": [
            {
                "id": 2077,
                "name": "General",
                "attributes": [
                    {
                        "id": 59,
                        "code": "sku",
                        "name": "Sku",
                        "display_name": "SKU",
                        "data_type": "static",
                        "input_type": "text",
                        "value": "8935086810576"
                    }
                ],
                "sort_order": 1
            },
            {
                "id": 2079,
                "name": "Thông tin chi tiết",
                "attributes": [
                    {
                        "id": 497,
                        "code": "dimensions",
                        "name": "Kích thước",
                        "display_name": "Kích thước",
                        "data_type": "text",
                        "input_type": "textarea",
                        "value": "13 x 20.5"
                    }
                ],
                "sort_order": 3
            }
        ],
        "cover": "Bìa mềm",
        "price": 27000.0,
        "supplier": {
            "id": 1453707,
            "value": " CÔNG TY CỔ PHẦN HỒNG LAM"
        },
        "special_from_date": "2017-02-17T09:22:00.000+00:00",
        "image": "/h/g/hgth_-_1_1.jpg",
        "enable_googlecheckout": 1,
        "thumbnail": "/h/g/hgth_-_1_1.jpg",
        "small_image_label": "4",
        "meta_title": "Hạt giống tâm hồn tập 1 - Kèm CD | Original",
        "visibility": 3,
        "support_cod": 1,
        "author": "4043",
        "vat": {
            "id": 1461703,
            "value": "0"
        },
        "weight": 200.0,
        "rma_status": 1331477,
        "thumbnail_label": "4",
        "is_free_gift": 1305065,
        "require_expiry_date": 0,
        "meta_description": "Hạt Giống Tâm Hồn 1- Kèm CD - Hạt Giống Tâm Hồn Tập 1 - Cho Lòng Dũng Cảm và Tình Yêu Cuộc Sống“Thân tặng tất cả những người đang trăn trở, đang vượt qua những khó khăn, ... | Original",
        "unit": {
            "id": 1461637,
            "value": "292769"
        },
        "number_of_page": "168",
        "meta_keyword": "Hạt giống tâm hồn tập 1 - Cho lòng dũng cảm và tình yêu cuộc sống, Kèm CD",
        "name": "Hạt Giống Tâm Hồn 1- Kèm CD",
        "image_label": "4",
        "translated_by": "First News",
        "location_number": "4",
        "status": 1,
        "edition": "4",
        "description": "<p style="text-align: justify;" _mce_style="text-align: justify;"><strong>Hạt Giống Tâm Hồn Tập 1 - Cho Lòng Dũng Cảm và Tình Yêu Cuộc Sống</strong><br></p><p style="text-align: justify;" _mce_style="text-align: justify;"><span style="font-size: small;" _mce_style="font-size: small;"><em>“Thân tặng tất cả những người đang trăn trở, đang vượt qua những khó khăn, thử thách tinh thần và niềm tin trong cuộc sống để đạt được ước mơ của mình”.</em></span> </p><p style="text-align: justify;" _mce_style="text-align: justify;"><span _mce_style="font-size: small;" style="font-size: small;">Cuộc sống chúng ta ra sao, luôn ngập tràn sợ hãi và oán hờn hay chấp nhận và vui sống để vươn lên sẽ tùy thuộc vào cách ta đối mặt với những khó khăn thử thách ta gặp trên con đường như thế nào.</span></p>rn<p style="text-align: justify;" _mce_style="text-align: justify;"><span style="font-size: small;" _mce_style="font-size: small;">Hai tập <em>“ <strong>Hạt giống tâm hồn cho lòng dũng cảm và tình yêu cuộc sống</strong>”</em> do First News thực hiện trong bộ sách <em>Hạt giống tâm hồn </em>này sẽ là người bạn đồng hành cùng độc giả vượt qua những khó khăn thử thách trong cuộc sống thường ngày như nỗi mất mát, nỗi đau tổn thương tinh thần, tình cảm, niềm tin, bệnh tật, những thăng trầm trên bước đường theo đuổi ước mơ của cuộc đời hay vươn lên cho cuộc sống tốt đẹp hơn.</span></p>rn<p style="text-align: justify;" _mce_style="text-align: justify;"><span style="font-size: small;" _mce_style="font-size: small;">Qua những sự kiện bất hạnh, những câu chuyện bình thường, những người bình dị, các câu chuyện đều nhấn mạnh đến tinh thần vượt lên, chiến thắng chứ không phải những điều lạ thường. bạn có thể bắt gặp câu chuyện của chính mình, của những người xung quanh hay của những người hoàn toàn xa lạ... để suy gẫm, chiêm nghiệm, khám phá và tìm thấy câu châm ngôn cuộc sống của mình!</span></p><p style="text-align: justify;" _mce_style="text-align: justify;"><span style="font-size: small;" _mce_style="font-size: small;"><strong>Mời bạn đón đọc.</strong><br></span></p>",
        "giftwrap": 1,
        "bao_sach_kho": 20750,
        "page_layout": "4",
        "publication_date": "2008-03-31T07:00:00.000+00:00",
        "is_recurring": 0,
        "special_to_date": "2017-02-28T23:59:00.000+00:00",
        "options_container": "container2",
        "url_path": "h-t-gi-ng-tam-h-n-1-kem-cd-p324683.html",
        "subtitles": "10947",
        "cost": 0.0,
        "publisher_vn": 1329031,
        "is_fresh": 0,
        "url_key": "h-t-gi-ng-tam-h-n-1-kem-cd-p324683",
        "po_type": 1329021,
        "manufacturer_book_vn": 1327858,
        "special_price": 27000.0,
        "dimensions": "13 x 20.5"
    },
    "images": [
        {
            "id": 12348871,
            "url": "https://uat.tikicdn.com/ts/h/g/hgth_-_1_1.jpg",
            "path": "/h/g/hgth_-_1_1.jpg",
            "position": 1
        }
    ],
    "categories": [
        {
            "id": 2,
            "name": "Root yyy",
            "url_key": "default-category",
            "is_primary": false
        },
        {
            "id": 316,
            "name": "Sách Tiếng Việt",
            "url_key": "sach-tieng-viet",
            "is_primary": true
        }
    ],
    "inventory": {
        "inventory_type": "instock",
        "fulfillment_type": "tiki_delivery",
        "warehouse_stocks": [
            {
                "warehouse_id": 1064,
                "quantity": 12,
                "quantity_available": 12,
                "quantity_reserved": 0,
                "quantity_sellable": 12
            },
            {
                "warehouse_id": 1043,
                "quantity": 16,
                "quantity_available": 16,
                "quantity_reserved": 0,
                "quantity_sellable": 16
            }
        ]
    }
}

Get a product by original sku

HTTP Request

GET

https://api.tiki.vn/integration/{version}/products/findBy

Get a product match with seller original sku

Example

GET https://api.tiki.vn/integration/v2/products/findBy?original_sku=YOUR_ORIGINAL_SKU_123

Response body

{
  "data": [
    {
      "sku": "4833677185901",
      "master_sku": "2629421073875",
      "master_id": 2088335,
      "super_sku": "",
      "super_id": 0,
      "name": "test product name",
      "entity_type": "seller_simple",
      "type": "simple",
      "price": 20000,
      "created_at": "2019-12-09 15:25:36",
      "created_by": "admin@tiki.vn",
      "product_id": 2088336,
      "original_sku": "YOUR_ORIGINAL_SKU_123",
      "market_price": 20000,
      "version": 5,
      "thumbnail": "https://uat.tikicdn.com/ts/product/83/f7/55/81986fa898d5b864f08de0186ad0f4e1.jpg",
      "images": [
        {
          "id": 47932612,
          "url": "https://uat.tikicdn.com/ts/product/83/f7/55/81986fa898d5b864f08de0186ad0f4e1.jpg",
          "path": "product/83/f7/55/81986fa898d5b864f08de0186ad0f4e1.jpg",
          "position": 0,
          "width": 1200,
          "height": 1200
        }
      ],
      "categories": [
        {
          "id": 1789,
          "name": "Điện Thoại - Máy Tính Bảng",
          "url_key": "dien-thoai-may-tinh-bang",
          "is_primary": false
        },
        {
          "id": 1795,
          "name": "Điện thoại smartphone",
          "url_key": "dien-thoai-smartphone",
          "is_primary": true
        }
      ]
    }
  ],
  "paging": {
    "total": 1,
    "current_page": 1,
    "from": 0,
    "to": 20,
    "per_page": 20,
    "last_page": 1
  }
}

Request

Headers	Content-type	application/json
	tiki-api	seller token key (contact Tiki supporter)
Request Parameters	Name	Type	Mandatory	Description
	original_sku	Integer	Y	The original sku from seller side

Response

Field	Type	Example	Description
data	List<Product>	see more detail below	list query result
paging	Paging	see more detail below	page information of this query

Exception Case

HTTP Code	message	Description
500	Internal server error	having error in server, can’t serving
400	Bad request	your request is invalid
429	Too Many Requests	Your rate limit is exceed

Get latest product request info

HTTP Request

GET

https://api.tiki.vn/integration/{version}/requests

Get all of product requests order by created_at desc (latest request)

Example

GET https://api.tiki.vn/integration/v2/requests

If you want to move to the next page:

GET https://api.tiki.vn/integration/v2/requests?page=2

If you want to see more product information generated from the product request

GET https://api.tiki.vn/integration/v2/requests?include=products

If you want to filter by state:

GET https://api.tiki.vn/integration/v2/requests?state=approved

Response body

{
  "data": [
    {
      "request_id": "1121408707461612725",
      "state": "approved",
      "created_at": "2019-12-20 11:57:50",
      "created_by": "tran.nguyen2@tiki.vn",
      "kind": "create_product",
      "approved_at": "2019-12-20 12:11:06",
      "approved_by": "khoa.tran2@tiki.vn",
      "reasons": null,
      "products": []
    },
    {
      "request_id": "1120793560477041639",
      "state": "awaiting_approve",
      "created_at": "2019-12-18 19:13:28",
      "created_by": "tran.nguyen2@tiki.vn",
      "kind": "create_product",
      "approved_at": null,
      "approved_by": null,
      "reasons": null,
      "products": []
    }
  ],
  "paging": {
    "total": 7837,
    "current_page": 1,
    "from": 0,
    "to": 20,
    "per_page": 20,
    "last_page": 392
  }
}

Request

Headers	Content-type	application/json
	tiki-api	seller token key (contact Tiki supporter)
Request Parameters	Name	Type	Mandatory	Description
	page	Integer	N	move to the page you choose in the data set, default 1
	limit	Integer	N	number result per page, default 20
	include	List	N	list addition info you want to include in this request
	state	String	N	choose 1 from state list table

Response

Field	Type	Example	Description
data	List<Request>	see more detail below	list query result
paging	Paging	see more detail below	page information of this query

Exception Case

HTTP Code	message	Description
500	Internal server error	having error in server, can’t serving
400	Bad request	your request is invalid
429	Too Many Requests	Your rate limit is exceed

---

Update product info

HTTP Request

POST

https://api.tiki.vn/integration/{version}/requests/updateProductInfo

Update attributes , image ( thumbnail ) , images ( product media ) of product

Example

POST https://api.tiki.vn/integration/v2/requests/updateProductInfo

Request body

{
     "product_id": 2138351,
     "attributes": {
           "description": "This is description",
           "name" "Product name"
     }
     "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"
     ]
 }

Response body

{
    "track_id": "650bc7a64bf7473cbb4bc322c554f754",
    "state": "queuing"
}

Request

Headers	Content-type	application/json
	tiki-api	seller token key (contact Tiki supporter)

Response

Field	Type	Example	Description
track_id	String	c3587ec50976497f837461e0c2ea3da5	track_id to tracking this request
state	String	queuing	current state of your request

Exception Case

HTTP Code	message	Description
500	Internal server error	having error in server, can’t serving
400	Bad request	your request is invalid
404	Not found	product_id not found
429	Too Many Requests	Your rate limit is exceed

---

Update original sku

HTTP Request

POST

https://api.tiki.vn/integration/{version}/products/updateOriginalSku

Update original sku of product

Example

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

Request body

{
    "product_id": 123456,
    "original_sku":"BRAND_NEW_CODE"
}

Response body

{
   "state": "approved"
}

Request

Headers	Content-type	application/json
	tiki-api	seller token key (contact Tiki supporter)
Path Parameters	Name	Type	Mandatory	Description
	version	String	Y	version of API

Response

Field	Type	Example	Description
state	String	approved	current state of your request

Exception Case

HTTP Code	message	Description
500	Internal server error	having error in server, can’t serving
400	Bad request	your request is invalid
404	Not found	product_id not found
429	Too Many Requests	Your rate limit is exceed

Get a product request info

HTTP Request

GET

https://api.tiki.vn/integration/{version}/requests/{request_id}

Get a request ‘s information detail with request_id from TIKI system

Example

GET https://api.tiki.vn/integration/v2/requests/1121456196340384958

Response body

{
  "request_id": "1121456196340384958",
  "state": "approved",
  "created_at": "2019-12-20 15:06:32",
  "created_by": "tran.nguyen2@tiki.vn",
  "kind": "create_product",
  "approved_at": "2019-12-20 15:07:07",
  "approved_by": "khoa.tran2@tiki.vn",
  "reasons": null,
  "products": [
    {
      "product_id": 2091401,
      "sku": "2886025648971",
      "name": "Disney Women's MK2106 Mickey Mouse White Bracelet Watch with Rhinestones",
      "active": 1,
      "original_sku": "B0055QD0EC5",
      "price": 984000,
      "market_price": 984000,
      "images": [
        {
          "id": null,
          "url": "https://uat.tikicdn.com/ts/product/45/02/eb/b024dce6529a4443fb4ad58c0f914e15.jpg",
          "path": "product/45/02/eb/b024dce6529a4443fb4ad58c0f914e15.jpg",
          "position": 0,
          "width": 1335,
          "height": 2259
        },
        {
          "id": null,
          "url": "https://uat.tikicdn.com/ts/product/fa/18/d1/bd7c815ee514344cf56256eb7a3cd9d8.jpg",
          "path": "product/fa/18/d1/bd7c815ee514344cf56256eb7a3cd9d8.jpg",
          "position": 1,
          "width": 0,
          "height": 0
        }
      ],
      "categories": [
        {
          "id": 601225,
          "name": "Laptop of JD",
          "url_key": null,
          "is_primary": true
        },
        {
          "id": 601223,
          "name": "Danh mục hàng JD",
          "url_key": null,
          "is_primary": false
        },
        {
          "id": 1882,
          "name": "Điện Gia Dụng",
          "url_key": null,
          "is_primary": false
        },
        {
          "id": 2,
          "name": "Root yyy",
          "url_key": null,
          "is_primary": false
        }
      ],
      "attributes": {
        "status": {
          "attribute_code": "status",
          "value": 1,
          "input_type": null
        },
        "sku": {
          "attribute_code": "sku",
          "value": "9493225709765",
          "input_type": null
        },
        "brand": {
          "attribute_code": "brand",
          "value": 50583,
          "input_type": null
        },
        "brand_country": {
          "attribute_code": "brand_country",
          "value": 630957,
          "input_type": null
        },
        "bulky": {
          "attribute_code": "bulky",
          "value": 0,
          "input_type": null
        },
        "description": {
          "attribute_code": "description",
          "value": "<html>n <head>n  <style>rn#productDetails_techSpec_section_2{width:70%;}rn#prodDetails .prodDetSectionEntry {width: 50%!important;white-space: normal;word-wrap: break-word;}rntable.a-keyvalue th {background-color: #f3f3f3;}rntable.a-keyvalue td, table.a-keyvalue th {padding: 7px 14px 6px;border-top: 1px solid #e7e7e7;}rn#prodDetails th {text-align: left;}rntable.a-keyvalue{border-bottom: 1px solid #e7e7e7;}rn</style>n </head>n <body>n  <div id="prodDetails">n   <table id="productDetails_techSpec_section_2" class="a-keyvalue prodDetTable" role="presentation">n    <tbody>n     <tr>n      <th class="a-color-secondary a-size-base prodDetSectionEntry">Item Shape</th>n      <td class="a-size-base">Round</td>n     </tr>n     <tr>n      <th class="a-color-secondary a-size-base prodDetSectionEntry">Display Type</th>n      <td class="a-size-base">Analog</td>n     </tr>n     <tr>n      <th class="a-color-secondary a-size-base prodDetSectionEntry">Case material</th>n      <td class="a-size-base">Metal</td>n     </tr>n     <tr>n      <th class="a-color-secondary a-size-base prodDetSectionEntry">Case diameter</th>n      <td class="a-size-base">37 millimeters</td>n     </tr>n     <tr>n      <th class="a-color-secondary a-size-base prodDetSectionEntry">Band Material</th>n      <td class="a-size-base">metal-alloy</td>n     </tr>n     <tr>n      <th class="a-color-secondary a-size-base prodDetSectionEntry">Band length</th>n      <td class="a-size-base">Women's Standard</td>n     </tr>n     <tr>n      <th class="a-color-secondary a-size-base prodDetSectionEntry">Band width</th>n      <td class="a-size-base">18 millimeters</td>n     </tr>n     <tr>n      <th class="a-color-secondary a-size-base prodDetSectionEntry">Band Color</th>n      <td class="a-size-base">White</td>n     </tr>n     <tr>n      <th class="a-color-secondary a-size-base prodDetSectionEntry">Dial color</th>n      <td class="a-size-base">White</td>n     </tr>n     <tr>n      <th class="a-color-secondary a-size-base prodDetSectionEntry">Bezel material</th>n      <td class="a-size-base">Metal</td>n     </tr>n     <tr>n      <th class="a-color-secondary a-size-base prodDetSectionEntry">Brand, Seller, or Collection Name</th>n      <td class="a-size-base">Disney</td>n     </tr>n     <tr>n      <th class="a-color-secondary a-size-base prodDetSectionEntry">Model number</th>n      <td class="a-size-base">MK2106</td>n     </tr>n     <tr>n      <th class="a-color-secondary a-size-base prodDetSectionEntry">Part Number</th>n      <td class="a-size-base">MK2106</td>n     </tr>n     <tr>n      <th class="a-color-secondary a-size-base prodDetSectionEntry">Case Thickness</th>n      <td class="a-size-base">9.3 millimeters</td>n     </tr>n     <tr>n      <th class="a-color-secondary a-size-base prodDetSectionEntry">Special features</th>n      <td class="a-size-base">includes a seconds-hand</td>n     </tr>n    </tbody>n   </table>n  </div>n  <p></p>n  <p>White bracelet watch featuring rhinestone-accented bezel and mother-of-pearl dial with sparkling Mickey Mouse design</p>n  <p>37-mm metal case with glass dial window</p>n  <p>Quartz movement with analog display</p>n  <p>Metal alloy bracelet with jewelry-clasp closure</p>n  <p>Not water resistant</p>n  <p></p>n  <p>Great timepiece for Disney Mickey Mouse fans! This spray white bracelet watch features round case with clear rhinestone accented, genuine white Mother-Of-Pearl dial, Arabic number 12,3,9 and dots display and jewelry clasp. Cute rhinestone accented Mickey Mouse image on dial. It is also powered by quartz movement that tells you the accurate time. It is casual and fashionable that is nice for everyday wear.</p>n  <p></p>n </body>n</html>",
          "input_type": null
        },
        "list_price": {
          "attribute_code": "list_price",
          "value": 984000,
          "input_type": null
        },
        "meta_description": {
          "attribute_code": "meta_description",
          "value": "#productDetails_techSpec_section_2{width:70%;}rn#prodDetails .prodDetSectionEntry {width: 50%!important;white-space: normal;word-wrap: break-word;}rntable.a-keyvalue th {background-color: #f3f3f3;}rntable.a-keyvalue td, table.a-keyvalue th {padding: 7px...",
          "input_type": null
        },
        "meta_title": {
          "attribute_code": "meta_title",
          "value": "Disney Women's MK2106 Mickey Mouse White Bracelet Watch...",
          "input_type": null
        },
        "name": {
          "attribute_code": "name",
          "value": "Disney Women's MK2106 Mickey Mouse White Bracelet Watch with Rhinestones",
          "input_type": null
        },
        "url_key": {
          "attribute_code": "url_key",
          "value": "disney-women-s-mk2106-mickey-mouse-white-bracelet-watch-with-rhinestones-p2091399",
          "input_type": null
        },
        "url_path": {
          "attribute_code": "url_path",
          "value": "disney-women-s-mk2106-mickey-mouse-white-bracelet-watch-with-rhinestones-p2091399.html",
          "input_type": null
        },
        "origin": {
          "attribute_code": "origin",
          "value": 10661,
          "input_type": null
        },
        "po_type": {
          "attribute_code": "po_type",
          "value": 111134,
          "input_type": null
        },
        "price": {
          "attribute_code": "price",
          "value": 984000,
          "input_type": null
        },
        "product_top_features": {
          "attribute_code": "product_top_features",
          "value": "White bracelet watch featuring rhinestone-accented bezel and mother-of-pearl dial with sparkling Mickey Mouse designn37-mm metal case with glass dial windownQuartz movement with analog displaynMetal alloy bracelet with jewelry-clasp closurenNot water resistantn",
          "input_type": null
        },
        "require_expiry_date": {
          "attribute_code": "require_expiry_date",
          "value": 0,
          "input_type": null
        },
        "visibility": {
          "attribute_code": "visibility",
          "value": 4,
          "input_type": null
        },
        "": {
          "attribute_code": "",
          "value": null,
          "input_type": null
        },
        "image": {
          "attribute_code": "image",
          "value": "product/45/02/eb/b024dce6529a4443fb4ad58c0f914e15.jpg",
          "input_type": null
        },
        "small_image": {
          "attribute_code": "small_image",
          "value": "product/45/02/eb/b024dce6529a4443fb4ad58c0f914e15.jpg",
          "input_type": null
        },
        "thumbnail": {
          "attribute_code": "thumbnail",
          "value": "product/45/02/eb/b024dce6529a4443fb4ad58c0f914e15.jpg",
          "input_type": null
        }
      }
    }
  ]
}

Request

Headers	Content-type	application/json
	tiki-api	seller token key (contact Tiki supporter)
Path Parameters	Name	Type	Mandatory	Description
	version	String	Y	version of API
	request_id	String	Y	request_id of TIKI system

Response

Field	Type	Example	Description
data	List<Request>	see more detail below	list query result
paging	Paging	see more detail below	page information of this query

Exception Case

HTTP Code	message	Description
500	Internal server error	having error in server, can’t serving
400	Bad request	your request is invalid
429	Too Many Requests	Your rate limit is exceed

Get a product request by track id

HTTP Request

GET

https://api.tiki.vn/integration/{version}/requests/findBy

Get a product request match with track id from create new product

Example

GET https://api.tiki.vn/integration/v2/requests/findBy?track_id=8b85b2cbd7424f03af41ae5b4507eb01

Response body

{
  "data": [
    {
      "sku": "2932389999690",
      "master_sku": "2932389999690",
      "master_id": 0,
      "super_sku": "",
      "super_id": 0,
      "name": "Instock_03",
      "entity_type": "master_simple",
      "type": "simple",
      "price": 50000,
      "created_at": "2019-12-03 16:47:13",
      "created_by": "admin@tiki.vn",
      "product_id": 2087783,
      "original_sku": null,
      "request_id": "1115320939429986651",
      "state": "approved",
      "kind": "create_product",
      "approved_at": "2019-12-03 16:48:01",
      "approved_by": "admin@tiki.vn",
      "product_info": null,
      "reasons": null
    }
  ],
  "paging": {
    "total": 7837,
    "current_page": 1,
    "from": 0,
    "to": 20,
    "per_page": 20,
    "last_page": 392
  }
}

Request

Headers	Content-type	application/json
	tiki-api	seller token key (contact Tiki supporter)
Request Parameters	Name	Type	Mandatory	Description
	track_id	String	Y	track_id from create product request response

Response

Field	Type	Example	Description
data	List<Request>	see more detail below	list query result
paging	Paging	see more detail below	page information of this query

Exception Case

HTTP Code	message	Description
500	Internal server error	having error in server, can’t serving
400	Bad request	your request is invalid
429	Too Many Requests	Your rate limit is exceed

Delete a product request

HTTP Request

DEL

https://api.tiki.vn/integration/{version}/requests/{request_id}

Delete a created product request base on request_id of TIKI system

Example

DELETE https://api.tiki.vn/integration/v2/requests/1115320939429986651

Response body

{
    "request_id": "1115320939429986651",
    "state": "deleted"
}

Request

Headers	Content-type	application/json
	tiki-api	seller token key (contact Tiki supporter)
Path Parameters	Name	Type	Mandatory	Description
	request_id	String	Y	the request_id you want to delete

Response

Field	Type	Example	Description
request_id	String	1115320939429986651	the request_id you just deleted
state	String	deleted	the new state of this request

Exception Case

HTTP Code	message	Description
500	Internal server error	having error in server, can’t serving
400	Bad request	your request is invalid
429	Too Many Requests	Your rate limit is exceed

Get TIKI warehouses

HTTP Request

Example

GET https://api.tiki.vn/integration/v2/warehouses/tiki

Response body

[
    {
        "name": "Hà Nội",
        "code": "hn"
    },
    {
        "name": "Sài Gòn",
        "code": "sgn"
    },
    {
        "name": "Cần Thơ",
        "code": "ct"
    },
    {
        "name": "Đà Nẵng",
        "code": "dn"
    },
    {
        "name": "Hải Phòng",
        "code": "hp"
    },
    {
        "name": "Tân Sơn",
        "code": "ts"
    },
    {
        "name": "Nha Trang",
        "code": "nt"
    },
    {
        "name": "Vĩnh Lộc Mới",
        "code": "vln"
    },
    {
        "name": "Buffer SGN",
        "code": "bfsgn"
    },
    {
        "name": "Sai Gon 3",
        "code": "sgn3"
    },
    {
        "name": "Hà Nội 4",
        "code": "hn4"
    }
]

GET

https://api.tiki.vn/integration/{version}/warehouses/tiki

Return all the TIKI’s active warehouses.

Header

Key	Description
tiki-api	seller token key (contact Tiki supporter)

Response body

Field	Type	Example	Description
root	List<TIKI warehouse>	Click on tag for more details	The list of tiki warehouse

Exception Case

HTTP Code	Message	Description
500	Internal server error	Having error in server, can’t serving
401	Unauthorized	Your tiki-api token is not valid
429	Too Many Requests	Your rate limit is exceed

Get required documents

Request

GET http://api.tiki.vn/integration/v2/requests/requiredDocs

Params

Param	Type	Mandatory	Description
category_id	number	Y	Id of category
brand_listdata_id	number	N	List data id of brand
manufacture_listdata_id	number	N	List data id of manufacture
publisher_listdata_id	number	N	List data if of publisher

Example

GET https://api.tiki.vn/integration/v2/requests/requiredDocs?category_id=1975&brand_listdata_id=123

Response body

{
        "category": [
            {
                "id": 1,
                "name": "Giấy xác nhận công bố phù hợp quy định an toàn thực phẩm - Cục An toàn thực phẩm cấp/Sở Y tế",
                "position": 1,
                "created_at": "2018-03-12 08:15:23",
                "updated_at": "2021-03-19 15:45:47"
            },
            {
                "id": 4,
                "name": "Giấy chứng nhận hợp quy hoặc giấy tiếp nhận bản công bố hợp quy",
                "position": 4,
                "created_at": "2018-03-12 08:15:23",
                "updated_at": "2021-03-19 15:45:47"
            },
            {
                "id": 18,
                "name": "Quyết định xuất bản/ phát hành sách (Nếu Nhà bán là NXB/ phát hành) HOẶC Hợp Đồng Phân Phối kèm Hóa đơn GTGT/ Bảng kê có tựa sách  \nHoặc Giấy cam kết bảo lãnh NXB/ Công ty phát hành theo đúng mẫu Tiki (Tải tại : http://bit.ly/2qNwhBJ) (Nếu là đơn vị PP)",
                "position": 0,
                "created_at": "2019-03-27 07:42:26",
                "updated_at": "2021-03-19 15:45:47"
            }
        ],
        "brand_is_required": false
    }

Get brand by name

Example

GET https://api.tiki.vn/integration/v2/brands?name=apple

Response body

{
  "data": [
    {
      "name": "Appleware",
      "is_active": true,
      "is_document_required": true
    },
    {
      "name": "Apple",
      "is_active": true,
      "is_document_required": true
    }
  ],
  "paging": {
    "from": 1,
    "to": 20,
    "total": 2,
    "current_page": 1,
    "last_page": 1,
    "per_page": 20
  }
}

GET

https://api.tiki.vn/integration/{version}/brands?name={brand_name}

Return list of certificate files required in this category

Header

Key	Description
tiki-api	seller token key (contact Tiki supporter)

Response body

Field	Type	Example	Description
root	List<Brand>	Click on tag for more details	List of brands object.

Exception Case

HTTP Code	Message	Description
500	Internal server error	Having error in server, can’t serving
401	Unauthorized	Your tiki-api token is not valid
429	Too Many Requests	Your rate limit is exceed