Obieg dokumentów

Integracja z KSeF dla firm z własnym systemem: wystawianie, pobieranie, obieg

Firmy sprzedające z własnej aplikacji lub programu bez modułu KSeF często przepisują faktury ręcznie do Aplikacji Podatnika. Integracja przez API KSeF 2.0 (API to interfejs, przez który programy wymieniają dane) pozwala wystawiać faktury prosto z systemu, w którym powstaje zamówienie, i automatycznie pobierać faktury kosztowe. Typowa integracja trwa 7 dni, a jej zakres ustala audyt gotowości.

  • od 3 999 zł netto— połączenie systemu firmy z KSeF
  • 7 dniod audytu do produkcji
  • 499 zł nettoza audyt gotowości KSeF, odliczane od ceny integracji
Schemat integracji własnego systemu zamówień z KSeF 2.0 przez API: wystawianie faktur, pobieranie faktur kosztowych, UPO i przekazanie danych do programu księgowego biura

Kiedy gotowy moduł KSeF nie wystarcza

  • Faktury powstają we własnej aplikacji zamówień lub w sklepie, a program księgowy jest po stronie zewnętrznego biura.
  • Dostawca systemu nie planuje aktualizacji pod KSeF 2.0 albo nie ma już kogo zapytać o kod.
  • Pracownik kopiuje dane do Aplikacji Podatnika KSeF, a numer KSeF wpisuje z powrotem ręcznie.
  • Faktury kosztowe z KSeF pobiera tylko biuro rachunkowe, więc dział zakupów czeka na PDF.

Terminy KSeF i sankcje — stan na 27 października 2026

DataCo się zmienia
1 lutego 2026KSeF 2.0 jedynym systemem; obowiązek wystawiania dla firm ze sprzedażą powyżej 200 mln zł w 2024 r.; obowiązek odbierania faktur w KSeF dla wszystkich
1 kwietnia 2026obowiązek wystawiania dla pozostałych podatników
do 31 grudnia 2026poza KSeF mogą trafiać faktury z kas rejestrujących oraz faktury podatników, których miesięczna sprzedaż na takich fakturach nie przekracza 10 000 zł brutto
1 stycznia 2027obowiązek dla wszystkich, także najmniejszych podatników i faktur z kas
1 stycznia 2027 lub 2028początek kar — zależnie od losów projektu ustawy

Kara za fakturę wystawioną poza KSeF wbrew obowiązkowi może wynieść do 100% kwoty VAT z faktury, a przy fakturze bez VAT do 18,7% kwoty należności. Według obowiązujących przepisów kary dotyczą naruszeń od 1 stycznia 2027 r. Rada Ministrów przyjęła 20 października 2026 r. projekt przesuwający kary na koniec 2027 r., ale sam obowiązek się nie zmienia.

Tryb offline i awaria KSeF

Faktura może powstać bez połączenia z KSeF w trzech trybach: offline24 (wysyłka najpóźniej następnego dnia roboczego), offline przy ogłoszonej niedostępności systemu oraz awaryjny (7 dni roboczych od końca awarii). Faktura offline ma dwa kody QR, a drugi wymaga certyfikatu KSeF. Integracja kolejkuje takie faktury i wysyła je automatycznie.

Integracja KSeF krok po kroku

  1. Audyt gotowości — dzień 1. Przegląd systemu, w którym powstają faktury, uprawnień w KSeF, uwierzytelnienia i współpracy z biurem. Wynik: raport z listą zmian i decyzją, czy wystarczy moduł programu.
  2. Mapowanie na strukturę FA(3) — dzień 2. Pola faktury z systemu firmy są przypisane do e-faktury FA(3), z korektami, zaliczkami i walutami. Wynik: specyfikacja pól zatwierdzona przez księgowość.
  3. Budowa na środowisku testowym — dni 3–5. Uwierzytelnienie, wysyłka w sesji interaktywnej lub wsadowej, odbiór UPO (urzędowego poświadczenia odbioru), pobieranie faktur zakupowych i tryb offline. Wynik: faktury testowe przyjęte przez KSeF.
  4. Próba na środowisku przedprodukcyjnym — dzień 6. Prawdziwe dane uwierzytelniające, faktury bez skutków prawnych. Wynik: protokół testów i instrukcja dla pracowników.
  5. Start produkcyjny — dzień 7. Pierwsze faktury z systemu trafiają do KSeF, a numer KSeF wraca do zamówienia. Wynik: działająca integracja i 30 dni monitoringu odrzuceń.
Zamów audyt gotowości KSeF

499 zł netto, kwota wraca w rozliczeniu integracji

Przykładowy scenariusz: producent z własnym systemem zamówień

Przykładowy zakres, oparty na typowych pytaniach firm produkcyjnych.

Producent prowadzi sprzedaż hurtową w aplikacji webowej napisanej na zamówienie, która generuje faktury jako PDF; księgowość prowadzi zewnętrzne biuro w swoim programie. Po integracji faktura trafia do KSeF w chwili zatwierdzenia wysyłki, a numer KSeF i UPO zapisują się przy zamówieniu. Faktury kosztowe są pobierane codziennie do obiegu akceptacji, a biuro pobiera je z KSeF na podstawie uprawnienia nadanego przez producenta.

Co otrzymujesz w ramach integracji

  • moduł KSeF wbudowany w system firmy albo działający obok niego jako osobna usługa,
  • obsługę certyfikatów KSeF i tokenów z przypomnieniem o wygasaniu,
  • kolejkę faktur offline z automatyczną wysyłką,
  • dziennik każdej wysyłki z numerem KSeF i UPO,
  • pobieranie faktur zakupowych z przekazaniem do obiegu lub księgowości,
  • dokumentację i kod na własność Twojej firmy.

Cena integracji z KSeF

Integracja systemu z KSeF kosztuje od 3 999 zł netto, a audyt gotowości 499 zł netto (odliczany od ceny integracji). Na cenę wpływają:

  • dostęp do kodu i bazy systemu — integracja wewnątrz aplikacji jest tańsza niż osobna usługa odczytująca dane z bazy bez dokumentacji,
  • rodzaje faktur — korekty, zaliczki, faktury w walucie i samofakturowanie zwiększają mapowanie FA(3),
  • kierunek — sama wysyłka sprzedaży to mniej pracy niż wysyłka i pobieranie zakupów,
  • liczba podmiotów — kilka NIP-ów w jednym systemie oznacza osobne konteksty i uprawnienia.

KSeF w programie księgowym czy integracja przez API?

KryteriumModuł KSeF w programie księgowymIntegracja własnego systemu przez API KSeF
Miejsce wystawienia fakturyprogram księgowy lub fakturowysystem, w którym powstaje zamówienie
Dane z zamówieniaprzepisywane lub importowaneprzekazywane automatycznie
Aktualizacje przy zmianach APIpo stronie dostawcy programuw ramach utrzymania integracji
Kosztzwykle w abonamencie programujednorazowa integracja i opcjonalne utrzymanie
Najlepszy wybór, gdyfaktury powstają w programie księgowymfaktury powstają we własnym lub nietypowym systemie

Pytania o integrację z KSeF

Czy własny system fakturowania można połączyć z KSeF?

Tak. API KSeF 2.0 jest publiczne, a Ministerstwo Finansów udostępnia dokumentację, środowisko testowe i przedprodukcyjne oraz biblioteki w Javie i C#. Integracja działa niezależnie od języka, w którym napisano system firmy.

Jak działa uwierzytelnienie w API KSeF 2.0?

System pobiera z KSeF jednorazowe wyzwanie i odpowiada na nie podpisem kwalifikowanym lub pieczęcią w formacie XAdES albo zaszyfrowanym tokenem KSeF. W zamian otrzymuje krótkotrwały token dostępowy i token odświeżający. Certyfikat KSeF działa jak podpis i jest ważny maksymalnie 2 lata.

Czy KSeF zastępuje obieg dokumentów w firmie?

Nie. KSeF przechowuje faktury, ale nie wskazuje, kto zatwierdza koszt, nie łączy faktury z zamówieniem i nie obejmuje umów ani faktur zagranicznych. Te zadania przejmuje firmowy obieg dokumentów zasilany fakturami z KSeF.

Jak biuro rachunkowe pobiera faktury firmy z KSeF?

Na podstawie uprawnienia nadanego przez firmę w KSeF. Uprawnienie można nadać całemu biuru, które przekazuje je swoim pracownikom. Własny system firmy i program biura pobierają wtedy te same faktury niezależnie. Szczegóły: automatyzacja biura rachunkowego.

Od kiedy obowiązują kary za niestosowanie KSeF?

Według obowiązujących przepisów od 1 stycznia 2027 r. Projekt ustawy przyjęty przez Radę Ministrów 20 października 2026 r. przesuwa kary o rok, do końca 2027 r., i jest w trakcie prac w parlamencie.

Kacper Matelski, założyciel nodif

Kacper Matelski — Software Engineer z ponad 6 letnim doświadczeniem w budowaniu systemów dla OZE, e-commerce, produkcji, lotnictwa i B2B. Od projektowania aż do finalnego wdrożenia i utrzymania. Współzałożyciel produktu SaaS dla firm produkcyjnych.

nodif na LinkedIn

KSeF w systemie, w którym powstaje sprzedaż

Audyt gotowości wskazuje, czy wystarczy moduł programu, czy potrzebna jest integracja, i ile będzie kosztowała.

Kontakt

Porozmawiajmy o Twojej firmie.

Bezpłatna konsultacja trwa godzinę. Jej wynikiem jest wskazanie procesu, który zwróci się najszybciej, oraz stała cena przed startem.

E-mail
kacper@nodif.dev