Przejdź do głównej treści
FA(3) · schemat 1-0E

Nabywca w FA(3): identyfikator, JST i GV w Podmiot2

Sekcja Podmiot2 mówi, komu wystawiasz fakturę. Schemat FA(3) daje cztery sposoby zapisania identyfikatora nabywcy i dwa obowiązkowe znaczniki, JST i GV, a KSeF na produkcji sprawdza dodatkowo sumę kontrolną NIP. Odoo wybiera identyfikator sam, a oba znaczniki wpisuje zawsze tak samo.

FlexigoTech · Odpowiada: Víctor Gómez · Aktualizacja: 5 listopada 2026

Najważniejsze

Moduł
KSeF 2.0
Wersje
Odoo 17, 18, 19 i 20
Sprawdzone
w kodzie źródłowym modułu, wersja 20.0 · w źródłach podanych na końcu
Czas czytania
2 min

Cztery sposoby na identyfikator

Element FA(3)Opis ze schematuKiedy go użyć
NIP„Identyfikator podatkowy NIP”Nabywca z polskim NIP.
KodUE + NrVatUE„Numer Identyfikacyjny VAT kontrahenta UE”Nabywca z numerem VAT innego kraju UE w przypadkach z ustawy o VAT.
KodKraju + NrID„Identyfikator podatkowy inny”Inny identyfikator podatkowy, np. spoza UE.
BrakID„Podmiot nie posiada identyfikatora podatkowego lub identyfikator nie występuje na fakturze: 1- tak”Konsument albo nabywca bez identyfikatora.

Schemat sprawdza tylko format NIP: 10 cyfr według wzorca typu TNrNIP. Sumy kontrolnej nie sprawdza. Robi to KSeF, ale tylko na środowisku produkcyjnym, dla Podmiot1, Podmiot2, Podmiot3 i PodmiotUpowazniony. Na środowisku testowym tę walidację włącza nagłówek X-KSeF-Feature: subject-identifier-validation. Dokumentacja nie podaje, jakim kodem KSeF odrzuca błędną sumę kontrolną.

Karta sekcji Podmiot2 FA(3)
Elementy identyfikatora nabywcy i znaczniki JST i GV ze schematu 1-0E.

Znaczniki JST i GV

Oba są obowiązkowe w Podmiot2 i przyjmują wartość 1 albo 2:

  • JST, „Znacznik jednostki podrzędnej JST.”: 1, gdy faktura dotyczy jednostki podrzędnej samorządu; wtedy trzeba wypełnić Podmiot3 z rolą 8 i podać NIP albo identyfikator wewnętrzny jednostki;
  • GV, „Znacznik członka grupy VAT.”: 1, gdy faktura dotyczy członka grupy VAT; wtedy Podmiot3 z rolą 10;
  • 2 w obu oznacza, że faktura ich nie dotyczy.

Co wpisuje Odoo 18, 19 i 20

Odoo wybiera identyfikator z numeru VAT klienta. Polski NIP trafia do NIP. KodUE i NrVatUE Odoo wpisuje tylko przy transakcjach specjalnych, czyli z etykietami podatkowymi OSS_Base, OSS_Tax, Triangular Sale, K_21 albo K_12; każdy inny zagraniczny numer idzie do KodKraju i NrID. Klient bez numeru VAT dostaje BrakID 1.

JST i GV Odoo wpisuje zawsze jako 2. Faktury dla jednostki podrzędnej samorządu albo członka grupy VAT nie da się więc z Odoo oznaczyć tak, jak tego wymaga schemat, i taka faktura nie trafi do tej jednostki przez Podmiot3.

Schemat: co Odoo 20 wpisuje w Podmiot2 i czego wymagają schemat i KSeF
Schemat na podstawie szablonu FA(3) z Odoo 20, schematu FA(3) 1-0E i dokumentacji KSeF; skreślone jest to, czego Odoo nie zapisuje.

Co sprawdzić przed wysyłką

  1. Numer VAT klienta: polski NIP z prefiksem PL albo bez niego (wtedy Odoo bierze kraj z karty klienta), z poprawną sumą kontrolną.
  2. Przy kliencie z UE: czy faktura naprawdę powinna mieć KodUE i NrVatUE, czyli czy pozycje mają właściwy podatek.
  3. Przy klientach z sektora publicznego: czy faktura nie powinna trafić do jednostki podrzędnej; tego Odoo nie zapisze.

Czy nasz moduł sprawdza NIP nabywcy?

Tak, częściowo. Poland KSeF 2.0 Validator przy „Mark ready for KSeF upload” liczy polską sumę kontrolną NIP klienta i, jeśli się nie zgadza, zgłasza „Partner NIP invalid” i zostawia fakturę w stanie „Manual action required”: nie przechodzi ona do „Ready to upload to KSeF”. Stosuje tę sumę do każdego numeru VAT, także zagranicznego, a zagraniczny numer prawie nigdy jej nie spełnia, więc przy kliencie z numerem VAT z innego kraju faktura zostaje w tym stanie, nawet gdy numer jest poprawny. Walidacja w FlexigoTech Cloud sprawdza plik ze schematem, a więc format, bez sumy kontrolnej.

Czytaj dalej

Daty w FA(3): P_1, P_6 i DataWytworzeniaFaReguły dat w schemacie FA(3) 1-0E i w KSeF: P_1 w czasie polskim, P_6, DataWytworzeniaFa od 2025-09-01. Kiedy kończą się kodem 450 i jak wypełnia je Odoo 18, 19 i 20.Kody 410 i 415 w KSeF: uprawnienia sprzedawcy i załącznikiKod 410 „Nieprawidłowy zakres uprawnień” i 415 „Brak możliwości wysyłania faktury z załącznikiem”: co je wywołuje według testów MF i co sprawdzić w Odoo 18, 19 i 20.Kod 450 w KSeF: „Błąd weryfikacji semantyki dokumentu faktury”Kod 450 oznacza, że KSeF odrzucił fakturę FA(3) po sprawdzeniu treści. Gdzie jest prawdziwa przyczyna, czego nie pokazuje Odoo 18, 19 i 20 i jak wysłać fakturę ponownie.
Sprawdzone w kodzie źródłowym modułu (wersja 20.0) i w podlinkowanych źródłach

Źródła