UpdateOneSalesQuote

Create Sales Quote

This endpoint allows you to create a new sales quote.

Request Body Parameters

customer_id (number, required): ID of the customer from the business customers list.

currency_id (number, required): Customer's currency ID.

created_date (date, required): Quote date.

due_date (date, optional): Due date for the quote.

description (text, optional): Description of the quote.

tax_inclusive (number, required): 1 for tax inclusive or 0 for no tax.

hide_total (number, optional): Option to hide total in view.

discount_check (number, required): 1 for discount, 0 for no discount.

discount (number, required): 0 for Percentage or 1 for Exact Amount.

custom_title (text, optional): Custom title for the quote.

total (number, required): Total amount.

final_total (number, required): Final total amount.

note (text, optional): Note for the quote.

item_sort[] (number, optional): Item sort in quote view.

item_id[] (number, required): Product ID from the ecommerce system.

item_qty[] (number, required): Quantity of the item.

item_price[] (text, required): Price of the item.

amount[] (number, required): Total amount for the item.

item_tax[] (number, required): Tax for the item.

tax_amount[] (number, required): Item tax amount.

total_with_tax[] (number, required): Item total with tax.

item_discount[] (number, required): Item discount amount.

item_desc[] (number, required): Description of the item.

Response

status (boolean): Indicates the success or failure of the request.

message (string): Additional information or error message.

data (object): Details of the created sales quote including ID, UUID, user and business IDs, currency, status, reference, due date, created date, description, billing address, tax inclusive status, rounding, discount, total, note, created and updated timestamps.

Example

{
    "status": true,
    "message": "",
    "data": {
        "id": 1234,
        "uuid": "abcd-1234",
        "user_id": 5678,
        "business_id": 9012,
        "currency_id": 3456,
        "status_id": 7890,
        "reference": 2468,
        "due_date": "2023-12-31",
        "created_date": "2023-12-01",
        "description": "Sample description",
        "billing_address": "123 Main St",
        "tax_inclusive": "1",
        "rounding": "0.5",
        "discount": "0.1",
        "hide_total": "0",
        "custom_title": "Custom Quote",
        "rounding_value": 0.5,
        "total": 1000,
        "note": "This is a sample note",
        "created_at": "2023-12-01T12:00:00Z",
        "updated_at": "2023-12-01T12:30:00Z"
    }
}

curl --location --request POST 'https://taccounting.vodoerp.com/api/v4/sales_quote/1805' \ --header 'secure-business-key: 14807664478836358b0.31329842' \ --header 'platform-key: 1234567' \ --header 'platform: web' \ --header 'Accept-Language: en' \ --header 'apikey: efe2db322a53' \ --header 'userToken: 7fa069ecb768d988724658e4d9cc7f3174a179921135a5b7f945926bc8eedce0' \ --form 'customer_id="31944"' \ --form 'currency_id="126"' \ --form 'created_date="2025-01-27"' \ --form 'due_date=""' \ --form 'description="quote desc"' \ --form 'tax_inclusive="1"' \ --form 'hide_total=""' \ --form 'discount_check=""' \ --form 'discount=""' \ --form 'custom_title="custom title for quote"' \ --form 'total="500"' \ --form 'final_total="525"' \ --form 'note=""' \ --form 'item_sort[]=""' \ --form 'item_id[]=""' \ --form 'item_qty[]="1"' \ --form 'item_price[]="500"' \ --form 'amount[]="525"' \ --form 'item_tax[]="185"' \ --form 'tax_amount[]="25"' \ --form 'total_with_tax[]="1250"' \ --form 'item_discount[]=""' \ --form 'item_desc[]=""'

{ "status": true, "message": "sales quote updated", "data": { "id": 1805, "uuid": "eba88ed7-c16b-46d1-ae1b-2c5e92898a83", "user_id": 3, "business_id": 256, "currency_id": 126, "status_id": 1, "reference": 1, "due_date": null, "created_date": "2025-09-02", "description": "quote desc", "billing_address": null, "tax_inclusive": "0", "rounding": "0", "discount": "0", "hide_total": "0", "custom_title": "", "rounding_value": 0, "total": 1250, "note": null, "created_at": "2025-03-26T12:07:22.000000Z", "updated_at": "2025-03-26T12:07:22.000000Z" } }

Request

Header Params

secure-business-key

string

required

this secure key from Accounts System base on business

Example:

14807664478836358b0.31329842

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
https://documenter.getpostman.com/view/20887296/2sAYkHoJLt#fbaa67f3-66ef-4e1c-a304-2897fcae50d3

Example:

7fa069ecb768d988724658e4d9cc7f3174a179921135a5b7f945926bc8eedce0

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:

31944

currency_id

string

required

customer currency id

Example:

126

created_date

string

required

quote date

Example:

2025-01-27

due_date

string

required

description

string

required

Example:

quote desc

tax_inclusive

string

required

1 for tax inclusive or 0 for no

Example:

hide_total

string

required

optional to hide total in view

discount_check

string

required

1 or discount 0 for no discount

discount

string

required

0 for Percentage or 1 for Exact Amount

custom_title

string

required

custom title for quote

Example:

custom title for quote

total

string

required

Example:

500

final_total

string

required

Example:

525

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:

500

amount[]

string

required

Example:

525

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:

1250

item_discount[]

string

required

item discount amount

item_desc[]

string

required

item description

Responses

🟢200UpdateOneSalesQuote

application/json

Body

status

boolean

required

message

string

required

data

object

required

integer

required

uuid

string

required

user_id

integer

required

business_id

integer

required

currency_id

integer

required

status_id

integer

required

reference

integer

required

due_date

null

required

created_date

string

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

rounding_value

integer

required

total

integer

required

note

null

required

created_at

string

required

updated_at

string

required

UpdateOneSalesQuote

Create Sales Quote#

Request Body Parameters#

Response#

Example#

Request

Responses

Create Sales Quote

Request Body Parameters

Response

Example