KSeF — invoice still using the retired FA(2) schema
A falha de migração para o KSeF mais comum: uma fatura perfeitamente bem formada que ainda declara o namespace FA(2), retirado a 1 de fevereiro de 2026. Nada parece errado até o KSeF a rejeitar. Repare no que o FA(3) acrescentou e aqui falta: Podmiot2 exige agora JST e GV.
FA(2) 1-0E — Inválido
A falha de migração para o KSeF mais comum: uma fatura perfeitamente bem formada que ainda declara o namespace FA(2), retirado a 1 de fevereiro de 2026. Nada parece errado até o KSeF a rejeitar. Repare no que o FA(3) acrescentou e aqui falta: Podmiot2 exige agora JST e GV.
O que este ficheiro mostra
A falha de migração para o KSeF mais comum: uma fatura perfeitamente bem formada que ainda declara o namespace FA(2), retirado a 1 de fevereiro de 2026. Nada parece errado até o KSeF a rejeitar. Repare no que o FA(3) acrescentou e aqui falta: Podmiot2 exige agora JST e GV.
Os defeitos que contém
- FA(2)this file uses the FA(2) schema
Citado literalmente do validador, sem paráfrase.
Todas as partes, IBAN e montantes abaixo são fictícios. Os IBAN são estruturalmente válidos — passam no mod-97 — mas não correspondem a nenhuma conta real.
Conteúdo do ficheiro
<?xml version="1.0" encoding="UTF-8"?>
<!--
DELIBERATELY OUT OF DATE. This invoice uses the retired FA(2) schema
(namespace http://crd.gov.pl/wzor/2023/06/29/12648/), which KSeF stopped
accepting on 1 February 2026 when FA(3) replaced it.
It is published as a sample because this is the single most common failure when
migrating: the file still looks fine, but the schema is the old one. Note also
what FA(3) added and this file therefore lacks — Podmiot2 now requires JST and GV.
-->
<Faktura xmlns:etd="http://crd.gov.pl/xml/schematy/dziedzinowe/mf/2022/01/05/eD/DefinicjeTypy/"
xmlns="http://crd.gov.pl/wzor/2023/06/29/12648/">
<Naglowek>
<KodFormularza kodSystemowy="FA (2)" wersjaSchemy="1-0E">FA</KodFormularza>
<WariantFormularza>2</WariantFormularza>
<DataWytworzeniaFa>2026-01-15T09:30:00Z</DataWytworzeniaFa>
<SystemInfo>Legacy ERP 4.2</SystemInfo>
</Naglowek>
<Podmiot1>
<DaneIdentyfikacyjne>
<NIP>9999999999</NIP>
<Nazwa>ABC AGD sp. z o. o.</Nazwa>
</DaneIdentyfikacyjne>
<Adres>
<KodKraju>PL</KodKraju>
<AdresL1>ul. Kwiatowa 1 m. 2</AdresL1>
<AdresL2>00-001 Warszawa</AdresL2>
</Adres>
</Podmiot1>
<Podmiot2>
<DaneIdentyfikacyjne>
<NIP>1111111111</NIP>
<Nazwa>CDE sp. j.</Nazwa>
</DaneIdentyfikacyjne>
<Adres>
<KodKraju>PL</KodKraju>
<AdresL1>ul. Sadowa 1 lok. 3</AdresL1>
<AdresL2>00-002 Kraków</AdresL2>
</Adres>
</Podmiot2>
<Fa>
<KodWaluty>PLN</KodWaluty>
<P_1>2026-01-15</P_1>
<P_2>FV/2026/01/88</P_2>
<P_13_1>1000.00</P_13_1>
<P_14_1>230.00</P_14_1>
<P_15>1230.00</P_15>
<Adnotacje>
<P_16>2</P_16>
<P_17>2</P_17>
<P_18>2</P_18>
<P_18A>2</P_18A>
<Zwolnienie>
<P_19N>1</P_19N>
</Zwolnienie>
<NoweSrodkiTransportu>
<P_22N>1</P_22N>
</NoweSrodkiTransportu>
<P_23>2</P_23>
<PMarzy>
<P_PMarzyN>1</P_PMarzyN>
</PMarzy>
</Adnotacje>
<RodzajFaktury>VAT</RodzajFaktury>
<FaWiersz>
<NrWierszaFa>1</NrWierszaFa>
<P_7>lodówka Zimnotech mk1</P_7>
<P_8A>szt.</P_8A>
<P_8B>1</P_8B>
<P_9A>1000.00</P_9A>
<P_11>1000.00</P_11>
<P_12>23</P_12>
</FaWiersz>
</Fa>
</Faktura>
Como sabemos que estes resultados se mantêm
Cada ficheiro desta biblioteca passa pelo próprio validador do site em cada build. O resultado esperado indicado acima é verificado por um teste automatizado: se um ficheiro deixasse de corresponder ao que esta página afirma, o build falharia. Duas fixtures herdadas foram reparadas assim antes da publicação: três IBAN falhavam o mod-97 e vários nomes usavam caracteres fora do conjunto SEPA básico.
Fatura KSeF (Polónia, FA(3))
- KSeF FA(3) — valid invoice (official MF example)
- KSeF FA(3) — bad NIP check digit and mismatched total (warnings only)
- KSeF FA(3) — correcting invoice (faktura korygująca, KOR)
- KSeF FA(3) — prepayment invoice (faktura zaliczkowa, ZAL)
- KSeF FA(3) — mandatory element missing (rejected by the official XSD)
- KSeF FA(3) — buyer NIP failing its mod-11 check digit (warning only)