O que a API do Zoho Books pede: centro de dados, organização e app
O conector lê a API v3 do Zoho Books. Segundo a ajuda do campo Zoho Data Center, o Zoho Books está dividido por regiões e é você que escolhe o centro de dados. Segundo a ajuda de Organization ID, o Zoho Books é multiorganização e cada chamada à API é feita no âmbito de uma só organização.
Precisa também da sua app Zoho, cujo segredo de cliente o FlexigoTech Cloud guarda. As contas ficam em Zoho Books › Configuration › Accounts, e o menu Zoho Books tem ainda Connect New Account. Cada organização liga-se apenas uma vez por base de dados.
Como a API do Zoho Books se liga através do FlexigoTech Cloud
A conta que cria liga-se através do FlexigoTech Cloud (campo Zoho Books connection): o conector precisa da subscrição FlexigoTech Cloud, plano Conector. A conta tem a caixa I accept that my Zoho app and my reads of Zoho Books go through FlexigoTech Cloud.
- Conta nova Envia uma vez ao FlexigoTech Cloud o segredo de cliente da sua app Zoho, e o FlexigoTech Cloud guarda-o cifrado.
- Autorização O FlexigoTech Cloud troca a autorização
Connect with Zoho.
- No dia a dia O FlexigoTech Cloud renova o acesso e faz passar cada leitura do Zoho Books. Depois de o FlexigoTech Cloud os ter, o Odoo não guarda nenhuma cópia do segredo nem dos tokens.
Por onde entram as faturas: ação agendada e webhook
A ação agendada Zoho Books: sync invoices (resilience net) corre a cada 15 minutos e está ativa na instalação. Pede à API as faturas enviadas pela sua hora da última modificação. O outro caminho é um webhook público: o Webhook Secret é um segredo aleatório incluído no seu URL.
- Emissão O Zoho Books emite a fatura ou a nota de crédito; o Odoo limita-se a contabilizá-la.
- Chegada O documento entra pelo webhook ou é recolhido pela ação agendada.
- Processamento O conector volta a obtê-lo do Zoho e processa-o com um único método, de forma idempotente, bloqueando a sua linha para que a ação agendada e o webhook não colidam.
- Contabilização O conector verifica que o número que o Odoo atribui ao lançamento é o do Zoho.
Como ficam no Odoo e porque não se registam duas vezes
Uma fatura do Zoho entra como fatura de cliente e uma nota de crédito como nota de crédito de cliente. O número e a referência do lançamento são os do Zoho. Só os lançamentos que a sincronização traz são contabilizados no diário Zoho Books.


Cada documento tem uma linha com o seu Zoho Document ID, a chave que evita duplicados, e o seu Zoho Invoice Number.
Enquanto um VERI*FACTU do Odoo estiver ativo para a empresa, estes documentos ficam à espera sem serem contabilizados, com o motivo no registo. O campo Waiting for VERI*FACTU of Odoo to be off conta-os.
Segundo a nota da AEAT sobre o RDL 15/2025, as empresas que apresentam o Imposto sobre as Sociedades têm de ter o sistema de faturação adaptado antes de 1 de janeiro de 2027, e as restantes antes de 1 de julho de 2027. A 5 de outubro de 2026, a Hacienda (o Ministério das Finanças espanhol) anunciou o plano de adiar essas obrigações até outubro de 2028.
Mensagens que o conector do Zoho Books pode mostrar
Cada resultado (sucesso, bloqueio ou erro) fica guardado numa linha em Zoho Books › Configuration › Sync Log. Entre as mensagens possíveis estão estas:
The Zoho Books organization … is already connected in this database (maybe in an archived account): use that account, so no invoice is posted twice.Aparece quando outra conta já tem o mesmoOrganization ID.
- Se a conta ainda não tiver
Organization ID, uma mensagem lembra que cada chamada precisa de um.
Odoo gave Zoho document … the number … instead of its Zoho number …: it is not posted.Aparece quando o número do lançamento não coincide com o do Zoho.
- Se a moeda do documento existir no Odoo mas não estiver ativa, a mensagem pede-lhe que a ative. Se não existir, o conector recusa também contabilizá-lo na moeda da empresa.
Perguntas sobre a API do Zoho Books no Odoo
Posso ligar a mesma organização em duas contas?
Não. Uma organização do Zoho Books liga-se uma vez por base de dados; se já estiver noutra conta, recebe a mensagem de organização já ligada.
O que acontece a uma linha cujo artigo não existe no Odoo?
As linhas são associadas aos artigos pela sua referência cruzada de artigo do Zoho. As linhas sem artigo correspondente entram como uma linha de serviço genérica por taxa de imposto, e nenhuma linha se perde.
Precisa da subscrição FlexigoTech Cloud?
Sim, o conector precisa da subscrição FlexigoTech Cloud, plano Conector. Encontra o módulo nas Odoo Apps e os detalhes na página do conector.
Continue a ler
Verificado no código do conector (versão 20.0) e nas fontes indicadas
Fontes
- Código do módulo: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): __manifest__.py
- Código do módulo: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): models/fgt_cloud.py
- Código do módulo: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): models/zoho_books_account.py
- Código do módulo: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): models/zoho_books_invoice_sync.py
- Código do módulo: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): wizards/zoho_books_onboarding_wizard.py
- Código do módulo: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): data/ir_cron.xml
- Código do módulo: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): README.md
- Código do módulo: flexigobe_zoho_verifactu_connector 20.0 (fba95ab9): static/description/index.html
- Código do 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
