Saltar al contenido principal
Zoho Books

Zoho Books API en Odoo: organización, centro de datos y facturas con su número

Zoho Books está repartido por centros de datos y cada llamada a su API v3 va a una sola organización. Por eso cada cuenta del conector de FlexigoTech para Odoo guarda el Centro de datos de Zoho (Zoho Data Center) y el Organization ID, y las lecturas pasan por FlexigoTech Cloud. Las facturas y abonos que emite Zoho llegan a Odoo con su número de Zoho, en un diario propio, y el conector no los vuelve a registrar en VERI*FACTU.

FlexigoTech · Responsable: Víctor Gómez · Actualizado el 12 de noviembre de 2026

Lo esencial

Módulo
Zoho Books
Versiones
Odoo 17, 18, 19 y 20
Comprobado
en el código del conector, versión 20.0 · en las fuentes enlazadas al final
Lectura
5 min

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).

  1. Cuenta nueva Envía una vez a FlexigoTech Cloud la clave secreta de su app de Zoho, que FlexigoTech Cloud guarda cifrada.
  1. Autorización FlexigoTech Cloud intercambia la autorización Conectar con Zoho (Connect with Zoho).
  1. 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.

  1. Emisión Zoho Books emite la factura o el abono; Odoo solo lo contabiliza.
  1. Llegada El documento entra por el webhook o lo recoge la tarea programada.
  1. 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.
  1. 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.

Facturas de cliente de Zoho Books en la lista de Odoo
Facturas traídas de Zoho Books con su número de Zoho, publicadas (datos de demostración)
Factura de cliente en el diario Zoho Books
Factura en el diario «Zoho Books» con el número de Zoho como número de Odoo (datos de demostració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 mismo Organization 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