Skip to content

ksefuj/awesome-ksef

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Awesome KSeF Awesome

Zbiór narzędzi, bibliotek i zasobów dla polskiego Krajowego Systemu e-Faktur (KSeF).

A curated list of tools, libraries, and resources for Poland's mandatory e-invoicing system (KSeF).

Contents

Oficjalne zasoby

  • Aplikacja Podatnika KSeF 2.0 - Oficjalna webowa aplikacja Ministerstwa Finansów do wystawiania, odbierania i przeglądania faktur ustrukturyzowanych FA(3).
  • Aplikacja mobilna KSeF 2.0 (Android) - Oficjalna aplikacja mobilna MF dla systemu Android do obsługi KSeF 2.0.
  • Aplikacja mobilna KSeF 2.0 (iOS) - Oficjalna aplikacja mobilna MF dla systemu iOS do obsługi KSeF 2.0.
  • e-mikrofirma - Oficjalna aplikacja MF dla mikroprzedsiębiorców i JDG, umożliwiająca wystawianie faktur w KSeF, ewidencję VAT i wysyłkę JPK.
  • Środowisko testowe KSeF 2.0 - Testowa wersja Aplikacji Podatnika KSeF 2.0 do weryfikacji integracji przed wdrożeniem produkcyjnym.
  • Portal dokumentacji KSeF - Oficjalny portal MF z dokumentacją, instrukcjami, materiałami szkoleniowymi i odpowiedziami na pytania dotyczące KSeF 2.0.
  • Schemat FA(3) XSD - Oficjalny schemat XSD struktury logicznej faktury FA(3), obowiązujący od 1 lutego 2026 r.

Walidatory

  • ksefuj.to - Darmowy walidator FA(3) działający w całości po stronie klienta (WebAssembly); weryfikuje zgodność z XSD oraz 42 regułami biznesowymi, obsługuje wiele plików jednocześnie, dostępny też jako pakiet npm i CLI. Open source (Apache 2.0).
  • ksefwalidator.pl - Przeglądarkowy walidator XML FA(3) działający po stronie klienta; sprawdza zgodność z XSD, poprawność NIP oraz status podatnika na Białej Liście. Darmowy.
  • naprawksef.pl - Walidator FA(3)/FA(2) z unikalną funkcją automatycznej naprawy najczęstszych błędów w strukturze XML faktury. Freemium (3 walidacje dziennie za darmo).
  • Sorgera KSeF Validator - Walidator FA(3) klasy enterprise z podświetlaniem błędów na poziomie linii XML i zaawansowanymi komunikatami diagnostycznymi. Darmowy.
  • fa3.site - Przeglądarkowy walidator FA(3) z podglądem wizualizacji faktury, zbudowany w React. Darmowy.
  • KSeF Assistant - Lokalny walidator XML z weryfikacją reguł biznesowych, sprawdzaniem NIP/IBAN i generowaniem raportów PDF. Freemium (10 walidacji miesięcznie za darmo).

Oprogramowanie do fakturowania

  • ProFak - Darmowy program do fakturowania dla mikroprzedsiębiorstw i JDG (Windows), obsługujący faktury VAT, JPK oraz integrację z KSeF 2.0. Darmowy.
  • KsefInvoice - Desktopowa aplikacja (Windows, Linux) do wystawiania faktur z integracją KSeF, weryfikacją kontrahentów i lokalnym przechowywaniem danych. Darmowy.
  • KSeFka - Desktopowa aplikacja (Windows, macOS, Linux) do fakturowania z pełną integracją KSeF, generowaniem PDF i lokalnym przechowywaniem danych. Darmowy.
  • Ksefi - Webowy generator faktur ustrukturyzowanych XML FA(3) wspomagany przez AI, działający bez rejestracji. Darmowy.
  • OpenKSeF - Aplikacja webowa i mobilna do automatycznej synchronizacji faktur z KSeF, powiadamiania o nowych dokumentach i zarządzania fakturami zakupowymi; przeznaczona do samodzielnego hostowania. Source-available (Elastic License 2.0).

Narzędzia dla programistów

  • ksefuj/ksefuj - Monorepo projektu ksefuj.to: aplikacja webowa, pakiet npm @ksefuj/validator, CLI i inne narzędzia dla deweloperów integrujących KSeF. Open source (Apache 2.0).
  • @ksefuj/validator - Pakiet npm do programatycznej walidacji faktur FA(3) w Node.js i przeglądarce, z obsługą TypeScript i API strumieniowym. Open source (Apache 2.0).
npx @ksefuj/validator faktura.xml
  • KSeF-GUI - Fork kcksefcli z lokalnym interfejsem przeglądarkowym do pobierania faktur z KSeF, powiadomieniami (Slack, Teams, e-mail) i eksportem CSV; dostępny jako obraz Docker. Open source (GPL-3.0).
  • KSeFCLI (kcksefcli) - Narzędzie CLI (C#) z ponad 30 komendami do zarządzania fakturami, certyfikatami i sesjami w KSeF API; binaria dla Linux x64 i Windows. Open source (GPL-3.0).

Agent Skills

  • ksef-fa3 - Skill dla Claude Code do generowania i walidacji faktur FA(3); zawiera mapowanie schematu XSD, przykłady XML dla 7 scenariuszy (WDT, eksport, odwrotne obciążenie, zaliczki, korekty) oraz referencję wszystkich 42 reguł semantycznych. Open source (Apache 2.0).

Monitory i narzędzia pomocnicze

  • KSeF Invoice Monitor - Serwis Python/Docker do cyklicznego monitorowania faktur w KSeF API v2 z powiadomieniami przez 5 kanałów (Pushover, Discord, Slack, e-mail, webhook), generowaniem PDF i eksportem metryk Prometheus. Open source (MIT).
  • Weryfikator Kodów QR z KSeF - Kliencka aplikacja webowa do weryfikacji kodów QR z e-faktur KSeF przez kamerę lub wgranie pliku graficznego; działa w całości po stronie przeglądarki. Darmowy.

Konwertery

  • Wizualizator e-Faktur (XML→PDF) - Kliencka aplikacja webowa do generowania wizualizacji e-faktury z pliku XML do formatu PDF/A-3 z osadzonym XML; dane nie są przesyłane na serwer. Open source (GPL-3.0). Demo
  • Pobieracz e-Faktur (PDF→XML) - Kliencka aplikacja webowa do pobierania pliku XML e-faktury z KSeF na podstawie kodu QR odczytanego z wizualizacji PDF; działa po stronie przeglądarki. Open source (GPL-3.0). Demo

Zasoby edukacyjne

Contributing

Przeczytaj contributing.md przed dodaniem wpisu. Jeden wpis na PR, tylko aktywnie utrzymywane narzędzia.

Read contributing.md before submitting. One entry per PR, actively maintained tools only.

Footnotes

CC0

Na tyle, na ile pozwala prawo, autorzy zrzekają się wszelkich praw autorskich i pokrewnych do tej listy.