Saltar para o conteúdo principal
FA(3) · esquema 1-0E

O comprador em FA(3): identificador, JST e GV em Podmiot2

A secção Podmiot2 indica a quem fatura. O esquema FA(3) oferece quatro formas de escrever o identificador do comprador e duas marcas obrigatórias, JST e GV, e em produção o KSeF verifica também a soma de controlo do NIP. O Odoo escolhe o identificador por conta própria e escreve sempre as duas marcas da mesma forma.

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

Quatro formas de identificar o comprador

Elemento FA(3)Descrição no esquemaQuando se usa
NIP«Identyfikator podatkowy NIP» (identificador fiscal NIP)Comprador com NIP polaco.
KodUE + NrVatUE«Numer Identyfikacyjny VAT kontrahenta UE» (número de IVA da contraparte na UE)Comprador com número de IVA de outro país da UE, nos casos previstos na lei do IVA.
KodKraju + NrID«Identyfikator podatkowy inny» (outro identificador fiscal)Outro identificador fiscal, por exemplo de fora da UE.
BrakID«Podmiot nie posiada identyfikatora podatkowego lub identyfikator nie występuje na fakturze: 1- tak» (sem identificador fiscal, ou não consta da fatura)Consumidor ou comprador sem identificador.

O esquema só verifica o formato do NIP: 10 algarismos segundo o padrão TNrNIP. Não verifica a soma de controlo. Quem a verifica é o KSeF, mas só em produção, para Podmiot1, Podmiot2, Podmiot3 e PodmiotUpowazniony. No ambiente de testes essa validação ativa-se com o cabeçalho X-KSeF-Feature: subject-identifier-validation. A documentação não indica com que código o KSeF rejeita uma soma de controlo errada.

Cartão da secção Podmiot2 de FA(3)
Os elementos do identificador do comprador e as marcas JST e GV do esquema 1-0E.

As marcas JST e GV

Ambas são obrigatórias em Podmiot2 e tomam o valor 1 ou 2:

  • JST, «Znacznik jednostki podrzędnej JST.» (marca de unidade subordinada de uma autarquia local): 1 quando a fatura diz respeito a uma unidade subordinada de um município ou de outra autarquia local; nesse caso é preciso preencher Podmiot3 com a função 8 e o NIP ou o identificador interno da unidade;
  • GV, «Znacznik członka grupy VAT.» (marca de membro de um grupo de IVA): 1 quando a fatura diz respeito a um membro de um grupo de IVA; nesse caso Podmiot3 com a função 10;
  • 2 em qualquer das duas significa que a fatura não lhes diz respeito.

O que escrevem o Odoo 18, 19 e 20

O Odoo escolhe o identificador a partir do número de IVA do cliente. Um NIP polaco vai para NIP. O Odoo só escreve KodUE e NrVatUE em operações especiais, as que levam as etiquetas de imposto OSS_Base, OSS_Tax, Triangular Sale, K_21 ou K_12; qualquer outro número estrangeiro vai para KodKraju e NrID. Um cliente sem número de IVA recebe BrakID 1.

JST e GV, o Odoo escreve-os sempre como 2. Assim, uma fatura para uma unidade subordinada de uma autarquia local, ou para um membro de um grupo de IVA, não pode ser marcada a partir do Odoo como o esquema exige, e não chegará a essa unidade através de Podmiot3.

Esquema: o que o Odoo 20 escreve em Podmiot2 e o que pedem o esquema e o KSeF
Esquema feito a partir do modelo FA(3) do Odoo 20, do esquema FA(3) 1-0E e da documentação do KSeF; o riscado é o que o Odoo não escreve.

O que rever antes de enviar

  1. O número de IVA do cliente: um NIP polaco com ou sem o prefixo PL (sem ele, o Odoo toma o país da ficha do cliente), com a soma de controlo correta.
  2. Com um cliente da UE: se a fatura deve mesmo levar KodUE e NrVatUE, ou seja, se as linhas têm o imposto adequado.
  3. Com clientes do setor público: se a fatura deve chegar a uma unidade subordinada; isso o Odoo não o escreve.

O nosso módulo verifica o NIP do comprador?

Em parte. Ao usar «Mark ready for KSeF upload», o Poland KSeF 2.0 Validator calcula a soma de controlo polaca do NIP do cliente e, se não bater certo, indica «Partner NIP invalid» e deixa a fatura em «Manual action required»: não passa para «Ready to upload to KSeF». Aplica a soma de controlo a qualquer número de IVA, também estrangeiro, e um número estrangeiro quase nunca a cumpre, por isso, com um cliente com número de IVA de outro país, a fatura fica aí mesmo que o número esteja correto. A validação do FlexigoTech Cloud verifica o ficheiro contra o esquema, ou seja, o formato, sem a soma de controlo.

Continue a ler

As datas no FA(3): P_1, P_6 e DataWytworzeniaFaRegras de datas do esquema FA(3) 1-0E e do KSeF: P_1 na hora polaca, P_6, DataWytworzeniaFa desde 2025-09-01. Quando dão 450 e o que faz o Odoo 18-20.Códigos 410 e 415 do KSeF: permissões do vendedor e anexosO 410 «Nieprawidłowy zakres uprawnień» e o 415 em faturas com anexo: o que os causa nos testes do Ministério e o que rever no Odoo 18, 19 e 20.Código 450 do KSeF: «Błąd weryfikacji semantyki dokumentu faktury»O código 450 do KSeF rejeita uma fatura FA(3) após rever o seu conteúdo. Onde está o motivo real, o que o Odoo 18, 19 e 20 não mostra e como voltar a enviá-la.
Verificado no código do módulo (versão 20.0) e nas fontes indicadas

Fontes