Integracja KSeF przez API jest potrzebna wtedy, gdy faktury powstają w Twoim własnym systemie, sklepie internetowym albo panelu, przy dużej liczbie zamówień lub przy nietypowym procesie sprzedaży. Terminy są twarde: od 1 lutego 2026 faktury w KSeF wystawiają firmy ze sprzedażą powyżej 200 mln zł w 2024 roku, a odbierają je wszystkie firmy; od 1 kwietnia 2026 wystawiają je pozostali podatnicy VAT, a od 1 stycznia 2027 obowiązek obejmuje także najmniejsze firmy ze sprzedażą do 10 tys. zł miesięcznie. Do końca 2026 roku nie ma kar — od 1 stycznia 2027 za niewystawienie faktury w KSeF grozi kara do 100% kwoty VAT z faktury, a przy fakturach bez VAT do 18,7% kwoty brutto.
Jeśli fakturujesz w programie do fakturowania albo w ERP z wbudowaną obsługą KSeF, prawdopodobnie nie musisz nic programować. Jeśli faktura powstaje w Twoim systemie — trzeba ją połączyć z KSeF przez API.
Od kiedy obowiązuje KSeF i kiedy zaczynają się kary?
Harmonogram jest rozłożony na dwa lata, ale pierwsza data dotyczy wszystkich firm: od 1 lutego 2026 faktury w KSeF trzeba odbierać, niezależnie od wielkości sprzedaży.
| Data | Kogo dotyczy |
|---|---|
| 1 lutego 2026 | Obowiązkowe wystawianie faktur w KSeF dla firm ze sprzedażą powyżej 200 mln zł w 2024 roku |
| 1 lutego 2026 | Wszystkie firmy odbierają faktury w KSeF |
| 1 kwietnia 2026 | Faktury w KSeF wystawiają pozostali podatnicy VAT |
| 1 stycznia 2027 | Obowiązek obejmuje najmniejsze firmy ze sprzedażą do 10 tys. zł miesięcznie |
| 1 stycznia 2027 | Koniec okresu bez kar: do 100% kwoty VAT z faktury, a przy fakturach bez VAT do 18,7% kwoty brutto |
Dla większości firm obowiązek już działa, a kar nie ma tylko do końca 2026 roku. To ostatnie miesiące, żeby dopracować integrację bez ryzyka kar. To, które daty dotyczą konkretnie Twojej firmy i jakiej sprzedaży, potwierdź w swojej księgowości — CodePort zajmuje się stroną techniczną, nie doradza w sprawach podatkowych.
Co to jest integracja z KSeF i czy na pewno jej potrzebujesz?
Integracja z KSeF to połączenie Twojego systemu z Krajowym Systemem e-Faktur przez API: dane o sprzedaży, które już masz w bazie, są zamieniane na fakturę w wymaganej strukturze, wysyłane do KSeF i opisywane zwrotnym numerem KSeF. Bez tego ktoś musi te same dane przepisywać ręcznie do innego programu.
Zanim zamówisz cokolwiek, odpowiedz sobie na jedno pytanie: gdzie dokładnie powstaje faktura?
| Gdzie powstaje faktura | Co wystarczy |
|---|---|
| Program do fakturowania z obsługą KSeF | Gotowy moduł dostawcy — bez programowania |
| ERP z wbudowaną obsługą KSeF | Gotowy moduł w ERP |
| Własny system, panel, sklep internetowy | Integracja przez API |
| Nietypowy proces sprzedaży lub duża liczba zamówień | Integracja przez API |
Jeśli trafiasz do dwóch pierwszych wierszy — nie kupuj integracji na zapas. Jeśli do dwóch dolnych, temat warto domknąć przed 1 stycznia 2027, kiedy zaczynają obowiązywać kary.
Które sytuacje w praktyce wymagają integracji przez API?
Własny system lub panel
Masz aplikację webową, w której obsługujesz zamówienia, umowy albo abonamenty, i to ona generuje faktury (choćby jako PDF). Dane są na miejscu, brakuje tylko warstwy, która zamieni je na dokument w strukturze KSeF i wyśle go dalej. Tak bywa w firmach, które kiedyś zbudowały sobie aplikację webową lub panel na miarę.
Sklep internetowy przy dużej liczbie zamówień
Przy dużej liczbie zamówień ręczne wystawianie faktur przestaje być opcją — nie ze względu na przepisy, tylko na godziny pracy. Integracja przenosi to na system, a człowiek zostaje przy wyjątkach: korektach, zwrotach, nietypowych zamówieniach.
ERP i program księgowy
Integracja ERP z KSeF bywa potrzebna nawet wtedy, gdy dostawca ma moduł — na przykład gdy część sprzedaży idzie kanałem, którego ERP nie obsługuje, albo gdy dane do faktury powstają w innym systemie i muszą wcześniej trafić do ERP. Wtedy realnym zadaniem jest połączenie dwóch systemów między sobą, a nie samo KSeF.
Sprzedaż na Allegro
API Allegro pozwala dodać do każdego zamówienia do 10 faktur w PDF, każdą o wielkości do 3 MB. Dzięki temu faktura wygenerowana w Twoim systemie trafia do kupującego automatycznie, bez ręcznego wgrywania dokumentów jeden po drugim. Więcej o łączeniu sklepu, ERP i płatności znajdziesz na stronie integracji systemów i API.
Co obejmuje integracja z KSeF krok po kroku?
Zakres, który realizujemy w CodePort, wygląda tak:
- Generowanie faktur w strukturze FA(3) z danych, które już są w Twoim systemie — bez przepisywania i bez drugiego miejsca na te same informacje.
- Wysyłka do KSeF i zapisanie numeru KSeF przy dokumencie, żeby każdy dokument w Twojej bazie miał potwierdzenie, że przeszedł.
- Obsługa błędów i ponowne próby, żeby żadna faktura nie utknęła niezauważona. To najczęściej niedoceniany element — dopóki nie zdarzy się pierwsza cicha porażka wysyłki.
- Pobieranie faktur zakupowych do systemu, bo od 1 lutego 2026 faktury trzeba także odbierać.
- Obsługa trybu awaryjnego na wypadek niedostępności KSeF — sprzedaż nie może się zatrzymać, kiedy system po drugiej stronie nie odpowiada.
To jest lista minimum. Reszta zależy od tego, co dzieje się u Ciebie z korektami, zaliczkami i zwrotami — i tego, jak te procesy opisze Twoja księgowość.
Ile kosztuje integracja z KSeF?
Koszt liczymy prosto: liczba godzin × 200 zł netto za programowanie. Liczba godzin zależy od tego, gdzie powstają faktury, ile ich jest i czy Twój system ma API.
Przykład: 40 godzin pracy to 8 000 zł netto. To wyliczenie poglądowe, nie oferta — konkretne widełki godzin podajemy po przejrzeniu Twoich systemów.
Co realnie podnosi koszt:
| Czynnik | Dlaczego zwiększa liczbę godzin |
|---|---|
| Brak dokumentacji API | Trzeba rozpoznać zachowanie systemu metodą prób |
| Stary system bez API | Potrzebna inna droga: import/eksport plików, połączenie z bazą albo dobudowanie API |
| Duże wolumeny danych | Kolejkowanie, wydajność, odporność na przerwy |
| Wiele wyjątków w procesie | Każdy wyjątek to osobna ścieżka do zaprogramowania i przetestowania |
Jeśli system nie ma API, to nie koniec tematu — są inne drogi: import i eksport plików, połączenie z bazą danych albo nowe API dobudowane do istniejącego systemu.
A utrzymanie?
Dostawcy zmieniają swoje API, więc integracja nie jest projektem „raz a dobrze”. Typowo to 5 – 15 godzin miesięcznie na monitoring, aktualizacje i poprawki. Przykładowo: 5 – 15 godzin × 200 zł/h netto to 1 000 – 3 000 zł netto miesięcznie — ile realnie, zależy od liczby połączonych systemów.
Jeśli przy okazji chcesz zdjąć z ludzi także inne powtarzalne czynności wokół dokumentów, zobacz, jak wygląda automatyzacja procesów biznesowych — faktury to zwykle tylko jeden z kilku procesów, które zjadają godziny.
Jak wygląda wdrożenie integracji i ile trwa wycena?
- Rozmowa i przegląd systemów. Sprawdzamy dokumentację API, przepływ danych i to, gdzie dziś powstają dokumenty. Widełki i harmonogram dostajesz w 2 – 3 dni robocze, a odpowiedź na samo zgłoszenie w ciągu jednego dnia roboczego.
- Schemat przepływu danych przed kodem. Ustalamy na papierze, skąd i dokąd płyną dane oraz co się dzieje, gdy któryś system nie odpowiada. Ten etap wyłapuje najwięcej nieporozumień.
- Sprinty. Co 1 – 2 tygodnie widzisz działającą część integracji, a nie raport o postępie.
- Wdrożenie. Uruchomienie na produkcji, obsługa błędów, monitoring.
Rozliczamy etapami, pracujemy na umowie i NDA, a pełne prawa majątkowe do kodu przechodzą na Ciebie po rozliczeniu — kod trafia do Twojego repozytorium. Przy integracji z systemem podatkowym to ma praktyczne znaczenie: nie zostajesz zakładnikiem jednego wykonawcy.
Co przygotować przed rozmową z programistą?
Im więcej z tego masz, tym węższe będą widełki:
- Nazwy systemów, w których powstają faktury i zamówienia (własny system, sklep, ERP, program księgowy).
- Informację, czy te systemy mają API i czy masz do nich dokumentację oraz dostęp.
- Przybliżoną liczbę faktur miesięcznie i kanały sprzedaży (sklep, Allegro, sprzedaż bezpośrednia).
- Listę wyjątków: korekty, zaliczki, zwroty, sprzedaż zagraniczna, faktury zbiorcze.
- Ustalenia z księgowością: od kiedy dokładnie Twoja firma musi wystawiać faktury w KSeF i kto pilnuje poprawności danych na dokumencie.
Dwie ostatnie rzeczy to zadanie dla księgowości albo doradcy podatkowego. My przekładamy ich ustalenia na technikę. Najszybciej zbierzesz to wszystko w jednym miejscu, wypełniając brief projektu — na jego podstawie przygotujemy widełki i wstępną specyfikację.
Czego nie warto robić
Nie warto czekać do grudnia 2026. Kary startują 1 stycznia 2027, a integracja to nie tylko kod — to też testy, poprawki i pierwszy miesiąc pracy na produkcji, w którym wychodzą wyjątki nieopisane w żadnej dokumentacji.
Nie warto też budować integracji „przy okazji” dużego przepisywania systemu. Zwykle KSeF da się podłączyć do tego, co już masz, bez wymiany działających narzędzi.
Opisz, gdzie powstają Twoje faktury i z jakimi systemami pracujesz — widełki i harmonogram integracji z KSeF dostaniesz w 2 – 3 dni robocze.
Najczęstsze pytania
Integracja z KSeF — od kiedy jest naprawdę potrzebna?
Odbieranie faktur w KSeF obowiązuje wszystkie firmy od 1 lutego 2026, wystawianie dla pozostałych podatników VAT od 1 kwietnia 2026, a dla najmniejszych firm ze sprzedażą do 10 tys. zł miesięcznie od 1 stycznia 2027. Data właściwa dla Twojej firmy powinna zostać potwierdzona przez księgowość.
Ile kosztuje integracja z KSeF?
Koszt to liczba godzin × 200 zł netto za programowanie; przykładowo 40 godzin pracy to 8 000 zł netto. Dokładne widełki godzin podajemy dopiero po przejrzeniu Twoich systemów i dokumentacji API, bo system bez API wymaga innej, zwykle bardziej pracochłonnej drogi.
Czy integracja KSeF z programem księgowym ma sens, skoro ma on własny moduł?
Jeśli faktury powstają bezpośrednio w tym programie, gotowy moduł wystarczy i nie ma czego programować. Integracja przydaje się wtedy, gdy dane do faktur powstają wcześniej w innym systemie i ktoś je dziś przepisuje ręcznie.
Co się stanie, gdy KSeF będzie niedostępny w trakcie sprzedaży?
W zakresie integracji jest obsługa trybu awaryjnego i ponawianie prób wysyłki: dokumenty czekają w kolejce i trafiają do KSeF po przywróceniu dostępności, a system oznacza te, które nie przeszły, żeby nikt ich nie przeoczył.
Co zrobić, gdy mój system w ogóle nie ma API?
Są inne drogi: import i eksport plików, połączenie bezpośrednio z bazą danych albo dobudowanie nowego API do istniejącego systemu. Wybór zależy od tego, jak system jest zbudowany i czy masz do niego dostęp techniczny.