Wprowadzenie
KodWaluty to kod waluty faktury zapisany jako trzyliterowy kod ISO 4217, na przykład PLN, EUR albo USD. Leży bezpośrednio w sekcji Fa struktury FA(3), pod ścieżką /Faktura/Fa/KodWaluty, i dotyczy całego dokumentu — każda kwota na fakturze jest wyrażona w tej walucie.
KodWaluty jest obowiązkowe na każdej fakturze FA(3). W XSD ma typ TKodWaluty, czyli zamknięte wyliczenie kodów ISO 4217 plus specjalną wartość XXX oznaczającą „brak waluty" (po polsku BRAK WALUTY). Nie można wymyślić własnego kodu: wartość musi być jednym z kodów z wyliczenia, inaczej dokument nie przejdzie walidacji XSD.
Na fakturach wystawianych przez polskiego sprzedawcę dla polskiego nabywcy kod to niemal zawsze PLN. Polski złoty jest domyślny, bo rejestr KSeF i rozliczenia VAT sprzedawcy działają w tej walucie. Nie znaczy to jednak, że schemat wymusza PLN: jeśli legalnie fakturowujesz klienta w euro lub dolarach, wpisujesz EUR lub USD w KodWaluty i podajesz wszystkie kwoty w tej samej walucie.
Jedyna zasada, której trzeba pilnować, to spójność. Gdy KodWaluty mówi EUR, to ceny jednostkowe netto (P_9A), wartości netto pozycji (P_11), kwoty podsumowania (P_13_x i P_14_x) oraz suma (P_15) muszą być w euro. Mieszanie kwot w PLN z kodem EUR daje dokument formalnie poprawny, ale faktycznie błędny — zdezorientuje nabywcę i każdego audytora.
KodWaluty to nie to samo co pole waluty umownej (WalutaUmowna), które pojawia się tylko w niektórych przypadkach korekt lub zaliczek i opisuje walutę inną niż waluta faktury. Na zwykłej fakturze VAT liczy się wyłącznie KodWaluty.
W Notaly nie wpisujesz KodWaluty bezpośrednio jako pola XML. Wysyłasz właściwość currency w payloadzie JSON, a Notaly mapuje ją na KodWaluty w wygenerowanym XML FA(3). Jeśli wartość nie jest obsługiwanym kodem ISO 4217, API odrzuca payload błędem 422, zanim cokolwiek trafi do KSeF.
Kompletny, poprawny przykład FA(3) znajduje się poniżej — z KodWaluty ustawionym na PLN.
<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