Pole FA(3)

NrWierszaFa w FA(3): numer wiersza faktury

Jak wypełnić NrWierszaFa (numer wiersza) w każdym bloku FaWiersz faktury KSeF FA(3): format, kolejność i poprawny przykład XML.

Aktualizacja

Wprowadzenie

NrWierszaFa to numer pojedynczej pozycji faktury (po polsku „numer wiersza faktury"). Znajduje się w każdym bloku FaWiersz pod ścieżką /Faktura/Fa/FaWiersz/NrWierszaFa i pokazuje czytelnikowi — oraz organowi podatkowemu — położenie danej pozycji na dokumencie.

Pole jest obowiązkowe w każdej pozycji, a jego typ w XSD to TNaturalny, czyli liczba naturalna większa od zera. Musi to być liczba całkowita bez miejsc po przecinku i bez znaku, więc 1, 2 i 3 są poprawne, a 0, -1 czy 1.5 już nie.

Numeracja idzie zgodnie z widoczną kolejnością pozycji. Pierwsza pozycja to 1, druga to 2 i tak dalej. Numery muszą być unikalne w obrębie jednej faktury, bo inne części dokumentu odwołują się do pozycji po numerze — na przykład struktury korekt i zaliczek używają NrWierszaFa lub pokrewnego NrWierszaZam, aby wskazać konkretną pozycję. Zduplikowany albo niepo kolei numer sprawia, że te odwołania stają się niejednoznaczne.

Nie ma reguły, ile pozycji może mieć faktura poza praktycznymi limitami dokumentu, ale każda pozycja nadal potrzebuje własnego kolejnego numeru. Jeśli podczas edycji przestawisz lub usuniesz pozycję, przenumeruj pozostałe tak, aby kolejność pozostała ciągła; luka w rodzaju 1, 3, 5 jest formalnie dopuszczalna w XSD, ale wygląda błędnie i może mylić odwołania do konkretnych pozycji.

W Notaly nie wpisujesz NrWierszaFa samodzielnie. Generator numeruje pozycje automatycznie, w kolejności, w jakiej podajesz tablicę items w payloadzie JSON, zaczynając od 1. Dzięki temu numeracja jest spójna z kolejnością pozycji i z wszelkimi późniejszymi odwołaniami.

Warto odróżnić NrWierszaFa od NrWierszaZam. Ten pierwszy numeruje pozycje samej faktury, a NrWierszaZam występuje w sekcji Zamowienie i numeruje wiersze zamówienia, do których odnosi się faktura. W korektach i rozliczeniach zaliczek odwołania wskazują konkretny wiersz po jego numerze, więc spójna numeracja między dokumentami ma znaczenie. Gdy pozycja nie ma kwoty — na przykład wiersz informacyjny — nadal otrzymuje kolejny numer, bo numeracja opisuje położenie, a nie wartość.

Gdy w jednej fakturze mieszasz kilka stawek VAT albo różne kody GTU, numeracja pozycji pozostaje po prostu kolejna — żadna z tych wartości nie wpływa na sposób numerowania. Numer opisuje tylko położenie wiersza na dokumencie, więc zachowuj go stabilnym niezależnie od stawek, ilości czy kodów GTU.

Kompletny, poprawny przykład FA(3) znajduje się poniżej — z NrWierszaFa ustawionym na 1 i 2 w dwóch pozycjach.

<Faktura xmlns="http://crd.gov.pl/wzor/2025/06/25/13775/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Naglowek>
    <KodFormularza kodSystemowy="FA (3)" wersjaSchemy="1-0E">FA</KodFormularza>
    <WariantFormularza>3</WariantFormularza>
    <DataWytworzeniaFa>2026-10-12T07:23:07Z</DataWytworzeniaFa>
    <SystemInfo>einvoice-api</SystemInfo>
  </Naglowek>
  <Podmiot1>
    <DaneIdentyfikacyjne><NIP>2745013933</NIP><Nazwa>Example Sp. z o.o. (FICTIONAL)</Nazwa></DaneIdentyfikacyjne>
    <Adres><KodKraju>PL</KodKraju><AdresL1>ul. Testowa 1, 00-001 Warszawa</AdresL1></Adres>
  </Podmiot1>
  <Podmiot2>
    <DaneIdentyfikacyjne><NIP>1234563218</NIP><Nazwa>Test Customer S.A. (FICTIONAL)</Nazwa></DaneIdentyfikacyjne>
    <Adres><KodKraju>PL</KodKraju><AdresL1>ul. Probna 2, 30-001 Kraków</AdresL1></Adres>
    <JST>2</JST>
    <GV>2</GV>
  </Podmiot2>
  <Fa>
    <KodWaluty>PLN</KodWaluty>
    <P_1>2026-10-12</P_1>
    <P_2>FV/2026/10/001</P_2>
    <P_13_1>1000.00</P_13_1><P_14_1>230.00</P_14_1>
    <P_13_2>301.00</P_13_2><P_14_2>24.08</P_14_2>
    <P_15>1555.08</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>SaaS subscription - October</P_7>
      <P_8A>pcs.</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>
    <FaWiersz>
      <NrWierszaFa>2</NrWierszaFa>
      <P_7>Support</P_7>
      <P_8A>hrs.</P_8A>
      <P_8B>2</P_8B>
      <P_9A>150.50</P_9A>
      <P_11>301.00</P_11>
      <P_12>8</P_12>
    </FaWiersz>
  </Fa>
</Faktura>

Źródła

Źródło: crd.gov.pl

Najczęstsze pytania

Czy NrWierszaFa jest wymagane w każdej pozycji?

Tak. Każdy blok FaWiersz musi mieć NrWierszaFa z dodatnią liczbą całkowitą.

Jakiego typu jest NrWierszaFa?

To liczba naturalna większa od zera (w XSD typ TNaturalny).

Czy numeracja musi być ciągła?

W praktyce tak: pozycje numeruje się 1, 2, 3 i tak dalej, zgodnie z kolejnością na fakturze.

Wystaw pierwszą fakturę testową w KSeF jeszcze dziś

Załóż konto sandbox: klucz API w kilka sekund, 3 darmowe faktury testowe w KSeF TEST, bez karty płatniczej.