AddOneSalesQuote
Testing Env
https://taccounting.vodoerp.com
Testing Env
https://taccounting.vodoerp.com
POST
/api/v4/sales_quote
Last modified:2025-04-06 12:28:16
POST
request to {{accounting_url}}api/v4/sales_quote
is used to create a new sales quote. The request should include a form-data body with various parameters such as customer ID, currency ID, dates, description, tax details, discounts, and item details.Request Body
customer_id
(number): Represents the ID of the customer for whom the quote is being created. It should be obtained from the business customers list.currency_id
(number): Specifies the currency ID for the customer.created_date
(date): Indicates the date when the quote was created.due_date
(date): Represents the due date for the quote.description
(text): Provides a description for the quote.tax_inclusive
(number): Set to '1' to indicate tax inclusive, or '0' for no tax inclusion.hide_total
(number): Optional parameter to hide the total in the view.discount_check
(number): Set to '1' to apply a discount, or '0' for no discount.discount
(numner): Set to '0' for percentage-based discount, or '1' for an exact amount discount.custom_title
(text): Represents a custom title for the quote.total
(number): Indicates the total amount for the quote.final_total
(number): Specifies the final total amount for the quote.note
(text): Additional notes for the quote.item_sort[]
(number): Represents the sort order of items in the quote view.item_id[]
(text): Specifies the product ID from the ecommerce system based on the business ID.item_qty[]
(number): Indicates the quantity of each item in the quote.item_price[]
(number): Represents the price of each item.amount[]
(number): Indicates the total amount for each item.item_tax[]
(text): Specifies the tax for each item, based on the business details.tax_amount[]
(number): Indicates the tax amount for each item.total_with_tax[]
(number): Represents the total amount including tax for each item.item_discount[]
(number): Specifies the discount amount for each item.item_desc[]
(text): Provides a description for each item.Response
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://taccounting.vodoerp.com/api/v4/sales_quote' \
--header 'secure-business-key: 4765066450c0bd66325.48403130' \
--header 'platform-key: 1234567' \
--header 'platform: web' \
--header 'Accept-Language: en' \
--header 'apikey: efe2db322a53' \
--header 'userToken: 6423c6ad718d7b715183753de01feeb9c4a107f52673377e1fe1f98d5c00e57a' \
--form 'customer_id="3"' \
--form 'currency_id="126"' \
--form 'created_date="2025-09-02"' \
--form 'due_date=""' \
--form 'description="quote desc"' \
--form 'tax_inclusive=""' \
--form 'hide_total=""' \
--form 'discount_check="1"' \
--form 'discount="0"' \
--form 'custom_title="custom title for quote"' \
--form 'total="1000"' \
--form 'final_total="1250"' \
--form 'note=""' \
--form 'item_sort[]=""' \
--form 'item_id[]=""' \
--form 'item_qty[]="1"' \
--form 'item_price[]="250"' \
--form 'amount[]="250"' \
--form 'item_tax[]="185"' \
--form 'tax_amount[]="45"' \
--form 'total_with_tax[]="295"' \
--form 'item_discount[]=""' \
--form 'item_desc[]=""'
Response Response Example
{
"status": true,
"message": "sales quote created",
"data": {
"uuid": "eba88ed7-c16b-46d1-ae1b-2c5e92898a83",
"user_id": "3",
"currency_id": "126",
"business_id": 259,
"reference": 1,
"created_date": "2025-09-02",
"due_date": null,
"description": "quote desc",
"billing_address": null,
"tax_inclusive": "0",
"rounding": "0",
"discount": "0",
"hide_total": "0",
"custom_title": "",
"total": "1250",
"rounding_value": 0,
"note": null,
"status_id": 1,
"updated_at": "2025-03-26T12:07:22.000000Z",
"created_at": "2025-03-26T12:07:22.000000Z",
"id": 1805
}
}
Request
Header Params
secure-business-key
stringÂ
required
Example:
4765066450c0bd66325.48403130
platform-key
stringÂ
required
Example:
1234567
platform
stringÂ
required
Example:
web
Accept-Language
stringÂ
required
Example:
en
apikey
stringÂ
required
Example:
efe2db322a53
userToken
stringÂ
required
Example:
6423c6ad718d7b715183753de01feeb9c4a107f52673377e1fe1f98d5c00e57a
Body Params multipart/form-data
customer_id
stringÂ
required
https://documenter.getpostman.com/view/23171355/2sAYkKJHmK#a03b809a-f3ec-44d4-8a96-4c0a7111de3d
Example:
3
currency_id
stringÂ
required
Example:
126
created_date
stringÂ
required
Example:
2025-09-02
due_date
stringÂ
required
description
stringÂ
required
Example:
quote desc
tax_inclusive
stringÂ
required
hide_total
stringÂ
required
discount_check
stringÂ
required
Example:
1
discount
stringÂ
required
Example:
0
custom_title
stringÂ
required
Example:
custom title for quote
total
stringÂ
required
Example:
1000
final_total
stringÂ
required
Example:
1250
note
stringÂ
required
item_sort[]
stringÂ
required
item_id[]
stringÂ
required
item_qty[]
stringÂ
required
Example:
1
item_price[]
stringÂ
required
Example:
250
amount[]
stringÂ
required
Example:
250
item_tax[]
stringÂ
required
Example:
185
tax_amount[]
stringÂ
required
Example:
45
total_with_tax[]
stringÂ
required
Example:
295
item_discount[]
stringÂ
required
item_desc[]
stringÂ
required