ksefnik

Open-source TypeScript SDK do automatycznego uzgadniania faktur KSeF z wyciągami bankowymi. 6-etapowy pipeline. 5 formatów bankowych. Zero konfiguracji.

Szybki start Referencja API GitHub

⚡

Silnik uzgadniania

6-etapowy pipeline dopasowania faktur do przelewów — od pewnego dopasowania po numerze KSeF, przez NIP i numer faktury, aż po fuzzy matching i proximity.

Sprawdź pipeline →

🏦

Parsery bankowe

MT940, mBank, ING, PKO BP, Santander — automatyczna detekcja formatu. Podaj plik, ksefnik rozpozna bank i sparsuje transakcje.

Zobacz formaty →

✅

20 reguł walidacji

NIP, kwoty brutto/netto/VAT, daty, duplikaty, spójność danych. Gotowe raporty z listą błędów na każdej fakturze.

Poznaj reguły →

🤖

Serwer MCP

9 narzędzi dla Claude, Cursor i Windsurf. Uzgadniaj faktury i importuj wyciągi bezpośrednio z poziomu AI.

Konfiguruj AI →

⚡ SDK (TypeScript)

import { createKsefnik } from '@ksefnik/core'
import { createKsefSimulator } from '@ksefnik/simulator'

const { adapter } = createKsefSimulator({
  scenario: 'happy-path',
  invoices,
})

const ksef = createKsefnik({
  config: { nip: '5213456784', environment: 'test' },
  adapter,
})

const txs = await ksef.bank.importFromString(csv)
const report = await ksef.reconciliation.run(invoices, txs)
// → matchedCount: 10, confidence: 95%

🤖 MCP (Claude Code)

claude mcp add ksefnik -- npx -y @ksefnik/mcp

> Ty: Zaimportuj wyciąg z pliku wyciag-mbank.csv
>     i sprawdź które faktury nie mają przelewu.

Claude: Zaimportowałem 15 transakcji z mBanku.
        Po uzgadnianiu 12 faktur ma dopasowany
        przelew (średnia pewność 93%).

        3 faktury bez przelewu:
        • FV/2026/03/012 — 4 500 PLN (ACME sp. z o.o.)
        • FV/2026/03/018 — 1 230 PLN (TechSoft)
        • FV/2026/03/021 — 8 900 PLN (DataCorp)