Tryb interaktywny

Tryb interaktywny prowadzi użytkownika krok po kroku przez proces uzgadniania faktur z przelewami bankowymi. Wykorzystuje @clack/prompts do wyświetlania czytelnych podpowiedzi w terminalu.

Uruchomienie

ksefnik
# lub
ksefnik --interactive

Uruchomienie bez komendy automatycznie włącza tryb interaktywny.

Przebieg

Ścieżka do wyciągu — wybierz plik z wyciągiem bankowym
NIP podmiotu — podaj NIP lub potwierdź z konfiguracji
Zakres dat — potwierdź lub zmień wykryty zakres
Import — automatyczny import i podsumowanie transakcji
Uzgadnianie — uruchomienie silnika dopasowań
Wynik — podsumowanie z możliwością eksportu

Przykład sesji

┌  ksefnik -- uzgadnianie faktur KSeF
│
◇  Ścieżka do wyciągu bankowego
│  ./wyciag-mbank-03-2026.csv
│
◇  NIP podmiotu
│  1234567890
│
◇  Wykryto zakres dat: 2026-03-01 — 2026-03-31
│  Kontynuować z tym zakresem? (T/n)
│  T
│
◆  Importowanie wyciągu...
│  Wykryto format: mBank CSV
│  Zaimportowano: 47 transakcji
│
◆  Pobieranie faktur z KSeF...
│  Pobrano: 12 faktur
│
◆  Uzgadnianie...
│  Pass 1 (KSeF ref): 2 dopasowania
│  Pass 2 (exact NIP): 5 dopasowań
│  Pass 3 (invoice ref): 1 dopasowanie
│  Pass 4 (fuzzy): 2 dopasowania
│
◇  Raport uzgodnienia
│  Dopasowane: 10/12 faktur (83%)
│  Średnia pewność: 0.92
│
◇  Eksportować raport? (T/n)
│  T → raport-2026-03.json
│
└  Gotowe!

Funkcja guidedReconcile

Pod spodem tryb interaktywny wywołuje funkcję guidedReconcile() z @ksefnik/cli:

import { guidedReconcile } from '@ksefnik/cli'

// Uruchom programowo (np. w skrypcie)
await guidedReconcile({
  nip: '1234567890',
  token: 'eyJhbGciOi...',
  env: 'demo',
})

Kiedy używać

Jednorazowe uzgodnienie bez pisania kodu
Szybkie sprawdzenie dopasowań na nowym wyciągu
Prezentacje i onboarding nowych użytkowników