Saltar para o conteúdo principal
VeriFactu

A biblioteca cryptography não está disponível no VeriFactu para Odoo: checklist

A mensagem Python cryptography library not available. Install it: pip install cryptography surge quando o módulo não consegue carregar essa biblioteca de Python ao cifrar. A solução é instalá-la com o comando que a própria mensagem indica e repetir a ação; esta checklist guia-te nesse processo.

FlexigoTech · Responsável: Víctor Gómez · Atualizado em 5 de novembro de 2026

O essencial

Módulo
VeriFactu
Versões
Odoo 17, 18, 19 e 20
Verificado
no código do módulo, versão 20.0 · nas fontes indicadas no fim
Leitura
4 min

Quando surge exatamente e o que significa

A mensagem surge quando o módulo tenta carregar da biblioteca cryptography a parte que cifra com AES-GCM e o Python não a consegue importar. É a primeira coisa que faz o método que cifra dados no modelo de certificados do VeriFactu España: AEAT RRSIF Compliance: antes de obter a chave e antes de cifrar o que quer que seja. Significa que a biblioteca está em falta ou não pode ser carregada nesse Python. A ação é interrompida.

Um dos caminhos que levam à mensagem é o botão Configure. Esse botão vê-se sempre, no Odoo 17, 18, 19 e 20, e a mensagem consta do código publicado dessas quatro versões. O módulo está publicado no Odoo Apps para 17, 18, 19 e 20.

Esquema feito com código, não uma captura do Odoo: o menu de certificados, o botão Configure e a mensagem sobre a biblioteca cryptography
Esquema feito com código a partir do código publicado do módulo (Odoo 17, 18, 19 e 20). Mostra, de cima para baixo, o menu, o botão e a mensagem, com os rótulos em inglês do código original.

O que faz o módulo quando a biblioteca está presente

Saber o que vem a seguir ajuda a perceber porque é que a mensagem surge tão cedo. Com a biblioteca disponível, o método obtém a chave de cifragem, gera um valor aleatório (o vetor de inicialização) e cifra os dados com AES-256-GCM. Devolve três coisas: o texto cifrado, esse vetor e a etiqueta de autenticação.

A chave é calculada a partir de um segredo da instância. Nos registos marcados com a chave por empresa, o identificador da empresa faz parte do cálculo. Nada disto acontece enquanto a biblioteca estiver em falta, porque a mensagem é lançada antes.

Checklist para resolver

Ao ver a mensagem

  • Confirma que o texto é o literal: Python cryptography library not available. Install it: pip install cryptography. Se o texto for outro, não é este erro.
  • Anota o que estavas a fazer. Se acabaste de clicar em Configure, esse é o caminho que leva à mensagem.
  • Anota também a versão do Odoo (17, 18, 19 ou 20). A mensagem consta do código das quatro, pelo que, por si só, não dá pista.
  • A ação foi interrompida: terás de a repetir quando estiver resolvido.
Esquema feito com código, não uma captura do Odoo: a mesma mensagem em castelhano e em catalão
Esquema feito com código a partir das traduções publicadas do módulo: em castelhano, La biblioteca cryptography de Python no está disponible. Instálela con: pip install cryptography; em catalão, La biblioteca cryptography de Python no està disponible. Instal·leu-la amb: pip install cryptography.

Instalar a biblioteca

  • Instala a biblioteca com o comando que a mensagem indica: pip install cryptography.
  • Fá-lo para o Python a partir do qual corre o teu Odoo, porque é nesse processo que o módulo tenta carregá-la.
  • Se o servidor for gerido por outra pessoa ou por um fornecedor de alojamento, envia-lhe a mensagem completa e o comando. Assim fica a saber o que instalar e porquê.
  • Verifica o resultado de pip install cryptography: se terminou com um erro, a biblioteca não foi instalada.

Confirmar que está resolvido

  • Repete a ação que falhava, por exemplo clicar em Configure.
  • Confirma que a mensagem já não aparece. Se o módulo passar esse ponto, o método prossegue com a chave e a cifragem descritas acima.
  • Se tiveres várias versões do Odoo em funcionamento (17, 18, 19 ou 20), repete a verificação em cada uma, porque a mensagem consta do código das quatro.

Onde estão as fichas de certificados

As fichas de certificados abrem-se a partir de Verifactu / SIF › Configuration › Certificates. Cada troço do menu exige uma permissão e, se não a tiveres, não vês esse troço:

  • O troço Configuration exige SIF Manager.
  • O troço Verifactu / SIF exige Accountant, Asesoría Operator, Auditor (read-only), Privacy Officer ou SIF Manager.
  • Se não vês o troço Configuration, pede que te atribuam a permissão SIF Manager.

Se a mensagem continuar a surgir

  • Volta a ler o texto: continua a ser o da biblioteca cryptography, não outro.
  • Verifica que a instalação foi feita no Python do teu Odoo e não noutro diferente do mesmo servidor.
  • Se a mensagem persistir, anota que botão clicaste e a versão do Odoo (17, 18, 19 ou 20) antes de pedires ajuda.

Como a FlexigoTech te pode ajudar

Se o servidor não for teu ou preferires que o revejamos, a FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida.

Continue a ler

O que o VeriFactu España acrescenta à fatura do Odoo e quando atuaCampos que o VeriFactu España acrescenta à fatura do Odoo, quando cria o registo ao publicá-la e como verificar que atuou, passo a passo.«Only a SIF Manager can retry AEAT submissions.»: quando aparece e o que fazerO que significa o aviso «Only a SIF Manager can retry AEAT submissions.» no VeriFactu para Odoo: quando aparece, que botões o provocam e como resolver.O que faz o botão Generate Export do VeriFactu Espanha no OdooO que faz o botão Generate Export do VeriFactu Espanha no Odoo: quem o vê, o que gera cada tipo de exportação e o evento que deixa registado.
Verificado no código do módulo (versão 20.0) e nas fontes indicadas

Fontes