Saltar para o conteúdo principal
KSeF 2.0 · estado da fatura

Códigos 410 e 415 do KSeF: permissões do vendedor e anexos

Os dois códigos chegam como estado da fatura depois do envio e ambos dizem respeito a poder enviar essa fatura nesse contexto. Os testes da biblioteca do Ministério das Finanças polaco mostram três causas concretas: um NIF de vendedor diferente do NIF da sessão, não ter permissão para anexos e um anexo numa sessão interativa.

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

O que diz o KSeF e o que testa o Ministério

CódigoTexto do KSeFCaso dos testes do Ministério
410«Nieprawidłowy zakres uprawnień» (âmbito de permissões incorreto)Fatura com um NIF de vendedor diferente do NIF com que a sessão foi autenticada.
410«Nieprawidłowy zakres uprawnień»Vendedor sem permissão para anexos; em details: «Sprzedawca {nip} nie posiada zgody do wysyłania faktur z załącznikami».
415«Brak możliwości wysyłania faktury z załącznikiem» (não é possível enviar uma fatura com anexo)Fatura com anexo enviada numa sessão interativa.

A documentação do KSeF acrescenta duas regras. Para enviar uma fatura é preciso ter o direito de a emitir no contexto desse contribuinte. As faturas com anexos só se enviam em modo lote (a exceção é a correção técnica de uma fatura offline) e depois de registar essa opção no e-Urząd Skarbowy.

Cartão dos códigos 410 e 415 do KSeF
O código 410 com a respetiva descrição da API e, ao lado, o 415 da fatura com anexo.

Como se vê no Odoo 18, 19 e 20

O l10n_pl_edi inicia sessão no KSeF com o certificado KSeF das definições, usando o NIF da empresa como contexto, e escreve esse mesmo NIF em Podmiot1. Exige que o NIF da empresa comece por PL («A polish VAT number must be set on your company.»). Depois de um 410 passa o estado para Rejected e escreve «KSeF Status: Rejected (Code: 410). Incorrect scope of permissions.» (na 18 e na 19 em polaco: «Status KSeF: Odrzucono (Kod:410). Nieprawidłowy zakres uprawnień.»).

O 410 chega como estado da fatura, tal como o 450, por isso o Odoo mostra-o no histórico depois de consultar o estado: logo após o envio ou mais tarde com o botão «Check Sending». As permissões concedem-se e verificam-se no próprio KSeF, não no Odoo: o Odoo só conhece o certificado e o NIF da empresa.

O modelo FA(3) do Odoo não tem o elemento Zalacznik e o Odoo envia numa sessão interativa. Por isso, o 415, e um 410 por causa de anexos, não deveriam sair de uma fatura gerada pelo Odoo; se os vir, o ficheiro veio de outro programa.

O que rever perante um 410

  • O NIF da empresa no Odoo é exatamente o NIF sobre o qual o titular do certificado tem permissões.
  • O titular do certificado tem no KSeF a permissão de emitir faturas para esse NIF; quem a concede é o titular da empresa. Sem permissão nenhuma, o KSeF já interrompe o início de sessão (estado 415 na autenticação: «Brak przypisanych uprawnień», sem permissões atribuídas).
  • Se alterou o NIF da empresa no Odoo, volte a guardar o certificado nas definições. O Odoo escreve em Podmiot1 o NIF atual, mas, até à próxima renovação automática, o seu acesso provém de um início de sessão com o anterior, que é justamente o caso do teste do Ministério.
  • Numa base de dados com várias empresas, cada uma tem o seu certificado; a fatura segue com o contexto da empresa a que pertence.
Esquema: o que devolve o KSeF com os códigos 410 e 415 e o que mostra o Odoo 20
Esquema feito a partir do código do l10n_pl_edi do Odoo 20 e da especificação da API do KSeF 2.9.0; o riscado é o que o Odoo não guarda ou não faz.

Voltar a enviá-la

Depois de corrigir, repõe a fatura em rascunho (numa rejeitada o Odoo apaga o estado e o número KSeF), confirme-a e envie-a de novo. O nosso módulo, Poland KSeF 2.0 Validator, toma do l10n_pl_edi o estado Rejected e depois o Accepted, mas não envia nada por conta própria nem altera permissões no KSeF.

Continue a ler

Estados de autenticação do KSeF: 415, 425, 450, 470 e 480Estados do início de sessão no KSeF 2.0 além do certificado: sem permissões, revogado, token errado, bloqueio. Códigos 21301 e 21304 e como aparecem no Odoo.Início de sessão no KSeF com certificado: código 460 e erros de assinatura XAdESCódigo 460 do KSeF e exceções 9101-9105, 21111, 21115, 21117, 21217, 21401 e 21406 ao iniciar sessão com certificado. O que o Odoo 18, 19 e 20 não mostram.Código 440 do KSeF: «Duplikat faktury»Código 440 do KSeF: já existe no sistema uma fatura com o mesmo NIF do vendedor, tipo e número. Como o KSeF o determina, o que mostra o Odoo 18, 19 e 20 e como resolver.
Verificado no código do módulo (versão 20.0) e nas fontes indicadas

Fontes