Komenda: fetch

Komenda fetch pobiera faktury z Krajowego Systemu e-Faktur za wskazany zakres dat.

Użycie

ksefnik fetch --from <data> --to <data> [--format json|table]

Parametry

Parametr	Wymagany	Opis
`--from`	Tak	Data początkowa (YYYY-MM-DD)
`--to`	Tak	Data końcowa (YYYY-MM-DD)
`--format`	Nie	Format wyjścia: `json` lub `table` (domyślnie)

Wymagania

Komenda wymaga skonfigurowanego adaptera KSeF:

--nip lub KSEFNIK_NIP — NIP podmiotu
--token lub KSEFNIK_TOKEN — token autoryzacyjny
--env lub KSEFNIK_ENV — środowisko (domyślnie production)

Przykłady

# Pobierz faktury z marca 2026
ksefnik fetch --from 2026-03-01 --to 2026-03-31

# Wynik w formacie tabeli:
# ┌────────────────────┬──────────────────┬──────────────┬──────────────┐
# │ Referencja KSeF    │ Numer faktury    │ Kwota netto  │ Data         │
# ├────────────────────┼──────────────────┼──────────────┼──────────────┤
# │ KSeF-ABC-123       │ FV/2026/03/001   │ 1 000,00 PLN │ 2026-03-10  │
# │ KSeF-DEF-456       │ FV/2026/03/002   │ 2 500,00 PLN │ 2026-03-15  │
# └────────────────────┴──────────────────┴──────────────┴──────────────┘
# Pobrano: 2 faktury

# Pobierz jako JSON do dalszego przetwarzania
ksefnik fetch --from 2026-03-01 --to 2026-03-31 --format json

{
  "invoices": [
    {
      "ksefReference": "KSeF-ABC-123",
      "invoiceNumber": "FV/2026/03/001",
      "sellerNip": "1234567890",
      "buyerNip": "0987654321",
      "netAmount": 100000,
      "grossAmount": 123000,
      "issueDate": "2026-03-10"
    }
  ],
  "count": 2
}