Cyklicznie pobiera faktury z KSeF, przyjmuje PDF-y mailem, kategoryzuje je ML-em, wykrywa duplikaty i przekazuje czyste dane Twojej księgowej — albo Twojemu dashboardowi przez API. Hostuj u siebie albo pozwól nam to zrobić za Ciebie.
Od 2026 roku każda polska firma musi pobierać faktury z Krajowego Systemu e-Faktur (KSeF), dopasowywać je do PDF-ów, które wciąż przychodzą mailem, i przekazywać cały ten bałagan księgowej. Robienie tego ręcznie przez portal rządowy to codzienny podatek od Twojego czasu.
KSeF Hub to brakująca warstwa operacyjna: porządny interfejs, REST API, ML uczący się Twoich kategorii i uprawnienia dla ludzi, którzy pomagają Ci prowadzić firmę. Open source, więc możesz audytować, forkować albo uruchomić u siebie — albo korzystać z wersji zarządzanej, jeśli wolisz.
Od zaciągnięcia po eksport. Każdy element działa osobno; razem zastępują schemat arkusz-plus-mail, który prowadzi dziś większość firm.
Zaplanowane pobieranie z rządowego systemu e-faktur. Certyfikat pozostaje na Twoim serwerze — żadnych logowań w przeglądarce ani wygasłych sesji.
Dodaj dowolną liczbę NIP-ów. Panel przełącza kontekst jednym kliknięciem — bez osobnych logowań dla każdego podmiotu.
Prześlij fakturę-wydatek na firmową skrzynkę. Wyciągamy NIP, kwoty i daty OCR-em i wrzucamy ją do tego samego rejestru, co wiersze z KSeF.
Modele uczą się na korektach Twojej firmy, a nie na globalnym zbiorze. Przewidywania z pewnością ≥80% stosują się automatycznie; poniżej — trafiają do weryfikacji. Nigdy nie przewidują kategorii, której nie ma na Twojej liście.
KSeF wystawia korekty jako osobne dokumenty. Każda jest modelowana z linkiem do oryginału, powodem i okresem, którego dotyczy — jedna oś czasu, a nie dwa niepowiązane wiersze.
Faktury z KSeF pozostają oczekujące do momentu zatwierdzenia przez człowieka. Faktury od członków zespołu z kompletną ekstrakcją mogą być zatwierdzane automatycznie — opcja do włączenia per firma. Każdy wiersz jest oczekujący, zatwierdzony, odrzucony albo wyłączony (zachowany do audytu, poza księgami).
Eksport plików CSV w formacie polskiego przelewu bankowego (rachunek_zleceniodawcy) z zatwierdzonych wydatków. Wiele walut, konta bankowe per firma, masowy wybór wielu dostawców. Oznaczaj jako zapłacone hurtowo — rejestr aktualizuje się atomowo.
Wgraj raz, data wygaśnięcia śledzona, przypomnienia o odnowieniu. Przechowywane w formie zaszyfrowanej na Twoim serwerze, nigdy w chmurze trzeciej strony.
Ograniczony odczyt i eksport. Twoja księgowa pobiera miesięczne paczki bezpośrednio — koniec z zipami w mailu.
Udostępnij pojedynczy wiersz osobie zainteresowanej, nie pokazując reszty. Zatwierdzający, edytujący, przeglądający — cofnij dostęp jednym kliknięciem.
Kto synchronizował, kto zatwierdził, kto eksportował, kto zmienił kategorię. Każda akcja ma znacznik czasu i przypisanego autora.
Każdy wiersz ma endpoint. Wepnij w swój stack BI, uruchamiaj własne workflow przy nowych zatwierdzeniach albo zbuduj własny UI.
Wiersze z KSeF, PDF-y z maila i ręczne faktury zagraniczne — wszystko trafia do tej samej tabeli z tymi samymi polami. Źródła oznaczone jedną kropką, żeby było widać odchylenia bez zaglądania do legendy.
| Numer | Sprzedawca | Data | Kwota | Status |
|---|---|---|---|---|
| FV/2026/04/118 | Orange Polska | 18 Apr | 1,427.00 / 1,160.16 | zatwierdzona |
| inv-ff3d1b | Cloudflare Inc. | 17 Apr | 820.00 / 820.00 | oczekująca |
| 2026-04-17-002 | Grupa Maspex | 17 Apr | 314.00 / 255.28 | duplikat |
| FV/2026/04/071 | Linear, Inc. | 14 Apr | 960.00 / 780.49 | zatwierdzona |
| API-2026-0042 | Stripe Payments | 12 Apr | 42.00 / 42.00 | wyłączona |
Czytaj faktury, wywołuj synchronizacje, oznaczaj płatności, subskrybuj zdarzenia. Wszystko, co robi panel administracyjny, jest dostępne po HTTP.
# Pobierz zatwierdzone wydatki z tego miesiąca dla jednego NIP-u
curl https://ksef-hub.local/v1/invoices \
-H "Authorization: Bearer $KSH_TOKEN" \
-G -d "company=5252344078" \
-d "status=approved" \
-d "type=expense" \
-d "date_from=2026-04-01"
# ->
{
"data": [
{ "number": "FV/2026/04/118",
"seller": "Orange Polska",
"brutto": 1427.00,
"category": "telecom",
"confidence": 0.94 }
],
"page": { "next": "cursor=inv_5f1b" }
}
KSeF Hub jest na licencji AGPL-3.0. Przeczytaj każdą linijkę, sprawdź każdą migrację, uruchom we własnej serwerowni. Jeśli coś ulepszysz, wyślij upstream — albo sforkuj i wypuść własną wersję.
Copyleft. Używaj, hostuj u siebie — jeśli oferujesz to jako usługę, Twoje modyfikacje wracają do społeczności.
Serwer BEAM. Obsługuje tysiące synchronizacji równolegle na jednej małej maszynie. Nudna, sprawdzona technologia.
Jeden .env, jeden kontener na usługę. Postgres, Oban, aplikacja Phoenix, worker OCR. Reverse proxy przynieś własny.
Zgłoszenia, RFC i cotygodniowe otwarte spotkanie. Zbudowane przez założycieli, którzy woleliby nigdy więcej nie dotykać portalu rządowego.
Ten sam kod, te same funkcje. Wybierz, ile pracy chcesz wziąć na siebie.
KSeF (Krajowy System e-Faktur) to rządowy system e-faktur w Polsce. Od 2026 roku każda zarejestrowana firma musi wystawiać i odbierać faktury przez KSeF. KSeF Hub jest warstwą operacyjną na tym systemie — Twój zespół nie musi już dotykać portalu rządowego.
Tak. KSeF Hub jest na licencji AGPL-3.0 i dostarczany jako stack docker compose: Postgres, aplikacja Phoenix i kilka sidecarów. Przynieś własny reverse proxy i ruszasz w niecałą godzinę. Dostępna jest też wersja zarządzana, jeśli wolisz nie prowadzić tego sam.
Certyfikaty osobowe (powiązane z PESEL) i firmowe (NIP). Każdy certyfikat jest przypisany do użytkownika, więc jeden wgrany certyfikat uwierzytelnia sesje KSeF dla wszystkich firm, do których użytkownik ma dostęp. Certyfikaty są szyfrowane w spoczynku na Twoim serwerze — nigdy w chmurze trzeciej strony.
Tak. KSeF Hub modeluje pełną taksonomię faktur KSeF: standardowe, korygujące, zaliczkowe, uproszczone i rozliczeniowe. Faktury korygujące są powiązane z oryginałami wraz z powodem i okresem, którego dotyczą — jedna oś czasu, a nie dwa niepowiązane wiersze.
Modele uczą się na korektach Twojej firmy, a nie na globalnym zbiorze. Przewidywania z pewnością ≥80% stosują się automatycznie; poniżej — trafiają do weryfikacji. Model nigdy nie przewidzi kategorii, której nie ma na Twojej liście.
Tak. Każdy wiersz w rejestrze jest dostępny po HTTP. Endpointy do czytania faktur, wywoływania synchronizacji, zatwierdzania płatności, plus webhooki dla invoice.created, invoice.approved i sync.failed. Autoryzacja przez Bearer token.
Sklonuj repo, uruchom kontener, podłącz certyfikat KSeF. Twój rejestr działa w niecałą godzinę.