Como instalar o fiscaldoo e que requisitos tem

Para que serve?

Para pôr o fiscaldoo a funcionar num Odoo 20 Community. A instalação tem duas partes: no servidor, junta-se o código do fiscaldoo às pastas de módulos do Odoo; no Odoo, instala-se um só pacote de entrada, fiscaldoo · Instalação — Ponto de entrada e pacotes. Os outros pacotes (faturação certificada, salários, Copiloto…) ligam-se depois nas Definições.

Este artigo é para quem administra o servidor do Odoo: consultor, parceiro ou administrador técnico.

Quando utilizar?

• Numa base de dados nova, antes de qualquer outro trabalho.
• Num Odoo 20 Community que já existe e vai passar a usar o fiscaldoo.
• Para confirmar se um servidor tem o que o fiscaldoo precisa.

A versão do fiscaldoo para o Odoo Enterprise ainda não está disponível para clientes. A etiqueta «Community e Enterprise», no topo deste artigo, diz para que edições do Odoo os passos servem (compatibilidade), e não que a versão Enterprise já existe: veja O que quer dizer a etiqueta «Community e Enterprise».

Onde encontrar?

• No servidor: o ficheiro de configuração do Odoo (linha addons_path).
• No Odoo: Aplicações, pesquisa fiscaldoo, cartão fiscaldoo · Instalação — Ponto de entrada e pacotes.

Antes de começar

O servidor tem de ter:

Requisito	O que é preciso	Porquê
Odoo	Odoo 20.0, edição Community	O fiscaldoo é feito para esta versão.
Python	3.12 a 3.14	São as versões que o Odoo 20 aceita.
PostgreSQL	16 ou mais recente	É a versão mínima do Odoo 20.
Bibliotecas Python	lxml, qrcode, xlsxwriter, cryptography, requests e xmlschema, no mesmo ambiente Python do Odoo	São as que os pacotes do fiscaldoo pedem (assinatura, código QR, SAF-T, exportações para Excel e comunicação com a AT).
Biblioteca de códigos de barras e QR	rl-renderPM==4.0.3 (pip install rl-renderPM==4.0.3), no mesmo ambiente Python do Odoo, e reinício do serviço	O Odoo 20 só a pede para Windows. Sem ela, no Linux, tudo o que desenha um código de barras ou QR em imagem falha com «Ops! Algo correu mal»: o QR de um pagamento a fornecedor, as etiquetas e os códigos de barras dos artigos. O QR da faturação certificada não depende dela.
Motor de PDF	wkhtmltopdf instalado no servidor	O pacote da faturação certificada usa o motor de PDF do Odoo baseado no wkhtmltopdf para imprimir os documentos.
Código	O fiscaldoo para o Odoo 20 (versão 20.0), com as pastas addons e community	São as pastas que entram numa base Community.

Precisa também de acesso de administrador ao Odoo, para usar Aplicações, Definições e o modo de programador do passo 5.

Pendente de validação no ecrã: os requisitos vêm dos ficheiros do Odoo 20 e dos pacotes do fiscaldoo. A instalação num servidor novo não se fez neste lote: a base de demonstração já vem instalada, e a regra do projeto não deixa instalar nada em servidores.

Como utilizar

1. Copie para o servidor as pastas addons e community do fiscaldoo, versão 20.0. Não copie a pasta enterprise para uma base Community: os pacotes dessa pasta precisam de aplicações do Odoo Enterprise.

2. No ficheiro de configuração do Odoo, acrescente as duas pastas à linha addons_path, a seguir à pasta addons do Odoo e com o caminho completo de cada uma, por exemplo <odoo>/addons,<fiscaldoo>/addons,<fiscaldoo>/community. Grave o ficheiro.

3. Reinicie o serviço do Odoo, para ele ler as pastas novas.

4. Numa base de dados nova, crie-a com o idioma português de Portugal e o país Portugal, sem dados de demonstração.

5. Num Odoo que já existia, mande-o ler os pacotes novos. Este passo é de instalação e só o administrador o faz:

   • abra Definições e, no grupo Ferramentas de desenvolvimento, carregue em Ativar o modo de programador;
   • abra Aplicações e, no menu de cima, carregue em Atualizar a lista de módulos;
   • na janela Atualização dos Módulos, carregue em Atualizar.

   O modo de programador mostra menus técnicos que o trabalho do dia a dia não usa. No fim da instalação, saia dele: no ícone do inseto, na barra de cima, carregue em Sair do modo de depuração. Numa base de dados criada depois do passo 3, a lista já vem com os pacotes do fiscaldoo e este passo não é preciso.

6. Abra Aplicações e escreva fiscaldoo na pesquisa. Aparecem os cartões dos pacotes do fiscaldoo.

7. No cartão fiscaldoo · Instalação — Ponto de entrada e pacotes, carregue em Ativar (no fundo do cartão, à esquerda de Saiba mais; depois de instalado, o cartão só mostra Saiba mais). Instale este pacote primeiro e sozinho.

Pendente de validação no ecrã: os passos 1 a 4 não se viram neste lote (o botão Ativar do passo 7 viu-se num pacote ainda não instalado), pelo mesmo motivo. Na base de demonstração viu-se o passo 5 até à janela Atualização dos Módulos (sem carregar em Atualizar) e o passo 6: com o filtro Aplicações, a pesquisa fiscaldoo mostra 14 cartões, entre eles fiscaldoo · Instalação — Ponto de entrada e pacotes, já instalado.

Resultado esperado

• Na lista da esquerda das Definições aparece fiscaldoo · Certificação, com um interruptor por pacote. É aí que se escolhe o que instalar a seguir: continue em Como ativar a faturação e as aplicações do fiscaldoo.
• O Odoo fica também em português de Portugal, porque os outros pacotes do fiscaldoo precisam deste idioma.
• No fim do grupo Sobre, nas Definições, lê-se «Odoo 20.0 (Community Edition)».

Notas importantes

• Instale o pacote de entrada antes da contabilidade. Numa base nova com uma só empresa ainda sem país, o pacote de entrada põe a empresa em Portugal e em euros, para a contabilidade instalada a seguir trazer o plano de contas português. Uma empresa que já tem país, uma segunda empresa ou uma contabilidade já instalada não são mexidas. Pendente de validação no ecrã: comportamento lido no código do pacote de entrada; numa base nova não se pôde ver.
• O pacote de demonstração não se instala em clientes. O l10n_pt_arxi_demo cria uma empresa fictícia com dados de exemplo e chaves de teste. Serve para formação e testes.
• Antes de atualizar o fiscaldoo, faça uma cópia de segurança da base de dados e ensaie a atualização numa cópia.

Problemas frequentes

Os pacotes do fiscaldoo não aparecem em Aplicações

• Causa: as pastas do fiscaldoo não estão na linha addons_path, o Odoo não foi reiniciado depois de gravar o ficheiro, ou, num Odoo que já existia, não se usou Atualizar a lista de módulos.
• O que fazer: confirme os caminhos completos das pastas addons e community, reinicie o Odoo e faça o passo 5: com o modo de programador, Aplicações › Atualizar a lista de módulos › Atualizar. Na pesquisa, retire o filtro Aplicações se procura um pacote que não é uma aplicação.

O Odoo não arranca ou recusa instalar um pacote por falta de uma biblioteca

• Causa: falta no ambiente Python do Odoo uma das bibliotecas da tabela de «Antes de começar».
• O que fazer: instale-a no mesmo ambiente Python em que o Odoo corre e reinicie o Odoo.

Pendente de validação no ecrã: as mensagens destes dois problemas não se provocaram, porque exigiam mexer no servidor.