Skip to main content

Understanding and Managing Tax Treatment in Alaan for Zoho Books

Learn how Alaan simplifies VAT reporting by automatically applying Tax Treatment and compatible Tax Codes to Zoho Books exports.

What is Tax Treatment in Zoho Books

Tax Treatment determines how VAT should be applied to a transaction based on the supplier's VAT registration status, location, and applicable tax rules.

For example, the Tax Treatment may differ depending on whether a supplier is VAT-registered in the UAE, located outside the GCC, or operating in a designated zone.

In Zoho Books, Tax Treatment and Tax Code serve different purposes:

  • Tax Treatment: Determines why a particular VAT treatment applies to a transaction.

  • Tax Code: Determines the VAT rate or tax calculation applied to the transaction.


How Does Tax Treatment Work in Alaan

With the updated integration, Alaan automatically retrieves the Tax Treatment from the selected vendor's record in Zoho Books and applies it to the transaction.

Alaan also supports Reverse Charge and Exempt Tax Codes, allowing you to select the appropriate Tax Code based on the vendor's Tax Treatment.

This helps ensure that the correct Tax Treatment and compatible Tax Code are applied before exporting, reducing the need for manual corrections in Zoho Books.


How to Enable and Apply Tax Treatment in Alaan

The Tax Treatment feature is available to customers using Vendor Mapping with their Zoho Books integration.

If Vendor Mapping is already enabled, no additional setup is required.

Watch the video below or follow the steps to learn how to enable Vendor Mapping, apply Tax Treatment, and export expenses with compatible Tax Codes.

Step 1: Enable Vendor Mapping

  1. Log in to your Alaan web portal.

  2. Navigate to Settings → Integrations → Zoho Books.

  3. Open your Zoho Books integration settings.

  4. Enable Vendor Mapping.

Once enabled, the Tax Treatment column will appear in the Prepare and Export tabs of the accounting page, alongside the Vendor and Tax Code columns.

Note: If you use Alaan Suppliers instead of Vendor Mapping, your existing export process will continue as before, and the Tax Treatment column will not be displayed.

Step 2: Select a Vendor

Go to the Prepare tab on the accounting page and select a vendor.

The Tax Treatment column will automatically populate based on the vendor's details in Zoho Books.

Step 3: Select a Tax Code

Open the Tax Code dropdown and select a compatible Tax Code.

Codes that are not supported for the selected Tax Treatment will appear greyed out.

Step 4: Review and Export

Review the Tax Treatment and Tax Code, then export the transaction to Zoho Books.

Both details will be included in the export.

Important things to know:

  • If you change the vendor and the previously selected Tax Code is no longer compatible, Alaan will automatically clear it. You must select a valid Tax Code before exporting.

  • Previously exported transactions will remain unchanged.


Which Tax Codes Are Supported for Each Tax Treatment

The table below shows which Tax Codes are supported for each Tax Treatment in Zoho Books.

Tax Treatment

Standard Rate (5%)

Zero Rate (0%)

Exempt

Reverse Charge (5%)

Reverse Charge (0%)

VAT Registered

Yes

Yes

Yes

Yes

Yes

Non VAT Registered

—

—

—

Yes

Yes

GCC VAT Registered

—

—

Yes

Yes

Yes

GCC Non VAT Registered

—

—

Yes

Yes

Yes

Non GCC

—

—

Yes

Yes

Yes

Non VAT

—

—

Yes

—

—

VAT Registered – Designated Zone

Yes

Yes

Yes

—

—

Non VAT Registered – Designated Zone

—

—

—

Yes

Yes

Note: Reverse Charge Tax Codes must be configured in your Zoho Books account before they can be selected in Alaan.

If these codes are unavailable, refer to our Import or Create Your Tax Codes guide.

For more information about VAT treatment in Zoho Books, refer to Zoho Books – VAT in Transactions.


How to Update a Vendor's Tax Treatment

Tax Treatment is retrieved directly from the vendor's record in Zoho Books and cannot be edited directly in Alaan.

If the Tax Treatment is incorrect, follow these steps:

Step 1: Log in to your Zoho Books account.

Step 2: Locate the relevant vendor record.

Step 3: Update the vendor's Tax Treatment and s ave the changes.

Alaan will retrieve the updated Tax Treatment during the next sync and apply it to transactions coded afterward.

Note: Transactions already in Ready to Export will retain the Tax Treatment assigned when they were prepared.

To apply the updated treatment to an existing prepared transaction, move it back to the Prepare tab and review the vendor and Tax Code again.


FAQ

Do I need to enable anything to use Tax Treatment?

  • No additional setup is required if Vendor Mapping is already enabled for your Zoho Books integration.

  • If it is disabled, you can enable it under Settings → Integrations → Zoho Books.

Why can't I see the Tax Treatment column?

  • The Tax Treatment column is only displayed when Vendor Mapping is enabled.

  • To enable it, navigate to Settings → Integrations → Zoho Books and turn on Vendor Mapping.

  • If you use Alaan Suppliers instead, your existing export workflow will remain unchanged.

Why is the Tax Treatment field empty for a transaction?

  • This may happen if:

    • No vendor has been selected for the transaction.

    • The selected vendor does not have a Tax Treatment configured in Zoho Books.

  • Check the vendor's Tax Treatment in Zoho Books, update it if necessary, and reselect the vendor in Alaan.

Why are some Tax Codes greyed out?

  • Tax Codes are greyed out when they are not compatible with the selected vendor's Tax Treatment.

  • You can either select a supported Tax Code or update the vendor's Tax Treatment in Zoho Books if it is incorrect.

  • Refer to the compatibility table above to check which Tax Codes are supported.

Can I manually change the Tax Treatment for an individual expense?

  • No. Tax Treatment is automatically retrieved from the selected vendor's record in Zoho Books. To change it, update the vendor's Tax Treatment in Zoho Books.

What happens if I change the vendor after selecting a Tax Code?

  • If the previously selected Tax Code is not supported for the new vendor's Tax Treatment, Alaan will automatically clear it.

  • You must select a compatible Tax Code before exporting.

Will previously exported transactions be updated?

  • No. Transactions exported before this feature was introduced will remain unchanged.

  • Alaan does not automatically update previously exported transactions in Zoho Books.

I updated a vendor's Tax Treatment in Zoho Books. Will my prepared transactions update automatically?

  • Transactions already in Ready to Export will retain their existing Tax Treatment.

  • To apply the updated treatment, move the transaction back to Prepare and review the vendor details.

Does Reverse Charge affect the amount charged to my card?

  • No. Reverse Charge affects how VAT is recorded in Zoho Books. It does not change the original expense amount charged to your card.

How does Tax Treatment work for split expenses?

  • Each split line can have its own Tax Code. However, the Tax Treatment is retrieved from the vendor associated with the transaction and applies to the entire entry.

Does Tax Treatment apply to both expenses and bills?

  • Yes. Tax Treatment is supported for both expense exports and bill exports to Zoho Books.

What should I do if Reverse Charge Tax Codes are unavailable?

  • Ensure that the required Reverse Charge Tax Codes are configured in your Zoho Books account. You can refer to our Import or Create Your Tax Codes guide for assistance.

Need Help? Please contact us at [email protected] or reach out through the in-app chat.

Did this answer your question?