Skip to main content
Zoho Books

Zoho Books API in Odoo: data centre, organisation and invoices with their Zoho number

Zoho Books is split across data centres and every call to its API v3 is scoped to one organisation. That is why each account of the FlexigoTech connector for Odoo stores the Zoho Data Center and the Organization ID, and reads go through FlexigoTech Cloud. The invoices and credit notes Zoho issues reach Odoo with their Zoho number, in a journal of their own, and the connector never registers them again in VERI*FACTU.

FlexigoTech · Editor in charge: Víctor Gómez · Updated 12 November 2026

Key facts

Versions
Odoo 17, 18, 19 and 20
Checked
in the connector's source code, version 20.0 · against the sources linked at the end
Reading time
4 min

What the Zoho Books API asks for: data centre, organisation and app

The connector reads the Zoho Books API v3. According to the help on the Zoho Data Center field, Zoho Books is region-sharded and you pick the data centre. According to the help on Organization ID, Zoho Books is multi-org and every API call is scoped to one organisation.

You also need your Zoho app, whose client secret FlexigoTech Cloud keeps. Accounts live under Zoho Books › Configuration › Accounts, and the Zoho Books menu also has Connect New Account. Each organisation is connected only once per database.

How the Zoho Books API connects through FlexigoTech Cloud

The account you create connects through FlexigoTech Cloud (the Zoho Books connection field): the connector needs the FlexigoTech Cloud subscription, Connector plan. The account carries the checkbox I accept that my Zoho app and my reads of Zoho Books go through FlexigoTech Cloud.

  1. New account It sends the client secret of its Zoho app to FlexigoTech Cloud once, and FlexigoTech Cloud keeps it encrypted.
  1. Authorisation FlexigoTech Cloud exchanges the Connect with Zoho authorisation.
  1. Day to day FlexigoTech Cloud renews the access and passes every read of Zoho Books. Once FlexigoTech Cloud holds them, Odoo keeps no copy of the secret or the tokens.

Where invoices come in: scheduled action and webhook

The scheduled action Zoho Books: sync invoices (resilience net) runs every 15 minutes and is active on install. It asks the API for sent invoices by their last modified time. The other path is a public webhook: the Webhook Secret is a random secret embedded in its URL.

  1. Issue Zoho Books issues the invoice or credit note; Odoo only books it.
  1. Arrival The document comes in through the webhook or is picked up by the scheduled action.
  1. Processing The connector fetches it from Zoho again and processes it with a single method, idempotently, locking its row so the scheduled action and the webhook do not clash.
  1. Posting The connector checks that the number Odoo gives the entry is the Zoho one.

How they land in Odoo and why they are not registered twice

A Zoho invoice comes in as a customer invoice, and a credit note as a customer credit note. The entry's number and reference are Zoho's. Only the entries the sync brings in are posted to the Zoho Books journal.

Customer invoices from Zoho Books in the Odoo list
Invoices brought in from Zoho Books with their Zoho number, posted (demo data)
Customer invoice in the Zoho Books journal
Invoice in the ‘Zoho Books’ journal with the Zoho number as its Odoo number (demo data)

Each document has one row with its Zoho Document ID, the key that prevents duplicates, and its Zoho Invoice Number.

While a VERI*FACTU of Odoo is active for the company, these documents wait unposted, with the reason in the log. The Waiting for VERI*FACTU of Odoo to be off field counts them.

According to the AEAT note on RDL 15/2025, businesses that file Corporate Income Tax must have their invoicing system adapted before 1 January 2027, and everyone else before 1 July 2027. On 5 October 2026 Hacienda (the Spanish Ministry of Finance) announced the plan to postpone those obligations until October 2028.

Messages the Zoho Books connector can show

Each outcome (success, blocked or error) is stored as one row under Zoho Books › Configuration › Sync Log. Among the possible messages are these:

  • The Zoho Books organization … is already connected in this database (maybe in an archived account): use that account, so no invoice is posted twice. It appears when another account already has the same Organization ID.
  • If the account has no Organization ID yet, a message reminds you that every call needs one.
  • Odoo gave Zoho document … the number … instead of its Zoho number …: it is not posted. It appears when the entry's number does not match the Zoho one.
  • If the document's currency exists in Odoo but is not active, the message asks you to activate it. If it does not exist, the connector also refuses to book it in the company currency.

Questions about the Zoho Books API in Odoo

Can I connect the same organisation in two accounts?

No. A Zoho Books organisation is connected once per database; if it is already in another account, you get the organisation already connected message.

What happens to a line whose item is not in Odoo?

Lines are matched to products by their Zoho item cross-reference. Lines without a matching product come in as a generic service line by tax rate, and no line is dropped.

Does it need the FlexigoTech Cloud subscription?

Yes, the connector needs the FlexigoTech Cloud subscription, Connector plan. You will find the module on Odoo Apps and the details on the connector page.

Keep reading

Checked in the connector's source code (version 20.0) and the linked sources

Sources

  • Module source code: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): __manifest__.py
  • Module source code: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): models/fgt_cloud.py
  • Module source code: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): models/zoho_books_account.py
  • Module source code: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): models/zoho_books_invoice_sync.py
  • Module source code: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): wizards/zoho_books_onboarding_wizard.py
  • Module source code: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): data/ir_cron.xml
  • Module source code: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): README.md
  • Module source code: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): static/description/index.html
  • Module source code: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): views/menus.xml
  • sede.agenciatributaria.gob.es/Sede/iva/sistemas-informaticos-facturacion-verifactu/nota-in
  • www.hacienda.gob.es/sgt/gabsehacienda/nota-informativa-verifactu.pdf