AddOneInvoice

Sales Invoices Creation

This endpoint allows you to create a new sales invoice.

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.

discocunt check :number,optional):1 for dicsount or 0 fo no discount

disount :(number,optional) :0 for percentage tyoe and 1 for exact amount

tax_inclusive :(number,optional):1 for tax inclisive and 0 for no

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

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

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

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

Example:

ae1ada74d1bf5c1a3efbed87a5d7420855dbd9f907a6ea51eb4fc0f274508695

Body Params multipart/form-data

user_id

string

required

invoice customer id from
https://documenter.getpostman.com/view/23171355/2sAYkKJHmK#a03b809a-f3ec-44d4-8a96-4c0a7111de3d

Example:

34479

branch_id

string

required

optional if customer have branch

created_date

string

required

today date

Example:

2025-01-30

order_number

string

required

optional if invoice related to speific ecommerce order

quote_number

string

required

optional if invoice related to speific sales quote

due_date

string

required

optional

note

string

required

billing_address

string

required

description

string

required

Example:

desc

total

string

required

invoice total

Example:

500

tax_total

string

required

invoice tax total

Example:

500

tax_inclusive

string

required

1 for tax inclusive or 0 for no tax inclusive

discount

string

required

0 for Percentage or 1 for Exact Amount

discount_check

string

required

1 or discount 0 for no discount

custom_title_check

string

required

custo titla fo invoice in invoice view

item_sort[]

array[string]

required

item sort in invoice view

Example:

["",""]

item_id[]

array[string]

required

Example:

["",""]

tax_id[]

string

required

Example:

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

Responses

🟢201AddOneInvoice

application/json

Body

status

boolean

required

message

string

required

data

object

required

uuid

string

required

user_id

string

required

branch_id

integer

required

currency_id

integer

required

business_id

integer

required

reference

integer

required

order_number

null

required

quote_number

null

required

created_date

string

required

due_date

null

required

description

string

required

billing_address

null

required

rounding

string

required

tax_inclusive

string

required

discount

null

required

custom_title

string

required

deduct_type

string

required

deduct_value

string

required

early_discount_type

string

required

early_discount_value

string

required

payment_fees

string

required

early_discount_days

string

required

hide_due_date

string

required

total_amount_word

string

required

invoice_status_days

string

required

total

string

required

total_without_deduct

string

required

due_balalnce

string

required

rounding_value

integer

required

note

string

required

bank_id

string

required

created_by

integer

required

amount_total

string

required

tax_amount_total

integer

required

qty_due_balance

integer

required

rate_value

integer

required

updated_at

string

required

created_at

string

required

integer

required

Sales Invoices Creation#

Request Body Parameters#

Response#

Request

Responses

Sales Invoices Creation

Request Body Parameters

Response