Cosa chiede l'API di Zoho Books: data center, organizzazione e app
Il connettore legge l'API v3 di Zoho Books. Secondo l'aiuto del campo Zoho Data Center, Zoho Books è suddiviso per regione e tu scegli il data center. Secondo l'aiuto di Organization ID, Zoho Books è multi-organizzazione e ogni chiamata API è limitata a una sola organizzazione.
Serve anche la tua app Zoho, di cui FlexigoTech Cloud conserva il client secret. Gli account si trovano in Zoho Books › Configuration › Accounts, e il menu Zoho Books ha anche Connect New Account. Ogni organizzazione si collega una sola volta per database.
Come l'API di Zoho Books si collega tramite FlexigoTech Cloud
L'account che crei si collega tramite FlexigoTech Cloud (campo Zoho Books connection): il connettore richiede l'abbonamento a FlexigoTech Cloud, piano Connettore. L'account ha la casella I accept that my Zoho app and my reads of Zoho Books go through FlexigoTech Cloud.
- Nuovo account Invia una sola volta a FlexigoTech Cloud il client secret della sua app Zoho, e FlexigoTech Cloud lo conserva cifrato.
- Autorizzazione FlexigoTech Cloud scambia l'autorizzazione
Connect with Zoho.
- Ogni giorno FlexigoTech Cloud rinnova l'accesso e fa passare ogni lettura di Zoho Books. Una volta che FlexigoTech Cloud li conserva, Odoo non tiene nessuna copia del secret né dei token.
Da dove entrano le fatture: azione pianificata e webhook
L'azione pianificata Zoho Books: sync invoices (resilience net) viene eseguita ogni 15 minuti ed è attiva dall'installazione. Chiede all'API le fatture inviate in base all'ultima data di modifica. L'altra via è un webhook pubblico: il Webhook Secret è un secret casuale incorporato nel suo URL.
- Emissione Zoho Books emette la fattura o la nota di credito; Odoo si limita a registrarla.
- Arrivo Il documento entra tramite il webhook oppure viene recuperato dall'azione pianificata.
- Elaborazione Il connettore lo richiede di nuovo a Zoho e lo elabora con un unico metodo, in modo idempotente, bloccando la sua riga perché azione pianificata e webhook non si pestino i piedi.
- Registrazione Il connettore verifica che il numero che Odoo assegna alla registrazione sia quello di Zoho.
Come arrivano in Odoo e perché non vengono registrate due volte
Una fattura Zoho entra come fattura cliente e una nota di credito come nota di credito cliente. Numero e riferimento della registrazione sono quelli di Zoho. Nel registro Zoho Books vengono contabilizzate solo le registrazioni che porta la sincronizzazione.


Ogni documento ha una riga con il suo Zoho Document ID, la chiave che evita i duplicati, e il suo Zoho Invoice Number.
Finché per l'azienda è attivo un VERI*FACTU di Odoo, questi documenti restano non contabilizzati, con il motivo nel log. Il campo Waiting for VERI*FACTU of Odoo to be off li conta.
Secondo la nota dell'AEAT sul RDL 15/2025, le attività che presentano l'Imposta sulle Società devono avere il sistema di fatturazione adeguato prima del 1° gennaio 2027, e tutte le altre prima del 1° luglio 2027. Il 5 ottobre 2026 Hacienda (il Ministero delle Finanze spagnolo) ha annunciato il piano di rinviare tali obblighi a ottobre 2028.
Messaggi che il connettore Zoho Books può mostrare
Ogni esito (riuscito, bloccato o errore) viene salvato come una riga in Zoho Books › Configuration › Sync Log. Tra i messaggi possibili ci sono questi:
The Zoho Books organization … is already connected in this database (maybe in an archived account): use that account, so no invoice is posted twice.Compare quando un altro account ha già lo stessoOrganization ID.
- Se l'account non ha ancora un
Organization ID, un messaggio ricorda che ogni chiamata ne richiede uno.
Odoo gave Zoho document … the number … instead of its Zoho number …: it is not posted.Compare quando il numero della registrazione non coincide con quello di Zoho.
- Se la valuta del documento esiste in Odoo ma non è attiva, il messaggio chiede di attivarla. Se non esiste, il connettore si rifiuta anche di registrarlo nella valuta dell'azienda.
Domande sull'API di Zoho Books in Odoo
Posso collegare la stessa organizzazione in due account?
No. Un'organizzazione di Zoho Books si collega una sola volta per database; se è già in un altro account, ricevi il messaggio di organizzazione già collegata.
Cosa succede a una riga il cui articolo non è in Odoo?
Le righe vengono associate ai prodotti tramite il riferimento incrociato dell'articolo Zoho. Le righe senza un prodotto corrispondente entrano come riga di servizio generica per aliquota, e nessuna riga viene scartata.
Serve l'abbonamento a FlexigoTech Cloud?
Sì, il connettore richiede l'abbonamento a FlexigoTech Cloud, piano Connettore. Trovi il modulo su Odoo Apps e i dettagli nella pagina del connettore.
Continua a leggere
Verificato nel codice del connettore (versione 20.0) e nelle fonti collegate
Fonti
- Codice del modulo: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): __manifest__.py
- Codice del modulo: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): models/fgt_cloud.py
- Codice del modulo: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): models/zoho_books_account.py
- Codice del modulo: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): models/zoho_books_invoice_sync.py
- Codice del modulo: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): wizards/zoho_books_onboarding_wizard.py
- Codice del modulo: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): data/ir_cron.xml
- Codice del modulo: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): README.md
- Codice del modulo: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): static/description/index.html
- Codice del modulo: 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
