Fakturownia (InvoiceOcean) automation · runs daily
Send Fakturownia invoices to KSeF
An invoice has to reach KSeF on the day it is issued, and a missed send turns it into an offline24 invoice that cannot be edited.
Cotlet does it in your own Fakturownia (InvoiceOcean) account with list_invoices, get_ksef_status and send_invoice_to_ksef, called by your AI agent, an n8n workflow or a script.
Hosted · nothing to install or maintain
Can Fakturownia (InvoiceOcean) do this on its own?
Fakturownia sends to KSeF automatically for buyer groups you choose in its settings, and its API sends one with send_to_ksef and reports gov_status (checked 14 Oct 2026). The official MCP is read-only. The gap is the ones automation skips, foreign companies and failed sends, which someone has to find and send.
How you do it in Fakturownia (InvoiceOcean) today
- Go to "Ustawienia > Integracje i dodatki > KSeF > Ustawienia" and choose whether "Automatycznie wysyłaj tworzone dokumenty do KSeF" is on and for which buyers.
- With it off, click "Zapisz i wyślij do KSeF" when creating an invoice, or the send action in the "KSeF" column under "Przychody > Faktury".
- For several invoices, tick them in the list and click "Wyślij faktury do KSeF", or open one invoice and click "KSeF".
- Check the invoice afterwards for its KSeF number or an error; a failed send has to be found by opening documents.
- What repeats: invoices for foreign companies are never sent automatically and must be sent by hand after checking.
How to send Fakturownia invoices to KSeF
Check Fakturownia for invoices issued today that are not in KSeF. For each one for a Polish company, show me the buyer and the total, and send it to KSeF after I approve. Report any that come back with an error. - 01
List today's unsent invoices
The agent reads invoices issued today and checks each one's KSeF status, so only those with no status, a send error or a server error are candidates.
- 02
Split by buyer
A Polish company is sent as is. A foreign company or a private person is shown separately, because Fakturownia never sends those on its own and you decide.
- 03
Send after your OK
send_invoice_to_ksef is a legally binding step, so each call waits for your OK by default. The agent never sends a proforma, which KSeF does not accept.
- 04
Read the answer
The status first comes back as processing. The agent checks it again and reports the KSeF number on success or the error text on failure.
- 05
Flag the deadline
If an invoice is already past its issue day, the agent tells you it will go as offline24 and cannot be edited afterwards.
What you get back
Checked 5 invoices issued today
Sent 3 to KSeF: 14/10/2026/1, /2, /3 (KSeF numbers received)
For you: 14/10/2026/4 buyer in Germany, send by hand?
Error: 14/10/2026/5 send_error, buyer address too long Other ways to ask
- Every evening, list invoices from the last 2 days with a KSeF error and tell me why each failed.
- Send this one invoice to KSeF now and return its KSeF number.
- Show invoices issued this month that were sent offline24.
What Fakturownia (InvoiceOcean) allows, and what to know first
- KSeF has a send deadline: an invoice sent on its issue day is online, later it becomes offline24.
- Invoices sent in offline24 cannot be edited or deleted, and an error needs a corrective invoice.
- Once an invoice has a KSeF number its content is locked; only attachments and accounting fields can change.
- Fakturownia emails an invoice to the customer only after it has a KSeF number.
- Users without the send permission can only save an invoice; the owner, an administrator or a user with "Wysyłanie do KSeF" sends.
send_invoice_to_ksef asks for your OK by default. To run it daily without you, switch confirmation off for that tool in your dashboard.
Sources: Fakturownia Help: Jak wysyłać faktury do KSeF · Fakturownia API: KSeF integration guide · Fakturownia Help: KSeF
Call send_invoice_to_ksef from a script
curl -X POST https://cotlet.dev/api/v1/fakturownia/invoices/5120/to-ksef \
-H "Authorization: Bearer $COTLET_API_KEY" {
"invoice_id": 5120,
"gov_status": "processing",
"gov_id": null
} MCP: add https://cotlet.dev/mcp/v1 with the same key; the call is fakturownia_write → send_invoice_to_ksef. Example data.
Schedule it in n8n, Make, Zapier or cronFakturownia (InvoiceOcean) tools this automation uses
| Tool | Parameters |
|---|---|
| list_invoices | period, date_from, date_to, status, kind, income, client_id, page, per_page |
| get_ksef_status | invoice_id |
| send_invoice_to_ksef | invoice_id |
Frequently asked questions
Is it safe to connect Fakturownia (InvoiceOcean) to Cotlet?
Yes. You sign in to Fakturownia (InvoiceOcean) yourself, in your own Cloud Browser in the EU, and we never save your password. Your agents only get Fakturownia (InvoiceOcean) once you enable it, every background request is listed, and the browser profile is stored encrypted with AES-256-GCM, the cipher 1Password uses for its vaults. The AI model never sees a login, posts and messages wait for your OK, and Disable for agents cuts access in one click. Independent scanners grade cotlet.dev A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory; live results are on https://cotlet.dev/security.
Give your agent access to Fakturownia (InvoiceOcean).
Free 7-day trial with 2,000 credits, no card needed. Cotlet is independent and not affiliated with Fakturownia (InvoiceOcean).