fakturownia-invoice-ksef-recipients-issuers

What problem does it solve?

When preparing invoices for KSeF reporting, many payloads require explicit recipient and issuer roles, tax identifier kinds, and participation fields which are not part of generic invoice builders; this Skill guides construction of those KSeF-specific payload sections using Fakturownia API-native field names.

Core Features & Use Cases

• KSeF Role Mapping: Curated role values for recipients and issuers to match KSeF expectations.
• Tax Identifier Handling: Handles tax_no_kind enums (e.g., nip_with_id) and country fields required for KSeF submissions.
• Participation Support: Allows specifying participation percentages for recipients and includes issuer participation and role metadata for accurate reporting.
• Use Case: Generate the recipients and issuers sections when creating or updating invoices to ensure payloads are KSeF-compliant before sending via the Fakturownia API.

Quick Start

Generate a KSeF-compliant recipients and issuers JSON block for an invoice using Fakturownia field names and include roles, tax_no_kind enums, and participation values.