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
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
Human Resuorce Management Module
Inventory Module Integration API
Sales Module Integration API
- Register Quotation API
- Register Proforma Invoice API
- List of Commercial Invoices
- Number of Commercial Invoices
- Register Invoice API
Services Module Integration 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
- Purchase Invoice List
- Purchase Invoice Details
- Register Purchase Invoice API
Manufacturing Module API
API # : 8004 | API Name : registerquotation
This API is used to register a quotation (new or old) for a customer in Tuhund.
URL : <domain>/apic/registerquotation
Methods Allowed : POST
Register Quotation API and all similar API like Proforma Invoice, Commercial Invoice, Inquiry, Purchase Order, FFQ, Purchase Invoice and Leads, etc can be used to register new records during mormal working or old records at the time of data entry into the system. Payload for both are slightly different. For the real time entry all entities like customer, address, product, record type and tax type will be identified only with their respective ID. However, for the old data entry ID or the names can be used.
Payload Schema :
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"terms": {
"type": "string",
"description": "Commercial or delivery terms applicable to the quotation, such as CIF Sea."
},
"branchid": {
"type": "string",
"description": "Unique identifier of the branch from which the quotation is issued."
},
"currency": {
"type": "string",
"description": "Currency code in which the quotation is issued, such as MYR."
},
"companyid": {
"type": "string",
"description": "Unique identifier of the company issuing the quotation."
},
"taxtype": {
"type": "string",
"description": "Tax type or tax classification applicable to the quotation, such as INTERSTATE."
},
"adiscount": {
"type": "number",
"description": "Additional discount as amount applicable to the quotation after item-level discounts."
},
"shippingaddressid": {
"type": "string",
"description": "Unique identifier of the shipping address."
},
"payment": {
"type": "string",
"description": "Payment terms applicable to the quotation."
},
"create": {
"type": "boolean",
"description": "Indicates whether missing masters should be created."
},
"companyname": {
"type": "string",
"description": "Name of the company issuing the quotation. Required if the companyid is not provided"
},
"reference": {
"type": "string",
"description": "External reference number or reference text associated with the quotation."
},
"discount": {
"type": "number",
"description": "Overall discount in percentage applicable to the quotation."
},
"pan": {
"type": "string",
"description": "Permanent Account Number of the company, where applicable. Considered only if companyid is not provided."
},
"salesman": {
"type": "string",
"description": "Name of the salesperson responsible for the quotation."
},
"validtill": {
"type": "string",
"description": "Date until which the quotation remains valid. Date format is dd/MM/yyyy."
},
"items": {
"type": "array",
"description": "List of products or services included in the quotation.",
"items": {
"type": "object",
"properties": {
"model": {
"type": "string",
"description": "Model number or model identifier of the product."
},
"adiscount": {
"type": "number",
"description": "Additional discount amount applicable to the individual quotation item."
},
"pda1": {
"type": "string",
"description": "Product-defined attribute 1."
},
"pda2": {
"type": "string",
"description": "Product-defined attribute 2."
},
"pda3": {
"type": "string",
"description": "Product-defined attribute 3."
},
"pda4": {
"type": "string",
"description": "Product-defined attribute 4."
},
"discount": {
"type": "number",
"description": "Discount as percentage applicable to the individual quotation item."
},
"unit": {
"type": "string",
"description": "Unit of measurement for the quoted quantity, such as Pcs."
},
"price": {
"type": "number",
"description": "Unit price of the product or service before applicable discounts and taxes."
},
"productid": {
"type": "string",
"description": "Unique identifier of the product or service."
},
"taxrate4": {
"type": "number",
"description": "Cess tax rate applicable to the item in GST systems. In systems where this tax component is not applicable, the value should be zero."
},
"description": {
"type": "string",
"description": "Detailed description of the product or service. Considered if productid is not provided."
},
"taxrate3": {
"type": "number",
"description": "IGST tax rate applicable to the item in GST systems. In VAT systems in countries where e-invoicing is applicable, taxrate3 represents the VAT rate."
},
"taxrate2": {
"type": "number",
"description": "CGST tax rate applicable to the item in GST systems."
},
"brand": {
"type": "string",
"description": "Brand or manufacturer name of the product. Considered if productid is not provided."
},
"taxrate1": {
"type": "number",
"description": "SGST tax rate applicable to the item in GST systems."
},
"quantity": {
"type": "number",
"description": "Quantity of the product or service being quoted."
},
"producttype": {
"type": "integer",
"description": "Type or classification identifier of the product. Considered if productid is not provided."
},
"productname": {
"type": "string",
"description": "Name of the product or service. Considered if productid is not provided."
},
"hsn": {
"type": "string",
"description": "HSN or applicable product classification code. Considered is productid is not provided."
},
"sac": {
"type": "string",
"description": "SAC or applicable service classification code. Considered for sercice if productid is not provided."
},
"taxcode": {
"type": "string",
"description": "Tax code applicable to the quotation item."
},
"warehouseid": {
"type": "string",
"description": "Unique identifier of the warehouse associated with the quotation item."
},
"remarks": {
"type": "string",
"description": "Additional remarks specific to the quotation item."
}
}
}
},
"address": {
"type": "string",
"description": "Billing or company address associated with the quotation."
},
"email": {
"type": "string",
"description": "Email address associated with the quotation or company."
},
"personid": {
"type": "string",
"description": "Unique identifier of the person or contact associated with the quotation."
},
"billingaddressid": {
"type": "string",
"description": "Unique identifier of the billing address."
},
"quotationdate": {
"type": "string",
"description": "Date on which the quotation is issued. Date format is dd/MM/yyyy."
},
"tan": {
"type": "string",
"description": "Tax Deduction and Collection Account Number of the company, where applicable."
},
"quotationprefixid": {
"type": "string",
"description": "Unique identifier of the quotation numbering prefix."
},
"shippingaddress": {
"type": "string",
"description": "Shipping address associated with the quotation."
},
"contactnumber": {
"type": "string",
"description": "Contact telephone number associated with the quotation."
},
"contactname": {
"type": "string",
"description": "Name of the contact person associated with the quotation."
},
"customerid": {
"type": "string",
"description": "Unique identifier of the customer for whom the quotation is prepared."
},
"customername": {
"type": "string",
"description": "Name of the customer for whom the quotation is prepared."
},
"referenceid": {
"type": "string",
"description": "Unique identifier of the external reference associated with the quotation."
}
},
"required": [
"companyid",
"companyname",
"branchid",
"currency",
"create",
"quotationdate",
"validtill",
"items"
]
}
Request Headers :
{
"device": "MYAPP",
"Authentication": "YOUR_AUTHENTICATION_CODE"
}
Request Headers Schema :
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"device": {
"type": "string",
"description": "A short name of your application. Device is mandatory but any value between 3 and 20 characters is accepted.",
"minLength": 3,
"maxLength": 20
},
"Authentication": {
"type": "string",
"description": "Authentication code generated for API call."
}
},
"required": [
"device",
"Authentication"
]
}
Sample Payload for Real Time entry :
{
"adiscount": 0,
"shippingaddressid": "cggr23344",
"payment": "50% advance, 50% on delivery",
"terms": "CIF Sea",
"branchid": "b12aaa1",
"remarks": "Packing must be waterproof as the shipment may have to wait in open warehouse for few days",
"reference": "PO 22366623",
"discount": 0,
"currency": "MYR",
"companyid": "Wl61Nt",
"validtill": "20/06/2021",
"items": [
{
"adiscount": 0,
"price": 4554.55,
"productid": "P15665566566",
"taxrate4": 0,
"taxrate3": 0,
"taxrate2": 9,
"taxrate1": 9,
"quantity": 10,
"discount": 0
},
{
"adiscount": 0,
"price": 125,
"productid": "P3305566566",
"taxrate4": 0,
"taxrate3": 0,
"taxrate2": 6,
"taxrate1": 6,
"quantity": 25,
"discount": 0
}
],
"personid": "645465464",
"billingaddressid": "cggr23344",
"quotationdate": "20/05/2021",
"taxtype": "INTERSTATE",
"quotationprefixid": "qy887q"
}
Sample Payload for old record :
{
"countrycode": "my",
"gstin": "29AAGGE1851A1Z7",
"terms": "CIF Sea",
"state": "WP Kuala Lumpur",
"remarks": "Packing must be waterproof as the shipment may have to wait in open warehouse for few days",
"branchid": "b12aaa1",
"tin": "TSSD3445553",
"city": "Kuala Lumpur",
"currency": "MYR",
"companyid": "Wl61Nt",
"cstnumber": "CST2333242424",
"taxtype": "INTERSTATE",
"cin": "C542234AADDE443434444",
"adiscount": 0,
"shippingaddressid": "cggr23344",
"payment": "50% advance, 50% on delivery",
"postcode": "56025",
"create": true,
"companyname": "ECS Business Software Solutions",
"reference": "PO 22366623",
"discount": 0,
"pan": "AAGGE1851A",
"salesman": "Andrew Wong",
"validtill": "20/06/2021",
"items": [
{
"model": "T-8422D-405-N64D",
"adiscount": 0,
"pda1": "Japan",
"pda2": "H7786",
"pda3": "A",
"pda4": "B",
"discount": 0,
"unit": "Pcs",
"price": 4554.55,
"productid": "P15665566566",
"taxrate4": 0,
"description": "New Generation DIRECT DRIVE Twin Needle with thread trimmer, wiper & control panel. Dual feed technology-needle feed and drop",
"taxrate3": 0,
"taxrate2": 9,
"brand": "Brother",
"taxrate1": 9,
"quantity": 10,
"producttype": 1,
"productname": "DIRECT DRIVE Twin Needle with thread trimmer"
},
{
"adiscount": 0,
"price": 125,
"productid": "P3305566566",
"taxrate4": 0,
"taxrate3": 0,
"taxrate2": 6,
"taxrate1": 6,
"quantity": 25,
"discount": 0
}
],
"address": "#255, Street 3, Jalan Chan Sow Lin",
"email": "ecsmalaysia@ecsbss.com",
"personid": "645465464",
"billingaddressid": "cggr23344",
"quotationdate": "20/05/2021",
"tan": "T23311AADD33",
"quotationprefixid": "qy887q"
}
Sample failure response :
{
"message":"No authentication code passed.",
"response":-1,
"errorcode":412
}
