ksef-accountant-pl
by alexwoo-awso
Web & Frontend DevelopmentBrief
Asystent ksiegowy Krajowego Systemu e-Faktur (KSeF) w jezyku polskim.
Description
What This Skill Does
Domain knowledge assistant for Poland's National e-Invoice System (KSeF) in Polish. Covers KSeF 2.0 API, FA(3) invoice XML structure, VAT compliance, corrective invoices, split payment (MPP), and JPK_V7 VAT registers. Instruction-only: no executable code, no runtime dependencies.
Combines KSeF 2.0 API specifics, FA(3) schema rules, and Polish VAT accounting entries in one place, removing the need to cross-reference Ministry of Finance documentation separately.
When to Use It
- Sending FA(3) XML invoices through the KSeF 2.0 API
- Generating monthly JPK_V7 VAT registers for tax filings
- Matching incoming payments to split-payment (MPP) invoices
- Creating corrective invoices linked to original KSeF reference numbers
- Classifying purchase invoice costs from KSeF-fetched XML
Example Workflow
User asks: How do I send a corrective invoice for an overpaid FA(3) invoice already registered in KSeF?
- 1
Retrieves the original invoice XML from KSeF using the stored KSeF reference number
- 2
Constructs a corrective FA(3) XML document with the difference amount and links it to the original via KSeF ID
- 3
Sends the corrective invoice to POST /api/online/Invoice/Send and polls for UPO confirmation
- 4
Returns matching accounting entries: storno or differential booking against receivables and VAT accounts
Corrective invoice submitted to KSeF with UPO confirmation and debit/credit journal entries for VAT and receivables
Requirements
- KSEF_TOKEN — KSeF API session token obtained by registering with the Polish Ministry of Finance KSeF portal (ksef.podatki.gov.pl)
Installation
clawhub install alexwoo-awso/ksef-accountant-plRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.