Expenses

Create an Expense

Create billable or non-billable expense.
OAuth Scope : ZohoBooks.expenses.CREATE

Arguments

account_id

string

(Required)

ID of the expense account.

date

string

(Required)

Date of the expense

amount

double

(Required)

Amount of the Expense.

tax_id

string

source_of_supply

string

🇮🇳 India

only

Place from where the goods/services are supplied. (If not given, place of contact given for the contact will be taken)

destination_of_supply

string

🇮🇳 India

only

Place where the goods/services are supplied to. (If not given, organisation's home state will be taken)

place_of_supply

string

GCC only

The place of supply is where a transaction is considered to have occurred for VAT purposes. For the supply of goods, the place of supply is the location of the goods when the supply occurs. For the supply of services, the place of supply should be where the supplier is established. (If not given, 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.

hsn_or_sac

string

🇮🇳 India

, 🇰🇪 Kenya

only

Add HSN/SAC code for your goods/services

gst_no

string

🇮🇳 India

only

15 digit GST identification number of the vendor.

reverse_charge_tax_id

string

ID of the reverse charge tax

line_items

array

Show Sub-Attributes

line_item_id

string

account_id

string

(Required)

ID of the expense account.

description

string

Description of the expense. Max-length [100]

amount

double

(Required)

Amount of the Expense.

tax_id

string

item_order

string

product_type

string

🇬🇧 United Kingdom

, 🇿🇦 South Africa

only

Type of the expense. This denotes whether the expense is to be treated as a goods or service or capital asset purchase. Allowed Values:
For UK: digital_service, goods and service.
For SouthAfrica Edition: service, goods, capital_service and capital_goods

acquisition_vat_id

string

🇬🇧 United Kingdom

only

This is the ID of the tax applied in case this is an EU - goods expense and acquisition VAT needs to be reported.

reverse_charge_vat_id

string

🇬🇧 United Kingdom

only

This is the ID of the tax applied in case this is a non UK - service expense and reverse charge VAT needs to be reported.

reverse_charge_tax_id

string

ID of the reverse charge tax

tax_exemption_code

string

🇮🇳 India

only

Enter tax exemption code

tax_exemption_id

string

🇮🇳 India

only

Enter tax exemption ID

taxes

array

🇲🇽 Mexico

only

Show Sub-Attributes

tax_id

string

tax_amount

double

is_inclusive_tax

boolean

is_billable

boolean

reference_number

string

Reference number of the expense. Max-length [100]

description

string

Description of the expense. Max-length [100]

customer_id

string

ID of the expense account.

currency_id

string

exchange_rate

double

project_id

string

ID of the project associated with the customer.

mileage_type

string

vat_treatment

string

🇬🇧 United Kingdom

only

VAT treatment for the expense. VAT treatment denotes the location of the vendor, if the vendor resides in UK then the VAT treatment is 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).

tax_treatment

string

GCC , 🇰🇪 Kenya

, 🇿🇦 South Africa

only

VAT treatment for the expense .Choose whether the contact falls under: 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).

product_type

string

🇬🇧 United Kingdom

, 🇿🇦 South Africa

only

Type of the expense. This denotes whether the expense is to be treated as a goods or service or capital asset purchase. Allowed Values:
For UK: digital_service, goods and service.
For SouthAfrica Edition: service, goods, capital_service and capital_goods

acquisition_vat_id

string

🇬🇧 United Kingdom

only

This is the ID of the tax applied in case this is an EU - goods expense and acquisition VAT needs to be reported.

reverse_charge_vat_id

string

🇬🇧 United Kingdom

only

This is the ID of the tax applied in case this is a non UK - service expense and reverse charge VAT needs to be reported.

start_reading

double

Start reading of odometer when creating a mileage expense where mileage_type is odometer.

end_reading

double

End reading of odometer when creating a mileage expense where mileage_type is odometer.

distance

string

Distance travelled for a particular mileage expense where mileage_type is manual

mileage_unit

string

Unit of the distance travelled. Allowed Values: km and mile

mileage_rate

double

Mileage rate for a particular mileage expense.

employee_id

string

🇬🇧 United Kingdom

only

ID of the employee who has submitted this mileage expense.

vehicle_type

string

🇬🇧 United Kingdom

only

Vehicle type for a particular mileage expense. Allowed Values: car, van, motorcycle and bike

can_reclaim_vat_on_mileage

string

🇬🇧 United Kingdom

only

To specify if tax can be reclaimed for this mileage expense.

fuel_type

string

🇬🇧 United Kingdom

only

Fuel type for a particular mileage expense. Allowed Values: petrol, lpg and diesel

engine_capacity_range

string

🇬🇧 United Kingdom

only

Engine capacity range for a particular mileage expense. Allowed Values: less_than_1400cc, between_1400cc_and_1600cc, between_1600cc_and_2000cc and more_than_2000cc

paid_through_account_id

string

(Required)

Search expenses by paid through account id.

vendor_id

string

ID of the vendor the expense is made.

custom_fields

array

Custom fields for an expense.

Query Parameters

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

account_id

string

(Required)

ID of the expense account.

date

string

(Required)

Date of the expense

amount

double

(Required)

Amount of the Expense.

tax_id

string

source_of_supply

string

🇮🇳 India

only

Place from where the goods/services are supplied. (If not given, place of contact given for the contact will be taken)

destination_of_supply

string

🇮🇳 India

only

Place where the goods/services are supplied to. (If not given, organisation's home state will be taken)

place_of_supply

string

GCC only

The place of supply is where a transaction is considered to have occurred for VAT purposes. For the supply of goods, the place of supply is the location of the goods when the supply occurs. For the supply of services, the place of supply should be where the supplier is established. (If not given, 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.

hsn_or_sac

string

🇮🇳 India

, 🇰🇪 Kenya

only

Add HSN/SAC code for your goods/services

gst_no

string

🇮🇳 India

only

15 digit GST identification number of the vendor.

reverse_charge_tax_id

string

ID of the reverse charge tax

line_items

array

Show Sub-Attributes

line_item_id

string

account_id

string

(Required)

ID of the expense account.

description

string

Description of the expense. Max-length [100]

amount

double

(Required)

Amount of the Expense.

tax_id

string

item_order

string

product_type

string

🇬🇧 United Kingdom

, 🇿🇦 South Africa

only

Type of the expense. This denotes whether the expense is to be treated as a goods or service or capital asset purchase. Allowed Values:
For UK: digital_service, goods and service.
For SouthAfrica Edition: service, goods, capital_service and capital_goods

acquisition_vat_id

string

🇬🇧 United Kingdom

only

This is the ID of the tax applied in case this is an EU - goods expense and acquisition VAT needs to be reported.

reverse_charge_vat_id

string

🇬🇧 United Kingdom

only

This is the ID of the tax applied in case this is a non UK - service expense and reverse charge VAT needs to be reported.

reverse_charge_tax_id

string

ID of the reverse charge tax

tax_exemption_code

string

🇮🇳 India

only

Enter tax exemption code

tax_exemption_id

string

🇮🇳 India

only

Enter tax exemption ID

taxes

array

🇲🇽 Mexico

only

Show Sub-Attributes

tax_id

string

tax_amount

double

is_inclusive_tax

boolean

is_billable

boolean

reference_number

string

Reference number of the expense. Max-length [100]

description

string

Description of the expense. Max-length [100]

customer_id

string

ID of the expense account.

currency_id

string

exchange_rate

double

project_id

string

ID of the project associated with the customer.

mileage_type

string

vat_treatment

string

🇬🇧 United Kingdom

only

VAT treatment for the expense. VAT treatment denotes the location of the vendor, if the vendor resides in UK then the VAT treatment is 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).

tax_treatment

string

GCC , 🇰🇪 Kenya

, 🇿🇦 South Africa

only

VAT treatment for the expense .Choose whether the contact falls under: 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).

product_type

string

🇬🇧 United Kingdom

, 🇿🇦 South Africa

only

Type of the expense. This denotes whether the expense is to be treated as a goods or service or capital asset purchase. Allowed Values:
For UK: digital_service, goods and service.
For SouthAfrica Edition: service, goods, capital_service and capital_goods

acquisition_vat_id

string

🇬🇧 United Kingdom

only

This is the ID of the tax applied in case this is an EU - goods expense and acquisition VAT needs to be reported.

reverse_charge_vat_id

string

🇬🇧 United Kingdom

only

This is the ID of the tax applied in case this is a non UK - service expense and reverse charge VAT needs to be reported.

start_reading

double

Start reading of odometer when creating a mileage expense where mileage_type is odometer.

end_reading

double

End reading of odometer when creating a mileage expense where mileage_type is odometer.

distance

string

Distance travelled for a particular mileage expense where mileage_type is manual

mileage_unit

string

Unit of the distance travelled. Allowed Values: km and mile

mileage_rate

double

Mileage rate for a particular mileage expense.

employee_id

string

🇬🇧 United Kingdom

only

ID of the employee who has submitted this mileage expense.

vehicle_type

string

🇬🇧 United Kingdom

only

Vehicle type for a particular mileage expense. Allowed Values: car, van, motorcycle and bike

can_reclaim_vat_on_mileage

string

🇬🇧 United Kingdom

only

To specify if tax can be reclaimed for this mileage expense.

fuel_type

string

🇬🇧 United Kingdom

only

Fuel type for a particular mileage expense. Allowed Values: petrol, lpg and diesel

engine_capacity_range

string

🇬🇧 United Kingdom

only

Engine capacity range for a particular mileage expense. Allowed Values: less_than_1400cc, between_1400cc_and_1600cc, between_1600cc_and_2000cc and more_than_2000cc

paid_through_account_id

string

(Required)

Search expenses by paid through account id.

vendor_id

string

ID of the vendor the expense is made.

custom_fields

array

Custom fields for an expense.

List Expenses

List all the Expenses with pagination.
OAuth Scope : ZohoBooks.expenses.READ

Query Parameters

Update an Expense

Update an existing Expense.
OAuth Scope : ZohoBooks.expenses.UPDATE

Arguments

account_id

string

(Required)

ID of the expense account.

date

string

(Required)

Date of the expense

amount

double

(Required)

Amount of the Expense.

tax_id

string

source_of_supply

string

🇮🇳 India

only

Place from where the goods/services are supplied. (If not given, place of contact given for the contact will be taken)

destination_of_supply

string

🇮🇳 India

only

Place where the goods/services are supplied to. (If not given, organisation's home state will be taken)

place_of_supply

string

GCC only

The place of supply is where a transaction is considered to have occurred for VAT purposes. For the supply of goods, the place of supply is the location of the goods when the supply occurs. For the supply of services, the place of supply should be where the supplier is established. (If not given, 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.

hsn_or_sac

string

🇮🇳 India

, 🇰🇪 Kenya

only

Add HSN/SAC code for your goods/services

gst_no

string

🇮🇳 India

only

15 digit GST identification number of the vendor.

reverse_charge_tax_id

string

ID of the reverse charge tax

line_items

array

Show Sub-Attributes

line_item_id

string

account_id

string

(Required)

ID of the expense account.

description

string

Description of the expense. Max-length [100]

amount

double

(Required)

Amount of the Expense.

tax_id

string

item_order

string

product_type

string

🇬🇧 United Kingdom

, 🇿🇦 South Africa

only

Type of the expense. This denotes whether the expense is to be treated as a goods or service or capital asset purchase. Allowed Values:
For UK: digital_service, goods and service.
For SouthAfrica Edition: service, goods, capital_service and capital_goods

acquisition_vat_id

string

🇬🇧 United Kingdom

only

This is the ID of the tax applied in case this is an EU - goods expense and acquisition VAT needs to be reported.

reverse_charge_vat_id

string

🇬🇧 United Kingdom

only

This is the ID of the tax applied in case this is a non UK - service expense and reverse charge VAT needs to be reported.

reverse_charge_tax_id

string

ID of the reverse charge tax

tax_exemption_code

string

🇮🇳 India

only

Enter tax exemption code

tax_exemption_id

string

🇮🇳 India

only

Enter tax exemption ID

taxes

array

🇲🇽 Mexico

only

Show Sub-Attributes

tax_id

string

tax_amount

double

is_inclusive_tax

boolean

is_billable

boolean

reference_number

string

Reference number of the expense. Max-length [100]

description

string

Description of the expense. Max-length [100]

customer_id

string

ID of the expense account.

currency_id

string

exchange_rate

double

project_id

string

ID of the project associated with the customer.

mileage_type

string

vat_treatment

string

🇬🇧 United Kingdom

only

VAT treatment for the expense. VAT treatment denotes the location of the vendor, if the vendor resides in UK then the VAT treatment is 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).

tax_treatment

string

GCC , 🇰🇪 Kenya

, 🇿🇦 South Africa

only

VAT treatment for the expense .Choose whether the contact falls under: 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).

product_type

string

🇬🇧 United Kingdom

, 🇿🇦 South Africa

only

Type of the expense. This denotes whether the expense is to be treated as a goods or service or capital asset purchase. Allowed Values:
For UK: digital_service, goods and service.
For SouthAfrica Edition: service, goods, capital_service and capital_goods

acquisition_vat_id

string

🇬🇧 United Kingdom

only

This is the ID of the tax applied in case this is an EU - goods expense and acquisition VAT needs to be reported.

reverse_charge_vat_id

string

🇬🇧 United Kingdom

only

This is the ID of the tax applied in case this is a non UK - service expense and reverse charge VAT needs to be reported.

start_reading

double

Start reading of odometer when creating a mileage expense where mileage_type is odometer.

end_reading

double

End reading of odometer when creating a mileage expense where mileage_type is odometer.

distance

string

Distance travelled for a particular mileage expense where mileage_type is manual

mileage_unit

string

Unit of the distance travelled. Allowed Values: km and mile

mileage_rate

double

Mileage rate for a particular mileage expense.

employee_id

string

🇬🇧 United Kingdom

only

ID of the employee who has submitted this mileage expense.

vehicle_type

string

🇬🇧 United Kingdom

only

Vehicle type for a particular mileage expense. Allowed Values: car, van, motorcycle and bike

can_reclaim_vat_on_mileage

string

🇬🇧 United Kingdom

only

To specify if tax can be reclaimed for this mileage expense.

fuel_type

string

🇬🇧 United Kingdom

only

Fuel type for a particular mileage expense. Allowed Values: petrol, lpg and diesel

engine_capacity_range

string

🇬🇧 United Kingdom

only

Engine capacity range for a particular mileage expense. Allowed Values: less_than_1400cc, between_1400cc_and_1600cc, between_1600cc_and_2000cc and more_than_2000cc

paid_through_account_id

string

(Required)

Search expenses by paid through account id.

vendor_id

string

ID of the vendor the expense is made.

custom_fields

array

Custom fields for an expense.

Query Parameters

Get an Expense

Get the details of the Expense.
OAuth Scope : ZohoBooks.expenses.READ