Aller au contenu principal
Zoho Books

API Zoho Books dans Odoo : centre de données, organisation et factures avec leur numéro Zoho

Zoho Books est réparti entre plusieurs centres de données et chaque appel à son API v3 est limité à une organisation. C'est pourquoi chaque compte du connecteur FlexigoTech pour Odoo enregistre le Zoho Data Center et l'Organization ID, et les lectures passent par FlexigoTech Cloud. Les factures et avoirs émis par Zoho arrivent dans Odoo avec leur numéro Zoho, dans un journal dédié, et le connecteur ne les enregistre jamais une seconde fois dans VERI*FACTU.

FlexigoTech · Responsable : Víctor Gómez · Mis à jour le 12 novembre 2026

L'essentiel

Versions
Odoo 17, 18, 19 et 20
Vérifié
dans le code du connecteur, version 20.0 · dans les sources citées à la fin
Lecture
4 min

Ce que demande l'API Zoho Books : centre de données, organisation et application

Le connecteur lit l'API Zoho Books v3. Selon l'aide du champ Zoho Data Center, Zoho Books est réparti par région et vous choisissez le centre de données. Selon l'aide d'Organization ID, Zoho Books est multi-organisation et chaque appel à l'API est limité à une organisation.

Il vous faut aussi votre application Zoho, dont FlexigoTech Cloud conserve le secret client. Les comptes se trouvent sous Zoho Books › Configuration › Accounts, et le menu Zoho Books propose aussi Connect New Account. Chaque organisation n'est connectée qu'une seule fois par base de données.

Comment l'API Zoho Books se connecte via FlexigoTech Cloud

Le compte que vous créez se connecte via FlexigoTech Cloud (champ Zoho Books connection) : le connecteur nécessite l'abonnement FlexigoTech Cloud, formule Connecteur. Le compte comporte la case I accept that my Zoho app and my reads of Zoho Books go through FlexigoTech Cloud.

  1. Nouveau compte Il envoie une seule fois à FlexigoTech Cloud le secret client de son application Zoho, que FlexigoTech Cloud conserve chiffré.
  1. Autorisation FlexigoTech Cloud échange l'autorisation Connect with Zoho.
  1. Au quotidien FlexigoTech Cloud renouvelle l'accès et fait transiter chaque lecture de Zoho Books. Une fois que FlexigoTech Cloud les détient, Odoo ne garde aucune copie du secret ni des jetons.

Où arrivent les factures : action planifiée et webhook

L'action planifiée Zoho Books: sync invoices (resilience net) s'exécute toutes les 15 minutes et est active dès l'installation. Elle interroge l'API pour obtenir les factures envoyées selon leur date de dernière modification. L'autre voie est un webhook public : le Webhook Secret est un secret aléatoire intégré à son URL.

  1. Émission Zoho Books émet la facture ou l'avoir ; Odoo se contente de le comptabiliser.
  1. Arrivée Le document arrive par le webhook ou est récupéré par l'action planifiée.
  1. Traitement Le connecteur le relit depuis Zoho et le traite avec une seule méthode, de façon idempotente, en verrouillant sa ligne pour que l'action planifiée et le webhook n'entrent pas en conflit.
  1. Comptabilisation Le connecteur vérifie que le numéro attribué par Odoo à la pièce est bien celui de Zoho.

Comment elles arrivent dans Odoo et pourquoi elles ne sont pas enregistrées deux fois

Une facture Zoho arrive comme facture client, et un avoir comme avoir client. Le numéro et la référence de la pièce sont ceux de Zoho. Seules les pièces importées par la synchronisation sont comptabilisées dans le journal Zoho Books.

Factures clients de Zoho Books dans la liste d'Odoo
Factures importées de Zoho Books avec leur numéro Zoho, comptabilisées (données de démonstration)
Facture client dans le journal Zoho Books
Facture dans le journal « Zoho Books » avec le numéro Zoho comme numéro Odoo (données de démonstration)

Chaque document a une ligne avec son Zoho Document ID, la clé qui évite les doublons, et son Zoho Invoice Number.

Tant qu'un VERI*FACTU d'Odoo est actif pour la société, ces documents restent en attente sans être comptabilisés, avec le motif dans le journal. Le champ Waiting for VERI*FACTU of Odoo to be off les compte.

Selon la note de l'AEAT sur le RDL 15/2025, les entreprises assujetties à l'impôt sur les sociétés doivent avoir adapté leur système de facturation avant le 1er janvier 2027, et toutes les autres avant le 1er juillet 2027. Le 5 octobre 2026, Hacienda (le ministère espagnol des Finances) a annoncé son intention de reporter ces obligations à octobre 2028.

Messages que peut afficher le connecteur Zoho Books

Chaque résultat (succès, blocage ou erreur) est enregistré sous la forme d'une ligne dans Zoho Books › Configuration › Sync Log. Voici quelques-uns des messages possibles :

  • The Zoho Books organization … is already connected in this database (maybe in an archived account): use that account, so no invoice is posted twice. Il apparaît quand un autre compte possède déjà le même Organization ID.
  • Si le compte n'a pas encore d'Organization ID, un message rappelle que chaque appel en exige un.
  • Odoo gave Zoho document … the number … instead of its Zoho number …: it is not posted. Il apparaît quand le numéro de la pièce ne correspond pas à celui de Zoho.
  • Si la devise du document existe dans Odoo mais n'est pas active, le message demande de l'activer. Si elle n'existe pas, le connecteur refuse aussi de la comptabiliser dans la devise de la société.

Questions sur l'API Zoho Books dans Odoo

Puis-je connecter la même organisation dans deux comptes ?

Non. Une organisation Zoho Books n'est connectée qu'une fois par base de données ; si elle figure déjà dans un autre compte, vous obtenez le message d'organisation déjà connectée.

Que devient une ligne dont l'article n'existe pas dans Odoo ?

Les lignes sont associées aux produits par leur référence croisée d'article Zoho. Les lignes sans produit correspondant arrivent comme une ligne de service générique par taux de taxe, et aucune ligne n'est perdue.

L'abonnement FlexigoTech Cloud est-il nécessaire ?

Oui, le connecteur nécessite l'abonnement FlexigoTech Cloud, formule Connecteur. Vous trouverez le module sur Odoo Apps et le détail sur la page du connecteur.

À lire aussi

Vérifié dans le code du connecteur (version 20.0) et dans les sources citées

Sources

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