ksef-cli

ksef-cli

Tekstowy klient wiersza poleceń dla Krajowego Systemu e-Faktur

Nieoficjalny klient CLI dla Krajowego Systemu e-Faktur (KSeF) — polskiego systemu faktur elektronicznych Ministerstwa Finansów.

Co potrafi

Czego jeszcze nie potrafi

Instalacja

Pobranie gotowego binarki

Pliki binarne dla Linux, macOS i Windows dostępne są w Releases.

Budowanie ze źródeł

Wymagany Go 1.25+.

git clone https://github.com/torgiren/ksef-cli
cd ksef-cli
make build

Binarka ksef-cli pojawi się w bieżącym katalogu.

Konfiguracja

Plik konfiguracyjny tworzony jest automatycznie przy pierwszym logowaniu:

• Konfiguracja: ~/.config/ksef-cli/config.yaml
• Cache tokenów: ~/.cache/ksef-cli/profile_<nazwa>.json

Użycie

Logowanie

# Pierwsze logowanie — tworzy profil i cachuje tokeny
ksef-cli login --profile moja-firma --nip 1234567890 --token <token_ksef> --save-token

# Ponowne logowanie używa zapisanego tokenu KSeF
ksef-cli login --profile moja-firma

Token KSeF można wygenerować w portalu podatnika lub pobrać z konta biura rachunkowego.

Listowanie faktur

# Lista faktur (ostatnie 3 miesiące)
ksef-cli invoice list --profile moja-firma

# Wyjście w formacie JSON
ksef-cli invoice list --profile moja-firma --output json

# Wybór okresu
ksef-cli invoice list --profile moja-firma --from 2026-02-01 --to 2026-03-31

# Wybór typu faktur
ksef-cli invoice list --profile moja-firma --subject subject2

# Paginacja
ksef-cli invoice list --profile moja-firma --pageoffset 2 --pagesize 50

Przykładowe wyjście tekstowe:

[torgiren@smartraptor ksef-cli (master)]$ ./ksef-cli invoice list --profile qwe 
+------------+--------------------------------------+------------+------------+-----------------------------------+
| DATA       | FAKTURA                              | BRUTTO     | NETTO      | KONTRAHENT                        |
+------------+--------------------------------------+------------+------------+-----------------------------------+
| 2026-01-16 | FV26/01/2026                         | 40.00      | 32.52      | KM Hotel DEV 1                    |
| 2026-01-16 | 1/HUZAR/2026                         | 20.00      | 20.00      | huzar                             |
| 2026-01-16 | 5/HUZAR/2026                         | 20.00      | 20.00      | huzar                             |
| 2026-01-16 | KOR/2/2026                           | 108.00     | 100.00     | Firma Przykladowa Sp. z o.o.      |
| 2026-01-16 | KOR/3/2026                           | -1246.65   | -1000.00   | Firma Przykladowa Sp. z o.o.      |
| 2026-01-18 | 17                                   | 615.00     | 500.00     | pokopoko                          |
| 2026-01-18 | 18                                   | 1500.00    | 1500.00    | hokokokokh                        |
| 2026-01-19 | 5/BA/2025                            | 861.00     | 700.00     | Jan Kowalski                      |
| 2026-01-20 | E67C085C-7127-4501-B2B1-BC41F5B783D8 | 829.49     | 674.37     | STI DEV SPRZEDAWCA                |
| 2026-01-20 | FV/GWW/ENE/2024/09/073               | 1.23       | 1.00       | STI DEV SPRZEDAWCA                |
| 2026-01-20 | FV/GWW/ENE/2024/09/074               | 1.23       | 1.00       | STI DEV SPRZEDAWCA                |
| 2026-01-20 | FV/GWW/ENE/2024/09/075               | 1.23       | 1.00       | STI DEV SPRZEDAWCA                |
| 2026-01-21 | FV/000005/26                         | 136.53     | 111.00     | STUDIO AS TOMASZ SZULGA           |
+------------+--------------------------------------+------------+------------+-----------------------------------+

Flagi globalne

Środowisko testowe

ksef-cli login --test --profile test-firma --nip 1234567890 --token <token>
ksef-cli invoice list --test --profile test-firma

Licencja

GNU AGPL v3