If you're unable to download an invoice or credit invoice from our system while using Fakturownia with KSeF enabled, one of the following issues is likely the cause.
Click a card to see what went wrong and how to fix it.
Common errors
Might be just processing ⏳ Invoice is still being processed by KSeF
What happened
KSeF processes invoices asynchronously. After Fakturownia submits the invoice there is a short delay - usually seconds to a few minutes, but occasionally longer during peak periods - before KSeF assigns the official number.
How to fix it
- Wait a few minutes and refresh the page in our system.
- Check the invoice in Fakturownia — once it shows Accepted by KSeF, the link will be available.
- If still pending after 30 minutes, there might be some errors regarding your Fakturownia or KSeF settings - read bellow. ⬇️
Error - KSeF rejection ⚠️ Invoice was rejected by KSeF due to incorrect data
What happened
The invoice was created in Fakturownia but failed validation by the KSeF government system. This typically occurs when required fields are missing or incorrectly formatted - for example, an invalid postal code, missing street address, wrong NIP (tax ID), or mismatched buyer/seller data. Until KSeF assigns an official number, our system treats the invoice as unregistered and will not provide a download link.
Common causes
- Incomplete seller address — street, city, and postal code are all required by the KSeF schema.
- Invalid or missing NIP — the buyer's tax ID must be a valid Polish NIP if registered as a company.
- Missing required fields — e.g. no payment method, missing issue date, or unsupported tax rate codes.
- Schema validation error — Fakturownia validates against the FA(3) XML schema; any deviation causes rejection.
How to fix it
- Open the invoice in Fakturownia and check the KSeF status field - the error message describes exactly which field failed.
- Edit the invoice to correct the invalid data (address, NIP, etc.).
- Re-send to KSeF via the send to KSeF button, or wait for automatic re-send.
- Once KSeF accepts it and assigns a number, the download link will appear in our system.
Error - Wrong KSeF mode ⚙️ KSeF sending mode is set to "manual"
What happened
For buyers who are not Polish VAT residents (e.g. EU companies or individuals outside Poland), KSeF registration is optional rather than mandatory. In Fakturownia, this can result in the KSeF sending mode being set to manual for that buyer's invoices. If the invoice is never manually sent to KSeF, no KSeF number is generated - and our system requires a valid KSeF number to provide a download link.
How YOu CAN FIX IT:
- In Fakturownia, go to Settings → Integrations → KSeF → Settings.
- Find the KSeF sending mode and change it from Manual to Automatic.
- For the current invoice, open it and click Send to KSeF manually to register it now.
- Once the KSeF number is assigned, the download link will be available in our system too.
Additional possible causes
Error - Authorization expired ⌛️ Fakturownia's KSeF authorization credentials have expired
What happened
The KSeF integration in Fakturownia uses authorization certificates or tokens that can expire. When these credentials lapse, Fakturownia can no longer send invoices to KSeF — meaning no new KSeF numbers are assigned and our system cannot retrieve download links.
How to fix it
- In Fakturownia go to Settings → Integrations → KSeF and check the connection status.
- If an authorization error is shown, click Re-authorize and follow the step-by-step process.
- For certificate-based auth: generate new certificates in the KSeF Taxpayer Application (Aplikacja Podatnika) and re-upload them to Fakturownia.
- Once re-authorized, resend any affected invoices to KSeF.
Error - Credit note issue 🧾 A credit invoice cannot be registered without a valid original KSeF number
What happened
KSeF requires that every corrective invoice (credit note / korekta) references the KSeF number of the original invoice. If the original invoice was never registered in KSeF — or was registered with errors — the credit note will also be rejected or stuck without a download link.
How to fix it
- First resolve the original invoice - ensure it has been successfully submitted to KSeF and has a valid KSeF number (see errors above).
- In Fakturownia, open the credit note and verify the gov_corrected_invoice_number field references the correct original KSeF number.
-
Re-send the credit note to KSeF - Fakturownia will automatically link it to the original.
Important: To issue a credit invoice through Fakturownia, the original invoice must also exist in Fakturownia. If it does not, the credit note must be created in the same system where the original invoice was issued.
Still having trouble?
If none of the above resolves your issue, contact the Fakturownia support team and include the invoice number, the Fakturownia account name, and a screenshot of the KSeF status shown in Fakturownia.
Comments
0 comments
Please sign in to leave a comment.