Ile kosztuje integracja z KSeF?
Samo API KSeF jest bezpłatne, tak samo jak certyfikat KSeF i środowisko testowe ministerstwa. Płacisz za pracę: albo programisty, który zbuduje i utrzyma połączenie, albo dostawcy, który robi to w abonamencie. Dlatego pytanie „ile kosztuje integracja z KSeF” ma trzy odpowiedzi, po jednej na każdą drogę.
Te liczby dotyczą firm, w których faktura powstaje we własnym systemie: w koszyku sklepu internetowego, w module rozliczeń aplikacji abonamentowej, w CRM po wygranej sprzedaży albo w ERP po wydaniu towaru. Firma, która wystawia faktury ręcznie w programie do faktur, nie potrzebuje żadnej integracji, bo program wysyła je do KSeF sam.
| Droga | Koszt na start | Koszt stały | Kto pilnuje zmian w KSeF |
|---|---|---|---|
| Własna integracja z API ministerstwa | 25 do 45 dni pracy programisty (nasz szacunek) | utrzymanie, monitoring, poprawki przy zmianach schematu | Twój zespół |
| Moduł KSeF w systemie, który masz | według cennika dostawcy, często z aktualizacją wersji | opłata za moduł albo abonament serwisowy | dostawca systemu |
| API programu do faktur | 2 do 5 dni pracy programisty | w Fakturowalni 399 zł netto miesięcznie, rocznie 199 zł miesięcznie | dostawca programu |
| Import faktur z pliku CSV | eksport zamówień do pliku, bez programisty | w Fakturowalni od planu Firma, rocznie 149 zł miesięcznie | dostawca programu |
Ile kosztuje własna integracja z API KSeF
Własna integracja to nie jedno wywołanie, które wysyła plik. To kilka modułów, z których każdy trzeba zbudować, przetestować na środowisku testowym ministerstwa i utrzymywać. Poniżej nasz szacunek dla zespołu, który robi to pierwszy raz, na podstawie tego, z czego składa się połączenie z KSeF 2.0. To nie jest cennik rynku: doświadczony zespół zrobi część szybciej, a nietypowe dokumenty wydłużą każdą pozycję.
| Element integracji | Co trzeba zrobić | Dni pracy |
|---|---|---|
| Uwierzytelnienie | token albo certyfikat KSeF, uzyskanie i odświeżanie dostępu, uprawnienia osób i systemów | 3 do 5 |
| Sesja i szyfrowanie | otwarcie sesji, szyfrowanie faktur kluczem symetrycznym, zamknięcie sesji i odbiór UPO | 3 do 5 |
| Struktura FA(3) | budowa XML z danych systemu, walidacja ze schematem, stawki, waluty, GTU, MPP, korekty i zaliczki | 6 do 10 |
| Statusy i błędy | odpytywanie o numer KSeF, obsługa odrzuceń, ponawianie, zapis numeru przy zamówieniu | 3 do 5 |
| Tryby offline i awaryjny | wystawienie bez połączenia, kody QR na wizualizacji, dosłanie w terminie | 3 do 6 |
| Wizualizacja dla klienta | PDF z numerem KSeF i kodem QR dla nabywcy spoza systemu | 2 do 4 |
| Testy i wdrożenie | scenariusze na środowisku testowym i przedprodukcyjnym, przejście na produkcję | 5 do 10 |
Razem wychodzi od 25 do 45 dni. Żeby przeliczyć to na złote, pomnóż liczbę dni przez dzienną stawkę programisty, którą płacisz. Przy przykładowej stawce 1 200 zł netto za dzień to 30 000 do 54 000 zł netto za samo zbudowanie. Do tego dochodzi faktura kosztowa, bo integracja wysyłkowa nie pobiera jeszcze faktur od dostawców z KSeF. To osobny moduł na kolejne kilka dni.
Koszty, o których firmy zapominają przy wycenie
Wycena programisty zwykle kończy się na dniu wdrożenia. Najdroższe bywa to, co przychodzi później.
Utrzymanie przy zmianach schematu i API
Ministerstwo zmieniało już strukturę faktury z FA(2) na FA(3) i wersję API na 2.0. Każda taka zmiana to praca dla Twojego zespołu w terminie narzuconym przez państwo, nie przez Twój plan sprzedaży. W czerwcu 2026 roku ministerstwo zaproponowało też zmiany zasad uwierzytelniania, w tym utrzymanie tokenów po 2026 roku. To na razie propozycja, więc bezpieczniej projektować integrację tak, żeby działała także z certyfikatem KSeF.
Certyfikaty i podpis
Certyfikat KSeF wydaje ministerstwo bez opłat, na wniosek w Module Certyfikatów i Uprawnień, ale ktoś musi go uzyskać, pilnować terminu ważności i wymienić. Do pierwszego nadania uprawnień w KSeF właściciel firmy potrzebuje zwykle profilu zaufanego albo kwalifikowanego podpisu elektronicznego, a spółka z kilkoma członkami zarządu ustala, kto i jak to robi.
Dyżur, gdy KSeF nie działa
Gdy system ministerstwa ma awarię, faktury trzeba wystawić w trybie awaryjnym i dosłać je później. Własna integracja oznacza, że ktoś w Twoim zespole musi o tym wiedzieć w nocy z piątku na sobotę, gdy sklep sprzedaje. Jak wygląda ten tryb od strony programu, opisujemy na stronie faktura offline w KSeF.
Ile kosztuje integracja przez API programu do faktur
Trzecia droga polega na tym, że Twój system nie rozmawia z KSeF wcale. Wysyła do programu do faktur proste zapytanie z nabywcą, pozycjami, stawkami i terminem płatności, a program buduje plik FA(3), wysyła go do KSeF, czeka na numer i odsyła wynik. Programista podłącza jedno API REST zamiast siedmiu modułów z tabeli wyżej.
W Fakturowalni API i webhooki są w planie Biuro za 399 zł netto miesięcznie albo 2 388 zł netto rocznie, czyli 199 zł miesięcznie. Plan obejmuje 5 000 dokumentów miesięcznie i do 25 firm, więc jedna integracja obsłuży też kilka spółek z grupy. API przyjmuje faktury, proformy i rachunki, zwraca status i numer KSeF, PDF dla klienta oraz listę kontrahentów. Kwoty podajesz w groszach, a limit to 120 zapytań na minutę.
| Zdarzenie webhooka | Kiedy przychodzi |
|---|---|
| dokument.wystawiony | faktura dostała numer w serii |
| ksef.przyjeta | KSeF nadał numer KSeF |
| ksef.odrzucona | KSeF odrzucił dokument, z opisem błędu |
| dokument.wyslany | faktura poszła mailem do klienta |
| dokument.oplacony | wpłata oznaczona, także z wyciągu bankowego |
| dokument.po_terminie | termin płatności minął bez wpłaty |
Cały opis połączenia, z przykładami sklepu, CRM i ERP, jest na stronie integracja z KSeF przez API i webhooki. Faktury, które wystawia Twój zespół ręcznie, powstają w tym samym koncie i w tej samej serii co faktury z API, więc w numeracji nie ma dziur.
Wdrożenie KSeF koszt w firmie bez programisty
Nie każdy sklep albo program magazynowy potrafi wywołać API. Jeśli Twój system umie wyeksportować zamówienia do pliku, wczytujesz plik CSV do Fakturowalni, a program sprawdza całą partię ze schematem FA(3), wystawia faktury i wysyła je do KSeF. Ta droga działa od planu Firma, czyli od 149 zł netto miesięcznie w rozliczeniu rocznym, i nie wymaga ani jednego dnia pracy programisty. Kolumny pliku opisujemy na stronie import faktur do KSeF z pliku CSV.
Ta sama firma zwykle chce też odbierać faktury od dostawców. Program pobiera je z KSeF raz na dobę i oddaje biuru rachunkowemu w pliku importu, co opisujemy na stronie program do pobierania faktur z KSeF.
Kiedy opłaca się własna integracja z KSeF?
Gdy system wystawia tysiące faktur dziennie, ma nietypowe rodzaje dokumentów albo firma ma własny zespół, który i tak utrzymuje integracje z administracją. Wtedy koszt budowy rozkłada się na duży wolumen, a kontrola nad każdym polem pliku jest warta utrzymania.
Przy kilkuset albo kilku tysiącach faktur miesięcznie liczby wyglądają inaczej. Jeśli własna integracja kosztuje 40 000 zł netto na start, ten sam budżet pokrywa ponad 16 lat planu Biuro w rozliczeniu rocznym, a zmiany schematu, tryby awaryjne i nowe wersje API bierze na siebie dostawca. Uczciwie: jeśli Twój ERP ma już moduł KSeF w cenie serwisu, nie płać drugi raz, tylko go włącz.
Pytania przed decyzją
Czy integracja z KSeF jest darmowa?
Samo API KSeF ministerstwo udostępnia bez opłat, podobnie jak certyfikat KSeF i środowisko testowe. Płacisz za pracę programisty, który zbuduje i będzie utrzymywał połączenie, albo za abonament programu, który robi to za Ciebie.
Ile trwa integracja z KSeF?
Własna integracja z API ministerstwa zajmuje zwykle od kilku tygodni do kilku miesięcy, bo obejmuje uwierzytelnienie, szyfrowanie, strukturę FA(3), statusy, tryby awaryjne i testy. Wywołanie gotowego API programu do faktur programista podłącza w kilka dni, a import faktur z pliku CSV działa tego samego dnia.
Czy mogę zacząć od pliku CSV i przejść na API później?
Tak. Faktury z pliku i z API trafiają do tego samego konta i tej samej serii, więc zmiana planu z Firma na Biuro nie zmienia numeracji ani historii. Różnice między planami są w cenniku programu do fakturowania.