Wsparcie dla integratorów


Krajowy System e-Faktur - środowisko integracyjne oraz dokumentacja dla API KSeF 2.0

30.09.2025

Środowisko integracyjne API KSeF 2.0

Udostępniamy środowisko integracyjne interfejsu programistycznego API KSeF 2.0.

Zachęcamy już dziś do prowadzenia testów integracyjnych.

Przejdź do środowiska integracyjnego API KSeF 2.0 

W ramach środowiska integracyjnego należy używać zanonimizowanych danych.
Faktury wystawione w środowisku integracyjnym nie będą wywierały żadnych skutków prawnych i po określonym czasie zostaną usunięte z systemu.

Struktura logiczna FA(3)

Zapoznaj się ze strukturą logiczną FA(3)

Kontakt

Masz pytanie? Skontaktuj się z nami

Dokumentacja API KSeF 2.0

Dokumentację API KSeF 2.0 przedstawiliśmy 30 czerwca 2025 r. Umożliwiło to integratorom rozpoczęcie przygotowań do wdrożenia systemu na środowisku integracyjnym.

Rodzaj dokumentacji

Opis

Lokalizacja

Plik kontraktu openapi.json

Specyfikacja API w formacie OpenAPI 3.0.4 (JSON), stanowiąca jednoznaczny kontrakt, zrozumiała dla programistów i w pełni obsługiwana przez narzędzia do dokumentowania, testowania oraz automatycznego generowania kodu.

Dokumentacja on-line

Interaktywna dokumentacja wygenerowana z kontraktu OpenAPI – prezentuje wszystkie endpointy, parametry, schematy danych, kody odpowiedzi oraz przykłady wywołań.

KSeF 2.0 przewodnik dla integratorów (dokumentacja rozszerzona)

Zawiera zestawy scenariuszy użycia API, np. uwierzytelnienie, wysyłka faktur w sesji interaktywnej lub batchowej, pobranie UPO. Każdy scenariusz opisuje pełen ciąg kroków, wskazuje właściwe endpointy oraz pokazuje wywołania i odpowiedzi w C# i Java.

Przegląd kluczowych zmian w API KSeF 2.0

Omówienie najważniejszych usprawnień wprowadzonych w API KSeF 2.0

Biblioteka .NET

Implementacja klienta KSeF 2.0, aplikacja demonstracyjna oraz implementacja scenariuszy użycia w .NET

Biblioteka Java

Analogiczny klient i przykłady integracji w Javie.

W przypadku pytań lub wątpliwości w zakresie udostępnionego środowiska integracyjnego API KSeF 2.0 oraz dokumentacji API KSeF 2.0 prosimy o kontakt za pośrednictwem formularza zgłoszeniowego udostępnionego w zakładce Kontakt - Napisz do nas.

podatki.gov.pl
Serwis Ministerstwa Finansów

Opublikowano: 30.06.2025

Zmodyfikowano: 30.09.2025

Opracowanie: Redakcja Portalu Podatkowego

02 Kreska Podstawowy Kolor Czerwone Tlo
podatki.gov.plSkontaktuj się z nami
KPO Barwy RP Nextgenerationeu Poziom Zestawienie Podstawowe RGB Pasek1h