Już w 2026 roku KSeF 2.0 stanie się obowiązkowy dla wszystkich podatników VAT. Ministerstwo Finansów opublikowało nową dokumentację API oraz strukturę FA(3), które zastąpią dotychczasowe rozwiązania KSeF 1.0. Co dokładnie się zmienia? Poniżej prezentujemy zestawienie najważniejszych różnic między wersją 1.0 a 2.0 oraz praktyczne wskazówki, jak przygotować swoją firmę do migracji.
Dlaczego wprowadzono KSeF 2.0?
Pierwsza wersja KSeF (1.0) została uruchomiona jako system fakultatywny. Umożliwiała przedsiębiorcom dobrowolne testowanie faktur ustrukturyzowanych, ale miała swoje ograniczenia – zarówno w obszarze technicznym (np. sesje SOAP, brak wsparcia dla załączników), jak i w samej strukturze logicznej faktury (FA(2)).
Od lutego 2026 roku startuje KSeF 2.0 – nowa, obowiązkowa wersja systemu, oparta na strukturze FA(3) i zupełnie nowej specyfikacji API. Dla firm oznacza to konieczność dostosowania oprogramowania księgowego i integracyjnego do nowych standardów.
| Obszar / element | KSeF 1.0 | KSeF 2.0 (zmiany / nowości) | Uwagi / implikacje |
|---|---|---|---|
| Struktura logiczna faktury (XML schema) | FA(2) — wersja obowiązująca w fakultatywnym KSeF | FA(3) — nowa, rozszerzona struktura logiczna faktury, która od 2026 r. zastąpi FA(2) | Konieczna rewizja generowania XML w systemach klientów, dodatkowe pola, walidacje |
| Formaty komunikacji (wejście/wyjście) | XML zgodne z XSD, obsługa XAdES dla podpisów; JSON w ograniczonym zakresie | XML + JSON (pełniejsze wsparcie), struktury REST API opisane w OpenAPI, binarne przesyłanie załączników | Systemy muszą wspierać JSON + XML i poprawnie mapować między strukturami |
| Interfejs / protokół komunikacji | SOAP / RPC, wymiana komunikatów XML, sesje interaktywne | API REST zgodne ze specyfikacją OpenAPI; metody HTTP (GET, POST, PUT, DELETE), bezstanowe wywołania | Konieczność zmiany klienta komunikacyjnego, dostosowania do wzorca REST |
| Operacje / endpointy / metody | Inicjalizacja paczki, sesja interaktywna, wysyłka faktury, pobranie UPO, pobieranie faktur, walidacja | Podobny zestaw, ale dodatkowo: obsługa załączników, tryb offline24, zarządzanie certyfikatami i uprawnieniami (MCU), granularne błędy | Trzeba zaktualizować ścieżki i nazwy metod, obsługę błędów |
| Obsługa błędów / walidacja | Błędy odrzucały całą paczkę | Błędy granularne – na poziomie pojedynczych dokumentów, lepsza diagnostyka | Ułatwia obsługę błędów, większa tolerancja na częściowe problemy |
| Załączniki do faktury | Brak lub bardzo ograniczone | Wsparcie dla załączników (węzeł Załącznik w FA(3)), możliwość dodania plików binarnych, limity rozmiaru | Trzeba obsłużyć upload i powiązanie załączników |
| Tryb offline / awaryjny | Brak lub ograniczony | Tryb „offline24” – wystawianie e-faktur mimo braku dostępu do KSeF i późniejsza synchronizacja | Konieczne buforowanie lokalne i synchronizacja |
| Uwierzytelnianie / autoryzacja / certyfikaty | Sesje uwierzytelniające, podpisy XAdES, prosty model uprawnień | Moduł Certyfikatów i Uprawnień (MCU), tokeny JWT, szczegółowy model ról i delegacji | System musi obsługiwać certyfikaty, ich rotację i zarządzanie uprawnieniami |
| Migracja danych / zgodność | Brak konieczności migracji | Migracja faktur i uprawnień właścicielskich z 1.0 do 2.0 | Wymagane przygotowanie systemów do importu starych danych |
| Dokumentacja / narzędzia wspierające | Dokumentacja PDF, XSD, statyczne opisy | OpenAPI, interaktywny portal, przykładowe SDK (Java, .NET) | Łatwiejsza integracja, możliwość generowania klienta |
| Terminy przejścia / obowiązkowość | System dobrowolny, działał testowo | Od lutego 2026 r. – obowiązkowy dla podatników etapami | Pilna konieczność migracji i testów integracyjnych |
Co to oznacza w praktyce?
- Dla przedsiębiorców – konieczność korzystania z oprogramowania, które obsługuje FA(3) i nowe API KSeF.
- Dla księgowych – większe bezpieczeństwo danych i łatwiejsza obsługa faktur, ale też konieczność zapoznania się z nową strukturą i rolami w systemie.
- Dla integratorów IT – duża zmiana technologiczna: REST, JSON, OpenAPI, obsługa tokenów JWT i MCU.
KSeF w Fakturowo.pl – obecnie i w przyszłości
Nasz system na chwilę obecną (jako jeden z niewielu programów) jest w pełni zintegrowany z obowiązującym systemem KSeF 1.0 oraz ze strukturą FA(2). Instrukcja korzystania dostępna jest tutaj:
Nasz system już wkrótce będzie również zintegrowany z nowym KSeF 2.0 zgodnie z obowiązującymi terminami. Obecnie prowadzimy prace nad obsługą struktury FA(3) i API KSeF 2.0, tak aby użytkownicy mogli rozpocząć testy w środowisku DEMO od listopada 2025 r.
Faktury FA(3) będą wystawiane bezpośrednio z programu i przesyłane do KSeF przez API. Możliwe będzie także pobieranie faktur kosztowych z KSeF, a użytkownicy otrzymają podgląd faktury wraz z numerem KSeF.
Integracja z KSeF i wsparcie użytkowników są dostępne w ramach obecnego abonamentu – nie przewidujemy żadnych dodatkowych opłat za samą wysyłkę faktur.
Więcej pytań i odpowiedzi znajdziecie Państwo tutaj:
- https://www.fakturowo.pl/pomoc/ksef-juz-dostepny-w-fakturowo-pl
- https://www.fakturowo.pl/pomoc/struktura-e-faktury
- https://www.fakturowo.pl/blog/ksef-w-fakturowo-pl-faq
- https://www.fakturowo.pl/blog/ksef
Podsumowanie
KSeF 2.0 to całkowicie nowa specyfikacja, która zmieni sposób wystawiania i przesyłania faktur w Polsce. Różnice względem KSeF 1.0 są znaczące – od struktury faktury, przez tryb offline24, po nowe mechanizmy autoryzacji.
Dzięki Fakturowo.pl przedsiębiorcy mogą już dziś korzystać z KSeF 1.0 i przygotować się bez stresu na migrację do KSeF 2.0.
