Integracja własnego systemu z KSeF
Masz własną aplikację, panel klienta albo system sprzedaży i faktury z niego trzeba teraz wysyłać do KSeF. Po integracji faktura sama trafia do KSeF, dostaje numer i wraca do Twojej bazy, a Twój zespół nie musi uczyć się KSeF od zera.
Co będzie działać samo
- faktura wystawiona
- korekta lub zwrot
- dane nabywcy z NIP
- sprawdza NIP
- wystawia fakturę
- nie wysyła jej dwa razy
- pilnuje, żeby nic nie zginęło
- faktura w KSeF
- numer KSeF
- potwierdzenie odbioru
Twój system wystawia fakturę
Faktura idzie do KSeF bez udziału człowieka. Numer KSeF, data przyjęcia i potwierdzenie odbioru wracają do Twojego systemu, więc obsługa i klient widzą je tam, gdzie zawsze.
Zwrot, rabat lub zmiana danych
Korekta powstaje w Twoim systemie jak dotąd, a do KSeF trafia faktura korygująca z numerem KSeF faktury pierwotnej. Nikt nie przepisuje jej ręcznie w aplikacji Ministerstwa.
Coś poszło nie tak
Błąd w danych albo odrzucenie przez KSeF zatrzymuje fakturę i trafia do wskazanej osoby z opisem, co poprawić. Gdy KSeF nie odpowiada, faktura czeka i sama wysyła się ponownie.
Jak wygląda wdrożenie
- 1Rozmowa, 30 minut. Jak dziś powstają faktury w Twoim systemie, kto jest nabywcą (firmy z Polski, z UE, konsumenci), ile faktur miesięcznie i kto po Twojej stronie opiekuje się kodem.
- 2Ustalenia i środowisko testowe KSeF. Ustalamy, skąd integracja bierze faktury i gdzie oddaje numer KSeF. Pierwsze faktury idą na środowisko testowe Ministerstwa Finansów, nie do urzędu. Sprawdzasz je na spokojnie.
- 3Odbiór z księgową. Razem przechodzimy stawki VAT, waluty, korekty, faktury dla firm z UE i przypadki brzegowe z Twojej sprzedaży.
- 4Produkcja i opieka. Przełączenie na produkcyjny KSeF, alert e-mail, gdy faktura utknie, poprawki w cenie przez 30 dni.
Gotowa aplikacja czy integracja?
Jeśli faktury i tak wystawiasz w programie do faktur (Fakturownia, inFakt, wFirma), zwykle prościej połączyć z nim Twój system, a program wyśle fakturę do KSeF. Ministerstwo udostępnia też dokumentację API i darmowe biblioteki, więc zespół z czasem może zrobić to sam. Gotowa integracja z odpowiedzialnością za wynik ma sens, gdy
- Twój system sam numeruje faktury i nie chcesz tego oddawać zewnętrznemu programowi
- zespół jest zajęty produktem, a KSeF to dla niego kilka tygodni nauki przepisów i API
- wystawiasz faktury za wielu klientów lub z kilku firm (kilka NIP-ów)
- potrzebujesz korekt, walut, trybu offline i faktur dla firm z UE, a nie tylko prostej wysyłki
- numer KSeF ma wrócić do Twojej bazy i do panelu klienta
Nie wiesz, czy gotowa aplikacja Ci wystarczy? Audyt KSeF od 900 zł netto: sprawdzę ją i skonfiguruję z Tobą (do 2 godzin w cenie), a jeśli potrzebna będzie integracja, koszt audytu odliczę.
- kilka firm (NIP-ów) w jednym systemie
- duży wolumen i wysyłka sesją wsadową
- tryb offline z certyfikatem KSeF i drugim kodem QR
Wycena stałą kwotą w ciągu 2 dni roboczych, bezpłatnie. Płatność: 50% na start, 50% po odbiorze.
Dla 5 pierwszych firm 30% taniej. W zamian zgadzasz się, żebym pokazał to wdrożenie jako przykład na swojej stronie (bez poufnych danych), i wystawiasz opinię w Google.
Zajmij miejsce →Pytania
Brakuje Twojego? Napisz je w formularzu, odpowiem konkretnie.
Od kiedy KSeF jest obowiązkowy dla mojej firmy?
Odbieranie faktur przez KSeF jest obowiązkowe dla wszystkich firm od 1 lutego 2026. Wystawianie: firmy ze sprzedażą powyżej 200 mln zł brutto w 2024 roku od 1 lutego 2026, pozostałe od 1 kwietnia 2026. Do końca 2026 roku poza KSeF mogą zostać faktury, jeśli sprzedaż udokumentowana fakturami (bez faktur dla konsumentów) nie przekracza 10 tys. zł brutto w miesiącu. Wyjątek przestaje działać od faktury, która ten próg przekracza, i nie wraca w kolejnych miesiącach, a od 1 stycznia 2027 znika całkiem. Kary za błędy według obecnej ustawy obowiązują od 1 stycznia 2027. Ministerstwo Finansów zapowiedziało 16 września 2026 ich przesunięcie do końca 2027 roku, ale wymaga to zmiany ustawy, więc na razie to zapowiedź. Sam obowiązek korzystania z KSeF nie jest odroczony.
Czy muszę zmieniać sposób, w jaki mój system wystawia faktury?
Zwykle nie. Integracja bierze fakturę, którą Twój system już tworzy, i przerabia ją na format wymagany przez KSeF. Po Twojej stronie potrzebne jest tylko miejsce, skąd da się ją pobrać, i miejsce, gdzie zapisze się numer KSeF. Jeśli czegoś brakuje w danych, na przykład NIP-u nabywcy, pokazuję to na etapie ustaleń.
Gdzie działa integracja?
Tam, gdzie Ci wygodniej, na przykład na Twoim serwerze lub w Twojej chmurze, obok systemu, który wystawia faktury. Ustalamy to przed startem. Za to, żeby działała zgodnie z ustaleniami, odpowiadam ja, także przez 30 dni opieki po starcie.
Co z fakturami dla osób prywatnych i firm z zagranicy?
Faktury dla osób fizycznych nieprowadzących działalności nie muszą trafiać do KSeF, można je wysyłać dobrowolnie. Faktury dla firm idą do KSeF, także dla nabywców z UE. Zagraniczny klient dostaje fakturę poza KSeF, jako PDF z kodem QR. Szczegóły ustalamy z Twoją księgową.
Co się dzieje, gdy KSeF nie działa?
Faktura nie ginie. Przy chwilowym błędzie integracja ponawia wysyłkę. Jeśli klient musi dostać fakturę od razu, powstaje ona w trybie offline z dwoma kodami QR i jest dosyłana do KSeF w ustawowym terminie: do następnego dnia roboczego w trybie offline24 i po ogłoszonej niedostępności KSeF, do 7 dni roboczych po ogłoszonej awarii. Integracja pilnuje terminu sama. Do trybu offline potrzebny jest certyfikat KSeF typu offline, którym podpisuje się drugi kod QR. Generujesz go w swoim KSeF, a ja pomagam to zrobić.
Czy dostęp do KSeF zostaje po mojej stronie?
Tak. Dostęp generujesz sam w swoim KSeF, tylko z prawem do wystawiania faktur, i możesz go w każdej chwili odebrać. Dane logowania trzymasz u siebie, a nie u zewnętrznego pośrednika.
Dla działu IT
Szczegóły techniczne dla osoby, która będzie odbierać wdrożenie.
Skąd integracja bierze faktury
Punkt startu dobieramy do Twojej architektury, żeby nie przebudowywać tego, co działa. Najczęściej to jedno z trzech:
- webhook lub zdarzenie w kolejce (na przykład RabbitMQ, SQS, Pub/Sub), które Twój system wysyła po wystawieniu faktury;
- endpoint REST integracji, który Twój backend wywołuje z danymi faktury;
- odczyt z bazy (tabela faktur albo widok), gdy nie chcesz ruszać kodu aplikacji, z zapisem statusu do osobnej tabeli.
Integracja buduje z tych danych dokument w strukturze logicznej FA(3), która od 1 lutego 2026 jest jedyną strukturą dla faktur ustrukturyzowanych. Pozycje, stawki VAT, rabaty, waluta i dane nabywcy przechodzą na fakturę jako osobne pola, a przed wysyłką dokument jest walidowany względem schemy XSD, żeby błąd wyszedł u nas, a nie w KSeF. NIP nabywcy sprawdzamy w wykazie podatników VAT (Biała lista) dla firm z Polski i w VIES dla firm z UE.
Wysyłka do KSeF i co wraca
Integracja korzysta z API KSeF 2.0 według oficjalnej dokumentacji Ministerstwa Finansów. Przy małym wolumenie faktury idą w sesji interaktywnej, przy większym są zbierane i wysyłane sesją wsadową. Po przyjęciu KSeF nadaje fakturze numer KSeF, a integracja zapisuje go w Twojej bazie razem z datą przyjęcia i UPO, czyli urzędowym poświadczeniem odbioru. Ten sam status możesz pokazać w panelu klienta albo pobrać przez API integracji.
Każda faktura przechodzi przez kolejkę z ponowieniami, a identyfikator faktury z Twojego systemu jest kluczem idempotencji. Numer faktury musi być stabilny przy ponowieniach, więc ponowna próba nie tworzy drugiej faktury w KSeF. Odrzucenie przez KSeF (na przykład niezgodność ze schemą) nie jest ponawiane w nieskończoność, tylko trafia do wskazanej osoby z opisem błędu.
Uwierzytelnienie i środowiska
Do KSeF integracja loguje się tokenem KSeF albo certyfikatem KSeF, wygenerowanym w Twoim KSeF z uprawnieniem tylko do wystawiania faktur. Ministerstwo zdecydowało, że tokeny zostają w KSeF 2.0 bezterminowo, więc wybór zależy od Twojej polityki bezpieczeństwa. Do trybów offline potrzebny jest osobny certyfikat KSeF typu 2, bo nim podpisuje się drugi kod QR na fakturze.
Pracuję na trzech środowiskach Ministerstwa: testowym (dane fikcyjne, bez skutków prawnych), przedprodukcyjnym Demo (prawdziwe metody logowania, bez skutków prawnych) i produkcyjnym. Poświadczenia z produkcji nie działają na Demo i odwrotnie, więc każde środowisko ma w konfiguracji osobny zestaw.
Korekty i tryby offline
Faktura korygująca wskazuje numer KSeF faktury pierwotnej. Korektę do faktury wystawionej offline można wysłać dopiero, gdy faktura pierwotna ma już numer KSeF, dlatego kolejka zna zależność korekty od dokumentu źródłowego i nie wysyła ich w przypadkowej kolejności.
Tryby offline24, niedostępności KSeF i awaryjny to technicznie ta sama ścieżka z innymi terminami dosłania: odpowiednio następny dzień roboczy po wystawieniu, następny dzień roboczy po zakończeniu niedostępności i 7 dni roboczych od zakończenia awarii. Integracja oznacza taką fakturę dwoma kodami QR, pilnuje terminu i dosyła ją sama.