Krótka odpowiedź: KSeF to centralna platforma Ministerstwa Finansów zbudowana wokół REST API: program podatnika wysyła fakturę XML (schema FA(3)), system waliduje ją względem XSD, nadaje numer KSeF-ID i udostępnia odbiorcy. Faktura jest prawnie wystawiona z chwilą przyjęcia przez system. Poniżej: warstwy architektury, uwierzytelnianie, sesje i tryby awaryjne.
Przepływ faktury przez system — krok po kroku
- Uwierzytelnienie — sesja interaktywna (podpis kwalifikowany, profil zaufany, pieczęć) albo token autoryzacyjny wygenerowany przez uprawnionego użytkownika (standard przy integracjach).
- Wysyłka XML — dokument zgodny ze schemą FA(3) trafia do API (żądania typu SendInvoice).
- Walidacja XSD — struktura, pola wymagane, spójność; błąd = odrzucenie (dokument nie istnieje prawnie).
- Nadanie KSeF-ID i UPO — numer identyfikacyjny + urzędowe poświadczenie; od tej chwili faktura jest wystawiona.
- Udostępnienie nabywcy — kontrahent pobiera dokument przez swoje oprogramowanie lub aplikację MF.
Kluczowe elementy architektury
REST API po HTTPS z komunikatami XML (m.in. SendInvoiceRequest, QueryInvoiceResponse), identyfikatory sesji i dzienniki operacji (każde żądanie jest logowane — ważne przy sporach o moment wystawienia), system uprawnień pozwalający delegować obsługę (np. biuru rachunkowemu lub programowi do fakturowania) bez przekazywania własnych danych logowania oraz środowiska: produkcyjne, demo i przedprodukcyjne do testów integracji — zobacz KSeF demo.
Tryby awaryjne
Architektura przewiduje pracę przy niedostępności systemu: tryb offline24 (wystawienie z kodem QR i dosłanie do KSeF w ciągu 1 dnia roboczego) oraz tryb awarii ogłaszanej przez MF (dłuższe terminy dosłania). Dla firmy oznacza to, że dobre oprogramowanie musi obsługiwać kolejkowanie i automatyczne dosyłanie dokumentów.
Techniczne szczegóły bierze na siebie program
Sesje, tokeny, walidacja XSD i tryby offline to problem dostawcy oprogramowania, nie Twój — w Mizzox cała ta warstwa działa pod maską: Ty wypełniasz formularz, resztą zajmuje się integracja (za darmo).
Architektura KSeF pod maską — Ty tylko wystawiasz
Bez karty • Plan darmowy na zawsze • 16 500+ firm
Szerzej w przewodniku: wszystko o KSeF w jednym miejscu.
W praktyce: jak Mizzox obsługuje KSeF.
FAQ
Czym jest API KSeF?
Interfejsem REST, przez który oprogramowanie komunikuje się z systemem: uwierzytelnia sesję, wysyła faktury XML, pobiera dokumenty i UPO — po HTTPS, komunikatami XML.
Kiedy faktura jest formalnie wystawiona?
Z chwilą przyjęcia przez KSeF i nadania numeru KSeF-ID — nie w momencie kliknięcia „wyślij” w programie.
Co się dzieje, gdy KSeF nie działa?
Przewidziano tryby offline24 i awarii: fakturę wystawia się z kodem QR i dosyła do systemu w ustawowym terminie po przywróceniu dostępności.