Grzegorz Giewon · UnitSoftware

Grzegorz Giewon · UnitSoftware

Wdrażacie SAP-a. Zostaje kawałek, którego SAP nie udźwignie.

Buduję to, czego nie da się zrobić w samym systemie — bo wersja jest za stara, bo funkcji nie ma w standardzie, bo termin jest na wczoraj. Satelita w .NET, która to domyka: KSeF, JPK, podpis XAdES, wizualizacja dokumentów. Pracuję jako podwykonawca — wdrożenie i relacja z klientem zostają po Waszej stronie.

Obowiązek KSeF
czynny — od i
Okres przejściowy
kary zawieszone do
Typowa integracja
4–6 tygodni od analizy do produkcji
Model pracy
podwykonawstwo dla partnerów wdrożeniowych
Dostępność
stała pula 10–15 h tygodniowo · zdalnie · B2B

Dla kogo

Przede wszystkim dla firm, które wdrażają cudze systemy i trafiają na ścianę:

  • wdrażacie SAP-a albo inny duży ERP, klient wymaga KSeF lub JPK, a wersja systemu tego nie unosi i podniesienie jej nie wchodzi w grę w tym projekcie
  • w standardzie nie ma tego, co trzeba dostarczyć — podpisu XAdES, wizualizacji dokumentu, kodów QR — i nie chcecie budować tego u siebie od zera
  • potrzebujecie komponentu, który wpina się w Wasze wdrożenie i który możecie dostarczyć klientowi jako część własnej oferty

Jak to wygląda w praktyce. Dostaję zakres, buduję to jako osobną usługę albo bibliotekę w .NET i oddaję z dokumentacją. Nie wchodzę między Was a klienta: wdrożenie, umowa i kontakt zostają po Waszej stronie. Jeśli wolicie, pracuję pod Waszą marką i klient nie musi wiedzieć, że mnie tam było. Zasady współpracy, zakres i rozliczenia →

Gdzie to już działa. Wszystkie narzędzia wymienione niżej powstały właśnie tak — na zlecenie partnerów wdrożeniowych, którzy dostarczają je dalej. Pracują dziś w polskich spółkach międzynarodowych grup przemysłowych: motoryzacja, opakowania, energetyka odnawialna, aparatura pomiarowa, elektronika.

Bez pośrednika też. Jeśli macie własne oprogramowanie — pisany na zamówienie ERP albo system magazynowy — i trzeba go podłączyć do KSeF, albo macie integrację, która wywala się przy każdej awarii API, zasada jest ta sama: pracuję na tym, co już macie.

Z czym nie pomogę: nie sprzedaję własnego programu do fakturowania i nie wdrażam gotowych systemów księgowych.

Czym to się różni od abonamentu

Nie płacisz od faktury

Pośrednicy i moduły KSeF w gotowych systemach rozliczają się licznikiem dokumentów: pakiet rośnie razem z liczbą faktur i płacisz go co miesiąc, dopóki wystawiasz. U mnie płacisz raz za zbudowanie integracji, a potem tylko za utrzymanie — jeśli go chcesz. Liczba faktur nie zmienia rachunku.

Kod, dokumentacja i pełne prawa autorskie przechodzą na Was na piśmie. Zostajecie na utrzymaniu albo idziecie dalej sami, także z innym wykonawcą — bez zamkniętego formatu i bez zależności od mojej infrastruktury po przekazaniu.

Faktury nie opuszczają Waszej infrastruktury

Integracja, którą buduję, stoi w Waszej sieci albo na Waszej chmurze i rozmawia z API KSeF bezpośrednio. W ścieżce dokumentu nie ma trzeciej strony: nie dochodzi podprocesor do rejestru czynności przetwarzania, nie trzeba umowy powierzenia z pośrednikiem, a dział bezpieczeństwa nie zatwierdza kolejnego dostawcy chmurowego.

Jeśli wolicie rozwiązanie hostowane, powiem to wprost na pierwszej rozmowie — nie każdy scenariusz wymaga budowania czegokolwiek u siebie.

Usługi

Integracja systemu z KSeF

Analizuję, jak Twój system wystawia i przyjmuje faktury, a potem podłączam go do KSeF: uwierzytelnienie, wysyłka faktur ustrukturyzowanych, odbiór od kontrahentów, obsługa numeru KSeF i kodów QR, podpis XAdES. Integracja jest odporna na to, co zawodzi najczęściej — timeouty, przerwy w dostępności API i błędy walidacji.

JPK i raportowanie do skarbówki

Generowanie i wysyłka jednolitych plików kontrolnych bezpośrednio z Twojego systemu, walidacja przed wysyłką i obsługa UPO. Bez eksportów do Excela i ręcznego wklejania w rządowe aplikacje.

Utrzymanie i modernizacja systemów .NET

Przejmuję opiekę nad oprogramowaniem po poprzednim wykonawcy i przenoszę starsze systemy — .NET Framework, WinForms, WCF — na aktualne wersje .NET. Etapami, przy działającej produkcji.

Narzędzia, które zbudowałem

Nie zaczynam od zera przy każdym wdrożeniu.

XRechnungKsefConnector

Konwersja faktur między XRechnung a KSeF w obie strony oraz wysyłka i odbiór dokumentów z KSeF: uwierzytelnienie, obsługa numeru KSeF.

XMLVisualizer

Podgląd plików JPK i faktur z KSeF w czytelnej formie, z eksportem do PDF, w wersji desktopowej i przeglądarkowej. Bez wizualizacji nikt w księgowości nie zweryfikuje XML-a.

XRechnungVisualizer

To samo dla faktur w standardzie XRechnung — podgląd i eksport do PDF.

JPK WysyłkaXML

Rozbudowana aplikacja do jednolitych plików kontrolnych: generowanie, walidacja, edycja zawartości pliku przed wysłaniem i wysyłka do bramki. Napisana na .NET 10.

WysylkaJPK

Wariant bez edytora, za to z automatyczną naprawą dokumentów: brakujące pola uzupełnia wartościami domyślnymi, zamiast odbijać plik na walidacji bramki.

NipService / WhiteListChecker

Weryfikacja NIP i rachunków bankowych na białej liście podatników VAT, wystawiona jako usługa REST, odporna na niedostępność rejestru.

RSAHelper

Podpis XAdES i operacje na kluczach, wymagane przy komunikacji z systemami skarbowymi.

Do sprawdzenia od ręki:XRechnungVisualizer działa w przeglądarce — wrzuć plik XRechnung (CII albo UBL) i zobacz, czy przechodzi walidację EN 16931, bez zakładania konta. Instrukcje i instalatory pozostałych narzędzi są na stronie Pliki do pobrania, też bez logowania.

Jak to działa

Integracja stoi obok Waszego systemu, nie w środku jego logiki fakturowania. ERP wystawia faktury dokładnie tak jak dziś.

Architektura integracji Wasz system przekazuje dokument do integracji. Integracja mapuje go na wymagany format, podpisuje i wysyła — fakturę do API KSeF, plik JPK do bramki Ministerstwa Finansów. Między integracją a każdym z tych API stoi kolejka z ponawianiem, więc awaria po stronie urzędu nie zatrzymuje wystawiania. Wasz systembez zmianIntegracjamapowanie FA(3)podpis XAdESwalidacjaAPI KSeFFA(3) · fakturyBramka MFJPK · e-Dokumentykolejka
Kolejka jest tą częścią, która decyduje na produkcji. API urzędowe bywają niedostępne, a dokument, którego nie da się w danej chwili wysłać, ma poczekać — nie wywalić się.

Całość działa w Waszej infrastrukturze. Strzałki na diagramie prowadzą z Waszego systemu wprost do API urzędu — nie ma po drodze mojego serwera ani żadnego pośrednika.

Jak to wygląda

Zrzuty z działających aplikacji. Dane na nich są testowe albo domyślne — nic, co należy do klientów.

JPK WysyłkaXML

Wersja webowa i desktopowa. Ta sama logika, dwa interfejsy — do wyboru zależnie od tego, jak pracuje księgowość.

Panel wersji webowej: stan plików, szybkie akcje i status lokalnej usługi podpisującej.
Panel wersji webowej: stan plików, szybkie akcje i status lokalnej usługi podpisującej.
Wysyłka w czterech krokach, z podpisem przez usługę lokalną albo narzędziem zewnętrznym.
Wysyłka w czterech krokach, z podpisem przez usługę lokalną albo narzędziem zewnętrznym.
Edytor JPK V7M — sekcje deklaracji i ewidencji, walidacja wskazuje braki przed wysłaniem.
Edytor JPK V7M — sekcje deklaracji i ewidencji, walidacja wskazuje braki przed wysłaniem.
Wersja desktopowa: wiersz sprzedaży ze znacznikami GTU, procedurami szczególnymi i polami K_.
Wersja desktopowa: wiersz sprzedaży ze znacznikami GTU, procedurami szczególnymi i polami K_.

WysylkaJPK

Bez edytora, za to z naprawą plików. Dla firm, które chcą wysłać, a nie poprawiać ręcznie.

Jeden ekran: wskaż plik, sprawdź i napraw, wyślij do bramki Ministerstwa Finansów.
Jeden ekran: wskaż plik, sprawdź i napraw, wyślij do bramki Ministerstwa Finansów.
Reguły naprawy: puste pole D_4 uzupełniane wartością stałą, daty spoza zakresu podmieniane na graniczne.
Reguły naprawy: puste pole D_4 uzupełniane wartością stałą, daty spoza zakresu podmieniane na graniczne.

Wizualizacja i usługi pomocnicze

Bez czytelnego podglądu nikt w księgowości nie zweryfikuje XML-a przed wysłaniem.

XMLVisualizer — podgląd i walidacja plików JPK oraz faktur z KSeF, konwersja do czytelnego HTML.
XMLVisualizer — podgląd i walidacja plików JPK oraz faktur z KSeF, konwersja do czytelnego HTML.
XRechnungVisualizer — formaty CII i UBL, walidacja zgodna z EN 16931, eksport do PDF.
XRechnungVisualizer — formaty CII i UBL, walidacja zgodna z EN 16931, eksport do PDF.
RSAHelper — podpis i certyfikaty KSeF, konwersja faktur do HTML i PDF, kody QR, walidacja XML.
RSAHelper — podpis i certyfikaty KSeF, konwersja faktur do HTML i PDF, kody QR, walidacja XML.

Technologie

Na co dzień.NET 8–10 · C# · ASP.NET Core (REST, OpenAPI) · Entity Framework Core · WPF · WinUI
E-fakturowanieKSeF · JPK · XRechnung · XAdES i podpis elektroniczny · XML/XSD · API systemów skarbowych
Interfejsy desktopoweDevExpress · Telerik · Syncfusion · CommunityToolkit MVVM · Prism
Jakość i utrzymanieNUnit / xUnit · NSubstitute · Playwright · Polly · NLog · Prometheus · CI/CD · testy architektury · SBOM
Systemy odziedziczone.NET Framework 3.5–4.8 · WCF · WinForms · migracje na .NET 8+

Jak pracujemy

1. Rozmowa (20 min). Mówisz, jak dziś wystawiacie faktury i w czym. Mówię, czy to robota na tydzień, czy na kwartał — i czy jestem właściwą osobą.

2. Analiza i wycena. Dostajesz na piśmie zakres, szacowany czas i sposób rozliczenia, zanim cokolwiek zaczniemy.

3. Wdrożenie etapami. Najpierw środowisko testowe, potem produkcja. Po każdym etapie działający efekt, postęp widoczny w systemie wsparcia.

4. Przekazanie. Kod, dokumentacja i pełne prawa autorskie są Twoje. Zostajesz na utrzymaniu albo idziesz dalej sam.

Częste pytania

Czy KSeF już obowiązuje?

Tak. Od 1 lutego 2026 dla firm z obrotem powyżej 200 mln zł, liczonym od obrotu brutto za 2024 rok, i od 1 kwietnia 2026 dla pozostałych. Do 31 grudnia 2026 trwa okres przejściowy: kary za niedostosowanie są zawieszone, a poza obowiązkiem zostają jeszcze faktury poniżej 450 zł brutto oraz podatnicy ze sprzedażą do 10 000 zł brutto miesięcznie. Oba wyłączenia wygasają z końcem roku. Od 1 stycznia 2027 zaczynają się kary — do 100% kwoty VAT z faktury wystawionej poza systemem — do zakresu wchodzą mikroprzedsiębiorcy, a numer KSeF trzeba podawać w tytule przelewu, również przy podzielonej płatności.

Integrowaliśmy się na początku 2026. Czy coś nam się zaraz zepsuje?

Możliwe. Schemat FA(2) został zastąpiony przez FA(3) 1 lutego 2026 — kto pisał integrację wcześniej, już to odczuł, a kto dopiero zaczyna, powinien budować od razu pod FA(3).

Czy muszę zmieniać system, żeby korzystać z KSeF?

Nie. KSeF komunikuje się przez API, więc w większości przypadków wystarczy dobudować integrację do systemu, którego już używacie.

Ile trwa integracja?

Przy typowym systemie firmowym 4–6 tygodni od analizy do produkcji. Największą niewiadomą jest zwykle nie KSeF, tylko stan kodu, do którego się podłączamy.

Co, jeśli KSeF przestanie odpowiadać?

To scenariusz, który trzeba założyć od początku. Integracje buduję z kolejkowaniem, ponawianiem i trybem awaryjnym, żeby niedostępność API nie zatrzymała wystawiania faktur.

Pracuję z oprogramowaniem od innego wykonawcy — podejmiesz się?

Tak, to znaczna część mojej pracy. Zaczynam od przeglądu kodu i wyceny; jeśli okaże się, że taniej i bezpieczniej będzie zrobić coś inaczej, powiem to wprost.

Jesteś jedną osobą. Co, jeśli przestaniesz być dostępny?

Pytanie jest uzasadnione i odpowiadam na nie tym, co robię od pierwszego dnia projektu, a nie deklaracją. Kod powstaje w Waszym repozytorium od początku, nie trafia do Was dopiero przy odbiorze. Prawa autorskie przechodzą na Was na piśmie. Integracja stoi na komponentach z publiczną dokumentacją — instrukcje są do pobrania z tej strony bez logowania, więc możecie z góry sprawdzić, czy są zrozumiałe dla kogoś z zewnątrz. Nie ma zamkniętego formatu ani zależności od mojej infrastruktury po przekazaniu. W najgorszym scenariuszu zostaje Wam działający kod w .NET, który przejmie inny programista — a nie usługa, która wygasa razem z umową.

Porozmawiajmy o Twoich fakturach

Dwadzieścia minut, bez zobowiązań. Powiedz, w czym wystawiacie faktury — resztę ustalimy.

Wiesz już, czego potrzebujesz? Umów godzinną konsultację techniczną — przegląd kodu, projekt integracji albo rozbiórka konkretnego problemu, który blokuje wdrożenie.

Obecni klienci: instalatory, wersje pod Wasze wdrożenie i dokumentacja czekają w strefie klienta. Logowanie kodem wysyłanym na Wasz adres e-mail — bez zakładania konta i bez hasła do zapamiętania. Dostęp nadaję na adresy, które mi wskażecie; każdy widzi wyłącznie swoje pliki.

Zgłoszenia serwisowe: support@unitsoftware.com.pl