fakturownia-invoice-ksef-send-status

Queue existing invoices for KSeF submission and read gov_* status fields via the Fakturownia API.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill lets you queue an already-created invoice for submission to Poland's KSeF system and quickly read the KSeF-related gov_* status fields returned by the Fakturownia API, removing guesswork about submission state and errors.

Core Features & Use Cases

  • Queue existing invoices: Submit an invoice that was created earlier for separate KSeF processing using the CLI's send-gov action.
  • Read KSeF status fields: Retrieve gov_status, gov_id, gov_send_date, and gov_error_messages to determine success, identifiers, or validation errors.
  • Use Case: Useful when an invoice must be sent to KSeF after creation or when an accountant needs to confirm whether the government submission succeeded and inspect any validation errors.

Quick Start

Use the fakturownia CLI to queue invoice 111 for KSeF submission and then retrieve its gov_status, gov_id, gov_send_date, and gov_error_messages fields.

Frequently Asked Questions about fakturownia-invoice-ksef-send-status

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

FAQPage Schema
How do I submit an existing Fakturownia invoice to KSeF?

To submit an existing Fakturownia invoice to KSeF, you queue it for separate processing using the send-gov action via the fakturownia CLI. This requires a valid invoice identifier and appropriate API credentials to execute the KSeF submission call.

What KSeF status fields does the Fakturownia API return?

The Fakturownia API returns the gov_status, gov_id, gov_send_date, and gov_error_messages fields. Reading these KSeF status fields lets you determine submission success, retrieve government identifiers, or inspect validation errors during compliance workflows.

How do I check if my invoice submission to KSeF succeeded?

You check if your invoice submission to KSeF succeeded by retrieving the invoice and inspecting the gov_status field. You can also review gov_id for the confirmation identifier and gov_error_messages to diagnose any validation errors.

Do I need API credentials to send invoices to KSeF through Fakturownia?

Yes, you need appropriate API credentials to send invoices to KSeF through Fakturownia. The process operates via the fakturownia CLI against the API, requiring authentication to perform both send-gov and invoice retrieval calls.

Why does my KSeF submission show an error in Fakturownia?

If your KSeF submission shows an error in Fakturownia, you should inspect the gov_error_messages field returned by the API. This field contains specific validation errors that occurred during the government submission process.