Jak zintegrować system przez API
Integracja przez API (Application Programming Interface) pozwala na pełną automatyzację procesów. Od 1 lutego 2026 r. jedynym obowiązującym formatem będzie struktura FA(3), która wprowadza m.in. obsługę załączników oraz nową rolę 'Pracownik'. Struktura FA(2) obowiązuje tylko do 31 stycznia 2026 r.
Kroki do wykonania
1. Analiza dokumentacji technicznej
Pobierz aktualną specyfikację API ze stron rządowych (Swagger/OpenAPI). Dokumentacja opisuje wszystkie endpointy, formaty żądań i odpowiedzi dla KSeF 2.0.
2. Przygotowanie generatora XML w formacie FA(3)
Twój system musi generować pliki XML ściśle według schemy FA(3) – każda pomyłka w polu spowoduje odrzucenie faktury przez system KSeF. FA(3) wprowadza nowe pola i obsługę załączników.
3. Obsługa sesji wsadowych i interaktywnych
Zaimplementuj mechanizmy otwierania sesji, przesyłania paczek faktur oraz sprawdzania ich statusu przetwarzania.
4. Pobieranie i archiwizacja UPO
Zaprogramuj system tak, aby automatycznie pobierał Urzędowe Poświadczenie Odbioru dla każdej wysłanej faktury i archiwizował je.
5. Testy na środowisku Demo KSeF 2.0
Przed wdrożeniem produkcyjnym wykonaj kompleksowe testy na środowisku Demo (https://ksef-demo.mf.gov.pl) w wersji KSeF 2.0, która obsługuje nową strukturę FA(3).