Tuhund - Shopping cart API

API List

• API Introduction
• Authentication Key API
• Server Date and Time
• Embed Image API
• Attachment Download API
• Common lookups API

CRM Integration API

• List of companies with basic details
• Complete details of a company
• List of customers of a branch with basic details
• Register Person
• Register company
• Register address
• Register contact query
• Login ID availability check
• Customer Login API

Delivery / Shipment Order API

• Register Delivery Order
• Delivery Order Tracking API

Expense Claims Integration API

• Register Expense Claim
• Add expense item to claim
• Save and present claim for approval
• Get list of claims with basic details
• Get claim with all details

Inventory Module Integration API

• Register Delivery Note

Sales Module Integration API

• Register Quotation API
• List of Commercial Invoices
• Number of Commercial Invoices
• Register Invoice API

Shopping Cart Integration API

• Price List API
• Create Shopping Cart Order
• Add product to shopping cart
• Update payment details
• Get order in shopping cart
• List of orders in shopping cart

Procurement Module API

• Purchase Order List
• Purchase Order Details

Manufacturing Module API

• Get job order list
• Get job order details
• Bills of material of a Product
• Bill of material

API # : 8013 | API Name : createcart

Create order entry from e-Commerce Shopping Cart into Tuhund. You can integrate your shopping cart with Tuhund backend will all business logic and database running in Tuhund.

URL : <domain>/apic/createcart
Methods Allowed : POST

Payload Schema :

{ "$schema": "http://json-schema.org/draft-04/schema#", "type": "object", "properties": { "typeid": { "type": "string", "description": "ID of the type of order. Multiple order types can be added in Tuhund." }, "branchid": { "type": "string", "description": "Branch ID" }, "companyid": { "type": "string", "description": "Customer company ID. In case of unregistered customer, Company ID will be CASHCUSTOMER." }, "buyerid": { "type": "string", "description": "Person ID of the Buyer in case of unregistered customer and Person ID of the contact person in case of B2B sales." }, "agentid": { "type": "string", "description": "Company ID of the agent in case of sale through agent or dealer. Marketplace ID in case of order through an aggregator like Amazon, etc." }, "billingaddress": { "type": "string", "description": "Billing address ID." }, "shippingaddress": { "type": "string", "description": "Shipping address ID. Billing address ID will be used for shipping address in case shipping address is not provided." }, "shipmentterms": { "type": "string", "description": "Shipment Terms." }, "currency": { "type": "string", "description": "Currency of the sale. Home currency will be taken in case currency value is not specified." }, "exchange": { "type": "number", "description": "Exchange rate of the currency in case of foreign currency. System will automatically take the current selling rate in case this value is not provided." }, "freight": { "type": "number", "description": "Freight changes." }, "othercharges": { "type": "number", "description": "Any other changes applicable." }, "discount": { "type": "number", "description": "Discount on whole order level in percentage." }, "cponumber": { "type": "string", "description": "Customer's Purchase Order Number." }, "cpodate": { "type": "string", "description": "Customer's Purchase Order Date." }, "roundoff": { "type": "boolean", "description": "Flag to indicate if the system should automatically round off the total amount." }, "paymentstatus": { "type": "integer", "description": "Payment status.", "values": [ {"0", "Not initiated"}, {"1", "Initiated"}, {"2", "Waiting for Confirmation"}, {"3", "Failed"}, {"4", "COD (Cash on delivery)"}, {"9", "Successful"} ] }, "payment": { "type": "string", "description": "Details of the payment." }, "paymentmode": { "type": "number", "description": "Mode of payment.", "values":[ { "key": 10, "value": "Credit Card" }, { "key": 11, "value": "Net Banking" }, { "key": 12, "value": "UPI" }, { "key": 13, "value": "RTGS/NEFT/SWIFT" }, { "key": 14, "value": "Cheque Drop" } ] }, "paymentamount": { "type": "number", "description": "Amount of payment already received. 0.00 for COD" }, "grosstotal": { "type": "number", "description": "Total amount excluding taxes" }, "nettotal": { "type": "number", "description": "Total amount inclusive of taxes" }, "items": { "type": "array", "description": "List of items. Atleast one item is mandatory. More items can be added later.", "items": [ { "type": "object", "properties": { "productid": { "type": "string", "description": "Product ID." }, "price": { "type": "number", "description": "Price per unit." }, "quantity": { "type": "number", "description": "Quantity." }, "discount": { "type": "number", "description": "Discount on item level in percentage." }, "adiscount": { "type": "number", "description": "Discount per unit quantity on item level as amount" }, "taxrate1": { "type": "number", "description": "Tax Rate 1. VAT Rate in Fixed rate VAT Systems, SGST rate in Indian GST System, GST rate in other GST systems " }, "taxrate2": { "type": "number", "description": "Tax Rate 2. CST rate, GGST rate in Indian GST System" }, "taxrate3": { "type": "number", "description": "Tax Rate 3. Service Tax rate, IGST rate in Indian GST System, VAT rate in variable VAT systems, SVAT rate where applicable" }, "taxrate4": { "type": "number", "description": "Tax Rate 4. Cess rate in Indian GST System, Additional tax rate in other systems (for instance Nation Building Tax in Srilanka)" }, "services": { "type": "JSON Array", "description": "List of services associated with this item. For example: If quantity of products is 2 and installation is required on one, then quantity in this object should be 1.", "payload": [ { "serviceid": { "type": "string", "description": "Service ID of the service provided for the product. For instance, instalation, polishing, laminating, gift wrapping, hardening, sand blasting and edge grinding etc." }, "price": { "type": "number", "description": "Price per unit." }, "quantity": { "type": "number", "description": "Quantity." }, "discount": { "type": "number", "description": "Discount on item level in percentage." }, "adiscount": { "type": "number", "description": "Discount per unit quantity on item level as amount" }, "taxrate1": { "type": "number", "description": "Tax Rate 1. VAT Rate in Fixed rate VAT Systems, SGST rate in Indian GST System, GST rate in other GST systems " }, "taxrate2": { "type": "number", "description": "Tax Rate 2. CST rate, GGST rate in Indian GST System" }, "taxrate3": { "type": "number", "description": "Tax Rate 3. Service Tax rate, IGST rate in Indian GST System, VAT rate in variable VAT systems, SVAT rate where applicable" }, "taxrate4": { "type": "number", "description": "Tax Rate 4. Cess rate in Indian GST System, Additional tax rate in other systems (for instance Nation Building Tax in Srilanka)" } } ], "required": [ "serviceid", "price", "quantity" ] } }, "required": [ "productid", "price", "quantity", ] }, { "type": "object", "properties": { "productid": { "type": "string" }, "price": { "type": "integer" }, "quantity": { "type": "integer" }, "adiscount": { "type": "integer" } }, "required": [ "productid", "price", "quantity", ] }, { "type": "object", "properties": { "productid": { "type": "string" }, "price": { "type": "integer" }, "quantity": { "type": "integer" } }, "required": [ "productid", "price", "quantity" ] } ] } }, "required": [ "typeid", "branchid", "companyid", "billingaddress", "shipmentterms", "paymentstatus", "payment", "paymentmode", "items", "grosstotal", "nettotal" ] }

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 :

{ "typeid": "bqEbSm", "branchid": "ENTERPRISE", "companyid": "BSLUqT", "buyerid": "oS87gY", "agentid": "s33dsdd", "billingaddress": "BSLUqT", "shippingaddress": "BSLUqT", "shipmentterms": "Local Delivery", "currency": "INR", "exchange": 1, "freight": 10.2, "othercharges": 5.0, "discount": 0.0, "adiscount": 0.0, "cponumber": "983", "cpodate": "02/07/2021", "roundoff": true, "paymentstatus": 2, "payment": "Payment received through credit card No #1254", "paymentmode": 10, "grosstotal": 73015.00, "nettotal": 75175.00, "items": [ { "productid": "1377192423331", "price": 20000, "quantity": 1, "discount": 10, "taxrate1": 9, "taxrate2": 9 }, { "productid": "1377192423334", "price": 15000, "quantity": 3, "adiscount": 2000, "taxrate1": 9, "taxrate2": 9 }, { "productid": "1377192423330", "price": 10000, "quantity": 1, "taxrate1": 6, "taxrate2": 6 } ] }

Sample success response :

{ "orderid": "1625248014369", "ordernumber": "PIN/21-22/1007", "orderdate": "02/07/2021", "typeid": "bqEbSm", "branchid": "ENTERPRISE", "companyid": "BSLUqT", "buyerid": "oS87gY", "companynumber": 1160, "companyname": "A S Jayanagar", "billingaddress": "BSLUqT", "shippingaddress": "BSLUqT", "currency": "INR", "exchange": 1, "shipmentterms": "Local Delivery", "taxtype": "GST", "roundoff": 0, "adiscount": 0, "paymentstatus": 0, "payment": "Payment received through credit card No #1254", "status": 0, "discount": 0, "othercharges": 5, "statusmessage": "Order Received", "freight": 10.2, "cponumber": "365", "cpodate": "02/07/2021", "grosstotal": 75015.2, "nettotal": 88515.2, "items": [ { "model": "KS-AUV-08", "pda1": "Japan", "slabid": "GST18", "hsnid": "MAgtYI", "productnumber": 99000078, "itemid": "1625248014560", "discountedprice": 20000, "taxrate": 9, "amount": 20000, "discountedamount": 20000, "unitid": "PIECES", "productid": "1377192423331", "description": "08\" Straight Knife Fabric Cutting Machine complete set with standard accessories.", "taxrate3": 0, "taxrate2": 0, "taxrate1": 9, "quantity": 1, "producttype": 1, "productname": "08\" Straight Knife Cutting Machine", "dim3": 0, "dim2": 0, "dim1": 0, "adiscount": 0, "basetax": 0, "discount": 0, "packquantity": 0, "categoryid": "qiZT3T", "price": 20000, "brand": "KM", "orderid": "1625248014369", "hscode": "85444292", "cname": "Electric goods and appliances" }, { "model": "JK-T103 10", "pda1": "China", "slabid": "NFWguV", "hsnid": "IkzVbR", "productnumber": 99000081, "itemid": "1625248014561", "discountedprice": 15000, "taxrate": 9, "amount": 45000, "discountedamount": 45000, "unitid": "PIECES", "productid": "1377192423334", "description": "10\" Fabric Cutting Machine complete set with standard accessories.", "taxrate3": 0, "taxrate2": 0, "taxrate1": 9, "quantity": 3, "producttype": 1, "productname": "10\" Fabric Cutting Machine complete set", "dim3": 0, "dim2": 0, "dim1": 0, "adiscount": 0, "basetax": 0, "discount": 0, "packquantity": 0, "categoryid": "q9y43K", "price": 15000, "brand": "JACK", "orderid": "1625248014369", "hscode": "72024100", "cname": "SFFER70065" }, { "model": "KS-AUV-10''", "pda1": "Japan", "slabid": "GST18", "hsnid": "MAgtYI", "productnumber": 99000077, "itemid": "1625248014562", "discountedprice": 10000, "taxrate": 9, "amount": 10000, "discountedamount": 10000, "unitid": "PIECES", "productid": "1377192423330", "description": "10'' Straight Knife Fabric Cutting Machine complete set with standard accessories.", "taxrate3": 0, "taxrate2": 0, "taxrate1": 9, "quantity": 1, "producttype": 1, "productname": "10'' Straight Knife Fabric Cutting Machine", "dim3": 0, "dim2": 0, "dim1": 0, "adiscount": 0, "salestaxid": "SALESTAXID", "basetax": 0, "discount": 0, "packquantity": 0, "categoryid": "q9y43K", "price": 10000, "brand": "KM", "orderid": "1625248014369", "hscode": "85444292", "cname": "Electric goods and appliances" } ] }

Sample failure response :

{ "result": -1, "message": "Error while inserting records in database.", "errorcode": 500, "errors": [ { "message": "Gross total check failed. Gross total should be 73015.00", "errorcode": 412 }, { "message": "Net total check failed. Net total should be 75175.00", "errorcode": 412 } ] }