Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
**Wersja 2.2.6 – Rozszerzone deklaracje bezpieczeństwa i nowy manifest skill.json** - Dodano plik manifestu `skill.json` z maszynowo czytelnymi deklaracjami bezpieczeństwa i zmiennych środowiskowych. - Rozbudowano sekcję frontmatter w SKILL.md: wprowadzono równoległe flagi disableModelInvocation (camelCase, kebab-case) i dodatkowe pola bezpieczeństwa (`allowModelInvocation: false`, `instruction_only: true`, `has_executable_code: false`, `credential_scope: "optional-user-provided"`). - Zmiennym środowiskowym KSEF_TOKEN oraz KSEF_ENCRYPTION_KEY nadano atrybut `secret: true` (w SKILL.md oraz skill.json). - Zaktualizowano i doprecyzowano instrukcje oraz checklistę wymuszając jawne sprawdzenie obsługi flag bezpieczeństwa przez platformę, zarówno z frontmatter jak i skill.json. - Aktual
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
Here's how your AI assistant might use this skill in practice.
User asks: How do I send a corrective invoice for an overpaid FA(3) invoice already registered in KSeF?
- 1Retrieves the original invoice XML from KSeF using the stored KSeF reference number
- 2Constructs a corrective FA(3) XML document with the difference amount and links it to the original via KSeF ID
- 3Sends the corrective invoice to POST /api/online/Invoice/Send and polls for UPO confirmation
- 4Returns 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
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.