Kompatybilność z KSeF - ocena gotowości Twojego oprogramowania

Kompatybilność z KSeF oznacza, że oprogramowanie księgowe lub ERP tworzy, wysyła, odbiera i archiwizuje e‑faktury zgodne ze specyfikacją Krajowego Systemu e‑Faktur, zapewnia komunikację z API KSeF, stosuje podpis kwalifikowany oraz mechanizmy bezpieczeństwa i archiwizacji wymagane przepisami.

SPIS TREŚCI

Kluczowe wymagania techniczne

obsługa formatu FA(2) i przygotowanie na FA(3),
integracja z API KSeF 2.0 (autoryzacja, wysyłka, pobranie numeru KSeF, pobranie dokumentu),
posiadanie i obsługa podpisu elektronicznego opartego na certyfikacie kwalifikowanym,
backup i archiwizacja dokumentów zgodna z wymogiem przechowywania przez 5 lat,
bezpieczeństwo transmisji (TLS) oraz szyfrowanie danych w spoczynku,
obsługa wyjątków: korekty, anulowania, re‑submission po błędach i mechanizmy kolejkowania.

Jak przeprowadzić ocenę gotowości oprogramowania — krok po kroku

audyty infrastruktury IT, sprawdź wersje bazy danych, środowiska aplikacyjnego, dostępność certyfikatów oraz harmonogram kopii zapasowych,
weryfikacja funkcji aplikacji, przetestuj generowanie FA(2) w XML, eksport/import danych, walidację pól oraz obsługę faktur korygujących,
integracja z API KSeF w środowisku testowym Ministerstwa Finansów, skonfiguruj połączenie i wykonaj pełny cykl: wysyłka → potwierdzenie → pobranie numeru KSeF → pobranie dokumentu,
testy obciążeniowe i wydajności, uruchom scenariusze 100, 1 000 i 10 000 dokumentów i zmierz czasy odpowiedzi oraz wskaźnik błędów,
procedury archiwizacji i odzyskiwania, wykonaj odtworzenie z kopii zapasowej dla co najmniej 1 000 dokumentów i zmierz kompletność i czas przywrócenia,
szkolenie i dokumentacja operacyjna, przygotuj instrukcje dla zespołu księgowego, scenariusze obsługi wyjątku oraz procedury eskalacji.

Praktyczne wskazówki do każdego kroku

Audyt infrastruktury: monitoruj wersje bibliotek kryptograficznych i stosuj wymóg TLS 1.2+; sprawdź mechanizmy automatycznego odnowienia certyfikatów oraz dostępność środowisk testowych i produkcyjnych. Zidentyfikuj komponenty, które będą wymagały skalowania przy wzroście liczby faktur.

Weryfikacja aplikacji: stosuj walidację schematu XML po stronie klienta przed wysyłką — zredukuje to liczbę odrzuceń przez KSeF. Dokumentuj błędy w systemie zarządzania zgłoszeniami (ticketing) z pełnymi logami i payloadami XML.

Integracja z API: testuj autoryzację, obsługę sesji i błędów HTTP (4xx/5xx). Upewnij się, że system potrafi pobrać i zapisać numer KSeF oraz że istnieje mechanizm identyfikacji transakcji po obu stronach (lokalny ID ↔ numer KSeF).

Testy wydajności: mierz czasy end-to-end (od przygotowania dokumentu do zapisania potwierdzenia), throughput (faktur/sekundę) i średni czas odpowiedzi API. Zapisuj metryki w systemie monitorującym i porównuj je do ustalonych progów.

Checklist do szybkiej oceny

generowanie FA(2) w formacie XML — tak/nie,
wsparcie dla FA(3) w planie rozwoju — tak/nie,
połączenie z API KSeF 2.0 w środowisku testowym — tak/nie,
posiadanie certyfikatu kwalifikowanego i procedury podpisu — tak/nie,
automatyczne tworzenie kopii zapasowych co 24 godziny — tak/nie,
przechowywanie dokumentów przez 5 lat z dostępem audytowym — tak/nie,
obsługa korekt i anulowań z wysyłką do KSeF — tak/nie,
scenariusze testowe dla 100/1 000/10 000 faktur dziennie — przeprowadzone/nie.

Scenariusze testowe i zalecane metryki

Scenariusz A (podstawowa wysyłka): 100 faktur w 1 godzinę. Oczekiwana metryka: czas odpowiedzi API 0,5–2 s. Jeśli średni czas przekracza 5 s, identyfikuj wąskie gardła w sieci lub w procesie generowania XML.

Scenariusz B (szczyt operacyjny): 1 000 faktur w 60 minut. Cel: liczba błędów poniżej 0,5% i średni czas odpowiedzi poniżej 3 s; monitoruj liczbę retry i długość kolejek wysyłkowych.

Scenariusz C (duża firma): 10 000 faktur w 1 dzień. Zaplanuj skalowalność poziomą, batch‑ową wysyłkę lub architekturę asynchroniczną z kolejkami; celem jest utrzymanie stabilnego poziomu błędów i akceptowalnych czasów latencji.

Test błędów i retry: symuluj 5% błędów sieciowych i sprawdź mechanizmy ponownej próby z backoffem oraz idempotentność operacji (unikaj duplikatów). Rejestruj kody błędów i czasy retry w logach.

Test archiwizacji: odtworzenie 1 000 dokumentów w czasie do 60 minut z walidacją integralności (sumy kontrolne, zgodność pól) i sprawozdaniem braków.

Typowe problemy i sposoby naprawy

nieprawidłowy format FA(2), naprawa: zaktualizuj generator XML i wprowadź walidację schematu przed wysyłką oraz testy regresyjne,
brak certyfikatu kwalifikowanego, naprawa: zakup certyfikatu od kwalifikowanego dostawcy i wdrożenie procesu automatycznego podpisu,
błędy po stronie API (timeouty, 5xx), naprawa: wprowadź retry z backoffem i kolejkowanie wysyłek w partiach oraz monitorowanie,
niekompletne archiwum, naprawa: wdroż mechanizm audytu zapisu z identyfikatorami transakcji oraz regularne testy odtwarzania,
brak obsługi korekt, naprawa: rozszerz funkcjonalność o generowanie korekt zgodnych z FA(2) i procedury rejestracji w KSeF.

Bezpieczeństwo, zgodność prawna i audyt

Przechowywanie e‑faktur przez 5 lat z możliwością audytu jest obowiązkiem podatkowym — systemy muszą zapewnić dostęp audytowy, ścieżkę zmian i integralność zapisów. Transmisja powinna odbywać się przy użyciu TLS 1.2 lub nowszego, a dane w spoczynku powinny być szyfrowane. Prowadź logi dostępu i operacji przez co najmniej 12 miesięcy i stosuj mechanizmy wykrywania anomalii (alerty przy nietypowych wzorcach dostępu).

Weryfikuj zgodność certyfikatów z rozporządzeniem eIDAS jeśli podpis elektroniczny ma potwierdzać autentyczność wysyłającego. Dokumentuj polityki retencji i procedury bezpieczeństwa oraz przeprowadzaj okresowe audyty wewnętrzne.

Wsparcie, szkolenia i finansowanie

Ministerstwo Finansów udostępnia środowisko testowe KSeF oraz dokumentację techniczną; skorzystaj z tych zasobów do weryfikacji integracji. Firmy szkoleniowe i partnerzy technologiczni oferują warsztaty dla księgowych i administratorów systemów — warto przygotować dedykowane szkolenia do obsługi wyjątków i procedur odzyskiwania danych. Dla MŚP dostępne są programy unijne i lokalne dofinansowania na cyfryzację — sprawdź warunki i terminy naborów.

Typowy czas wdrożenia: dla MŚP z gotowym modułem integracyjnym producenta to zazwyczaj 4–12 tygodni, natomiast pełna integracja przy rozbudowie systemu lub migracji danych może trwać 3–6 miesięcy. Planowanie zależy od złożoności procesów księgowych, liczby dokumentów oraz gotowości dostawcy oprogramowania.

Materiały techniczne i dowody testów

Dokumentuj wyniki testów w formie logów, raportów wydajnościowych i listy błędów wraz ze statusem napraw. Przechowuj kopie konfiguracji API, przykładowe pliki XML użyte w testach, oraz zrzuty ekranów z wynikami testów integracyjnych. Takie materiały ułatwiają audyt wewnętrzny i dialog z dostawcą oprogramowania.

Tak, jeśli system generuje FA(2), łączy się z API KSeF 2.0 w środowisku testowym oraz przechowuje e‑faktury przez 5 lat z podpisem kwalifikowanym, to można uznać go za kompatybilny; każdy brak w tych obszarach wymaga zaplanowanej aktualizacji.

Kolejne kroki rekomendowane do wykonania: dokonaj audytu według checklisty, umów demonstrację integracji z dostawcą oprogramowania, przeprowadź testy wydajnościowe (100/1 000/10 000 faktur), zabezpiecz certyfikat kwalifikowany oraz przygotuj procedury archiwizacji i odzyskiwania danych.

Kompatybilność z KSeF – ocena gotowości Twojego oprogramowania