AddOneInvoice
Testing Env
https://taccounting.vodoerp.com
Testing Env
https://taccounting.vodoerp.com
POST
/api/v4/sales_invoices
Last modified:2025-04-28 11:49:35
Sales Invoices Creation
Request Body Parameters
user_id
number, required): ID of the customer for the invoice.branch_id
(number, optional): ID of the branch if the customer has multiple branches.created_date
(number, required): Date of creation for the invoice.order_number
(number, optional): Number of the specific ecommerce order related to the invoice.quote_number
(inumber, optional): Number of the specific sales quote related to the invoice.due_date
(date, optional): Due date for the invoice.note
(text, required): Note for the invoice.billing_address
(text, optional): Billing address for the invoice.description
(text, optional): Description of the invoice.total
(number, required): Total amount for the invoice.tax_total
(number, optional): Total tax amount for the invoice id choose tax .tax_inclusive
(number, optional): Indicates if tax is inclusive.Response
{
"type": "object",
"properties": {
"status": {"type": "boolean"},
"message": {"type": "string"},
"data": {
"type": "object",
"properties": {
"uuid": {"type": "string"},
"user_id": {"type": "string"},
"branch_id": {"type": "integer"},
"currency_id": {"type": "integer"},
"business_id": {"type": "integer"},
"reference": {"type": "integer"},
"order_number": {"type": ["string", "null"]},
"quote_number": {"type": ["string", "null"]},
"created_date": {"type": "string"},
"due_date": {"type": ["string", "null"]},
"description": {"type": "string"},
"billing_address": {"type": ["string", "null"]},
"rounding": {"type": "string"},
"tax_inclusive": {"type": "string"},
"discount": {"type": ["string", "null"]},
"custom_title": {"type": "string"},
"deduct_type": {"type": "string"},
"deduct_value": {"type": "string"},
"early_discount_type": {"type": "string"},
"early_discount_value": {"type": "string"},
"payment_fees": {"type": "string"},
"early_discount_days": {"type": "string"},
"hide_due_date": {"type": "string"},
"total_amount_word": {"type": "string"},
"invoice_status_days": {"type": "string"},
"total": {"type": "string"},
"total_without_deduct": {"type": "string"},
"due_balalnce": {"type": "string"},
"rounding_value": {"type": "integer"},
"note": {"type": "string"},
"bank_id": {"type": "string"},
"created_by": {"type": "integer"},
"amount_total": {"type": "string"},
"tax_amount_total": {"type": "integer"},
"qty_due_balance": {"type": "integer"},
"rate_value": {"type": "integer"},
"updated_at": {"type": "string"},
"created_at": {"type": "string"},
"id": {"type": "integer"}
}
}
}
}
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://taccounting.vodoerp.com/api/v4/sales_invoices' \
--header 'secure-business-key: 4765066450c0bd66325.48403130' \
--header 'platform-key: 1234567' \
--header 'platform: web' \
--header 'Accept-Language: ar' \
--header 'apikey: efe2db322a53' \
--header 'userToken: ae1ada74d1bf5c1a3efbed87a5d7420855dbd9f907a6ea51eb4fc0f274508695' \
--form 'user_id="34479"' \
--form 'branch_id=""' \
--form 'created_date="2025-01-30"' \
--form 'order_number=""' \
--form 'quote_number=""' \
--form 'due_date=""' \
--form 'note=""' \
--form 'billing_address=""' \
--form 'description="desc"' \
--form 'total="500"' \
--form 'tax_total="500"' \
--form 'tax_inclusive=""' \
--form 'discount=""' \
--form 'discount_check=""' \
--form 'custom_title_check=""' \
--form 'item_sort[]=""' \
--form 'item_sort[]=""' \
--form 'item_id[]=""' \
--form 'item_id[]=""' \
--form 'tax_id[]="89"' \
--form 'account_id[]="2367"' \
--form 'account_id[]="2367"' \
--form 'item_qty[]="5"' \
--form 'item_qty[]="1"' \
--form 'item_price[]="100"' \
--form 'item_price[]="200"' \
--form 'amount[]="500"' \
--form 'amount[]="200"' \
--form 'item_desc[]="asdasd"' \
--form 'item_desc[]="asdasd"' \
--form 'item_discount[]=""' \
--form 'item_discount[]=""' \
--form 'item_tax[]="85"' \
--form 'item_tax[]="85"' \
--form 'tax_amount[]="30"' \
--form 'tax_amount[]="30"' \
--form 'total_with_tax[]="500"' \
--form 'total_with_tax[]="200"'
Response Response Example
{
"status": true,
"message": "invoice addedd success",
"data": {
"uuid": "0a46e481-a768-41f5-9ceb-613f8987ce19",
"user_id": "34479",
"branch_id": 0,
"currency_id": 219,
"business_id": 259,
"reference": 5,
"order_number": null,
"quote_number": null,
"created_date": "2025-01-30",
"due_date": null,
"description": "desc",
"billing_address": null,
"rounding": "0",
"tax_inclusive": "0",
"discount": null,
"custom_title": "",
"deduct_type": "",
"deduct_value": "",
"early_discount_type": "",
"early_discount_value": "",
"payment_fees": "",
"early_discount_days": "",
"hide_due_date": "0",
"total_amount_word": "0",
"invoice_status_days": "",
"total": "500",
"total_without_deduct": "500",
"due_balalnce": "500",
"rounding_value": 0,
"note": "",
"bank_id": "",
"created_by": 598,
"amount_total": "500",
"tax_amount_total": 60,
"qty_due_balance": 6,
"rate_value": 0,
"updated_at": "2025-03-25T15:19:32.000000Z",
"created_at": "2025-03-25T15:19:31.000000Z",
"id": 121029
}
}
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:
ar
apikey
stringÂ
required
Example:
efe2db322a53
userToken
stringÂ
required
https://documenter.getpostman.com/view/20887296/2sAYkHoJLt#fbaa67f3-66ef-4e1c-a304-2897fcae50d3
Example:
ae1ada74d1bf5c1a3efbed87a5d7420855dbd9f907a6ea51eb4fc0f274508695
Body Params multipart/form-data
user_id
stringÂ
required
https://documenter.getpostman.com/view/23171355/2sAYkKJHmK#a03b809a-f3ec-44d4-8a96-4c0a7111de3d
Example:
34479
branch_id
stringÂ
required
created_date
stringÂ
required
Example:
2025-01-30
order_number
stringÂ
required
quote_number
stringÂ
required
due_date
stringÂ
required
note
stringÂ
required
billing_address
stringÂ
required
description
stringÂ
required
Example:
desc
total
stringÂ
required
Example:
500
tax_total
stringÂ
required
Example:
500
tax_inclusive
stringÂ
required
discount
stringÂ
required
discount_check
stringÂ
required
custom_title_check
stringÂ
required
item_sort[]
array[string]
required
Example:
["",""]
item_id[]
array[string]
required
Example:
["",""]
tax_id[]
stringÂ
required
Example:
89
account_id[]
array[string]
required
Example:
["2367","2367"]
item_qty[]
array[string]
required
Example:
["5","1"]
item_price[]
array[string]
required
Example:
["100","200"]
amount[]
array[string]
required
Example:
["500","200"]
item_desc[]
array[string]
required
Example:
["asdasd","asdasd"]
item_discount[]
array[string]
required
Example:
["",""]
item_tax[]
array[string]
required
Example:
["85","85"]
tax_amount[]
array[string]
required
Example:
["30","30"]
total_with_tax[]
array[string]
required
Example:
["500","200"]