Table of Contents

Krajowy System e-Faktur 2.0

Na początku lipca 2025 na stronach Ministerstwa Finansów pojawiły się nowe informacje dotyczące Krajowego Systemu e-Faktur w wersji 2.0. Nowa podstrona zawiera informacje dotyczące planowanych zmian w KSeF, dokumentację techniczną dla integratorów, link do struktury logicznej FA(3) jak i zestaw plików do pobrania w kontekście KSeF 2.0. Szczególnie istotne materiały znajdują się w repozytorium z dokumentacją będącą kompendium wiedzy dla deweloperów, analityków i integratorów systemów, którzy realizuja integrację z Krajowym Systemem e-Faktur (KSeF) w wersji 2.0.

Przewodnik dla Integratorów

W kontekście dynamicznych zmian w dokumentacji, które znacząco wpływają na kształt implementowanego rozwiązania w ramach [!include[polish-localization-md](includes/polish-localization-md.md)] wskazane jest monitorowanie repozytorium na bieżąco.

Jeden z rozdziałów jest poświęcony kluczowym zmianom w API 2.0 dla Krajowego Systemu e-Faktur:

KSeF API 2.0 - Przegląd kluczowych zmian

W związku z wprowadzonymi zmianami w interfejsie API 2.0 dla KSeF planowane są następujące zmiany w aplikacji Polish Localization:

  • nowy model uwierzytelniania oparty o JWT (Json Web Token) - komunikacja z KSeF 2.0 będzie zawierała obsługę JWT do inicjowania sesji interaktywnej jak i wsadowej. Zakładamy, że do każdej sesji będzie generowany nowy JWT.
  • wszystkie faktury lub paczki faktur wysyłane do KSeF będą szyfrowane lokalnie za pomocą klucza AES, który jest generowany indywidualnie dla każdej sesji.
  • zgodnie z wymaganiami wersji 2.0 obsłużona zostanie nowa para kluczy RSA o długości 4096 bit oraz padding OAEP z SHA-256 i MGF1-SHA256.
  • w ramach wersji KSeF API 2.0 wprowadzono nowy moduł do zarządzania Certyfikatami KSeF. Certyfikaty bedą umożliwiały uwierzytelnienie w KSeF oraz są niezbędne do wystawienia faktury w trybie offline. W ramach funkcjonalności Polish Localization nie jest przewidziany proces wygenerowania Certyfikatu KSeF poprzez komunikację API z MCU (Moduł Certyfikatów i Uprawnień). Zakładamy wygenerowanie Certyfikatu KSeF w MCU oraz pobranie go w celu dalszego użycia w ramach funkcjonalności integracji z KSeF do następujących operacji:
    • nawiązywanie sesji podpisywanych Certyfikatem KSeF;
    • generowanie QR kod na fakturach Offline;
  • obsługa wysyłki wsadowej, czyli w jednej sesji wysyłka wielu faktur w postaci przygotowanego archiwum ZIP podzielonego zgodnie ze specyfikacją.
  • wprowadzenie zapisów logu komunikacji z KSeF dla każdej sesji.
  • wprowadzenie dodatkowych zabezpieczeń dotyczących poprawności generowanej faktury: weryfikacja duplikatów, unikalność faktury, walidacja daty w polu P_1, maksymalny rozmiar pliku, ograniczenia dotyczące załączników. Niezmieniony w stosunku do KSeF 1.0 pozostaje mechanizm weryfikacji zgodności faktury ze strukturą logiczną obowiązującą w danym okresie.
  • zarządzanie uprawnieniami w KSeF będzie realizowane poza systemem Dynamics 365 Business Central i powinno być możliwe w MCU lub w Aplikacji Podatnika KSeF.