Schemat FA(3) – co musi zawierać faktura ustrukturyzowana w KSeF

Zespół NaprawKSeF·15 min czytania

Schemat FA(3) to fundament Krajowego Systemu e-Faktur. Bez zrozumienia jego struktury nie wystawisz faktury, która przejdzie walidację. W tym artykule rozbieramy schemat na części pierwsze: poznasz wymagane pola, zrozumiesz strukturę XML i zobaczysz konkretne przykłady.

Czym jest schemat FA(3)?

Schemat FA(3) to oficjalna specyfikacja Ministerstwa Finansów określająca strukturę faktury ustrukturyzowanej. "FA" oznacza "faktura", a "(3)" to numer wersji schematu.

Główne sekcje schematu FA(3)

Faktura ustrukturyzowana składa się z kilku głównych bloków: Nagłówek (podstawowe informacje o dokumencie), Podmiot1 (dane sprzedawcy), Podmiot2 (dane nabywcy) oraz Fa (dane faktury – serce dokumentu).

Najważniejsze pola sekcji Fa

  • KodWaluty – waluta (ISO 4217: PLN, EUR, USD...)
  • P_1 – data wystawienia (YYYY-MM-DD)
  • P_2 – numer faktury (unikalny)
  • P_6 – data sprzedaży (YYYY-MM-DD)
  • P_13_1 do P_13_7 – sumy netto dla różnych stawek VAT
  • P_14_1 do P_14_3 – sumy VAT dla różnych stawek
  • P_15 – suma brutto

Struktura pozycji faktury (FaWiersz)

Każda pozycja na fakturze to osobny element FaWiersz zawierający: NrWierszaFa (numer pozycji), P_7 (nazwa towaru/usługi, max 256 znaków), P_8A (jednostka miary), P_8B (ilość), P_9A (cena jednostkowa netto), P_11 (wartość netto), P_12 (stawka VAT).

Typowe błędy w schemacie FA(3)

  • Złe namespace – brak lub niepoprawny atrybut xmlns
  • Niewłaściwa kolejność elementów – elementy muszą być w kolejności określonej w schemacie
  • Nieprawidłowy format liczb – bez spacji, kropka jako separator dziesiętny, bez jednostki
  • Puste wymagane pola – nie mogą być puste ani zawierać tylko spacji

Klucz do sukcesu z KSeF

  • ✓ Struktura ma znaczenie – elementy w określonej kolejności
  • ✓ Formaty są ścisłe – daty YYYY-MM-DD, liczby z kropką
  • ✓ Wymagane pola są wymagane – brak = odrzucenie
  • ✓ Matematyka musi się zgadzać – sumy netto + VAT = brutto
  • ✓ Waliduj przed wysłaniem – zawsze

→ Przetestuj NaprawKSeF za darmo – zwaliduj swoją pierwszą fakturę

→ Zobacz bibliotekę błędów KSeF