Bank Transactions
In many instances, you would wish to record manual entries for your offline transactions for your bank or credit card accounts. These entries might not be a part of your bank feeds but would make an important entry for your business records.
Attribute
Allowed transaction types : deposit, refund(*Supported only in Credit Card accounts), transfer_fund, card_payment, sales_without_invoices, expense_refund, owner_contribution, interest_income, other_income, owner_drawings, sales_return
Note: You will not be able to create the following module-specific transaction types under Bank Transaction endpoints :
uk
. If the customer or vendor is in an EU country & VAT registered, you are resides in Northen Ireland and purchasing/selling Goods then his VAT treatment is eu_vat_registered
. And, if he resides outside the UK then his VAT treatment is overseas
.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 and Europe:
digital_service
, goods
and service
.For SouthAfrica Edition:
service
, goods
, capital_service
and capital_goods
Create a transaction for an account
Create a bank transaction based on the allowed transaction types.
OAuth Scope : ZohoBooks.banking.CREATE
Arguments
Allowed transaction types : deposit, refund(*Supported only in Credit Card accounts), transfer_fund, card_payment, sales_without_invoices, expense_refund, owner_contribution, interest_income, other_income, owner_drawings, sales_return
Note: You will not be able to create the following module-specific transaction types under Bank Transaction endpoints :
Get transactions list
Get all the transaction details involved in an account.
OAuth Scope : ZohoBooks.banking.READ
Query Parameters
date_start
and date_end
amount_start
and amount_end
Status.All
, Status.Uncategorized
, Status.Categorized
, Status.ManuallyAdded
, Status.Excluded
and Status.Matched
.date
.Update a transaction
Make changes in the applicable fields of a transaction and update it.
OAuth Scope : ZohoBooks.banking.UPDATE
Arguments
Allowed transaction types : deposit, refund(*Supported only in Credit Card accounts), transfer_fund, card_payment, sales_without_invoices, expense_refund, owner_contribution, interest_income, other_income, owner_drawings, sales_return
Note: You will not be able to create the following module-specific transaction types under Bank Transaction endpoints :
Get transaction
Fetch the details of a transaction by specifying the transaction_id.
OAuth Scope : ZohoBooks.banking.READ
Delete a transaction
Delete a transaction from an account by specifying the transaction_id.
OAuth Scope : ZohoBooks.banking.DELETE
Match a transaction
Match an uncategorized transaction with an existing transaction in the account.
OAuth Scope : ZohoBooks.banking.CREATE
Arguments
Allowed transaction types : deposit, refund(*Supported only in Credit Card accounts), transfer_fund, card_payment, sales_without_invoices, expense_refund, owner_contribution, interest_income, other_income, owner_drawings, sales_return
Note: You will not be able to create the following module-specific transaction types under Bank Transaction endpoints :
Query Parameters
Get matching transactions
Provide criteria to search for matching uncategorised transactions. The list of transactions can also include invoices/bills/credit-notes which will not be matched directly. Instead, a new (payment/refund) transaction is recorded and matched.
OAuth Scope : ZohoBooks.banking.READ
Query Parameters
Allowed transaction types : deposit, refund(*Supported only in Credit Card accounts), transfer_fund, card_payment, sales_without_invoices, expense_refund, owner_contribution, interest_income, other_income, owner_drawings, sales_return
Note: You will not be able to create the following module-specific transaction types under Bank Transaction endpoints :
Unmatch a matched transaction
Unmatch a transaction that was previously matched and make it uncategorized.
OAuth Scope : ZohoBooks.banking.CREATE
Query Parameters
Exclude a transaction
Exclude a transaction from your bank or credit card account.
OAuth Scope : ZohoBooks.banking.CREATE
Query Parameters
Restore a transaction
Restore an excluded transaction in your account.
OAuth Scope : ZohoBooks.banking.CREATE
Query Parameters
Categorize an uncategorized transaction
Categorize an uncategorized transaction by creating a new transaction.
OAuth Scope : ZohoBooks.banking.CREATE
Arguments
Allowed transaction types : deposit, refund(*Supported only in Credit Card accounts), transfer_fund, card_payment, sales_without_invoices, expense_refund, owner_contribution, interest_income, other_income, owner_drawings, sales_return
Note: You will not be able to create the following module-specific transaction types under Bank Transaction endpoints :
Categorize as expense
Categorize an Uncategorized transaction as expense.
OAuth Scope : ZohoBooks.banking.CREATE
Arguments
petrol
, lpg
, diesel
less_than_1400cc
, between_1401cc_and_1600cc
, between_1601cc_and_2000cc
and more_than_2000cc
gmaps
,imaps
,gps
,odometer
,wmaps
,manual
,non_mileage
and per_diem
uk
. If the customer or vendor is in an EU country & VAT registered, you are resides in Northen Ireland and purchasing/selling Goods then his VAT treatment is eu_vat_registered
. And, if he resides outside the UK then his VAT treatment is overseas
.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 and Europe:
digital_service
, goods
and service
.For SouthAfrica Edition:
service
, goods
, capital_service
and capital_goods
For UK and Europe:
digital_service
, goods
and service
.For SouthAfrica Edition:
service
, goods
, capital_service
and capital_goods
Query Parameters
Uncategorize a categorized transaction
Revert a categorized transaction as uncategorized.
OAuth Scope : ZohoBooks.banking.CREATE
Query Parameters
Categorize a vendor payment
Categorize an uncategorized transaction as Vendor Payment.
OAuth Scope : ZohoBooks.banking.CREATE
Arguments
Categorize as customer payment
Categorize an uncategorized transaction as Customer Payment.
OAuth Scope : ZohoBooks.banking.CREATE
Arguments
Categorize as credit note refunds
Categorize an Uncategorized transaction as a refund from a credit note.
OAuth Scope : ZohoBooks.banking.CREATE
Arguments
Categorize as vendor credit refunds
Categorize an uncategorized transaction as a refund from a vendor credit.
OAuth Scope : ZohoBooks.banking.CREATE
Arguments
Categorize as Customer Payment refund
Categorizing bank transactions as Payment Refund.
OAuth Scope : ZohoBooks.banking.CREATE
Arguments
Categorize as Vendor Payment refund
Categorizing bank transactions as Vendor Payment Refund.
OAuth Scope : ZohoBooks.banking.CREATE