KSeF w dedykowanej aplikacji: co musi umieć system, który wystawia faktury

Coraz więcej firm nie wystawia faktur w osobnym programie księgowym. Robi to ich własna aplikacja: system zamówień, który po sprzedaży od razu wystawia fakturę, portal klienta z zakładką „dokumenty”, magazyn, który fakturuje wydania towaru. Jeśli tak działa Twoja firma, albo dopiero planujesz taki system, to Krajowy System e-Faktur (KSeF) dotyczy Cię bardziej bezpośrednio niż firmy, która klika faktury ręcznie w cudzym programie.

Dobra wiadomość na start: KSeF nie zmienia tego, co sprzedajesz ani jak liczysz cenę. Zmienia drogę, którą faktura pokonuje. Zamiast PDF-a w mailu powstaje ustrukturyzowany plik wysyłany do jednego, centralnego systemu Ministerstwa Finansów. Twoja aplikacja musi się nauczyć tej nowej drogi. Nic ponadto.

Ten wpis to prosta lista: czym jest KSeF w dwóch zdaniach, co (z grubsza) mówi harmonogram i, co najważniejsze, co konkretnie musi umieć system wystawiający faktury, żeby być zgodny. Bez straszenia i bez żargonu. Na końcu pokazujemy, ile taka integracja waży w godzinach, bo u nas wszystko liczy się w godzinach.

Czym jest KSeF, w dwóch zdaniach

KSeF, czyli Krajowy System e-Faktur, to prowadzona przez Ministerstwo Finansów centralna platforma, przez którą przechodzą faktury. Zamiast wysyłać klientowi PDF, Twój system tworzy fakturę jako ustrukturyzowany plik (w formacie XML, według urzędowego wzoru zwanego FA(3)) i przekazuje ją przez API KSeF (tak zwane „KSeF 2.0”); system nadaje jej własny numer KSeF i to on jest urzędowym dowodem, że faktura istnieje.

Dla właściciela firmy najważniejsze są dwie konsekwencje. Po pierwsze, faktura to teraz nie ładny dokument do wydruku, tylko dane w ściśle określonym układzie: nazwa pola, format daty, sposób zapisu stawki VAT muszą być dokładnie takie, jakich oczekuje wzór. Po drugie, faktura „istnieje” dopiero wtedy, gdy KSeF ją przyjmie i odeśle potwierdzenie. To potwierdzenie, UPO, czyli urzędowe poświadczenie odbioru, jest Twoim dowodem, że dokument został prawidłowo wystawiony.

Harmonogram: co wiadomo, a czego nie traktować jak pewnik

Obowiązek korzystania z KSeF wchodzi etapami, rozłożony na lata 2026–2027: zaczyna się w 2026 roku, a pełny zakres ma objąć wszystkich do 2027 roku. Kolejność jest z grubsza taka, że najpierw wchodzą więksi podatnicy, a mniejsze firmy dołączają w następnej fali. To znaczy, że nawet jeśli Twój termin jest później, kierunek jest jeden: prędzej czy później faktury pójdą przez KSeF.

I teraz rzecz, którą traktujemy poważnie: konkretne daty bywały już przesuwane, więc nie podajemy ich jako pewnika. Zanim ustalisz swój termin, sprawdź aktualny harmonogram na stronie Ministerstwa Finansów – to jedyne źródło, które warto traktować wiążąco. Z perspektywy budowy systemu ważniejsze od dnia w kalendarzu jest to, żeby aplikacja była gotowa z wyprzedzeniem i przetestowana, zanim obowiązek zacznie Cię dotyczyć.

Co konkretnie musi umieć system, który wystawia faktury

Tu jest sedno. Niezależnie od tego, czy Twoja aplikacja to sklep, portal klienta czy magazyn, żeby być zgodna z KSeF musi umieć sześć rzeczy:

• Zbudować fakturę w strukturze FA(3). Nie „wygenerować PDF”, tylko ułożyć dane w urzędowym układzie: sprzedawca, nabywca, pozycje, stawki, daty – każde pole tam, gdzie wzór go oczekuje. To najważniejsza i zwykle najbardziej pracochłonna część.
• Wysłać ją do KSeF i odebrać potwierdzenie. System łączy się z KSeF, przekazuje fakturę, a w odpowiedzi zapisuje numer KSeF oraz UPO. Od tej chwili to numer KSeF, a nie Twój wewnętrzny numer, jest urzędowym identyfikatorem dokumentu.
• Poradzić sobie, gdy KSeF nie odpowiada (tryb awaryjny). Przepisy przewidują sytuacje, w których KSeF jest niedostępny albo Ty nie masz z nim łączności. System musi wtedy wystawić fakturę w trybie zastępczym i dosłać ją do KSeF, gdy połączenie wróci – bez gubienia dokumentów po drodze.
• Przechowywać i odnajdywać faktury. Wystawione dokumenty razem z numerem KSeF i UPO trzeba trzymać i umieć szybko odszukać: na potrzeby klienta, księgowości i ewentualnej kontroli.
• Pobierać faktury, które ktoś wystawił Tobie. KSeF działa w dwie strony: Twoi dostawcy też wrzucają tam faktury dla Ciebie. Jeśli chcesz je widzieć u siebie, system musi umieć je stamtąd pobrać.
• Pilnować uprawnień i dostępu. Rozmowa z KSeF wymaga uwierzytelnienia – tokenów i uprawnień powiązanych z Twoją firmą. System musi je bezpiecznie przechowywać i używać tak, żeby fakturę wysyłał w Twoim imieniu wyłącznie ktoś do tego upoważniony.

Brzmi jak dużo, ale dla właściciela firmy większość z tego dzieje się niewidocznie. Po zbudowaniu modułu wystawianie faktury wygląda tak samo jak dziś: klikasz „wystaw” albo nie klikasz nic, bo robi to za Ciebie sprzedaż, a cała rozmowa z KSeF – numer, UPO, archiwum – toczy się w tle. Ten wysiłek ponosisz raz, przy budowie; codziennie korzystasz już z gotowego.

Skąd system bierze dane do faktury, i dlaczego to Twoja przewaga

Zostaje pytanie najbardziej „firmowe”: skąd w ogóle biorą się dane, które trafią na fakturę. W dedykowanej aplikacji faktura nie powstaje w próżni – jej pozycje to Twoje zamówienia, Twoje umowy, Twój cennik. Nazywamy to mapowaniem: ustaleniem, które pole w Twoim procesie odpowiada któremu polu na fakturze FA(3).

To akurat jest przewaga własnego systemu nad pudełkowym programem. Skoro faktura powstaje automatycznie z danych, które już masz – ze sprzedaży, magazynu, rezerwacji – to znika ręczne przepisywanie, a z nim najczęstsza przyczyna błędnych faktur. Dobrze zmapowany system wystawia poprawny plik FA(3) sam, w tle, w momencie sprzedaży, a Ty widzisz gotowy dokument z numerem KSeF, nie formularz do wypełnienia.

Przykład z życia: w systemie zamówień pozycja „lunch dnia × 2” z ceną i stawką VAT musi trafić na fakturę jako właściwe pola ilości, ceny jednostkowej i stawki, a dane Twojej firmy oraz nabywcy – w pola sprzedawcy i nabywcy. Zmapowanie tego raz sprawia, że każda kolejna faktura powstaje bez Twojego udziału i bez pomyłki. Właśnie dlatego integrację z KSeF najłatwiej dołożyć tam, gdzie dane sprzedaży już są uporządkowane – czyli w dedykowanym systemie.

KSeF nie zmienia tego, co sprzedajesz. Zmienia tylko drogę, którą faktura trafia do urzędu i do klienta – a tę drogę system może przejść za Ciebie, w tle.

Ile to jest w godzinach uncrn

U nas każda funkcja ma cenę w godzinach, a godzina kosztuje 600 zł netto. Integracja z KSeF to nie osobny, tajemniczy produkt – to moduł, który dokładamy do systemu wystawiającego faktury, i który w praktyce mieści się w zakresie MVP (30 h · 18 000 zł netto) albo produktu (60 h · 36 000 zł netto), zależnie od tego, ile Twoja aplikacja już potrafi.

Ile dokładnie – zależy od kilku rzeczy, które przejdziemy na pierwszej rozmowie: czy system już wystawia faktury, czy dopiero ma się tego nauczyć; ile masz typów dokumentów; czy potrzebujesz tylko wysyłać faktury, czy też pobierać te od dostawców. Cokolwiek ustalimy, dostajesz estymatę godzin na piśmie, zanim cokolwiek zbudujemy, i akceptujesz ją, zanim wydasz złotówkę na budowę.

• Kod i prawa w 100% Twoje – moduł KSeF, jak cała aplikacja, zostaje Twój po każdym opłaconym etapie; żadnego uzależnienia od jednego wykonawcy.
• Estymata przed pracą – rozpisane godziny na piśmie; akceptujesz, zanim ruszymy.
• Start do 24 h od płatności – projekt bierze konkretny inżynier, nie kolejka zgłoszeń.
• NDA od pierwszej wiadomości, automatycznie z regulaminu – o swoich danych i procesach rozmawiasz poufnie od początku.
• Fakturę VAT wystawia aveneo – software house działający od 2008 roku, którego marką jest uncrn.

← wszystkie wpisy