Przejdź do treści

Technologie KSeF6 min czytania

Migracja danych do nowego systemu FK zgodnego z KSeF - jak przeprowadzić ją bez przestojów i błędów

Migracja danych do nowego systemu FK zgodnego z KSeF to proces przenoszenia danych księgowych, kontrahentów, zapasów i faktur do aplikacji współpracującej z Krajowym Systemem e-Faktur, zgodnie z wymogami art. 106na-106nc ustawy o VAT. Obligatoryjne wdrożenie systemu nastąpi 1 lutego 2026 r. dla dużych podatników oraz 1 kwietnia 2026 r. dla pozostałych jednostek gospodarczych. Wszystkie przenoszone dane muszą zachować pełną kompatybilność z API KSeF 2.0, które staje się fundamentem obrotu gospodarczego w Polsce. Proces ten wymaga integracji systemów finansowo-księgowych z infrastrukturą Ministerstwa Finansów w celu zapewnienia ciągłości raportowania i wystawiania dokumentów ustrukturyzowanych.

KSeF 2.0 - co się zmienia i dlaczego migracja jest nieunikniona

Tekst opracowany z wykorzystaniem sztucznej inteligencji. Zasady i ograniczenia

Krajowy System e-Faktur przechodzi fundamentalną zmianę technologiczną, która wymusza na podatnikach porzucenie dotychczasowych rozwiązań komunikacyjnych. Należy jednoznacznie wskazać, że API KSeF 1.0 nie jest kompatybilne z API KSeF 2.0, co oznacza, iż oprogramowanie wykorzystujące starszą wersję protokołu przestanie funkcjonować w środowisku produkcyjnym. Zgodnie z oficjalnymi komunikatami resortu finansów, faktury przesłane za pośrednictwem wersji 1.0 nie przejdą walidacji po 31 stycznia 2026 r. Krytycznym punktem harmonogramu jest przerwa techniczna systemu KSeF 1.0 zaplanowana w dniach 26-31 stycznia 2026 r., po której jedyną dostępną wersją produkcyjną będzie KSeF 2.0.

Model rozliczania podatku VAT zmienia się z dotychczasowego systemu „post-audit” na model „clearance”, w którym każda faktura musi zostać autoryzowana przez serwery centralne przed jej wprowadzeniem do obrotu prawnego. Wersja produkcyjna (fakultatywna) KSeF 1.0 nie będzie dalej rozwijana, co czyni migrację do systemów wspierających standard FA(3) koniecznością prawną i techniczną. Jeśli 1 kwietnia 2026 r. podatnik prześle dokument w formacie PDF drogą elektroniczną do kontrahenta bez uprzedniej rejestracji w systemie, w świetle obowiązujących przepisów faktura ta nie zostanie uznana za wystawioną, co rodzi sankcje karno-skarbowe.

Terminy wdrożenia systemu są ściśle powiązane ze skalą prowadzonej działalności mierzoną wartością sprzedaży brutto. Podatnicy muszą dostosować swoje systemy finansowo-księgowe do poniższego harmonogramu:

Grupa podatników Próg obrotu Data obowiązku
Duzi podatnicy Powyżej 200 mln zł 1 lutego 2026 r.
Pozostali podatnicy (czynni VAT) Poniżej 200 mln zł 1 kwietnia 2026 r.
Podatnicy zwolnieni z VAT Nie dotyczy 1 stycznia 2027 r.

Niezastosowanie się do powyższych terminów naraża przedsiębiorstwo na dotkliwe kary finansowe, które mogą wynosić do 100% kwoty podatku VAT wykazanego na fakturze. W związku z tym dostawcy systemów finansowo-księgowych powinni niezwłocznie sprawdzić, jak ich oprogramowanie współpracuje ze środowiskiem przedprodukcyjnym API KSeF 2.0, które Ministerstwo Finansów udostępniło 15 października 2025 r.

Przygotowanie danych źródłowych - audyt przed migracją

Skuteczna migracja danych wymaga przeprowadzenia szczegółowej inwentaryzacji zasobów cyfrowych przedsiębiorstwa. Każdy rekord przenoszony do nowego systemu FK musi spełniać wymogi nowej struktury logicznej, co wymusza oczyszczenie bazy danych z błędów nagromadzonych w poprzednich latach działalności. Audytowi powinny podlegać przede wszystkim dane identyfikacyjne kontrahentów, gdyż system KSeF automatycznie odrzuca dokumenty zawierające nieprawidłowe numery NIP lub braki w prefiksach krajowych.

Inwentaryzacja systemu powinna obejmować następujące kluczowe obszary:

  1. Konta bankowe - Czy numery rachunków w formacie IBAN są przypisane do właściwych walut i czy figurują na białej liście podatników?
  2. Zapasy i indeksy towarowe - Czy kody GTU oraz stawki VAT są zmapowane zgodnie z aktualną matrycą stawek?
  3. Kontrahenci - Czy NIP-y kontrahentów zagranicznych są zwalidowane przez system VIES, a krajowych przez rejestr podmiotów MF?
  4. Faktury VAT - Czy historyczne serie numeracji nie będą kolidować z nowym schematem numeru KSeF o długości 32 znaków?
  5. Dokumenty kasowe - Czy raporty kasowe są powiązane z odpowiednimi kontami księgowymi w nowym planie kont?

Czyszczenie duplikatów jest procesem krytycznym, zwłaszcza w przypadku długotrwałej obsługi przez biura rachunkowe. Przykładem może być firma „X”, która po 8 miesiącach prowadzenia ewidencji w systemie Symfonia FK wykazała 12% duplikacji w kartotece kontrahentów, co uniemożliwiało poprawną automatyzację importu. W takich przypadkach zaleca się wykorzystanie funkcji archiwizacji i dearchiwizacji w systemie Symfonia 2.0, aby odizolować poprawne dane od rekordów archiwalnych przed ich eksportem do formatu XML.

Nowoczesne systemy ERP, takie jak Business Central, wykorzystują nawet 27 tabel w pakiecie migracyjnym, co pokazuje skomplikowanie operacji. Programy takie jak QuickBooks czy Dynamics NAV posiadają dedykowane kreatory, jednakże zawsze należy przeprowadzić „suchy eksport” do arkusza kalkulacyjnego w celu weryfikacji sum kontrolnych i spójności danych przed ostatecznym transferem do środowiska KSeF 2.0.

Eksport i konwersja - jak uniknąć utraty dokumentów

Proces konwersji danych do standardu XML jest etapem, na którym najczęściej dochodzi do błędów strukturalnych. Każdy plik przesyłany do Krajowego Systemu e-Faktur musi być zgodny ze specyfikacją XSD (XML Schema Definition). Dokumenty nieposiadające odpowiedniego kodowania UTF-8 z oznaczeniem BOM (Byte Order Mark) zostaną natychmiast odrzucone przez bramkę Ministerstwa Finansów. Wybór odpowiedniego formatu pośredniego zależy od możliwości technicznych dotychczasowego systemu FK.

Wyróżnia się cztery podstawowe formaty wejściowe dopuszczalne w procesach konwersji:

  • JPK_FA - najbezpieczniejszy format bazowy, zawierający większość wymaganych pól strukturalnych.
  • XLSX - stosowany przy mniejszej skali operacji, wymagający precyzyjnego mapowania kolumn.
  • CSV - format tekstowy, podatny na błędy kodowania znaków specjalnych.
  • XML - format natywny, o ile jest zgodny ze starszymi schematami FA(1) lub FA(2).

Przykładem efektywnej ścieżki migracyjnej jest wykorzystanie programu KT Konwerter Księgowy, który wspiera 16 systemów źródłowych, w tym Enova365, Comarch ERP Optima oraz Subiekt GT. Procedura konwersji do systemu Finka FK przebiega w dwóch etapach. Najpierw konwerter wczytuje plik źródłowy (np. z Optimy), a następnie generuje wynikowy plik XML w standardzie FA(3). Ważne jest, aby plik ten zawierał element <Fa(3)>, który jest wymagany w wersji KSeF 2.0. Każda niezgodność ze schematem spowoduje błąd krytyczny podczas próby uwierzytelnienia dokumentu w systemie centralnym.

Import do docelowego systemu FK i pierwsze uruchomienie KSeF

Po przygotowaniu i skonwertowaniu danych następuje faza importu do docelowego systemu finansowo-księgowego oraz nawiązanie połączenia z infrastrukturą rządową. Biura rachunkowe muszą być gotowe na automatyczny dostęp do faktur klientów, co wymaga uprzedniego nadania odpowiednich uprawnień w systemie. Integracja ze środowiskiem testowym KSeF 2.0 powinna zostać przeprowadzona z wykorzystaniem rzeczywistych metod uwierzytelniania, co pozwoli na weryfikację stabilności łącza i poprawności certyfikatów.

Uwierzytelnienie w systemie możliwe jest poprzez trzy główne kanały:

  • Profil Zaufany - najczęściej stosowany przez mikroprzedsiębiorców.
  • Kwalifikowany podpis elektroniczny - zalecany dla osób zarządzających finansami w dużych podmiotach.
  • Pieczęć elektroniczna - rozwiązanie dla osób prawnych, pozwalające na masowe wystawianie faktur bez przypisywania ich do konkretnej osoby fizycznej.

Należy zwrócić uwagę na ważność certyfikatów KSeF, które zazwyczaj wygasają po 2 latach. Przed rozpoczęciem importu produkcyjnego zaleca się przeprowadzenie tzw. „suchego importu” na środowisku demo, które funkcjonuje od 15 października 2025 r. Test ten powinien obejmować maksymalnie 100 faktur dziennie, co jest limitem narzuconym przez Ministerstwo Finansów dla środowisk testowych. Wystawianie dokumentów w tym trybie nie niesie ze sobą skutków prawnych, co pozwala na bezpieczne testowanie procedur wewnętrznych i eliminację błędów w godzinach wsparcia technicznego (7:00-19:00).

Najczęstsze błędy i jak im zapobiec

Podczas procesów migracyjnych i pierwszych wysyłek do KSeF 2.0 użytkownicy napotykają szereg powtarzalnych problemów technicznych. Najpoważniejszym z nich jest brak kompatybilności między wersjami API, co przy braku aktualizacji oprogramowania do wersji przejściowej (np. 3.132 planowanej na styczeń 2026 r.) całkowicie blokuje możliwość fakturowania. Poniżej przedstawiono rozwiązania najczęstszych incydentów w formie zestawienia FAQ.

Co zrobić, gdy XML ma błąd CRC?
Błąd CRC oznacza niezgodność sumy kontrolnej pliku z hashem wyliczonym po przesłaniu. Należy zweryfikować stabilność połączenia internetowego i upewnić się, że plik nie został zmodyfikowany przez oprogramowanie antywirusowe podczas wysyłki.
Czy można cofnąć import?
W środowisku produkcyjnym KSeF nie ma możliwości cofnięcia raz nadanego numeru identyfikacyjnego. Błędną fakturę należy skorygować poprzez wystawienie faktury korygującej w formacie ustrukturyzowanym.
Jak naprawić niezgodność NIP-u?
Walidator KSeF automatycznie odrzuca NIP bez prefiksu PL w transakcjach wewnątrzwspólnotowych. Należy zaktualizować kartotekę kontrahenta w systemie FK przed ponowną generacją pliku XML.
Dlaczego faktura ma status „Odrzucona”?
Status ten pojawia się najczęściej przy próbie wysyłki dokumentu do wyłączonego API KSeF 1.0 po 31 stycznia 2026 r. Rozwiązaniem jest aktualizacja systemu do wersji obsługującej API 2.0.

W celu minimalizacji ryzyka, każda firma powinna wdrożyć procedurę weryfikacji danych kontrahentów co najmniej raz w tygodniu oraz korzystać z darmowych aplikacji Ministerstwa Finansów, takich jak Aplikacja Podatnika KSeF, do wstępnej kontroli poprawności plików. Integracja systemów takich jak EZD RP z KSeF, realizowana przez NASK, stanowi obecnie kluczowy element cyfryzacji, pozwalający na automatyczne pobieranie i rejestrowanie faktur bez ingerencji manualnej operatora.

Redakcja · wszystkie artykuły