fakturownia-invoice-ksef-recipients-issuers

Build KSeF-compliant recipient and issuer payloads with Fakturownia API field names.

Updated Apr 14, 2026
One-click install
npx skills add https://github.com/sixers/fakturownia-cli --skill fakturownia-invoice-ksef-recipients-issuers
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fakturownia-invoice-ksef-recipients-issuers
Source: https://github.com/sixers/fakturownia-cli/tree/main/skills/fakturownia/recipes/invoice-ksef-recipients-issuers
Command: npx skills add https://github.com/sixers/fakturownia-cli --skill fakturownia-invoice-ksef-recipients-issuers

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about fakturownia-invoice-ksef-recipients-issuers

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build KSeF-compliant recipient and issuer payloads for Fakturownia invoices?

To build KSeF-compliant recipient and issuer payloads for Fakturownia invoices, you must include explicit roles, tax identifier kinds, participation fields, and country codes using API-native field names.

What tax_no_kind enums are required for KSeF invoice submissions?

KSeF invoice submissions require specific tax_no_kind enums, such as nip_with_id, alongside country fields to accurately identify recipient and issuer tax identifiers within the payload.

When do I need participation fields in KSeF invoice payloads?

You need participation fields in KSeF invoice payloads when specifying participation percentages for recipients and including issuer participation metadata to ensure accurate KSeF reporting.

Can I use standard invoice builders to generate KSeF recipient and issuer JSON?

Standard invoice builders lack the KSeF-specific roles, tax_no_kind enums, and participation fields required for compliant submissions, making dedicated KSeF payload builders necessary for Fakturownia API requests.

What roles do recipients and issuers need for KSeF reporting via Fakturownia?

KSeF reporting via Fakturownia requires applying curated role values for recipients and issuers to match KSeF expectations, ensuring the JSON payload accurately reflects the required participation and tax identifier metadata.