Saltar para o conteúdo principal
KSeF 2.0

KSeF 2.0: token, certificado KSeF ou Perfil de Confiança? Como escolher

Para entrar no KSeF pessoalmente pode usar o Perfil de Confiança, uma assinatura eletrónica qualificada ou, desde 1 de abril de 2026, o nó nacional login.gov.pl. Para que o Odoo envie faturas com o seu módulo nativo, a empresa precisa de um certificado KSeF. E, para pedir esse certificado, primeiro tem de se autenticar com um dos primeiros métodos. Este guia ajuda-o a pôr a decisão por ordem.

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

O essencial

Módulo
KSeF 2.0
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
3 min

Os métodos que o KSeF 2.0 aceita

Segundo o manual do Ministério das Finanças, no KSeF 2.0 pode autenticar-se com:

  • Perfil de Confiança (Podpis Zaufany).
  • Assinatura eletrónica qualificada.
  • Token KSeF.
  • Certificado KSeF.
  • Desde 1 de abril de 2026, o nó nacional login.gov.pl, com o Podpis Zaufany, a aplicação mObywatel, a banca online ou o e-Dowód.

As perguntas que decidem

PerguntaSe a resposta for sim
Vai entrar pessoalmente na aplicação do KSeF para consultar ou emitir à mão?Perfil de Confiança, assinatura qualificada ou nó nacional.
Quer que o Odoo envie as faturas com l10n_pl_edi?Um certificado KSeF guardado na empresa do Odoo.
Ainda não tem certificado KSeF?Peça-o depois de se autenticar, por exemplo com o Podpis Zaufany ou uma assinatura qualificada.
Usa tokens noutros programas?Pode continuar: o Ministério mantém-nos sem data de fim.
Está no Odoo 17?l10n_pl_edi não existe na 17: o envio faz-se fora do Odoo.
Política legal do KSeF configurada no módulo do Odoo
A política legal do módulo: as datas são dados que configura, não texto fixo. Captura do Odoo com dados de demonstração.

Como o Odoo o usa

No Odoo 19, o l10n_pl_edi guarda um «KSeF Certificate» na empresa e autentica-se com ele. Uma ação agendada renova os tokens de acesso de todas as empresas que têm certificado, para que ninguém tenha de copiar tokens à mão.

O módulo da FlexigoTech não se liga ao KSeF: valida o FA(3) e vigia as suas credenciais. Em Configuration › Credentials guarda certificados e tokens com a respetiva validade, e em Authorizations as autorizações que concedeu. Todos os dias avisa do que está prestes a expirar, com um semáforo: OK, a expirar, bloqueada ou expirada, e a contagem decrescente de 30, 14, 7 e 1 dias.

Campos do esquema FA(3) validados pelo módulo KSeF no Odoo
Além das credenciais, o módulo valida cada fatura com os campos do FA(3). Captura do Odoo com dados de demonstração.

O que guardar e onde

No módulo, cada credencial tem o seu estado e a sua data de validade, e cada autorização os seus: ativa, a expirar, revogada ou expirada. As datas legais, como o início da obrigação para cada tipo de empresa, configuram-se em Configuration › Legal Policy em vez de ficarem escritas no código. E cada alteração fica em Configuration › Audit Log, para saber quem mexeu numa credencial e quando.

Erros de planeamento que vemos

Pensar que o Perfil de Confiança desaparece em abril de 2026. Não desaparece: a 1 de abril de 2026 abre-se mais um canal, o nó nacional, e o Perfil de Confiança continua dentro dele.

Contar com que os tokens expirem no fim de 2026. Essa era a ideia inicial; o Ministério decidiu mantê-los sem data de fim.

Configurar o Odoo antes de ter o certificado. Sem certificado, o envio nativo não se consegue autenticar. Peça-o primeiro.

Uma ordem que funciona

Primeiro, entre no KSeF pessoalmente com o método que já tem, seja o Perfil de Confiança ou uma assinatura qualificada. Segundo, peça o certificado KSeF da empresa. Terceiro, guarde-o no Odoo 18, 19 ou 20 para o envio nativo e registe-o no módulo para vigiar a validade. Assim, ninguém depende de um token colado num e-mail.

As autorizações também expiram ou são revogadas. O aviso diário do módulo inclui-as, para que ninguém descubra no próprio dia que uma fatura não sai.

Continue a ler

KSeF 2.0: o calendário de 2026 e 2027 e o que preparar no Odoo para cada dataDatas oficiais do KSeF 2.0 na Polónia (fevereiro e abril de 2026, janeiro de 2027), as sanções adiadas e o que ter pronto no Odoo para cada uma.KSeF no Odoo 17, 18, 19 e 20: o que muda com a sua versãoDiferenças do KSeF entre o Odoo 17 e o Odoo 18, 19 e 20: envio nativo com l10n_pl_edi, de onde vem o FA(3) validado e o que faz o módulo em cada versão.
Verificado no código do módulo (versão 20.0) e nas fontes indicadas

Fontes