Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
**Security-focused update: Adds strict instruction-only and credential management warnings.** - Added a dedicated `skill.json` manifest declaring security flags, environment variables, and non-executable status. - Updated SKILL.md with expanded "Security Model" and pre-installation checklist, clarifying platform-dependent enforcement of safety features (`disableModelInvocation`, env var secrecy). - Marked the skill as instruction-only: code is for reference, not execution; no code, models, or credentials handled by the skill. - Enhanced constraints and documentation to disallow any autonomous invocation and emphasize user validation before production/credential use. - Reference and troubleshooting files updated for consistency with new security and usage guidelines.
What This Skill Does
Domain knowledge for Poland's National e-Invoice System (KSeF) 2.0, covering FA(3) invoice structure, KSeF API operations, accounting workflows, and VAT compliance. Instruction-only, containing reference patterns and code examples without executing code or calling APIs. Covers developer integration (API, XML), accounting (journal entries, JPK_V7), and AI-assisted patterns for expense classification and fraud detection.
Combines KSeF API documentation, FA(3) XML structure, Polish accounting entries, and compliance patterns in one reference instead of requiring separate consultation of scattered Ministry of Finance resources.
When to use it
- Sending FA(3) invoices to KSeF and recording corresponding journal entries
- Querying purchase invoices from the KSeF API for automated bookkeeping
- Generating JPK_V7 VAT registers for monthly or quarterly tax reporting
- Processing corrective invoices linked to original KSeF reference numbers
- Implementing split payment (MPP) and VAT White List verification workflows
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: How do I issue a sales invoice through KSeF and record it in accounting?
- 1Explains required FA(3) XML fields, contractor identifiers, and VAT rate structure
- 2Shows session initialization and token authentication with the KSeF API
- 3Provides the POST /api/online/Invoice/Send request format and expected response fields
- 4Retrieves the confirmed KSeF reference number via the invoice status endpoint
- 5Returns the accounting entry: Dr 300 Receivables | Cr 700 Sales + Cr 220 Output VAT
FA(3) invoice submitted to KSeF with confirmed KSeF number, UPO download reference, and accounting entry ready to post
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.