Lo que pide la API de Zoho Books: centro de datos, organización y app
El conector lee la API v3 de Zoho Books. Según la ayuda del campo Centro de datos de Zoho, Zoho Books está repartido por regiones y tú eliges el centro de datos. Según la del Organization ID, Zoho Books es multiorganización y cada llamada a la API va a una organización.
También necesitas tu app de Zoho, cuya clave secreta guarda FlexigoTech Cloud. Las cuentas están en Zoho Books › Configuración › Cuentas (Zoho Books › Configuration › Accounts), y el menú Zoho Books tiene además Conectar cuenta nueva (Connect New Account). Cada organización se conecta una sola vez por base de datos.
Cómo se conecta la API de Zoho Books con FlexigoTech Cloud
La cuenta que creas se conecta a través de FlexigoTech Cloud (campo Conexión con Zoho Books, Zoho Books connection): el conector necesita la suscripción a FlexigoTech Cloud, plan Conector. La cuenta lleva la casilla Acepto que mi app de Zoho y mis lecturas de Zoho Books pasen por FlexigoTech Cloud (I accept that my Zoho app and my reads of Zoho Books go through FlexigoTech Cloud).
- Cuenta nueva Envía una vez a FlexigoTech Cloud la clave secreta de su app de Zoho, que FlexigoTech Cloud guarda cifrada.
- Autorización FlexigoTech Cloud intercambia la autorización
Conectar con Zoho(Connect with Zoho).
- Uso diario FlexigoTech Cloud renueva el acceso y pasa cada lectura de Zoho Books. Cuando FlexigoTech Cloud ya los tiene, Odoo no guarda copia de la clave ni de los tokens.
Por dónde llegan las facturas: tarea programada y webhook
La tarea Zoho Books: sincronizar facturas (red de resiliencia) (Zoho Books: sync invoices (resilience net)) corre cada 15 minutos y está activa al instalar. Pide a la API las facturas enviadas por fecha de última modificación. El otro camino es un webhook público: el Secreto del webhook (Webhook Secret) es un secreto aleatorio que va dentro de su URL.
- Emisión Zoho Books emite la factura o el abono; Odoo solo lo contabiliza.
- Llegada El documento entra por el webhook o lo recoge la tarea programada.
- Proceso El conector vuelve a pedirlo a Zoho y lo procesa con un solo método, de forma idempotente, bloqueando su fila para que la tarea y el webhook no choquen.
- Contabilización El conector comprueba que el número que Odoo da al asiento es el de Zoho.
Cómo quedan en Odoo y por qué no se registran dos veces
Una factura de Zoho entra como factura de cliente, y un abono, como abono de cliente. El número y la referencia del asiento son los de Zoho. En el diario Zoho Books solo se contabilizan los asientos que trae la sincronización.


Cada documento tiene una fila con su ID de documento de Zoho (Zoho Document ID), la clave para no duplicarlo, y su Número de factura de Zoho (Zoho Invoice Number).
Mientras un VERI*FACTU de Odoo esté activo en la compañía, estos documentos esperan sin contabilizar, con el motivo en el registro. Los cuenta el campo En espera de que se apague el VERI*FACTU de Odoo (Waiting for VERI*FACTU of Odoo to be off).
Según la nota de la AEAT sobre el RDL 15/2025, quien presenta el Impuesto sobre Sociedades debe tener adaptado su sistema de facturación antes del 1 de enero de 2027, y el resto, antes del 1 de julio de 2027. Hacienda anunció el 5 de octubre de 2026 la previsión de aplazar esas obligaciones hasta octubre de 2028.
Mensajes que puede dar el conector de Zoho Books
Cada resultado (éxito, bloqueado o error) queda como una fila en Zoho Books › Configuración › Registro de sincronización (Zoho Books › Configuration › Sync Log). Entre los mensajes posibles están estos:
La organización de Zoho Books … ya está conectada en esta base de datos (quizá en una cuenta archivada): usa esa cuenta, para que ninguna factura se contabilice dos veces.Sale cuando otra cuenta ya tiene el mismoOrganization ID.
- Si la cuenta aún no tiene
Organization ID, un aviso recuerda que cada llamada necesita uno.
Odoo dio al documento de Zoho … el número … en lugar de su número de Zoho …: no se contabiliza.Sale cuando el número del asiento no coincide con el de Zoho.
- Si la divisa del documento existe en Odoo pero no está activa, el aviso pide activarla. Si no existe, el conector también se niega a contabilizarlo en la divisa de la compañía.
Preguntas sobre la API de Zoho Books en Odoo
¿Puedo conectar la misma organización en dos cuentas?
No. Una organización de Zoho Books se conecta una vez por base de datos; si ya está en otra cuenta, sale el mensaje de organización ya conectada.
¿Qué pasa con una línea cuyo artículo no está en Odoo?
Las líneas se casan con el producto por su referencia al artículo de Zoho. Las que no tienen producto entran como línea de servicio genérica por tipo de impuesto, y ninguna se pierde.
¿Necesita la suscripción a FlexigoTech Cloud?
Sí, el conector necesita la suscripción a FlexigoTech Cloud, plan Conector. Tienes el módulo en Odoo Apps y los detalles en la página del conector.
Sigue leyendo
Comprobado en el código del conector (versión 20.0) y en las fuentes enlazadas
Fuentes
- Código del módulo: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): __manifest__.py
- Código del módulo: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): models/fgt_cloud.py
- Código del módulo: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): models/zoho_books_account.py
- Código del módulo: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): models/zoho_books_invoice_sync.py
- Código del módulo: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): wizards/zoho_books_onboarding_wizard.py
- Código del módulo: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): data/ir_cron.xml
- Código del módulo: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): README.md
- Código del módulo: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): static/description/index.html
- Código del módulo: 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
