KSeF — jak przygotować firmęod strony IT przed wdrożeniem e-fakturowania

roku — ta data na trwałe zmienia sposób, w jaki polskie firmy wystawiają faktury. Krajowy System e-Faktur przestaje być dobrowolnym narzędziem, a staje się obowiązkową infrastrukturą fiskalną dla każdego czynnego podatnika VAT w Polsce.

Dla wielu firm to nie jest kwestia księgowości — to kwestia IT. Bo KSeF nie wymaga jedynie zmiany przyzwyczajeń w dziale finansów. Wymaga zaktualizowania oprogramowania, skonfigurowania certyfikatów, przetestowania integracji API i upewnienia się, że cały łańcuch dokumentowy działa bez przerw. Właśnie o tym jest ten artykuł.

KSeF — czym jest i kogo obowiązuje od?

Krajowy System e-Faktur (KSeF) to centralny system informatyczny Ministerstwa Finansów, za pośrednictwem którego podatnicy wystawiają i otrzymują faktury ustrukturyzowane w formacie XML (FA_VAT). Każda faktura otrzymuje unikalny numer KSeF nadany przez system i jest przechowywana przez Ministerstwo przez co najmniej 10 lat.

System działa na zasadzie pośrednictwa cyfrowego: zamiast wysyłać fakturę PDF e-mailem lub pocztą, podatnik przesyła ją do KSeF, skąd odbiorca pobiera ją w czasie rzeczywistym. Faktura ustrukturyzowana ma moc prawną taką samą jak dotychczasowa faktura elektroniczna lub papierowa.

Warto podkreślić: KSeF nie zastępuje całkowicie dotychczasowych faktur w przypadku transakcji z podmiotami zagranicznymi, faktur za przejazdy autostradami czy faktur wystawianych przez kasy fiskalne online w trybie fiskalnym. Jednak dla zdecydowanej większości transakcji B2B KSeF staje się jedyną legalną ścieżką fakturowania.

Co KSeF zmienia w infrastrukturze IT firmy?

Dla działów IT KSeF to wielowymiarowe wyzwanie. Zmiany dotyczą czterech głównych obszarów infrastruktury:

• Oprogramowanie do fakturowania i ERP — każdy program, w którym wystawiasz faktury, musi zostać zaktualizowany do wersji obsługującej format FA_VAT i komunikację z API KSeF. Starsza wersja Subiekta, Optimy czy Symfonii może po prostu nie mieć tego modułu.
• Certyfikaty cyfrowe i zarządzanie tożsamością — do uwierzytelnienia w systemie KSeF potrzebujesz podpisu kwalifikowanego lub pieczęci elektronicznej. To oznacza nowe certyfikaty, ich instalację na odpowiednich urządzeniach i ustalenie, kto w firmie ma uprawnienia do wysyłania faktur.
• Połączenie sieciowe i dostępność API — KSeF wymaga stałego dostępu do internetu. Awaria łącza lub firewall blokujący API MF może uniemożliwić wystawienie faktury. Dział IT musi zapewnić redundancję łącza i właściwą konfigurację reguł sieciowych.
• Archiwizacja i backup dokumentów elektronicznych — chociaż KSeF przechowuje faktury przez 10 lat, wiele firm zdecyduje się na własną archiwizację dla celów audytowych. To wymaga dodatkowej przestrzeni i procedur backup.

Które programy księgowe wymagają aktualizacji?

Poniżej zestawienie najpopularniejszych programów ERP i fakturowania w Polsce z informacją o statusie integracji z KSeF (stan na kwiecień).

Kluczowy wniosek: posiadanie aktualnej licencji nie oznacza, że masz moduł KSeF. W wielu firmach oprogramowanie jest „na licencji", ale dawno nieaktualizowane. Pierwszym krokiem jest sprawdzenie wersji i kontakt z dostawcą lub z nami jako Twoim działem IT.

Podpis kwalifikowany i pieczęć elektroniczna — wymagania techniczne

Do uwierzytelnienia w systemie KSeF i wystawiania faktur wymagane jest jedno z trzech:

• Kwalifikowany podpis elektroniczny — wydawany przez certyfikowane centra certyfikacji (Certum, Sigillum, Eurocert, KIR). Kosztuje 200–350 zł rocznie + czytnik kart 80–150 zł jednorazowo. Podpis jest przypisany do konkretnej osoby fizycznej.
• Kwalifikowana pieczęć elektroniczna — przypisana do podmiotu (firmy), nie do osoby. Idealna dla automatycznych procesów fakturowania i integracji API. Koszt: 400–700 zł rocznie.
• Token KSeF — specjalny token wygenerowany przez system KSeF dla podmiotu. Można go używać do automatycznego wysyłania faktur przez oprogramowanie — bez fizycznego podpisu przy każdej fakturze.

Wymagania techniczne dla podpisu kwalifikowanego

Podpis kwalifikowany na karcie kryptograficznej wymaga: czytnika kart USB, zainstalowanego oprogramowania dostawcy certyfikatu (np. Certum SimplySign lub middleware dla kart), przeglądarki kompatybilnej z podpisem oraz aktualnego certyfikatu (ważność 1–3 lata). Dział IT musi zainstalować i przetestować podpis na stacjach roboczych wszystkich osób uprawnionnych do fakturowania.

Coraz popularniejszym rozwiązaniem są podpisy mobilne (np. mSzafir, SimplySign Mobile), które działają przez aplikację na smartfonie — bez fizycznej karty. To wygodne rozwiązanie dla osób pracujących zdalnie lub w terenie.

Integracja API z KSeF — co musi skonfigurować dział IT

Dla firm korzystających z ERP kluczowym krokiem technicznym jest prawidłowa konfiguracja połączenia z API KSeF. Poniżej lista elementów, które musi zweryfikować i skonfigurować dział IT:

• Endpoint API KSeF — produkcyjne API MF jest dostępne pod adresem https://ksef.mf.gov.pl/api. Wersja testowa (DEMO) na https://ksef-demo.mf.gov.pl/api. Dział IT powinien przeprowadzić testy na środowisku DEMO przed uruchomieniem produkcyjnym.
• Konfiguracja firewall i proxy — systemy IT firmy muszą mieć otwarty ruch HTTPS (port 443) do domen *.mf.gov.pl. Firewalle korporacyjne często blokują nowe domeny — wymagane whitelistowanie.
• Tokeny sesji i uwierzytelnienie — każde połączenie z API KSeF wymaga najpierw inicjacji sesji przez podpis kwalifikowany lub token KSeF. ERP generuje żądanie, wysyła podpis, otrzymuje token sesji ważny przez określony czas.
• Obsługa kodów błędów i timeout — API KSeF zwraca różne kody błędów (plik niezgodny ze schematem, brak uprawnień, system niedostępny). Oprogramowanie musi prawidłowo obsługiwać błędy i nie duplikować faktur przy próbach ponowienia.
• Zarządzanie uprawnieniami w KSeF — system KSeF umożliwia nadawanie uprawnień do wysyłania i odbierania faktur dla konkretnych osób lub systemów IT (tokenów). Administrator IT zarządza tymi uprawnieniami przez panel MF lub API uprawnień.
• Testowanie end-to-end — przed wdrożeniem produkcyjnym konieczne jest przeprowadzenie testów wysyłki i odbioru faktur na środowisku testowym DEMO z udziałem użytkowników końcowych i działu finansów.

Checklist: 12 kroków do gotowości KSeF od strony IT

Poniższy checklist możesz przekazać swojemu działowi IT lub firmie IT obsługującej Twoją infrastrukturę. Każdy krok jest oznakowo wymagany lub zalecany.

1. Audyt oprogramowania — sprawdź wszystkie programy, w których wystawiasz faktury. Zidentyfikuj wersje i status integracji KSeF u producenta.
2. Zakup i instalacja podpisu kwalifikowanego — zamów certyfikat dla osób wystawiających faktury lub pieczęć elektroniczną dla firmy. Czas oczekiwania: 3–7 dni roboczych.
3. Aktualizacja ERP do wersji z obsługą KSeF — zaktualizuj oprogramowanie do najnowszej wersji. Uwaga: aktualizacja może wymagać kopii zapasowej bazy danych i okna serwisowego.
4. Konfiguracja modułu KSeF w ERP — wprowadź dane firmy (NIP, uprawnienia, certyfikat/token) w ustawieniach modułu KSeF. Postępuj zgodnie z dokumentacją producenta.
5. Whitelisting domen *.mf.gov.pl w firewall — poproś dział IT lub administratora sieci o odblokowanie ruchu HTTPS do serwerów MF. Przetestuj dostępność z sieci firmowej.
6. Rejestracja w systemie KSeF — zaloguj się do portalu KSeF z podpisem kwalifikowanym i ustanów pierwsze uprawnienia dla użytkowników i systemów ERP.
7. Generowanie tokena API dla systemu ERP — utwórz token w panelu KSeF dla systemu fakturowania. Przechowaj go bezpiecznie — ma uprawnienia do wystawiania faktur w imieniu firmy.
8. Testy na środowisku DEMO — wyślij co najmniej 5 faktur testowych na ksef-demo.mf.gov.pl. Sprawdź, czy faktury są poprawnie walidowane i czy system ERP odbiera numery KSeF.
9. Szkolenie pracowników działu finansów — przeprowadź szkolenie z nowego procesu wystawiania i odbioru faktur. Omów tryb awaryjny offline.
10. Aktualizacja procedur archiwizacji — ustal, czy firma prowadzi własną archiwizację faktur KSeF poza systemem MF (zalecane dla celów audytowych).
11. Konfiguracja monitoringu dostępności API KSeF — dodaj endpoint API KSeF do systemu monitoringu IT firmy. Alerty o niedostępności umożliwią szybkie przejście na tryb offline.
12. Test gotowości z datą uruchomienia — przeprowadź próbny start produkcyjny: wyślij pierwszą fakturę i odbierz potwierdzenie. Masz czas — nie czekaj na ostatni dzień.

Jak DSX.PL pomaga firmom przejść na KSeF

Nasze podejście do wdrożenia KSeF składa się z czterech etapów:

• Audyt gotowości (1–2 godziny) — sprawdzamy wersję ERP, stan certyfikatów, konfigurację sieci i uprawnienia użytkowników. Identyfikujemy luki i przygotowujemy plan działania z konkretnym harmonogramem.
• Wdrożenie techniczne (1–5 dni) — aktualizacja oprogramowania, instalacja certyfikatów, konfiguracja API, testy na środowisku DEMO. Pracujemy w oknie serwisowym, żeby nie przerywać pracy firmy.
• Szkolenie (2–4 godziny) — szkolenie dla działu finansów z nowego procesu fakturowania, trybu offline i archiwizacji. Przekazujemy dokumentację w przystępnym języku.
• Wsparcie powdrożeniowe (30 dni) — helpdesk dostępny na problemy związane z KSeF przez 30 dni od uruchomienia produkcyjnego. W razie problemów technicznych reagujemy zgodnie z SLA.

Podsumowanie

KSeF to nie jest kolejny biurokratyczny obowiązek, który można odłożyć na ostatnią chwilę. To fundamentalna zmiana w infrastrukturze IT każdej firmy wystawiającej faktury VAT. Wymaga aktualizacji oprogramowania, certyfikatów cyfrowych, konfiguracji API i przeszkolenia pracowników.

Im wcześniej zaczniesz — tym spokojniejszy będziesz. Skontaktuj się z nami, a pomożemy Ci przeprowadzić audyt gotowości i wdrożyć wszystkie niezbędne zmiany techniczne. Działamy w Szczecinie, Policach, Stargardzie, Bezrzeczu i całym regionie zachodniopomorskim.