Naar hoofdinhoud
Zoho Books

Zoho Books API in Odoo: datacenter, organisatie en facturen met hun Zoho-nummer

Zoho Books is verdeeld over datacenters en elke aanroep van de API v3 geldt voor één organisatie. Daarom bewaart elk account van de FlexigoTech-connector voor Odoo het Zoho Data Center en het Organization ID, en lopen alle leesacties via FlexigoTech Cloud. De facturen en creditfacturen die Zoho uitgeeft komen met hun Zoho-nummer in Odoo terecht, in een eigen dagboek, en de connector registreert ze nooit opnieuw in VERI*FACTU.

FlexigoTech · Verantwoordelijk: Víctor Gómez · Bijgewerkt op 12 november 2026

In het kort

Versies
Odoo 17, 18, 19 en 20
Gecontroleerd
in de broncode van de connector, versie 20.0 · in de bronnen onderaan
Leestijd
4 min

Wat de Zoho Books API vraagt: datacenter, organisatie en app

De connector leest de Zoho Books API v3. Volgens de hulptekst van het veld Zoho Data Center is Zoho Books per regio opgedeeld en kies jij het datacenter. Volgens de hulptekst van Organization ID is Zoho Books multi-organisatie en geldt elke API-aanroep voor één organisatie.

Je hebt ook je Zoho-app nodig, waarvan FlexigoTech Cloud het client secret bewaart. De accounts staan onder Zoho Books › Configuration › Accounts, en het menu Zoho Books heeft ook Connect New Account. Elke organisatie wordt maar één keer per database gekoppeld.

Hoe de Zoho Books API verbindt via FlexigoTech Cloud

Het account dat je aanmaakt, verbindt via FlexigoTech Cloud (veld Zoho Books connection): de connector heeft het abonnement FlexigoTech Cloud nodig, plan Connector. Het account heeft het selectievakje I accept that my Zoho app and my reads of Zoho Books go through FlexigoTech Cloud.

  1. Nieuw account Het stuurt het client secret van zijn Zoho-app één keer naar FlexigoTech Cloud, dat het versleuteld bewaart.
  1. Autorisatie FlexigoTech Cloud wisselt de autorisatie Connect with Zoho uit.
  1. Dagelijks gebruik FlexigoTech Cloud vernieuwt de toegang en verwerkt elke leesactie van Zoho Books. Zodra FlexigoTech Cloud ze heeft, houdt Odoo geen kopie van het secret of de tokens.

Waar facturen binnenkomen: geplande actie en webhook

De geplande actie Zoho Books: sync invoices (resilience net) draait elke 15 minuten en is actief na installatie. Ze vraagt de API om verzonden facturen op basis van hun laatste wijzigingstijd. De andere weg is een openbare webhook: het Webhook Secret is een willekeurig geheim dat in de URL is verwerkt.

  1. Uitgifte Zoho Books geeft de factuur of creditfactuur uit; Odoo boekt ze alleen.
  1. Aankomst Het document komt binnen via de webhook of wordt opgepikt door de geplande actie.
  1. Verwerking De connector haalt het opnieuw op bij Zoho en verwerkt het met één methode, idempotent, waarbij de rij wordt vergrendeld zodat de geplande actie en de webhook elkaar niet in de weg zitten.
  1. Boeking De connector controleert dat het nummer dat Odoo aan de boeking geeft het Zoho-nummer is.

Hoe ze in Odoo terechtkomen en waarom ze niet twee keer worden geregistreerd

Een Zoho-factuur komt binnen als klantfactuur en een creditnota als creditfactuur van een klant. Het nummer en de referentie van de boeking zijn die van Zoho. Alleen de boekingen die de synchronisatie binnenbrengt worden geboekt in het dagboek Zoho Books.

Klantfacturen uit Zoho Books in de Odoo-lijst
Facturen uit Zoho Books binnengehaald met hun Zoho-nummer, geboekt (demogegevens)
Klantfactuur in het dagboek Zoho Books
Factuur in het dagboek ‘Zoho Books’ met het Zoho-nummer als Odoo-nummer (demogegevens)

Elk document heeft één rij met zijn Zoho Document ID, de sleutel die duplicaten voorkomt, en zijn Zoho Invoice Number.

Zolang een VERI*FACTU van Odoo actief is voor het bedrijf, wachten deze documenten ongeboekt, met de reden in het logboek. Het veld Waiting for VERI*FACTU of Odoo to be off telt ze.

Volgens de AEAT-nota over RDL 15/2025 moeten bedrijven die vennootschapsbelasting indienen hun factureringssysteem vóór 1 januari 2027 hebben aangepast, en alle anderen vóór 1 juli 2027. Op 5 oktober 2026 kondigde Hacienda (het Spaanse ministerie van Financiën) het plan aan om die verplichtingen uit te stellen tot oktober 2028.

Meldingen die de Zoho Books-connector kan tonen

Elke uitkomst (gelukt, geblokkeerd of fout) wordt opgeslagen als één rij onder Zoho Books › Configuration › Sync Log. Mogelijke meldingen zijn onder meer:

  • The Zoho Books organization … is already connected in this database (maybe in an archived account): use that account, so no invoice is posted twice. Ze verschijnt wanneer een ander account al hetzelfde Organization ID heeft.
  • Als het account nog geen Organization ID heeft, herinnert een melding je eraan dat elke aanroep er een nodig heeft.
  • Odoo gave Zoho document … the number … instead of its Zoho number …: it is not posted. Ze verschijnt wanneer het nummer van de boeking niet overeenkomt met dat van Zoho.
  • Als de valuta van het document in Odoo bestaat maar niet actief is, vraagt de melding je die te activeren. Bestaat ze niet, dan weigert de connector het document ook te boeken in de valuta van het bedrijf.

Vragen over de Zoho Books API in Odoo

Kan ik dezelfde organisatie in twee accounts koppelen?

Nee. Een Zoho Books-organisatie wordt één keer per database gekoppeld; staat ze al in een ander account, dan krijg je de melding dat de organisatie al is gekoppeld.

Wat gebeurt er met een regel waarvan het item niet in Odoo staat?

Regels worden aan producten gekoppeld via hun Zoho-itemverwijzing. Regels zonder overeenkomend product komen binnen als een generieke dienstregel per btw-tarief, en er valt geen enkele regel weg.

Is het abonnement FlexigoTech Cloud nodig?

Ja, de connector heeft het abonnement FlexigoTech Cloud nodig, plan Connector. De module vind je op Odoo Apps en de details op de connectorpagina.

Lees verder

Gecontroleerd in de broncode van de connector (versie 20.0) en in de gelinkte bronnen

Bronnen

  • Broncode van de module: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): __manifest__.py
  • Broncode van de module: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): models/fgt_cloud.py
  • Broncode van de module: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): models/zoho_books_account.py
  • Broncode van de module: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): models/zoho_books_invoice_sync.py
  • Broncode van de module: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): wizards/zoho_books_onboarding_wizard.py
  • Broncode van de module: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): data/ir_cron.xml
  • Broncode van de module: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): README.md
  • Broncode van de module: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): static/description/index.html
  • Broncode van de module: 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