Wszystkie aktualności

**Wykaz wykorzystywanych ciastek**
Nazwa ciastka	Dostawca / domena	Okres przechowywania	Opis ciastka
_nsid	serwer hostingowy / bieżąca domena	1 dzień	Ciastko generowane przez mechanizm CMS na potrzeby obsługi mechanizmu zabezpieczania przed wywołaniami strony przez np. boty rozsyłające spam.
_cp	serwer hostingowy / bieżąca domena	365 dni	Ciastko zapisywane przez mechanizm CMS na potrzeby obsługi wyrażanych zgód przez użytkownika.
PHPSESSID	serwer hostingowy / bieżąca domena	sesja	Ciastko generowane przez aplikacje oparte na języku PHP (identyfikator ogólnego przeznaczenia używany do obsługi zmiennych sesji użytkownika). Zwykle wartość to liczba generowana losowo, sposób jej użycia może być specyficzny dla witryny, ale dobrym przykładem jest utrzymywanie statusu zalogowanego użytkownika między stronami.
fontsize	serwer hostingowy / bieżąca domena	30 dni	Ciastko generowane przez mechanizm CMS na potrzeby obsługi wielkości wyświetlanej czcionki.
jezyk_www	serwer hostingowy / bieżąca domena	sesja	Ciastko generowane przez mechanizm CMS na potrzeby obsługi wersji językowej strony.
licznikX	serwer hostingowy / bieżąca domena	sesja	Ciastko generowane przez mechanizm CMS na potrzeby obsługi podstawowych statystyk odwiedzin strony (zapis X przyjmuje postać liczby).
licznik[X]	serwer hostingowy / bieżąca domena	15 minut	Ciastko generowane przez mechanizm CMS na potrzeby obsługi podstawowych statystyk odwiedzin strony (zapis X przyjmuje postać liczby).
wersja_gui	serwer hostingowy / bieżąca domena	sesja	Ciastko generowane przez mechanizm CMS na potrzeby obsługi wybranej wizualizacji strony.
bnr[X]	serwer hostingowy / bieżąca domena	od 1 minuty	Ciastko generowane przez mechanizm CMS na potrzeby obsługi wyświetlania banerów z ustawionym czasem karencji (zapis X przyjmuje postać liczby).

Schemat przedstawiający kluczowe terminy wdrożenia KSeF

Publikacja dokumentacji API KSeF 2.0 oraz struktury logicznej FA(3)

Ministerstwo Finansów udostępniło narzędzia do integracji systemów IT z KSeF 2.0.Dokumentacja API KSeF 2.0 pozwoli integratorom i firmom rozpocząć przygotowania do wdrożenia systemu w środowisku testowym.

Dokumentacja API KSeF 2.0
API (ang. Application Programming Interface) to zbiór szczegółowych zasad oraz specyfikacji technicznych, które określają sposób, w jaki Krajowy System e-Faktur (KSeF) wymienia dane i współdziała z zewnętrznymi systemami finansowo-księgowymi. Współpraca z KSeF 2.0 jest możliwa dla różnych programów do fakturowania, niezależnie od ich producenta. Aby użytkownik mógł wystawiać, przesyłać bądź odbierać faktury, niezbędne jest wcześniejsze zintegrowanie oprogramowania z KSeF 2.0 za pośrednictwem interfejsu API.

Opublikowana dokumentacja API zawiera:

dokumentację techniczną API opisaną w standardzie Open API, w formie interaktywnego portalu technicznego, który zawiera:
opisy metod,
struktury danych,
parametry i przykłady,
specyfikację (plik JSON OpenAPI), przeznaczoną do wykorzystania w narzędziach automatyzujących integrację (np. generatory kodu, walidatory kontraktów API).

Dodatkowo, w celu ułatwienia prac zespołom programistycznym resort finansów opublikował również:

biblioteki SDK stanowiące zbiór narzędzi i przykładów w dwóch językach programowania - Java i .Net,
podręcznik zawierający instrukcje wraz z fragmentami kodu, które ilustrują sposób korzystania z kluczowych endpointów systemu,
przegląd kluczowych zmian między KSeF API 2.0. a KSeF API 1.0 (system fakultatywny działający obecnie).

Pełna dokumentacja API znajduje się na: https://ksef.podatki.gov.pl/ksef-na-okres-obligatoryjny/wsparcie-dla-integratorow/

Struktura logiczna FA(3)
Ministerstwo Finansów opublikowało docelową wersję struktury logicznej e-Faktury – FA(3). Powstała ona w wyniku szerokich konsultacji z ekspertami podatkowymi, księgowymi, biegłymi rewidentami, a także z dostawcami oprogramowania do fakturowania oraz przyszłymi użytkownikami API KSeF 2.0 – w tym firmami, jednostkami samorządu terytorialnego i organizacjami pozarządowymi.

Wzór struktury logicznej FA(3) dostępny jest w Centralnym Repozytorium Wzorów Dokumentów Elektronicznych na ePUAP do których odnośniki znajdziemy na stronie: https://ksef.podatki.gov.pl/ksef-na-okres-obligatoryjny/struktura-logiczna-fa-3/

Wsparcie dla integratorów
W przypadku jakichkolwiek pytań, wątpliwości lub potrzeby uzyskania dodatkowych informacji dotyczących udostępnionej dokumentacji API KSeF 2.0, uprzejmie prosimy o kontakt za pośrednictwem formularza zgłoszeniowego: https://ksef.podatki.gov.pl/formularz/

Wypełniając formularz zgłoszeniowy użyj następującej ścieżki kontaktu:

Rola, którą pełnisz: Integrator/ Rodzaj zgłoszenia: Techniczne/ Typ zgłoszenia: Prośba o informacje/ Aplikacja, której dotyczy zgłoszenie: API KSeF/ Środowisko, którego dotyczy zgłoszenie: Testowe/ Podkategoria zgłoszenia: Inne kwestie techniczne.

Harmonogram wdrożenia KSeF
30 września 2025 r. zostanie udostępnione środowisko testowe API KSeF 2.0, które umożliwi dostawcom oprogramowania oraz przedsiębiorstwom przeprowadzenie testów. Na listopad 2025 r. planowane jest uruchomienie testowej wersji przeglądarkowej Aplikacji Podatnika KSeF, która pozwoli użytkownikom testować najważniejsze funkcjonalności systemu KSeF.

Od 1 lutego 2026 r. KSeF 2.0 zostanie udostępniony w wersji obowiązkowej dla wszystkich użytkowników. Tego samego dnia struktura logiczna FA(3) zastąpi obecnie obowiązującą strukturę logiczną FA(2).