Connecting Zoho Books
Zoho Books is connected through OAuth, which means FiscoBridge securely links to your Zoho account without you needing to share credentials. Once connected, your Zoho Books invoices are automatically synced and fiscalized.
Setting Up the Connection
- Go to Integrations → Integrations in the sidebar
- Click Create Integration
- On the New Integration page, select the Zoho Books card

An Upload Certificate dialog opens — select your PFX certificate file and enter its password, then click Upload
After the certificate is uploaded, the Connect Zoho Books dialog opens. Choose:
- Fiscalize invoice — when invoices from Zoho Books should be fiscalized (see Fiscalization Trigger below)
- Receipt format — Receipt slip (journal) or A4 invoice: the layout of the fiscal receipt PDF attached in Zoho Books and offered on the receipt link
- Training mode — leave off for live fiscal receipts, or turn on to send test (Training) invoices
Then click Connect
You'll be redirected to Zoho's authorization page
Log in to your Zoho account (if not already logged in)
Allow FiscoBridge access

- You'll be redirected back to the Customer Portal. If your Zoho account has more than one organization, the portal shows a Select Zoho Organization page listing each organization with its ID — pick the one you want to connect. With a single organization this step is skipped.
Once authorized, the Zoho Books integration appears in your integrations list with status Active.

Fiscalization Trigger
When you connect Zoho Books, you decide at what point each invoice should be fiscalized. There are two options:
When invoice is marked as sent (default)
The invoice is fiscalized as soon as it leaves Draft in Zoho Books — that is, when you send it to the customer or click Mark as Sent. Invoices that are already Viewed, Overdue, Unpaid, Partially Paid or Paid count as sent too.
- Best when you issue the fiscal receipt at the moment of sale, regardless of payment status
- Useful for credit sales where the customer pays later but the invoice is finalized immediately
- You can keep an invoice in Draft and edit it as many times as needed — fiscalization only happens once you send it
When payment is added
The invoice is fiscalized only once its status becomes Paid in Zoho Books.
- Best when you want the fiscal receipt to reflect the moment of payment
- Works well for businesses that record the payment in Zoho Books at the time of sale
- Sent but unpaid invoices stay in Zoho Books without being sent to the tax authority
- Partially paid invoices are not fiscalized until the balance reaches zero
Draft and Pending Approval invoices are never fiscalized under either option. Each invoice is fiscalized once; a later status change (for example from Sent to Paid) does not produce a second receipt. Voiding a fiscalized invoice cancels its fiscal receipt — see Voids and Credit Notes.
Note: To change the trigger, receipt format or training mode later, open the ⋮ menu on the Zoho Books integration and choose Settings. The new settings apply to invoices processed from then on.
Sales Receipts
Zoho Books sales receipts (Sales → Sales Receipts) record a sale that is paid on the spot, which is how many businesses bill cash customers. By default FiscoBridge fiscalizes invoices only. To fiscalize sales receipts as well:
- Go to Integrations → Integrations in the Customer Portal
- Open the ⋮ menu on your Zoho Books integration and choose Settings
- Turn on Fiscalize sales receipts and click Save changes
From then on:
- Every sales receipt you save in Zoho Books is fiscalized once, within about 5 minutes. A sales receipt is paid as soon as it is saved, so the Fiscalize invoice trigger does not apply to it
- The fiscal receipt number, total and verification link are written back to the sales receipt as a comment, and the fiscal receipt PDF is attached to it, the same as for invoices
- Sales receipts created before you turned the setting on are not fiscalized
- Sales receipts use the same tax labels as invoices
- Each fiscalized sales receipt counts towards your monthly invoice limit like any other fiscal document
Voiding a sales receipt
When you void a sales receipt that FiscoBridge has fiscalized, FiscoBridge issues a fiscal cancellation (a full refund referencing the original receipt) and writes it back to the voided sales receipt. Voids are picked up within about 15 minutes, for sales receipts dated within the last 7 days.
Note: Zoho Books has no credit note or partial refund for a sales receipt. To reverse part of a cash sale, void the sales receipt and issue a new one for the correct amount. Deleting a sales receipt in Zoho Books does not cancel its fiscal receipt, so void it instead.
Note: A sales receipt is picked up by its receipt date. If you back-date a sales receipt by more than one day it is not fiscalized. The Zoho Books webhook does not cover sales receipts.
Webhook Setup (Optional)
A webhook makes Zoho Books notify FiscoBridge as soon as an invoice or credit note changes, so documents are fiscalized in near real-time once they reach the chosen trigger. Each Zoho Books integration has its own webhook URL and secret token.
Note: Webhooks are set up through Zoho's Workflow Rules, which are not included in the Zoho Books Free plan. On the Free plan, skip this section — invoices are still picked up automatically every 5 minutes, and credit notes every 15 minutes.
- Go to Integrations → Integrations in the Customer Portal
- Open the ⋮ menu on your Zoho Books integration and choose Webhook

- Copy the Webhook URL and the Secret token shown in the dialog

- In Zoho Books, go to Settings → Automation → Workflow Rules
- Create a new rule for the Invoices module, triggered when an invoice is created or edited
- Add a Webhook action with the copied URL and the POST method
- Select the Default payload format
- Tick I want to secure this webhook and paste the secret token
- Repeat steps 5–8 for the Credit Notes module, using the same URL and secret token, so credit notes are picked up in near real-time as well
Note: Zoho Books doesn't show the secret token again after you save the webhook, but you can always view it in the Webhook dialog in the Customer Portal. If you click Regenerate token, the old token stops working immediately. Delete the webhook action in Zoho Books and add it again with the new token.
Note: Without webhook setup, invoices are polled every 5 minutes and credit notes every 15 minutes automatically. The poll looks at documents modified since the previous poll, so an invoice created as a draft on one day and marked as sent on another is still picked up.
How It Works
- Invoices in your Zoho Books account are synced to FiscoBridge
- When an invoice reaches the chosen fiscalization trigger, it is signed with your fiscal certificate and reported to the tax authority
- The fiscal receipt number, total and verification link are written back to the Zoho Books invoice as a comment, and the fiscal receipt PDF (slip or A4, per your Receipt format) is attached to it
- Voided invoices and credit notes are synchronized too — see Voids and Credit Notes
- Sync happens automatically — no manual export or import needed
Voids and Credit Notes
A fiscal receipt reported to the tax authority cannot be edited or deleted; it can only be reversed by a refund document that references it. FiscoBridge mirrors the two ways Zoho Books reverses an invoice:
Voiding an invoice
When you void an invoice that FiscoBridge has already fiscalized, FiscoBridge issues a fiscal cancellation (a full refund referencing the original receipt) and writes the cancellation receipt back to the voided invoice as a comment and a receipt PDF. Voiding an invoice that was never fiscalized (for example a draft, or a sent invoice under the When payment is added trigger) does nothing.
Credit notes
A credit note is fiscalized as a fiscal refund of the invoice it credits. For this to work, the credit note must be applied to exactly one invoice that FiscoBridge fiscalized:
- In Zoho Books, create the credit note with the items being returned or discounted, using the same tax names as the invoice
- Apply it to the invoice (Credits Applied → Apply to Invoice, or create it directly from the invoice)
- FiscoBridge fiscalizes a refund for the credit note's items and total, referencing the original fiscal receipt, and writes the refund receipt back to the credit note as a comment and a receipt PDF
A partial credit note produces a partial refund. If the credit note cannot be fiscalized, FiscoBridge leaves a comment on it explaining why:
- Not applied to any invoice — apply it to the invoice it credits and it is picked up automatically
- Applied to several invoices — a fiscal refund can reference only one receipt; create one credit note per invoice
- The invoice was not fiscalized by FiscoBridge — there is no receipt to refund
- The receipt was already refunded or cancelled — the tax authority allows one refund per receipt, so a second credit note on the same invoice, or a credit note followed by a void, cannot be fiscalized
Note: A refund that has been reported to the tax authority cannot be undone. If you void a credit note after its refund was fiscalized, FiscoBridge leaves a warning comment on the credit note; issue a new invoice in Zoho Books if the amount is still owed. Credit notes count towards your monthly invoice limit like any other fiscal document.
Connected before credit-note support? Credit notes need an extra Zoho Books permission. If your integration was connected before this feature was added, go to Integrations, click Reconnect on your Zoho Books integration and approve the Zoho authorization once; credit notes created from then on are fiscalized automatically. Invoices and voids keep working without reconnecting.
Tax Labels
Every invoice FiscoBridge fiscalizes is reported to the tax authority system, which recognises a fixed set of tax labels — single letters such as A, E, F — and ties each one to a rate (for example Fiji's A · 9% VAT, Samoa's A · 15% VAGST, or Vanuatu's V · 15% VAT). Those labels are the only tax categories the tax authority will accept on a fiscal receipt.
When an invoice comes from Zoho Books, FiscoBridge maps each line's Zoho tax onto one of those tax labels. It does this by name — so your Zoho Books taxes have to carry names that match the tax labels exactly.
Tax labels by country
The labels and rates depend on the country your certificate was issued for:
Fiji
| Label | Rate | Name |
|---|---|---|
F |
0.00 | ECAL |
N |
0.00 | N-TAX |
P |
0.50 | PBL |
E |
0.00 | STT |
H |
5.00 | TST |
A |
9.00 | VAT |
B |
0.00 | VAT |
D |
15.00 | VAT |
G |
12.50 | VAT |
C |
0.00 | VAT-EXCL |
Samoa
| Label | Rate | Name |
|---|---|---|
N |
0.00 | N-TAX |
A |
15.00 | VAGST |
C |
0.00 | VAGST-EXCL |
B |
0.00 | VAGST-EXPO |
Vanuatu
| Label | Rate | Name |
|---|---|---|
V |
15.00 | VAT |
Z |
0.00 | VAT-Z |
What FiscoBridge matches on
FiscoBridge reads the taxes configured in your Zoho Books organization and matches on the tax name. A Zoho tax maps successfully when its name is exactly a tax label (e.g. a tax named A). Matching is case-insensitive, but otherwise the name must be the label and nothing else — A matches, VAT A or Standard (A) does not.
Setting it up in Zoho Books
- In Zoho Books, go to Settings → Taxes → Tax Rates
- For each tax label you use, open or create a tax
- Set its Tax Name to the tax label letter, exactly:
A,E,F, … - Set the Rate (%) to the rate the tax authority uses for that label (e.g.
9for Fiji'sA · 9%VAT) - Save, then apply the tax to the relevant invoice line items
Match the rate, not just the name. The label letter is what links the line to the tax authority's category, but you should also set the tax rate to match the tax authority's rate for that label. If the names line up but the percentages differ, your Zoho Books totals will no longer reconcile with the fiscal receipt.
Combining two labels on one line
Each Zoho Books tax maps to exactly one tax label. If a line has to be reported under two categories at once — say Fiji's A (VAT 9%) and F (ECAL) — split it into two line items, putting the A tax on one and the F tax on the other. Zoho has no combined-tax option that FiscoBridge can map to both labels in a single line.
What happens if a label doesn't match
If any line on an invoice uses a tax that doesn't map to a tax label, the whole invoice is not fiscalized. It is not sent to the tax authority, and no default label is substituted. FiscoBridge records the reason on the invoice — naming the unmapped Zoho taxes, listing the required tax labels, and linking back to this guide — so you can rename the tax in Zoho Books and have the invoice synced again.
Checking the status in FiscoBridge
The Integrations page flags any active Zoho Books integration whose taxes don't match. When there's a mismatch you'll see a Tax labels warning chip on the integration row and a banner that lists:
- Your unmapped Zoho Books taxes
- The required tax labels with their rates (as chips, e.g.
A · 9%)
Once you've renamed the taxes in Zoho Books, click Re-check on the banner to confirm the mismatch is cleared.
Reconnecting
If the OAuth connection expires or is interrupted:
- Go to Integrations → Integrations
- Find your Zoho Books integration
- Click the Reconnect button
- Complete the Zoho authorization again
Note: Zoho OAuth tokens can expire. If your integration shows as inactive, reconnecting will restore the sync.
Removing the Integration
- Go to Integrations → Integrations
- Click Remove next to the Zoho Books integration
- Confirm the removal

Previously fiscalized invoices are not affected.
Troubleshooting
Sync issues?
- Check that the integration status is Active
- Try reconnecting if the status shows as inactive
- Ensure your integration license is active and within its invoice limit
Invoice not fiscalized at all?
- Check the fiscalization trigger: with When payment is added, a Sent invoice is not fiscalized until it is Paid; with When invoice is marked as sent, a Draft invoice is not fiscalized until you send it or click Mark as Sent
- Draft invoices are never fiscalized
- Open the Zoho Books invoice — a FiscoBridge comment explains any failure
Sales receipt not fiscalized?
- Check that Fiscalize sales receipts is turned on in the integration Settings. See Sales Receipts
- Sales receipts created before the setting was turned on, or back-dated by more than one day, are not fiscalized
- Open the sales receipt in Zoho Books. A FiscoBridge comment explains any failure
Credit note not fiscalized?
- If the integration was connected before credit-note support was added, click Reconnect on the Integrations page once to grant credit-note access
- Open the credit note in Zoho Books — a FiscoBridge comment explains why (not applied, applied to several invoices, or the receipt was already refunded)
- See Voids and Credit Notes for the rules
Delayed invoices?
- If you haven't set up the webhook, invoices are polled every 5 minutes and credit notes every 15 minutes
- With the webhook configured, invoices sync in near real-time
- Sync frequency also depends on your integration tier — the Professional tier offers faster processing
Next Steps
- Manage integrations — View all your connections
- Integrations Overview — Explore other supported platforms