Saltar para o conteúdo principal
KSeF 2.0

Poland KSeF 2.0 Validator: o que cobre, o que não cobre e se encaixa no seu Odoo

O Poland KSeF 2.0 Validator encaixa se usa o Odoo 17, 18, 19 ou 20 e quer validar as suas faturas FA(3) e gerir dentro do Odoo a sua preparação, a sua fila e o seu ciclo no KSeF. Não envia as faturas: isso é feito pelo l10n_pl_edi do Odoo, que existe no 18, 19 e 20 mas não no 17, onde o FA(3) é carregado já pronto, feito fora do Odoo. A validação corre na FlexigoTech Cloud e requer a subscrição.

FlexigoTech · Responsável: Víctor Gómez · Atualizado em 4 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
6 min

Quem faz cada parte do trabalho com o KSeF

Para decidir se o módulo encaixa, o mais útil é separar o que ele faz do que faz o Odoo, do que faz você e do que fica fora da subscrição. A tabela resume a sua página no Odoo Apps e o seu README.

Parte do trabalhoQuem a fazO que diz a documentação
Gerar o FA(3)l10n_pl_edi no Odoo 18, 19 e 20; fora do Odoo no 17O FA(3) sai do l10n_pl_edi ou de um ficheiro que carrega
Validar o FA(3) contra o esquema do KSeFO módulo, na FlexigoTech CloudCom a subscrição, e guarda um relatório assinado
Enviar a fatura para o KSeFl10n_pl_edi do OdooO módulo não tem cliente HTTP para o KSeF
Verificar se parceiros, empresa e faturas estão prontosO móduloValidador de migração da preparação de parceiros, empresa e faturas
Datas da vaga de obrigatoriedadeO móduloMetadados por empresa da vaga e da política legal, com datas configuráveis
Fila de faturas prontas para carregarO móduloDeteta o l10n_pl_edi e mantém essa fila
Número KSeF, soma de controlo do UPO, motivo de rejeição, novas tentativas e limite de pedidosO móduloGere o ciclo de vida desses dados
Casos Offline24 e awariaO móduloCargas QR e prazo até ao dia útil seguinte
Certificados e tokens KSeFO móduloInventário, mais registos de autorização e delegação
Registo de auditoriaO móduloImutável, com mascaramento de NIP, PESEL e credenciais
Configurar o móduloVocêA implementação fica fora da subscrição
Migrar a base de dados para outra versão do OdooVocê ou quem escolherA FlexigoTech não se encarrega de migrações
Importar dados históricosVocê ou quem escolherFica fora da subscrição
Contas em cada plataforma, Odoo e alojamentoVocêÉ você quem as contrata e paga
Execução de validação em formulário com os botões Run e Export checklist, a pontuação obtida e, por baixo, uma linha por fatura com o seu resultado, o código de erro e o motivo
Uma execução de validação: em cima a empresa, o âmbito e a pontuação; em baixo, fatura a fatura, o resultado obtido, com que código de erro e por que motivo.

Como ler a tabela consoante a sua situação

A tabela deixa uma ideia clara: o módulo valida e prepara, mas não envia. O envio real é feito pelo l10n_pl_edi do Odoo. A partir daí, estes critérios ajudam a decidir.

  • Está no Odoo 18, 19 ou 20 e fatura com o l10n_pl_edi. O módulo valida o FA(3) que o l10n_pl_edi gera ou já enviou, e deteta esse módulo para montar a fila de faturas prontas para carregar.
  • Está no Odoo 17. O Odoo Community não inclui o l10n_pl_edi no 17, por isso o FA(3) é carregado já feito fora do Odoo. Encaixa se já tem de onde obter esse ficheiro.
  • Procura algo que envie as faturas para o KSeF por si só. Este módulo não tem cliente HTTP para o KSeF, por isso não cobre essa parte.
  • Precisa de controlar os casos Offline24 e awaria. O módulo gere-os com cargas QR; em modo offline, o prazo vai até ao dia útil polaco seguinte, com um aviso diário.
  • Gere várias empresas no Odoo. O módulo guarda por empresa os metadados da vaga de obrigatoriedade e da política legal, com datas configuráveis.
  • Quer que lho deixem configurado, migrar de versão ou carregar históricos. A configuração do módulo, a migração da base de dados, a importação de dados históricos e a personalização ou o desenvolvimento à medida ficam fora da subscrição, tal como o suporte a módulos que não são da FlexigoTech.

O que muda com e sem a subscrição

A validação do FA(3) corre na FlexigoTech Cloud e depende da subscrição. Sem ela, o módulo não valida o FA(3) e cada fatura fica em Not validated. Se não tiver subscrição ou o serviço estiver suspenso, para o que a subscrição fornece, mas os dados ficam no seu Odoo.

Com a subscrição tem a validação KSeF FA(3) com a sua manutenção e supervisão, as atualizações do módulo e suporte com primeira resposta em 1 dia útil. O pagamento é feito a partir do Odoo, e há uma verificação do serviço a cada 6 horas e relatórios de saúde.

O serviço local custa 29 €/mês ou 290 €/ano sem IVA (Pro: 58 €/mês ou 580 €/ano). Se o comprar em flexigotech.com, o módulo para as novas versões do Odoo está incluído na subscrição; na Odoo App Store, cada versão do Odoo compra-se lá.

O que ter pronto antes de o instalar

  • Uma versão do Odoo publicada. O módulo está no Odoo Apps para 17, 18, 19 e 20.
  • De onde vem o FA(3). Do l10n_pl_edi no 18, 19 e 20, ou de um ficheiro que carrega; no 17, o FA(3) é carregado já feito fora do Odoo.
  • A sua forma de se autenticar no KSeF. No KSeF 2.0 há o Perfil de Confiança (Podpis Zaufany), assinatura eletrónica qualificada, token KSeF e certificado KSeF. Para pedir um certificado KSeF é preciso autenticar-se antes, por exemplo com o Podpis Zaufany ou com uma assinatura eletrónica qualificada. No Odoo 19, o l10n_pl_edi guarda na empresa um KSeF Certificate e autentica-se com ele no KSeF. O módulo mantém o inventário de certificados e tokens, e registos de autorização e delegação.
  • As contas de terceiros. A sua conta em cada plataforma, o Odoo e o alojamento são contratados e pagos por si.

Se quiser ver que menus acrescenta e por onde passa cada registo antes de decidir, explicamo-lo em como funciona o módulo por dentro.

Painel KSeF Dashboard em kanban ainda vazio, com o aviso No data to display, a pesquisa, o botão New e em cima os menus Dashboard, Migration, Operations e Configuration
O KSeF Dashboard ainda sem registos: só aparece o aviso No data to display, com os menus Dashboard, Migration, Operations e Configuration na parte superior.

Que dados saem do seu Odoo para a FlexigoTech Cloud

Faz parte da decisão, sobretudo se trabalha com dados fiscais de clientes. Segundo a página da app, é enviado o seguinte:

  • O identificador (uuid) da base de dados, o seu endereço (URL) e a versão do Odoo.
  • Os módulos da FlexigoTech instalados, com a sua versão, e se a base de dados é uma cópia neutralizada (staging ou testes).
  • O nome da empresa e o e-mail da pessoa que aceita, com a data e a versão do texto aceite.
  • Um código público para verificar que os pedidos vêm dessa base de dados, e uma prova de que é ela, calculada no seu servidor sem enviar o seu segredo.
  • Um pedido da licença de serviço a cada 6 horas e a saúde do serviço: contadores e erros (tipo e código), sem o conteúdo dos seus registos.
  • Quando usa a validação KSeF FA(3): o XML FA(3) de cada fatura que peça para verificar, com os nomes, números fiscais, moradas, contas bancárias e montantes que contém.
  • Um aviso quando desinstala o módulo.

Dentro do Odoo, o registo de auditoria é imutável e mascara NIP, PESEL e os dados de credenciais. Para qualquer questão sobre os seus dados: comercial@flexigobe.com ou +34 616 809 504.

Como a FlexigoTech o ajuda

A FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida. Se, ao rever a tabela, perceber que lhe falta a parte de configuração ou algo que o módulo não cobre, pode encará-lo como implementação ou desenvolvimento à medida, que são à parte da subscrição. Tem os detalhes do módulo na sua página em flexigotech.com e na página do Odoo Apps.

Continue a ler

Como funciona o Poland KSeF 2.0 Validator no Odoo: menus, ação agendada e percursoQue menus o Poland KSeF 2.0 Validator adiciona ao Odoo, que ação agendada corre, o que valida no FlexigoTech Cloud e o que deixa ao l10n_pl_edi para o envio.
Verificado no código do módulo (versão 20.0) e nas fontes indicadas

Fontes