Salta al contingut principal
Zoho Books

API de Zoho Books a Odoo: centre de dades, organització i factures amb el seu número de Zoho

Zoho Books es reparteix per centres de dades i cada crida a la seva API v3 va lligada a una organització. Per això cada compte del connector de FlexigoTech per a Odoo desa el Zoho Data Center i l'Organization ID, i les lectures passen per FlexigoTech Cloud. Les factures i les factures rectificatives que emet Zoho arriben a Odoo amb el seu número de Zoho, en un diari propi, i el connector mai no les torna a registrar a VERI*FACTU.

FlexigoTech · Responsable: Víctor Gómez · Actualitzat el 12 de novembre de 2026

L'essencial

Versions
Odoo 17, 18, 19 i 20
Comprovat
al codi del connector, versió 20.0 · a les fonts enllaçades al final
Lectura
4 min

Què demana l'API de Zoho Books: centre de dades, organització i app

El connector llegeix l'API v3 de Zoho Books. Segons l'ajuda del camp Zoho Data Center, Zoho Books està repartit per regions i tu tries el centre de dades. Segons l'ajuda d'Organization ID, Zoho Books és multiorganització i cada crida a l'API va lligada a una sola organització.

També necessites la teva app de Zoho, el secret de client de la qual guarda FlexigoTech Cloud. Els comptes són a Zoho Books › Configuration › Accounts, i el menú Zoho Books també té Connect New Account. Cada organització es connecta només una vegada per base de dades.

Com es connecta l'API de Zoho Books a través de FlexigoTech Cloud

El compte que crees es connecta a través de FlexigoTech Cloud (camp Zoho Books connection): el connector necessita la subscripció a FlexigoTech Cloud, pla Connector. El compte porta la casella I accept that my Zoho app and my reads of Zoho Books go through FlexigoTech Cloud.

  1. Compte nou Envia una sola vegada a FlexigoTech Cloud el secret de client de la seva app de Zoho, i FlexigoTech Cloud el guarda xifrat.
  1. Autorització FlexigoTech Cloud intercanvia l'autorització Connect with Zoho.
  1. Dia a dia FlexigoTech Cloud renova l'accés i fa passar cada lectura de Zoho Books. Un cop FlexigoTech Cloud els té, Odoo no en conserva cap còpia del secret ni dels tokens.

Per on entren les factures: acció planificada i webhook

L'acció planificada Zoho Books: sync invoices (resilience net) s'executa cada 15 minuts i està activa en instal·lar. Demana a l'API les factures enviades segons l'hora de l'última modificació. L'altre camí és un webhook públic: el Webhook Secret és un secret aleatori inclòs a la seva URL.

  1. Emissió Zoho Books emet la factura o la factura rectificativa; Odoo només la comptabilitza.
  1. Arribada El document entra pel webhook o l'arreplega l'acció planificada.
  1. Processament El connector el torna a demanar a Zoho i el processa amb un únic mètode, de manera idempotent, bloquejant la seva fila perquè l'acció planificada i el webhook no es trepitgin.
  1. Comptabilització El connector comprova que el número que Odoo dona a l'assentament és el de Zoho.

Com aterren a Odoo i per què no es registren dues vegades

Una factura de Zoho entra com a factura de client, i una factura rectificativa, com a factura rectificativa de client. El número i la referència de l'assentament són els de Zoho. Només els assentaments que porta la sincronització es comptabilitzen al diari Zoho Books.

Factures de client de Zoho Books a la llista d'Odoo
Factures portades de Zoho Books amb el seu número de Zoho, comptabilitzades (dades de demostració)
Factura de client al diari de Zoho Books
Factura al diari «Zoho Books» amb el número de Zoho com a número d'Odoo (dades de demostració)

Cada document té una fila amb el seu Zoho Document ID, la clau que evita duplicats, i el seu Zoho Invoice Number.

Mentre hi ha un VERI*FACTU d'Odoo actiu per a l'empresa, aquests documents esperen sense comptabilitzar, amb el motiu al registre. El camp Waiting for VERI*FACTU of Odoo to be off els compta.

Segons la nota de l'AEAT sobre el RDL 15/2025, les empreses que presenten l'Impost sobre Societats han de tenir el sistema de facturació adaptat abans de l'1 de gener de 2027, i la resta, abans de l'1 de juliol de 2027. El 5 d'octubre de 2026 Hisenda va anunciar el pla d'ajornar aquestes obligacions fins a l'octubre de 2028.

Missatges que pot mostrar el connector de Zoho Books

Cada resultat (èxit, bloqueig o error) es desa com una fila a Zoho Books › Configuration › Sync Log. Entre els missatges possibles hi ha aquests:

  • The Zoho Books organization … is already connected in this database (maybe in an archived account): use that account, so no invoice is posted twice. Apareix quan un altre compte ja té el mateix Organization ID.
  • Si el compte encara no té Organization ID, un missatge recorda que cada crida n'ha de portar un.
  • Odoo gave Zoho document … the number … instead of its Zoho number …: it is not posted. Apareix quan el número de l'assentament no coincideix amb el de Zoho.
  • Si la divisa del document existeix a Odoo però no està activa, el missatge demana activar-la. Si no existeix, el connector tampoc no el comptabilitza en la divisa de l'empresa.

Preguntes sobre l'API de Zoho Books a Odoo

Puc connectar la mateixa organització en dos comptes?

No. Una organització de Zoho Books es connecta una vegada per base de dades; si ja és en un altre compte, reps el missatge d'organització ja connectada.

Què passa amb una línia el producte de la qual no és a Odoo?

Les línies s'associen als productes per la seva referència creuada de l'article de Zoho. Les línies sense producte coincident entren com una línia de servei genèrica per tipus d'impost, i cap línia es descarta.

Necessita la subscripció a FlexigoTech Cloud?

Sí, el connector necessita la subscripció a FlexigoTech Cloud, pla Connector. Trobaràs el mòdul a Odoo Apps i els detalls a la pàgina del connector.

Continua llegint

Comprovat al codi del connector (versió 20.0) i a les fonts enllaçades

Fonts

  • Codi del mòdul: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): __manifest__.py
  • Codi del mòdul: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): models/fgt_cloud.py
  • Codi del mòdul: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): models/zoho_books_account.py
  • Codi del mòdul: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): models/zoho_books_invoice_sync.py
  • Codi del mòdul: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): wizards/zoho_books_onboarding_wizard.py
  • Codi del mòdul: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): data/ir_cron.xml
  • Codi del mòdul: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): README.md
  • Codi del mòdul: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): static/description/index.html
  • Codi del mòdul: 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