AddOneSalesQuote

The 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

The response for this request should follow a JSON schema, detailing the structure and data types of the response object. The response will contain the newly created sales quote information.

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[]=""'

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

this secure key from Accounts System base on business

Example:

4765066450c0bd66325.48403130

platform-key

string

required

Example:

1234567

platform

string

required

Example:

web

Accept-Language

string

required

Example:

apikey

string

required

Example:

efe2db322a53

userToken

string

required

from login request in accounts APIs

Example:

6423c6ad718d7b715183753de01feeb9c4a107f52673377e1fe1f98d5c00e57a

Body Params multipart/form-data

customer_id

string

required

from business customers list from here
https://documenter.getpostman.com/view/23171355/2sAYkKJHmK#a03b809a-f3ec-44d4-8a96-4c0a7111de3d

Example:

currency_id

string

required

customer currency id

Example:

126

created_date

string

required

Example:

2025-09-02

due_date

string

required

description

string

required

quote desciption

Example:

quote desc

tax_inclusive

string

required

1 for tax inclusive or 0 for no

hide_total

string

required

optional to hide total in view

discount_check

string

required

1 or discount 0 for no discount

Example:

discount

string

required

0 for Percentage or 1 for Exact Amount

Example:

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 sort in quote view

item_id[]

string

required

product id from ecommerce system base on business id from here https://documenter.getpostman.com/view/32977971/2sAYkHodX8#a21a517a-3cf4-4ff8-bb1c-7127b220abde

item_qty[]

string

required

Example:

item_price[]

string

required

Example:

250

amount[]

string

required

Example:

250

item_tax[]

string

required

get tax base on business from here https://documenter.getpostman.com/view/23171355/2sAYkKJHmK#48bd0af4-6ba1-4142-bd76-36cbbb8366e7

Example:

185

tax_amount[]

string

required

item tax amount

Example:

total_with_tax[]

string

required

item total wit tax

Example:

295

item_discount[]

string

required

item discount amount

item_desc[]

string

required

item description

Responses

🟢201AddOneSalesQuote

application/json

Body

status

boolean

required

message

string

required

data

object

required

uuid

string

required

user_id

string

required

currency_id

string

required

business_id

integer

required

reference

integer

required

created_date

string

required

due_date

null

required

description

string

required

billing_address

null

required

tax_inclusive

string

required

rounding

string

required

discount

string

required

hide_total

string

required

custom_title

string

required

total

string

required

rounding_value

integer

required

note

null

required

status_id

integer

required

updated_at

string

required

created_at

string

required

integer

required

Request Body#

Response#

Request

Responses

Request Body

Response