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.
- Nieuw account Het stuurt het client secret van zijn Zoho-app één keer naar FlexigoTech Cloud, dat het versleuteld bewaart.
- Autorisatie FlexigoTech Cloud wisselt de autorisatie
Connect with Zohouit.
- 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.
- Uitgifte Zoho Books geeft de factuur of creditfactuur uit; Odoo boekt ze alleen.
- Aankomst Het document komt binnen via de webhook of wordt opgepikt door de geplande actie.
- 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.
- 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.


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 hetzelfdeOrganization IDheeft.
- Als het account nog geen
Organization IDheeft, 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
