Tuhund - Price List API

API List

CRM Integration API

Delivery / Shipment Order API

Expense Claims Integration API

Inventory Module Integration API

Sales Module Integration API

Shopping Cart Integration API

Procurement Module API

Manufacturing Module API

API # : 8003 | API Name : pricelist

This API gets filtered, sort and ordered records under a specific Price list.

URL : <domain>/apic/pricelist
Methods Allowed : POST
Request Body : JSON Payload

Payload Structure :

Name	Description	Type
itemid	ID is the price list. Client will select a price list and provide ID for integration. This is a mandatory field.	String
search	Search text. System will search in all product fields including Brand Part Number Model Product Name Description Keywords Part number search is smart search. It excludes spaces and special characters.	String
show	Currency Code. This is an optional field required only in case of filtering records of a specific currency in case of a multi-currency price map. Examples : USD EUR INR MYR BDT	String
show3	Product Type 1 = Products / Machines 2 = Spare Parts and Accessories	Integer
show4	Brand. Brand name of the products. Multiple brand names can also be passed as semicolon separated list.	String
show5	Color. Hexadecimal color code of the product. For example : FFFFFF = While 000000 = Black FF0000 = Red	String
show6	PDA 1	String
show7	PDA 2	String
show8	PDA 3	String
show9	PDA 4	String
ep1	Product ID or multiple product IDs as a comma separated string. Use this in case one or multiple specific products data is required. For instance data for static sections in index and other pages, cart pages and confirmation pages where products have already been selected.	String
ep2	Category ID. System will return data of the products within the category as well as products in all levels of sub-categories within the category. Multiple category Ids can also be passed as a semicolon separated list.	String
ep3	Minimum Price	String
ep4	Maximum Price	String
ep6	Minimum Points / Mean product rating	Number
ep7	Maximum Points / Mean product rating	Number
ep8	Minimum capacity / size. This parameter works only when capacity / size data has been entered as number.	Number
ep9	Maximum capacity / size. This parameter works only when capacity / size data has been entered as number.	Number
branchid	This parameter is optional and is only required if realtime stock position is needed in the return payload.	String
pp	Number of records per page. All the matching records are split in sets similar to pages. This value tells the system how many records have to be grouped under each page. Default value is 100	Integer
page	Page number. Default is 1	Integer
srt	Sort by. Possible values are : PRODUCTNAME PRODUCTNUMBER BRAND MODEL PDA1 PDA2 PDA3 PDA4 MINPRICE PRODUCTTYPE DESCRIPTION	String
order	Sort Order. ASC or DESC	String

Request Headers :

Name	Description
device	A short name of your application. Device is mandatory but any value between 3 and 20 characters is accepted.
Authentication	Authentication code generated for API call.

Sample Payload :

{
    "search": "server",
    "page": 1,
    "itemid": "Q1Z8rO",
    "pp": 50
}

Sample success response :

{
    "response": 1,
    "totalitems": 43025,
    "list": [
        {
            "tax2": 9,
            "model": "KS-AUV-10''",
            "tax1": 9,
            "pda1": "Japan",
            "number": 99000077,
            "itemid": "1614249244209",
            "tax4": 1,
            "type": 1,
            "tax3": 18,
            "currency": "INR",
            "discount": 5,
            "unit": "Pcs",
            "price": 13750,
            "unitid": "PIECES",
            "productid": "1377192423330",
            "description": "10'' Straight Knife Fabric Cutting Machine complete set with standard accessories.",
            "name": "10'' Straight Knife Fabric Cutting Machine",
            "brand": "KM",
            "hscode": "85444292"
        },
        {....},
        {....}
    ]
}

Response Interpretation :

Key	Description
totalitems	Total Number of items matching search criteria
list	Array of list items
list.tax1	SGST / GST / VAT
list.tax2	CGST / CST,
list.tax3	IGST / SERVICE TAX,
list.tax4	CESS
list.number	Product Number
list.name	Product Name
list.description	Product Description
list.brand	Brand
list.model	Model
list.pda1	Custom Product Attribute 1
list.pda2	Custom Product Attribute 2
list.pda3	Custom Product Attribute 3
list.pda4	Custom Product Attribute 4
list.itemid	List Item ID
list.type	Product Type
list.currency	Currency
list.price	Item Price per unit
list.discount	Discount in percentage
list.unit	Unit (Abbreviation)
list.unitid	Unit ID
list.productid	Product ID
list.hscode	HS Code