Expenses
A typical expense is incurred when money goes out of your pocket. Whether its a product you buy from your vendor to run your business, or food that you eat while on business trips, it’s important to track the money you spend.
Attribute
business_gst
, business_none
, overseas
, consumer
.vat_registered
,vat_not_registered
,gcc_vat_not_registered
,gcc_vat_registered
,non_gcc
.dz_vat_registered
and dz_vat_not_registered
are supported only for UAE. For Kenya Edition:
vat_registered
,vat_not_registered
,non_kenya
(A business that is located outside Kenya).For SouthAfrica Edition:
vat_registered
, vat_not_registered
, overseas
(A business that is located outside SouthAfrica).place of contact
given for the contact will be taken)Supported codes for UAE emirates are :
Abu Dhabi -
AB
,Ajman -
AJ
,Dubai -
DU
,Fujairah -
FU
,Ras al-Khaimah -
RA
,Sharjah -
SH
,Umm al-Quwain -
UM
.Supported codes for the GCC countries are :
United Arab Emirates -
AE
,Saudi Arabia -
SA
,Bahrain -
BH
,Kuwait -
KW
,Oman -
OM
,Qatar -
QA
.place of contact
given for the contact will be taken)mileage_type
is odometer
.mileage_type
is odometer
.Create an Expense
Create billable or non-billable expense.
OAuth Scope : ZohoBooks.expenses.CREATE
Arguments
place of contact
given for the contact will be taken)place of contact
given for the contact will be taken)Supported codes for UAE emirates are :
Abu Dhabi -
AB
,Ajman -
AJ
,Dubai -
DU
,Fujairah -
FU
,Ras al-Khaimah -
RA
,Sharjah -
SH
,Umm al-Quwain -
UM
.Supported codes for the GCC countries are :
United Arab Emirates -
AE
,Saudi Arabia -
SA
,Bahrain -
BH
,Kuwait -
KW
,Oman -
OM
,Qatar -
QA
.For UK:
digital_service
, goods
and service
.For SouthAfrica Edition:
service
, goods
, capital_service
and capital_goods
uk
. If the vendor is in an EU country & VAT registered, you are resides in Northen Ireland and purchasing Goods then his VAT treatment is eu_vat_registered
and if he resides outside the UK then his VAT treatment is overseas
(For Pre Brexit, this can be split as eu_vat_registered
, eu_vat_not_registered
and non_eu
).vat_registered
,vat_not_registered
,gcc_vat_not_registered
,gcc_vat_registered
,non_gcc
.dz_vat_registered
and dz_vat_not_registered
are supported only for UAE. For Kenya Edition:
vat_registered
,vat_not_registered
,non_kenya
(A business that is located outside Kenya).For SouthAfrica Edition:
vat_registered
, vat_not_registered
, overseas
(A business that is located outside SouthAfrica).For UK:
digital_service
, goods
and service
.For SouthAfrica Edition:
service
, goods
, capital_service
and capital_goods
mileage_type
is odometer
.mileage_type
is odometer
.mileage_type
is manual
km
and mile
car
, van
, motorcycle
and bike
petrol
, lpg
and diesel
less_than_1400cc
, between_1400cc_and_1600cc
, between_1600cc_and_2000cc
and more_than_2000cc
Query Parameters
gif
, png
, jpeg
, jpg
, bmp
, pdf
, xls
, xlsx
, doc
and docx
.Update an expense using a custom field's unique value
A custom field will have unique values if it's configured to not accept duplicate values. Now, you can use that custom field's value to update a expense by providing its API name in the X-Unique-Identifier-Key header and its value in the X-Unique-Identifier-Value header. Based on this value, the corresponding bill expense be retrieved and updated. Additionally, there is an optional X-Upsert header. If the X-Upsert header is true and the custom field's unique value is not found in any of the existing expenses, a new expense will be created if the necessary payload details are available
OAuth Scope : ZohoBooks.expenses.UPDATE
Arguments
place of contact
given for the contact will be taken)place of contact
given for the contact will be taken)Supported codes for UAE emirates are :
Abu Dhabi -
AB
,Ajman -
AJ
,Dubai -
DU
,Fujairah -
FU
,Ras al-Khaimah -
RA
,Sharjah -
SH
,Umm al-Quwain -
UM
.Supported codes for the GCC countries are :
United Arab Emirates -
AE
,Saudi Arabia -
SA
,Bahrain -
BH
,Kuwait -
KW
,Oman -
OM
,Qatar -
QA
.For UK:
digital_service
, goods
and service
.For SouthAfrica Edition:
service
, goods
, capital_service
and capital_goods
uk
. If the vendor is in an EU country & VAT registered, you are resides in Northen Ireland and purchasing Goods then his VAT treatment is eu_vat_registered
and if he resides outside the UK then his VAT treatment is overseas
(For Pre Brexit, this can be split as eu_vat_registered
, eu_vat_not_registered
and non_eu
).vat_registered
,vat_not_registered
,gcc_vat_not_registered
,gcc_vat_registered
,non_gcc
.dz_vat_registered
and dz_vat_not_registered
are supported only for UAE. For Kenya Edition:
vat_registered
,vat_not_registered
,non_kenya
(A business that is located outside Kenya).For SouthAfrica Edition:
vat_registered
, vat_not_registered
, overseas
(A business that is located outside SouthAfrica).For UK:
digital_service
, goods
and service
.For SouthAfrica Edition:
service
, goods
, capital_service
and capital_goods
mileage_type
is odometer
.mileage_type
is odometer
.mileage_type
is manual
km
and mile
car
, van
, motorcycle
and bike
petrol
, lpg
and diesel
less_than_1400cc
, between_1400cc_and_1600cc
, between_1600cc_and_2000cc
and more_than_2000cc
List Expenses
List all the Expenses with pagination.
OAuth Scope : ZohoBooks.expenses.READ
Query Parameters
description_startswith
and description_contains
. Max-length [100]reference_number_startswith
and reference_number_contains
. Max-length [100]date_start
, date_end
, date_before
and date_after
. Format [yyyy-mm-dd]unbilled
, invoiced
, reimbursed
, non-billable
and billable
amount_less_than
, amount_less_equals
, amount_greater_than
and amount_greater_than
account_name_startswith
and account_name_contains
. Max-length [100]customer_name_startswith
and customer_name_contains
. Max-length [100]vendor_name_startswith
and vendor_name_contains
.customer name
or vendor name
. Max-length [100]date
, account_name
, total
, bcy_total
, reference_number
, customer_name
and created_time
Status.All
, Status.Billable
, Status.Nonbillable
, Status.Reimbursed
, Status.Invoiced
and Status.Unbilled
Update an Expense
Update an existing Expense.
OAuth Scope : ZohoBooks.expenses.UPDATE
Arguments
place of contact
given for the contact will be taken)place of contact
given for the contact will be taken)Supported codes for UAE emirates are :
Abu Dhabi -
AB
,Ajman -
AJ
,Dubai -
DU
,Fujairah -
FU
,Ras al-Khaimah -
RA
,Sharjah -
SH
,Umm al-Quwain -
UM
.Supported codes for the GCC countries are :
United Arab Emirates -
AE
,Saudi Arabia -
SA
,Bahrain -
BH
,Kuwait -
KW
,Oman -
OM
,Qatar -
QA
.For UK:
digital_service
, goods
and service
.For SouthAfrica Edition:
service
, goods
, capital_service
and capital_goods
uk
. If the vendor is in an EU country & VAT registered, you are resides in Northen Ireland and purchasing Goods then his VAT treatment is eu_vat_registered
and if he resides outside the UK then his VAT treatment is overseas
(For Pre Brexit, this can be split as eu_vat_registered
, eu_vat_not_registered
and non_eu
).vat_registered
,vat_not_registered
,gcc_vat_not_registered
,gcc_vat_registered
,non_gcc
.dz_vat_registered
and dz_vat_not_registered
are supported only for UAE. For Kenya Edition:
vat_registered
,vat_not_registered
,non_kenya
(A business that is located outside Kenya).For SouthAfrica Edition:
vat_registered
, vat_not_registered
, overseas
(A business that is located outside SouthAfrica).For UK:
digital_service
, goods
and service
.For SouthAfrica Edition:
service
, goods
, capital_service
and capital_goods
mileage_type
is odometer
.mileage_type
is odometer
.mileage_type
is manual
km
and mile
car
, van
, motorcycle
and bike
petrol
, lpg
and diesel
less_than_1400cc
, between_1400cc_and_1600cc
, between_1600cc_and_2000cc
and more_than_2000cc
Query Parameters
gif
, png
, jpeg
, jpg
, bmp
, pdf
, xls
, xlsx
, doc
and docx
.Get an Expense
Get the details of the Expense.
OAuth Scope : ZohoBooks.expenses.READ
Delete an Expense
Delete an existing expense.
OAuth Scope : ZohoBooks.expenses.DELETE
List expense History & Comments
Get history and comments of expense.
OAuth Scope : ZohoBooks.expenses.READ
Create an employee
Create an employee for an expense.
OAuth Scope : ZohoBooks.expenses.CREATE
Arguments
List employees
List employees with pagination.
OAuth Scope : ZohoBooks.expenses.READ
Get an employee
Get the details of the employee.
OAuth Scope : ZohoBooks.expenses.READ
Delete an employee
Delete an existing employee.
OAuth Scope : ZohoBooks.expenses.DELETE
Add receipt to an expense.
Attach a receipt to an expense.
OAuth Scope : ZohoBooks.expenses.CREATE
Query Parameters
gif
, png
, jpeg
, jpg
, bmp
, pdf
, xls
, xlsx
, doc
and docx
.Get an expense receipt
Returns the receipt attached to the expense.
OAuth Scope : ZohoBooks.expenses.READ
Query Parameters
Delete a receipt
Delete the receipt attached to the expense.
OAuth Scope : ZohoBooks.expenses.DELETE