Recurring Expenses
Recurring expenses are those expenses that repeat itself after a fixed interval of time.
Attribute
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
. 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).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
).For SouthAfrica edition:(Required if customer tax treatment is
vat_registered
)Used to specify whether the transaction is applicable for Domestic Reverse Charge (DRC) or not.
For UK edition:
digital_service
, goods
and service
.For SouthAfrica Edition:
service
, goods
, capital_service
and capital_goods
For SouthAfrica edition:(Required if customer tax treatment is
vat_registered
)Used to specify whether the transaction is applicable for Domestic Reverse Charge (DRC) or not.
Create a recurring expense
Create a recurring 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 SouthAfrica edition:(Required if customer tax treatment is
vat_registered
)Used to specify whether the transaction is applicable for Domestic Reverse Charge (DRC) or not.
For UK edition:
digital_service
, goods
and service
.For SouthAfrica Edition:
service
, goods
, capital_service
and capital_goods
For SouthAfrica edition:(Required if customer tax treatment is
vat_registered
)Used to specify whether the transaction is applicable for Domestic Reverse Charge (DRC) or not.
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 edition:
digital_service
, goods
and service
.For SouthAfrica Edition:
service
, goods
, capital_service
and capital_goods
Update an recurring 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 recurring 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 recurring expense will 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 recurring expenses, a new recurring 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 SouthAfrica edition:(Required if customer tax treatment is
vat_registered
)Used to specify whether the transaction is applicable for Domestic Reverse Charge (DRC) or not.
For UK edition:
digital_service
, goods
and service
.For SouthAfrica Edition:
service
, goods
, capital_service
and capital_goods
For SouthAfrica edition:(Required if customer tax treatment is
vat_registered
)Used to specify whether the transaction is applicable for Domestic Reverse Charge (DRC) or not.
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 edition:
digital_service
, goods
and service
.For SouthAfrica Edition:
service
, goods
, capital_service
and capital_goods
List recurring expenses
List all the Expenses with pagination.
OAuth Scope : ZohoBooks.expenses.READ
Query Parameters
recurrence_name_startswith
and recurrence_name_contains
. Max-length [100]last_created_date_start
, last_created_date_end
, last_created_date_before
and last_created_date_after
. Format [yyyy-mm-dd]next_expense_date_start
, next_expense_date_end
, next_expense_date_before
and next_expense_date_after
. Format [yyyy-mm-dd]active
, stopped
and expired
account_name_startswith
and account_name_contains
. Max-length [100]amount_less_than
, amount_less_equals
, amount_greater_than
and amount_greater_than
customer_name_startswith
and customer_name_contains
. Max-length [100]Status.All
, Status.Active
, Status.Expired
and Status.Stopped
customer name
or vendor name
. Max-length [100] .next_expense_date
, account_name
, total
, last_created_date
, recurrence_name
, customer_name
and created_time
Update a recurring expense
Update a recurring 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 SouthAfrica edition:(Required if customer tax treatment is
vat_registered
)Used to specify whether the transaction is applicable for Domestic Reverse Charge (DRC) or not.
For UK edition:
digital_service
, goods
and service
.For SouthAfrica Edition:
service
, goods
, capital_service
and capital_goods
For SouthAfrica edition:(Required if customer tax treatment is
vat_registered
)Used to specify whether the transaction is applicable for Domestic Reverse Charge (DRC) or not.
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 edition:
digital_service
, goods
and service
.For SouthAfrica Edition:
service
, goods
, capital_service
and capital_goods
Get a recurring expense
Get the details of the recurring expense.
OAuth Scope : ZohoBooks.expenses.READ
Delete a recurring expense
Deleting an existing recurring expense.
OAuth Scope : ZohoBooks.expenses.DELETE
Stop a recurring expense
Stop an active recurring expense.
OAuth Scope : ZohoBooks.expenses.CREATE
Resume a recurring Expense
Resume a stopped recurring expense.
OAuth Scope : ZohoBooks.expenses.CREATE
List child expenses created
List child expenses created from recurring expense.
OAuth Scope : ZohoBooks.expenses.READ
Query Parameters
next_expense_date
, account_name
, total
, last_created_date
, recurrence_name
, customer_name
and created_time
List recurring expense history
Get history and comments of a recurring expense.
OAuth Scope : ZohoBooks.expenses.READ