KSeF

Migracja FA(2) → FA(3): co się zmienia

Co zmienia migracja z FA(2) na FA(3): data P_6, bloki stron Podmiot1/Podmiot2 i FaWiersz oraz jak na nowo zmapować pola.

Opublikowano 3 min czytaniaAutor: Tomek

Wprowadzenie

FA(3) to aktualny schemat faktury ustrukturyzowanej w KSeF, a migracja ze starszej struktury FA(2) to przemapowanie pól, nie samo przemianowanie elementu głównego. W FA(3) dane faktury — między innymi P_6 (data dostawy lub wykonania usługi), bloki stron Podmiot1/Podmiot2 i pozycje FaWiersz — leżą wewnątrz elementu Fa, oddzielnie od nagłówka formularza (Nagłówek). Sprawdź położenie każdego pola względem aktualnego XSD, zamiast zakładać, że pozycje z FA(2) nadal obowiązują.

Gdzie FA(3) umieszcza pola

Dokument FA(3) ma jeden element główny — Faktura — który zawiera Nagłówek i Fa. Nagłówek niesie tylko metadane formularza: kod formularza, wariant, znacznik czasu wytworzenia i informacje o systemie. Dane faktury, na których Ci zależy, siedzą w Fa: P_1 (data wystawienia), P_2 (numer faktury), P_6 (data wydania towaru lub wykonania usługi) i P_15 (kwota do zapłaty z VAT), a obok nich strony i pozycje faktury.

P_6: data dostawy lub wykonania usługi

P_6 to data, kiedy faktycznie doszło do sprzedaży — wydania towaru albo wykonania usługi — i może się różnić od P_1, czyli daty wystawienia. Przy migracji upewnij się, że pole źródłowe mapujesz na P_6, a nie na sąsiednie pole daty, bo te dwie daty znaczą co innego i KSeF waliduje je osobno.

Podmiot1 i Podmiot2: ustrukturyzowane strony

Sprzedawca to Podmiot1, a nabywca to Podmiot2 — oba w elemencie Fa. Każdy niesie własny blok identyfikacyjny (numer identyfikacji podatkowej, NIP) oraz nazwę i adres. Migracja to dobry moment na uporządkowanie tych danych: NIP sprzedawcy niezgodny z uwierzytelnionym kontekstem albo błędny NIP nabywcy to błąd, który obala walidację, zanim faktura stanie się użyteczna.

FaWiersz: pozycje faktury

Pozycje faktury leżą w FaWiersz wewnątrz Fa. Pozycja niesie nazwę towaru lub usługi (P_7), jednostkę i ilość (P_8A i P_8B), cenę netto jednostkową (P_9A), wartość netto pozycji (P_11) oraz stawkę VAT (P_12). Zmapuj swoje pozycje na te pola i pozwól, żeby sumy były liczone z pozycji, dzięki czemu kwoty pozostaną spójne.

Jak Notaly obsługuje migrację

Notaly bierze Twój JSON, odwzorowuje sprzedawcę, nabywcę i pozycje na strukturę FA(3), waliduje wynik wobec oficjalnego XSD i wysyła go do KSeF. To zdejmuje najryzykowniejszą część migracji — ręczne utrzymywanie XML — więc Ty wysyłasz dane, a Notaly tworzy poprawny dokument FA(3).

FAQ

Czy FA(3) to tylko przemianowane FA(2)? Nie. Struktura się zmieniła: w FA(3) dane faktury leżą w elemencie Fa, oddzielnie od nagłówka formularza Nagłówek. Przemapuj pola, zamiast zakładać, że pozycje się przenoszą.

Gdzie leżą P_1, P_2, P_6 i P_15? Wszystkie cztery są w elemencie Fa, nie w nagłówku formularza Nagłówek.

Zastrzeżenie

Notaly nie jest doradcą podatkowym, księgowym ani prawnym. Ten artykuł ma charakter informacyjny, nie stanowi porady podatkowej i może być nieaktualny. Ponosisz odpowiedzialność za własne rozliczenia VAT; w razie potrzeby skonsultuj się z wykwalifikowanym księgowym.

Źródła

Źródło: www.podatki.gov.pl

Najczęstsze pytania

Czy FA(3) to tylko przemianowane FA(2)?

Nie. Struktura się zmieniła: w FA(3) dane faktury leżą w elemencie Fa, oddzielnie od nagłówka formularza Nagłówek. Przemapuj pola, zamiast zakładać, że pozycje się przenoszą.

Gdzie leżą P_1, P_2, P_6 i P_15?

Wszystkie cztery są w elemencie Fa, nie w nagłówku formularza Nagłówek.

Którą stroną jest Podmiot1?

Podmiot1 to sprzedawca, a Podmiot2 to nabywca — oba w elemencie Fa.

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.