Jak zintegrować KSeF z programem do faktur i ERP (Subiekt GT, Fakturownia, wFirma, Comarch Optima bez przepisywania danych)

Zanim ktokolwiek zapyta mnie, jakiego narzędzia użyć do integracji z KSeF, zadaję inne pytanie: ile faktur miesięcznie wystawiacie i odbieracie, i ile osób dziś ręcznie klika „wyślij" albo przepisuje dane z PDF-a do systemu księgowego. Bo odpowiedź na to pytanie decyduje o wszystkim, co dalej. Firma wystawiająca 40 faktur miesięcznie w Fakturowni nie potrzebuje tego samego rozwiązania co hurtownia na Comarch Optima z 3000 dokumentów sprzedażowych i zakupowych miesięcznie, gdzie część kontrahentów przysyła faktury zakupowe mailem, a część przez EDI.

W praktyce nie zmieniamy klientowi programu, w którym pracuje księgowość czy handlowcy od lat. To błąd, który widziałem wielokrotnie u firm próbujących „przy okazji KSeF" wdrożyć nowy ERP. Wychodzi to drożej, dłużej i frustruje ludzi, którzy mieli już opanowany stary system. Zamiast tego pytamy: co program już potrafi wysłać do KSeF sam, a czego nie potrafi i trzeba dopiąć z boku.

Dwie drogi integracji i kiedy wybrać którą

Są dwie ścieżki i obie mają sens, tylko w różnych sytuacjach. Pierwsza to poleganie na natywnym wsparciu KSeF, jeśli program je ma i jest wystarczające do skali firmy. Druga to warstwa integracyjna, najczęściej oparta o n8n albo Make, która łączy się z API KSeF niezależnie od tego, co robi program księgowy, i uzupełnia luki: automatyczne pobieranie faktur zakupowych, masową wysyłkę korekt, powiadomienia o odrzuceniach.

Widziałem firmy, które wybrały drugą drogę tylko dlatego, że brzmiała nowocześniej, mimo że natywny moduł w ich programie w zupełności wystarczał. To niepotrzebny koszt utrzymania. Ale widziałem też odwrotnie: klientów przekonanych, że wystarczy „włączyć KSeF" w Subiekcie, którzy po miesiącu odkrywali, że nikt w firmie nie ogarnia ręcznie 200 odrzuconych faktur zakupowych od kontrahentów z błędnym NIP-em.

Jak to wygląda w konkretnych programach

Subiekt GT (InsERT)

Subiekt GT ma wsparcie KSeF realizowane przez dodatek producenta, zintegrowany z modułem sprzedaży. Działa dobrze przy standardowych fakturach sprzedażowych wystawianych bezpośrednio w programie. Problem pojawia się tam, gdzie firma ma dodatkowe źródła danych sprzedażowych spoza Subiekta, np. sklep internetowy albo integrację z platformą marketplace. Wtedy dopinamy warstwę, która zbiera dane z tych źródeł, tworzy dokument w Subiekcie przez jego API i dopiero stamtąd trafia on do KSeF natywnym kanałem. Nie duplikujemy wysyłki do KSeF, tylko porządkujemy to, co wchodzi do Subiekta.

Fakturownia

Fakturownia ma jedno z lepiej rozwiniętych wsparć KSeF wśród programów dla mniejszych firm, włącznie z automatycznym pobieraniem faktur zakupowych z systemu. Dla firm do kilkuset dokumentów miesięcznie to zwykle wystarcza bez żadnej dodatkowej integracji. Tam, gdzie dokładamy automatyzację, to zwykle nie sam KSeF, tylko to, co dzieje się z fakturą później: automatyczne przypisanie kosztu do odpowiedniej kategorii w księgowości, powiadomienie księgowej o nowej fakturze zakupowej przekraczającej określoną kwotę, albo eksport do arkusza do rozliczeń z klientem.

wFirma

Podobnie jak Fakturownia, wFirma rozwija własną obsługę KSeF w ramach systemu. Miejsce na integrację pojawia się, gdy firma korzysta z wFirmy jako głównego narzędzia księgowego, ale sprzedaż idzie z kilku kanałów jednocześnie, np. Allegro, własny sklep i sprzedaż B2B poza platformą. Wtedy scalanie zamówień i wystawianie faktur trzeba zautomatyzować przed KSeF, a nie próbować to obejść integracją samego KSeF.

Comarch Optima

Optima to inna liga skali. Ma moduł KSeF, ale przy dużym wolumenie i firmach z rozbudowaną strukturą (kilka spółek, oddziały, różne stawki VAT) samo wysłanie faktury do KSeF to za mało. Potrzebne jest monitorowanie statusów w czasie rzeczywistym, automatyczne oznaczanie dokumentów odrzuconych i przekazanie ich do właściwej osoby, oraz archiwizacja UPO (Urzędowego Poświadczenia Odbioru) w sposób zgodny z wymogami przechowywania. Tu warstwa integracyjna oparta o API KSeF ma sens niemal zawsze, bo pozwala spiąć Optimę z systemem obiegu dokumentów albo z CRM bez czekania na kolejną wersję dodatku producenta.

Gdzie zostawiamy decyzję człowiekowi

Automatyzacja KSeF potrafi ogarnąć zdecydowaną większość ruchu bez udziału człowieka: wysyłkę standardowej faktury sprzedażowej, pobranie faktury zakupowej i jej wstępną kategoryzację, generowanie i archiwizację UPO. Ale są miejsca, gdzie automat powinien się zatrzymać i poprosić o decyzję, a nie zgadywać.

Korekty to pierwszy taki obszar. Faktura korygująca w KSeF wymaga powiązania z dokumentem pierwotnym i często zmiany w kilku miejscach naraz (kwota, opis, czasem kontrahent). Automat może przygotować taką korektę na podstawie reguł, ale ostateczne zatwierdzenie zostawiamy osobie z księgowości, bo błąd w korekcie generuje kolejną korektę, a to psuje zaufanie do całego procesu.

Drugi obszar to błędne dane kontrahenta, głównie NIP niezgodny z rejestrem albo brak numeru w ogóle przy sprzedaży do konsumenta. System powinien to wychwycić i zablokować wysyłkę zamiast próbować „na siłę" przepchnąć fakturę do KSeF, bo odrzucenie na poziomie API generuje więcej pracy niż zatrzymanie dokumentu wcześniej. Trzeci obszar to sytuacje nietypowe: faktury zbiorcze za dłuższy okres, faktury w walucie obcej z przeliczeniem po kursie z dnia poprzedzającego, transakcje wewnątrzwspólnotowe. Tu reguły automatyzacji trzeba budować bardzo precyzyjnie i testować na realnych przykładach, zanim się je uruchomi produkcyjnie.

Dobrze zaprojektowana integracja z KSeF nie próbuje wyeliminować człowieka całkowicie. Próbuje zredukować liczbę dokumentów, które w ogóle do niego trafiają, z kilkuset dziennie do kilku wyjątków tygodniowo. To jest realistyczny cel i widziałem go osiągalny nawet w firmach, które na starcie były przekonane, że ich proces jest zbyt skomplikany do automatyzacji.

Terminy KSeF 2026 i dlaczego kolejność ma znaczenie

Obowiązek korzystania z KSeF wchodzi etapami w 2026 roku, zgodnie z harmonogramem publikowanym przez Ministerstwo Finansów na gov.pl. Duzi podatnicy wchodzą jako pierwsi, pozostali przedsiębiorcy nieco później w tym samym roku. Dokładne daty i progi warto śledzić bezpośrednio w komunikatach MF, bo terminy były już raz przesuwane i mogą się jeszcze precyzować w rozporządzeniach wykonawczych.

To, co widzę jako powtarzający się błąd, to podejście „poczekamy do ostatniego kwartału przed swoim terminem". Integracja z KSeF, nawet ta oparta o natywne wsparcie programu, wymaga testów na realnych fakturach, sprawdzenia obsługi korekt, przetestowania scenariuszy odrzuceń i ustalenia procedury na wypadek awarii systemu KSeF (bo tryb offline i awaryjny też trzeba mieć rozpisany). Zrobienie tego w tydzień przed wejściem obowiązku kończy się chaosem operacyjnym w pierwszym miesiącu, czyli dokładnie wtedy, gdy firma najbardziej potrzebuje płynności w wystawianiu faktur.

Firmy korzystające z zewnętrznego biura rachunkowego mają dodatkowe pytanie do rozwiązania: kto technicznie wysyła fakturę do KSeF, kto ma dostęp do tokenu i jak wygląda przekazywanie UPO z powrotem do systemu klienta. To temat, który warto ustalić zanim zacznie się testować samą integrację, bo od tego zależy architektura całego rozwiązania. Więcej o tym, jak to układamy w praktyce, piszemy przy okazji automatyzacji biura rachunkowego, bo tam KSeF to tylko jeden z elementów większego procesu obiegu dokumentów.

Jeśli dopiero zaczynacie porządkować obieg faktur przed KSeF, warto najpierw spojrzeć szerzej niż na samą integrację z API. Sensowniejsze bywa uporządkowanie całego procesu wystawiania i księgowania faktur, a dopiero potem dołożenie warstwy KSeF, bo wtedy integracja staje się naturalnym elementem gotowego procesu, a nie łatą na chaos. Piszemy o tym więcej przy automatyzacji obiegu faktur.