Integracja z KSeF – gdy system firmy nie wysyła faktur

Integracja z KSeF - firmowy obieg faktur spięty z rejestrem państwowym, premium B2B

Integracja z KSeF w wielu firmach kończy się na dziale księgowości. Faktury sprzedażowe idą do rejestru, bo księgowa ma to w swoim programie, a sklep internetowy, magazyn i handlowcy w terenie wystawiają dokumenty po staremu. Ktoś przepisuje je potem ręcznie albo wrzuca zbiorczo pod koniec dnia i liczy, że nic nie przepadnie. Taki układ trzyma się do pierwszej korekty i do pierwszego dokumentu, którego nikt nie przepisał. Ten przewodnik jest o tej luce: co dokładnie musi umieć system firmy, jakie są trzy drogi wyjścia, ile każda z nich trwa i kosztuje oraz gdzie takie wdrożenia najczęściej się sypią. Kwoty podajemy jako orientacyjne stawki rynkowe dla Polski w sierpniu 2026 roku, a nie jako cennik Devstocka.

Kto i od kiedy musi wysyłać faktury przez KSeF

Obowiązek wszedł etapami i większość firm jest już w środku. Zgodnie z harmonogramem Ministerstwa Finansów system stał się obowiązkowy 1 lutego 2026 roku dla podatników o sprzedaży powyżej 200 mln zł za 2024 rok, liczonej wraz z kwotą podatku. Pozostałych podatników obowiązek objął 1 kwietnia 2026 roku (sprawdzone 26.08.2026).

Dwie rzeczy z tego harmonogramu bywają pomijane, a mają bezpośredni wpływ na zakres wdrożenia. Pierwsza: co do zasady odbieranie faktur przez rejestr stało się obowiązkowe już 1 lutego 2026 roku, niezależnie od tego, kiedy firma zaczęła je wystawiać. Przepisy przewidują wyjątki, więc zakres dotyczący Twojej firmy potwierdź z księgowością.

Druga dotyczy ułatwienia dla najmniejszych. Do 31 grudnia 2026 roku działa przejściowy limit 10 tys. zł miesięcznie, liczony jako kwota brutto z faktur objętych obowiązkiem, a nie jako cała sprzedaż firmy. Od 1 stycznia 2027 roku obowiązek obejmuje również te podmioty. Ministerstwo Finansów zaznacza przy tym, że po przekroczeniu limitu ułatwienie nie wraca w kolejnych miesiącach (sprawdzone 26.08.2026).

To nie jest porada podatkowa. Ten tekst opisuje techniczną stronę połączenia systemu firmy z rejestrem. Zakres obowiązku, klasyfikacja dokumentów oraz sposób ich ujęcia w rozliczeniach to sprawa dla księgowości i doradcy podatkowego, a nie dla wykonawcy oprogramowania.

Co dokładnie musi zrobić system firmy

System firmy musi zrobić sześć rzeczy: przygotować dokument w wymaganej strukturze, uwierzytelnić się, wysłać go, sprawdzić status i zapisać nadany numer, pobierać faktury zakupowe oraz poradzić sobie z niedostępnością rejestru. To jest lista wymagań do oferty, a nie wykład o przepisach.

Wystawienie w strukturze i wysyłka

Faktura nie idzie jako plik PDF ani jako wydruk. Idzie jako dokument o ściśle określonej strukturze, w której każde pole ma swoje miejsce. Twój system musi więc umieć złożyć taki dokument z danych, które ma w bazie.

Tu pojawia się pierwszy realny problem wdrożeniowy. Pola wymagane przez strukturę często istnieją w systemie firmy pod inną nazwą, w innym formacie albo wcale. Klasyczne przykłady to jednostki miary, stawki i oznaczenia procedur oraz dane kontrahenta, które w bazie bywają niepełne. Uzupełnienie tych danych jest zwykle osobnym zadaniem przed startem.

Status wysyłki i numer KSeF

Po wysłaniu system sprawdza status przetwarzania dokumentu. Gdy rejestr przyjmie fakturę, nadaje jej numer i ten numer trzeba zapisać przy dokumencie. Ministerstwo Finansów podaje, że nadanie numeru jest równoznaczne z prawidłowym przetworzeniem faktury (sprawdzone 26.08.2026).

Osobną rzeczą jest urzędowe poświadczenie odbioru, w skrócie UPO. System może je pobrać jako dodatkowy element ścieżki audytowej, natomiast lokalne archiwizowanie poświadczeń nie jest wymagane. Warto to wiedzieć przed rozmową o zakresie, bo bywa wyceniane jako osobna praca.

Drugi kierunek bywa niedoceniany. Faktury zakupowe przychodzą do firmy przez rejestr i ktoś musi je stamtąd pobierać oraz wprowadzać do obiegu. Jeżeli tego nie zautomatyzujesz, dział księgowości pobiera je ręcznie, a to jest dokładnie ta praca, którą integracja miała zdjąć.

Obsługa błędów i trybu niedostępności

To są dwie różne sytuacje i wdrożenia lubią je mylić. Wysłany dokument może zostać odrzucony, na przykład z powodu niezgodności ze strukturą, i wtedy potrzebna jest obsługa błędu oraz ponowna wysyłka. Osobno rejestr może być niedostępny. Na brak możliwości przesłania dokumentu przepisy przewidują odrębne tryby z własnymi terminami, więc system musi umieć kolejkować niewysłane faktury.

Praktyczny wniosek dla zakresu wdrożenia jest taki, że sama wysyłka to może połowa roboty. Druga połowa to obsługa sytuacji, w których wysyłka się nie udała, oraz pilnowanie, żeby żaden dokument nie utknął po cichu w kolejce. Ogólną zasadę, że integracja bez planu na błędy jest integracją tylko z nazwy, rozwijamy w przewodniku o integracji systemów w firmie.

Trzy drogi wyjścia dla firmy z własnym systemem

Masz trzy możliwości: moduł od dostawcy Twojego systemu, pośrednika, który wystawia w Twoim imieniu, albo integrację pisaną na zamówienie. Wybór zależy głównie od tego, ile miejsc w firmie generuje faktury.

DrogaCo dostajeszCzego nie dostajeszKoszt wejściaZależność
Moduł dostawcy systemuGotową wysyłkę i odbiór w jednym programieZwykle obsługi dokumentów spoza tego programuZwykle w cenie aktualizacji albo jako płatny dodatekPełna, także co do terminu wydania
PośrednikSzybki start, zwykle z mniejszą pracą programistycznąPełnej kontroli nad tym, gdzie leżą dane i jak wygląda obiegAbonamentDuża, dochodzi drugi dostawca do umowy
Integracja pisana na zamówienieObsługę wszystkich miejsc, w których powstają dokumentyGotowego rozwiązania z dnia na dzieńWycena projektuPo Twojej stronie, razem z utrzymaniem

Kolejność sprawdzania jest przy tym stała. Najpierw zapytaj dostawcę swojego systemu, co dokładnie dowiózł i w której wersji. Jeżeli moduł pokrywa Twój przypadek, zwykle jest to droga najtańsza. Zapytaj przy okazji, czy moduł ma interfejs albo import dla dokumentów z innych źródeł, bo część rozwiązań to potrafi. Dopiero gdy odpowiedź brzmi “nie obsługujemy tego”, zaczyna się rozmowa o dwóch pozostałych drogach.

Kiedy moduł dostawcy nie wystarczy

Moduł dostawcy obsługuje przede wszystkim dokumenty powstające w jego własnym programie. Wystarcza więc firmom, w których faktury wychodzą z jednego miejsca. Problem zaczyna się tam, gdzie miejsc jest kilka.

W praktyce sprzedaż rozjeżdża się na cztery kanały, a każdy generuje dokumenty osobno. Sklep internetowy wystawia je automatycznie po opłaceniu zamówienia. Magazyn przy wydaniu towaru. Handlowiec w terenie z aplikacji na telefonie. Sprzedaż w serwisach zewnętrznych ma jeszcze własny obieg, co opisaliśmy przy okazji integracji sklepu z Allegro.

Jeżeli rozpoznajesz u siebie więcej niż jedno takie miejsce, sprawdź najpierw, czy moduł księgowy przyjmuje dokumenty z zewnątrz. Gdy nie przyjmuje, tematu nie zamknie kolejna licencja, tylko warstwa zbierająca dokumenty ze wszystkich systemów i wysyłająca je w jednym, kontrolowanym przepływie. Wtedy firma potrzebuje wykonawcy. Opisz nam swój obieg dokumentów przez formularz wyceny, a odpowiemy, czy w Twoim przypadku wystarczy moduł, czy potrzebna jest osobna warstwa.

Devstock · Software house

Faktury powstają w czterech miejscach, a rejestr jest jeden

Budujemy warstwę, która zbiera dokumenty ze sklepu, magazynu i aplikacji handlowców, a potem wysyła je w jednym kontrolowanym przepływie. Razem z kolejką, ponawianiem i podglądem tego, co utknęło.

Sprawdź usługę →

Ile trwa i ile kosztuje integracja z KSeF

Disclaimer rynkowy. Poniższe kwoty i terminy to orientacyjne stawki rynkowe w Polsce w sierpniu 2026 roku, a nie cennik Devstocka. Realna wycena zależy od liczby systemów wystawiających dokumenty oraz od stanu danych kontrahentów i towarów w bazie.

Integracja własnego systemu z KSeF kosztuje w Polsce zwykle od kilkunastu do kilkudziesięciu tysięcy złotych netto i zajmuje od sześciu do szesnastu tygodni. Górna granica dotyczy wdrożeń obejmujących także odbiór faktur zakupowych, korekty oraz pracę przy niedostępnym rejestrze.

Co przesuwa wycenę w górę

Trzy rzeczy podnoszą rachunek najbardziej i wszystkie da się sprawdzić przed wyceną. Pierwsza to liczba systemów, które wystawiają dokumenty, bo każdy z nich jest osobnym podłączeniem. Druga to stan danych: braki w danych kontrahentów i niespójne jednostki miary potrafią zająć więcej czasu niż samo połączenie. Trzecia to korekty i dokumenty nietypowe, które mają własne reguły.

Koszt utrzymania

Ta pozycja nie kończy się razem z wdrożeniem. Struktura dokumentu oraz sposób uwierzytelniania są elementem systemu państwowego i bywają zmieniane, a każda taka zmiana oznacza poprawkę po Twojej stronie w narzuconym terminie.

W ofercie warto więc zapytać wprost o dwie rzeczy: kto obserwuje komunikaty Ministerstwa Finansów oraz w jakim czasie wykonawca zobowiązuje się wdrożyć zmianę wymuszoną przepisami. Bez tego integracja działa do pierwszej większej aktualizacji rejestru.

Gdzie integracja z KSeF najczęściej się sypie

Pięć miejsc powtarza się w tych wdrożeniach niezależnie od branży. Każde z nich da się przewidzieć na etapie ustalania zakresu.

Uwierzytelnianie i uprawnienia

Uwierzytelnienie i uprawnienia potrafią zatrzymać gotowe wdrożenie, jeśli nie trafią do harmonogramu. W integracjach można korzystać między innymi z podpisu lub pieczęci kwalifikowanej, z certyfikatów wydawanych przez rejestr oraz przejściowo z tokenów. Ministerstwo Finansów podaje, że tokeny będą działać do końca 2026 roku (sprawdzone 26.08.2026). Integracja oparta wyłącznie na nich ma więc wpisaną datę przeterminowania.

Wniosek praktyczny: sposób uwierzytelnienia oraz osobę, która nadaje uprawnienia w firmie, ustal na starcie projektu. Zdarza się, że wykonawca jest gotowy, a projekt nadal czeka na wymagane uprawnienia.

Trzy środowiska, nie dwa

Tu wdrożenia potykają się o uproszczenie. Ministerstwo Finansów udostępnia integratorom środowisko integracyjne na danych anonimowych, środowisko przedprodukcyjne Demo działające na prawdziwych danych uwierzytelniających oraz środowisko produkcyjne (sprawdzone 26.08.2026). Faktury z dwóch pierwszych nie wywołują skutków prawnych.

Praktyczna kolejność wygląda więc tak: prace i testy na środowisku integracyjnym, końcowa walidacja na Demo, dopiero potem produkcja. Produkcji nie traktuj jako kolejnego środowiska testowego, bo wystawiony tam dokument jest już fakturą ze wszystkimi konsekwencjami.

Korekty i dokumenty nietypowe

Zwykła faktura sprzedaży to najprostszy przypadek. Korekty, faktury zaliczkowe oraz dokumenty w walucie obcej mają własne reguły i to one zwykle wracają z odrzuceniem. Ustal wprost z księgowością, które rodzaje dokumentów faktycznie u Was występują, bo lista bywa dłuższa, niż zakłada wykonawca.

Załączniki i to, czego faktura nie przenosi

Struktura dokumentu nie jest workiem na wszystko. Obowiązująca struktura faktury przewiduje wprawdzie ustrukturyzowany załącznik, natomiast jego użycie wymaga wcześniejszego zgłoszenia w usłudze e-Urząd Skarbowy i otrzymania potwierdzenia. Nie zastępuje to zwykłych plików: nie prześlesz tą drogą arkusza, zdjęcia ani podpisanego protokołu odbioru.

Firmy, które dołączały takie materiały do faktur, muszą więc ustalić, gdzie one teraz mieszkają i jak trafiają do klienta. To decyzja procesowa, nie techniczna, ale bez niej wdrożenie się nie domknie.

Archiwizacja i dostęp do dokumentów

Rejestr przechowuje faktury, natomiast firma nadal potrzebuje własnego dostępu do nich: do reklamacji, do audytu, do rozliczeń z klientem. Zaplanuj, gdzie i jak długo trzymacie własną kopię oraz kto ma do niej wgląd.

FAQ – najczęstsze pytania o wdrożenie

Poniżej pytania, które wracają najczęściej przy planowaniu wdrożenia.

Czy sklep internetowy musi wysyłać faktury do KSeF?

To, które dokumenty ze sklepu mają trafić do rejestru, ustal z księgowością, bo jest to kwalifikacja podatkowa. Po stronie technicznej liczy się co innego: sklep powinien przekazywać integracji wynik tej kwalifikacji i obsługiwać osobno dokumenty kierowane do rejestru oraz te pozostające poza nim. Zakres wdrożenia zależy właśnie od tego rozdzielenia.

Co zrobić, gdy dostawca oprogramowania nie dowiózł modułu?

Poproś o pisemną informację, w której wersji i w jakim terminie moduł będzie dostępny. Jeżeli termin jest odległy albo odpowiedź jest wymijająca, masz dwie drogi: pośrednika jako rozwiązanie doraźne albo integrację pisaną na zamówienie jako docelową. Warto policzyć oba warianty, zamiast czekać na aktualizację, której data nie jest potwierdzona.

Czy potrzebna jest osobna integracja do faktur zakupowych?

Zwykle tak, bo to inny kierunek przepływu i inna praca po stronie systemu. Wysyłka faktur sprzedażowych oraz pobieranie zakupowych to dwa osobne mechanizmy, choć korzystają z tego samego połączenia. W ofercie sprawdź, czy wykonawca wycenił oba, czy tylko pierwszy.

Ile trwa wdrożenie integracji z KSeF?

Najczęściej od sześciu do szesnastu tygodni, licząc od zatwierdzenia zakresu. Prosty przypadek, czyli jeden system i wyłącznie wysyłka, zamyka się w dolnej części tego przedziału. Górna dotyczy firm z kilkoma źródłami dokumentów, korektami i wymaganym uporządkowaniem danych kontrahentów przed startem.

Podsumowanie

Integracja z KSeF przestała być projektem przygotowawczym i stała się pytaniem o to, co zrobić z dokumentami powstającymi poza programem księgowym. System firmy musi umieć sześć rzeczy: złożyć dokument w wymaganej strukturze, uwierzytelnić się, wysłać, sprawdzić status i zapisać nadany numer, pobierać faktury zakupowe oraz obsłużyć niedostępność rejestru. Masz trzy drogi: moduł dostawcy, pośrednika albo integrację pisaną na zamówienie, a wybór zależy przede wszystkim od liczby miejsc, w których wystawiacie faktury. Największe ryzyka nie są przy tym programistyczne. Leżą w uwierzytelnianiu, w stanie danych kontrahentów oraz w dokumentach nietypowych, które wracają z odrzuceniem. Jeżeli chcesz sprawdzić, ile pracy oznacza to u Ciebie, opisz swój obieg dokumentów w formularzu wyceny.

POZOSTAŁE