Przemysław Zalewski

Dla firm, które fakturują w Polsce

KSeF w Twoim systemie, obok programu księgowego

Faktury wychodzą z Twojego systemu: OMS‑a, CRM‑a, SaaS‑a, może zbudowanego z AI. Od 2026 roku muszą przechodzić przez KSeF. Dodaję do tego systemu wysyłkę i odbiór, najpierw testuję na środowisku testowym KSeF i utrzymuję to, gdy zmienia się schemat albo API.

Zobacz cenę i termin → Umów bezpłatne 30 minut

Godzinowo 150⁠–⁠220 zł/h netto. Integracja trwa zwykle od jednego do trzech tygodni. Szczegóły w konfiguratorze →

Przemysław Zalewski

Brzmi znajomo?

Problemy z integracją KSeF, które rozwiązuję w 2026

Dlaczego KSeF zwraca błąd 429 przy wysyłce faktur?

W KSeF 2.0 sesja interaktywna przyjmuje najwyżej 180 wysyłek faktur na godzinę na kontekst i adres IP; przekroczenie kończy się błędem 429 z nagłówkiem Retry-After, a powtarzane przekroczenia mogą znacznie wydłużyć blokadę (limity API KSeF).

Większe wolumeny wysyłam w trybie wsadowym, wysyłkę stawiam za kolejką respektującą Retry-After, a gdy skala to uzasadnia, przygotowuję wniosek o wyższe limity, który Ministerstwo przyjmuje od integratorów od lutego 2026.

Nasza integracja z KSeF przestała działać w lutym 2026

Tokenów wygenerowanych dla KSeF 1.0 nie da się użyć w KSeF 2.0 i nie zostały przeniesione, co Ministerstwo ogłosiło 4 grudnia 2025 (KSeF). Integracja ze starym tokenem po prostu się nie zaloguje.

Przepinam integrację na API KSeF 2.0 z nowym tokenem albo certyfikatem, testuję ją na środowisku testowym KSeF na danych testowych i dopiero wtedy przełączam produkcję na Twoich kontach.

Masz to u siebie? Umów bezpłatne 30 minut →

Jak automatycznie pobierać faktury zakupowe z KSeF?

Od 1 lutego 2026 faktury otrzymuje się przez KSeF, a KSeF nie wysyła powiadomień, więc do Twojego systemu nic nie trafi, jeśli sam o to nie zapyta (pytania i odpowiedzi KSeF).

Dodaję przyrostowe pobieranie opisane przez Ministerstwo: okna eksportu, z których każde zaczyna się tam, gdzie skończyło się poprzednie, usuwanie duplikatów po numerze KSeF i zapis każdej faktury zakupowej w Twoim systemie razem z jej numerem KSeF.

KSeF odrzucił fakturę FA(3) z błędem schematu

Struktura FA(3) obowiązuje od 1 lutego 2026, a KSeF odrzuca fakturę niezgodną z nią, także gdy wypełniona sekcja opcjonalna nie ma pola obowiązkowego (KSeF dla integratorów).

Sprawdzam każdą fakturę oficjalnym schematem, zanim wyjdzie z Twojego systemu, tak samo jak robi to w przeglądarce mój darmowy walidator faktury KSeF, a błędy zamieniam na komunikaty, z którymi zespół wie, co zrobić.

Masz jeden z tych problemów? Umów bezpłatne 30 minut →

Zakres

Co obejmuje integracja

Wysyłka faktur FA(3)

Faktury generowane przez Twój system, sprawdzone oficjalnym schematem, zanim wyjdą.

UPO i numery KSeF

Potwierdzenia odebrane i zapisane przy każdej fakturze w Twoim systemie.

Odbiór faktur

Faktury zakupowe pobierane z KSeF do Twojego systemu, jeśli chcesz je tam mieć.

Korekty i tryb offline

Faktury korygujące i procedury offline, żeby awaria KSeF nie zatrzymała sprzedaży.

Proces

Jak to wygląda

  1. Krótka rozmowa

    Który system wystawia faktury, jakie rodzaje faktur, ile miesięcznie.

  2. Od jednego do trzech tygodni

    Integracja przetestowana na środowisku testowym KSeF na danych testowych.

  3. Produkcja

    Przełączenie na produkcję z Twoim certyfikatem albo tokenem, na Twoich kontach.

  4. Stała opieka

    Opcjonalna miesięczna opieka nad zmianami schematu i API, które ministerstwo ogłasza w changelogu.

Co mogę połączyć

  • Twój własny OMS, CRM albo SaaS, także apki zbudowane z AI.
  • Starsze systemy desktopowe z bazą albo API, z których da się czytać faktury.
  • Systemy firm zagranicznych sprzedających w Polsce, z dokumentacją po angielsku.

Doświadczenie

Dowody

Zbudowałem darmowy walidator faktury KSeF: sprawdza fakturę FA(3) oficjalnym schematem w przeglądarce i tłumaczy błędy zwykłymi słowami. Wrzuć do niego jedną swoją fakturę, zanim porozmawiamy.

Platforma list supresji: od MVP do produktu, 300+ GB na produkcji

Problem
Brytyjski wydawca mailingowy potrzebował list supresji gotowych na skalę terabajtów, z zapisem w stałym czasie i wdrożeniami bez przestoju.
Co zrobiłem
Prowadziłem mały zespół od MVP do pełnej platformy. Partycjonowanie Postgresa po tenancie i liście, równoległe pipeline’y żądań, wdrożenia blue/green. Wypisanie jednym kliknięciem wyszło cztery miesiące przed ogłoszeniem wymogu przez Google i Yahoo.
Efekt
300+ GB i miliony zdarzeń na produkcji, wdrożenia bez przestoju, ścieżka wypisu działająca przy celowo wyłączonym backendzie i funkcja compliance gotowa, zanim powstał termin. W sierpniu 2026 znalazłem osierocone partycje tabel po usuniętych kontach i demach sprzedażowych, zatrzymałem ich przyrost i odzyskałem około 140 GB.

300+ GB wypis odporny na awarię blue/green

Zobacz też: TypeScript i Node.js · Full‑stack i custom software

Zarządzanie zadaniami back-office: lead czwórki, bez product managera

Problem
Narzędzie back-office potrzebowało nowych funkcji, odświeżenia UI i szybszego pipeline’u, bez product managera na horyzoncie.
Co zrobiłem
Prowadziłem czterech inżynierów i dalej kodowałem. Trunk-based development z CI/CD, aktualizacje na żywo przez server-sent events, zatrzymana równoległa inicjatywa, która wedle analizy by się nie zwróciła, priorytety ustalane wprost z kierownikami działów. Ankieta wśród 100+ operatorów narzędzia oceniła zmiany jako wyraźną poprawę.
Efekt
„Measurable changes in some key metrics” i „a true bias for action” w publicznej rekomendacji na LinkedInie od mojego przełożonego w tym projekcie, dziś CTO.

zespół 4 rekomendacja przełożonego

Zobacz też: Full‑stack i custom software

Agent AI jako członek zespołu, pod wymuszonymi regułami

Problem
Agenci kodujący piszą kod szybciej, niż zespół zdąży go przejrzeć. Czteroosobowy zespół chciał tempa bez bagna na mainie.
Co zrobiłem
Napisałem zestaw reguł wspólny dla Claude Code i Codexa: mechaniczne kontrole zamiast spisanych zasad, bramki lint i testów dla bezpieczeństwa, powierzchni API i CSP, agenci na mainie z hookami, każdy PR przejrzany przez człowieka, treści z AI jawnie oznaczone.
Efekt
W 2026 około dwóch trzecich zmergowanych PR w dwóch produktach powstało z agentami, a prawie wszystkie przeszły przez mój review albo merge. Zmergowałem 260+ własnych PR i zrobiłem review 300+ cudzych. Mój własny wynik w tych dwóch produktach urósł z poniżej 1000 commitów w 2025 do 7500+ do października 2026.

~2/3 PR z agentami 300+ review 7500+ commitów w 2026

Zobacz też: AI i agenci · Full‑stack i custom software

Oferta: AI engineer do Twojego zespołu (Node.js, agenci LLM)

Chcesz znać kwotę przed rozmową?

Godzinowo 150⁠–⁠220 zł/h netto. Integracja trwa zwykle od jednego do trzech tygodni.

Zobacz cenę i termin → Umów bezpłatne 30 minut

Warto wiedzieć

Szczegóły KSeF, które integracje robią źle

Kary: do 100 procent VAT

Ustawa o VAT przewiduje karę do 100 procent podatku z faktury wystawionej poza KSeF albo do 18,7 procent kwoty brutto, gdy faktura nie wykazuje VAT, od 1 stycznia 2027 (ustawa o VAT, art. 106ni).

Projekt przesuwa kary na koniec 2027

20 października 2026 rząd przyjął projekt odraczający kary do końca 2027. Musi jeszcze przejść przez Sejm, a obowiązek KSeF zostaje tak czy inaczej (Ministerstwo Finansów).

Numer KSeF w tytule przelewu

Od 1 stycznia 2027 czynny podatnik VAT płacący przelewem za fakturę z KSeF musi podać jej numer KSeF, więc Twój system musi go pokazać płacącemu (ustawa o VAT, art. 108g, KSeF).

Przekroczenie 10 tys. zł przełącza na stałe

Miesięczne zwolnienie do 10 tys. zł kończy się 31 grudnia 2026. Faktura, która przekroczy limit, i wszystkie kolejne idą przez KSeF, nawet gdy następny miesiąc jest niższy (KSeF).

Faktura offline ma dwa kody QR

Faktura offline jeszcze nie w KSeF ma kod „OFFLINE” i kod „CERTYFIKAT”. Drugi wymaga osobnego certyfikatu typu 2 (KSeF dla integratorów, certyfikaty KSeF).

Certyfikat żyje najwyżej 2 lata

Certyfikaty KSeF są ważne do 2 lat, a typy do logowania i do trybu offline wydaje się osobno, więc każda integracja ma datę odnowienia (certyfikaty KSeF).

FAQ

Pytania

Od kiedy KSeF jest obowiązkowy?
Według Ministerstwa Finansów od 1 lutego 2026 r. dla firm, które w 2024 r. miały sprzedaż powyżej 200 mln zł, a od 1 kwietnia 2026 r. dla pozostałych.
Nasz program księgowy już obsługuje KSeF. Czy to nam potrzebne?
Tylko jeśli faktury powstają poza nim, w Waszym własnym systemie. Wtedy ten system musi je wysłać albo niezawodnie przekazać do programu księgowego.
Czy potrzebujesz dostępu do naszej produkcji?
Na początku nie. Wszystko powstaje i jest testowane na środowisku testowym KSeF na danych testowych. Na produkcji certyfikat albo token jest wystawiony na Twoją firmę i zostaje w Waszych systemach, więc dostęp kończy się, gdy go unieważnisz.
Ile to trwa?
Zwykle od jednego do trzech tygodni, zależnie od systemu i rodzajów faktur.
Co, gdy zmieni się schemat albo API?
Od tego jest opcjonalna stała opieka: śledzę changelog ministerstwa, aktualizuję integrację i testuję ją na środowisku testowym KSeF, zanim trafi na produkcję. To opieka, a nie dyżur z SLA; powody opisuję na stronie jak pracuję.
Ile to kosztuje?
Godzinowo, 150 do 220 zł netto, a integracja trwa zwykle od jednego do trzech tygodni. Konfigurator pokaże widełki i termin startu przed rozmową, a po rozmowie w 24 godziny dostajesz zakres i cenę na piśmie.
Czy w 2027 będą kary za KSeF?
Obecne przepisy mówią, że tak, od 1 stycznia 2027 (ustawa o VAT). Rządowy projekt z 20 października 2026 przesuwa je na koniec 2027, a obowiązek KSeF zostaje tak czy inaczej (Ministerstwo Finansów).
Co z fakturami, gdy KSeF nie działa?
Wystawia się je offline z dwoma kodami QR i dosyła później: w trybie offline24 do następnego dnia roboczego, a po awarii ogłoszonej przez Ministerstwo w ciągu 7 dni roboczych (KSeF dla integratorów).
Czy faktury dla klientów spoza UE idą przez KSeF?
Tak. Wystawia się je w KSeF i przekazuje nabywcy w ustalony sposób, na przykład jako PDF z kodem QR (KSeF).
Dlaczego KSeF zwraca błąd 429 przy wysyłce faktur?
W KSeF 2.0 sesja interaktywna przyjmuje najwyżej 180 wysyłek faktur na godzinę na kontekst i adres IP; przekroczenie kończy się błędem 429 z nagłówkiem Retry-After, a powtarzane przekroczenia mogą znacznie wydłużyć blokadę (limity API KSeF). Większe wolumeny wysyłam w trybie wsadowym, wysyłkę stawiam za kolejką respektującą Retry-After, a gdy skala to uzasadnia, przygotowuję wniosek o wyższe limity, który Ministerstwo przyjmuje od integratorów od lutego 2026.

W 30 minut sprawdzisz, czy do siebie pasujemy

Ty przynosisz problem, ja pytania. Chcesz najpierw liczbę? Konfigurator pokaże godziny, widełki ceny i termin startu.

Umów bezpłatne 30 minut Wolę napisać maila

albo napisz na ciunkos@gmail.com

Po umówieniu dostajesz zaproszenie do kalendarza. Nic więcej do wypełniania.

Moja obietnica

  • Odpowiedź w 24 godziny. Odpowiadam w ciągu 24 godzin w dni robocze. Osobiście, nie bot. Wiadomości z weekendu: do poniedziałku, do 12:00.
  • Spóźnienie znaczy gratis. Jeśli się spóźnię, pierwsza godzina pracy jest za darmo. Nie musisz o to prosić.
  • Zakres na piśmie w 24 godziny. Bezpłatna rozmowa 30 minut bez prezentacji firmy, potem zakres i cena na piśmie w ciągu 24 godzin. Ty decydujesz.
  • Osoba, która wykona pracę. Rozmawiasz z osobą, która wykona pracę. Bez warstwy sprzedaży, bez przekazywania dalej.
  • Odzywam się tylko z czymś nowym. Odzywam się tylko wtedy, gdy mam dla Ciebie coś nowego. Nigdy „czy jest już decyzja?”.
  • Uczciwe „to nie dla mnie”. Jeśli nie jestem właściwą osobą, mówię to na rozmowie i wskazuję kogoś, kto jest.

Rozmowy w tym tygodniu · start od zaraz · Kontrakt B2B · Wrocław, zdalnie

Kod, domena i konta są Twoje od pierwszego dnia. Nic nie trzymam jako zakładnika.