↑↓ selectEnter openEsc close

    1. Elbuz
    2. EU e-invoices

    How to connect KSeF and send Polish e-invoices

    9 min readUpdated

    Elbuz builds an FA(3) invoice, sends it to KSeF, Poland's state system, for your company and returns the KSeF number and UPO.

    When you need this:

    • You sell in Poland as a VAT payer — invoices go to KSeF with one button or on posting.
    • The buyer needs paper — the “Faktura VAT (KSeF)” printout has a verification QR code.
    • Suppliers invoice you in KSeF — these become purchase invoices automatically.
    • KSeF is down, goods ship now — issue it offline with two QR codes; it reaches KSeF by itself.

    Where to start: get a KSeF token in Aplikacja Podatnika and connect your company in the “KSeF (Poland)” window.

    What the KSeF integration does

    • Company connection — the KSeF token of your Polish company, with a sign-in check right after you save.
    • Sending invoices — with a button in the card or automatically when the document is posted; the status, KSeF number and UPO appear in the same card.
    • Print form — “Faktura VAT (KSeF)” in Polish, with totals per VAT rate and a QR code for verification.
    • Incoming invoices — every 15 minutes, invoices where your company is the buyer become purchase invoices.
    • Offline mode — an invoice with two QR codes when KSeF is unavailable; it goes to KSeF by itself.
    • Correcting invoice — a return from a customer goes to KSeF as a faktura korygująca that refers to the original invoice.
    • Split payment — an invoice with Annex 15 goods worth 15,000 PLN or more gets the MPP mark by itself.
    • Foreign currency invoice — VAT is also shown in PLN at the NBP rate; the rate and table appear on the print form.

    What you need to know about KSeF if you have not worked with Polish invoices

    A short overview of the Polish rules the integration is built on. Primary sources: ksef.podatki.gov.pl (the KSeF portal of the Polish Ministry of Finance) and podatki.gov.pl. Deadlines may still change: check your case there or with your accountant.

    KSeF and the KSeF number

    KSeF (Krajowy System e-Faktur) is Poland's government e-invoicing system. An invoice counts as issued once KSeF has accepted it and assigned a KSeF number: the seller's NIP, the date and a code, for example 4521347056-20261031-6BF79AC00000-CF. The buyer receives the invoice from KSeF, not by email. The invoice format is FA(3), an XML file following the Ministry of Finance schema.

    Who must use it and when (ustawa z 5.08.2025)
    DateWhat changes
    February 1, 2026All VAT payers receive invoices through KSeF. Companies with 2024 sales above 200 million PLN must issue invoices in KSeF.
    April 1, 2026All other taxpayers must issue invoices in KSeF, including those exempt from VAT.
    until December 31, 2026Transition period: companies with sales of up to 10,000 PLN a month may issue invoices outside KSeF.
    from January 1, 2027Under the current law, penalties apply for an invoice issued outside KSeF. The government has approved a draft law moving the penalties to 2028; it does not cancel the obligation to issue in KSeF.

    Invoices to private individuals do not have to be sent to KSeF, but you can send them. A foreign company with a Polish VAT number but no fixed establishment in Poland uses KSeF on a voluntary basis.

    UPO

    UPO (Urzędowe Poświadczenie Odbioru) is the official confirmation that KSeF has received the invoice: an XML file with the KSeF number and the time of acceptance. It is proof for the tax office that the invoice was issued on time. Elbuz fetches the UPO by itself and stores it in the document card.

    QR codes KOD I and KOD II

    An invoice handed to the buyer outside KSeF — on paper, as a PDF or by email — carries a QR code for verification.

    • KOD I — on every such invoice. It leads to a KSeF page showing that the invoice is genuine. Under the code is the KSeF number, or, on an offline invoice not yet sent, the word “OFFLINE”.
    • KOD II — on offline invoices only. It confirms the seller: it is signed with a KSeF certificate of the Offline type, and the code is labeled “CERTYFIKAT”.

    Offline modes and sending deadlines

    ModeWhen allowedDeadline to send to KSeF
    offline24At the seller's choice, no conditionsBy the end of the next business day after the issue date
    offlineThe Ministry of Finance has announced that KSeF is unavailableBy the end of the next business day after KSeF is back
    awariaThe Ministry of Finance has announced a KSeF failure7 business days after the failure ends
    awaria całkowitaA total failure announced in the mediaNo need to send: the invoice is issued outside KSeF

    Elbuz issues an offline invoice with the offline24 deadline — the strictest one — and sends it as soon as KSeF responds. More: how to issue an invoice offline.

    Correcting invoice (KOR)

    An invoice accepted in KSeF cannot be changed or deleted. An error or a return is handled with a correcting invoice (faktura korygująca, type KOR): it refers to the number and the KSeF number of the original invoice and contains the difference, with a minus for a return. How to do it: correct an accepted invoice.

    Foreign currency invoices and the NBP rate

    You can issue an invoice in euros, dollars or another currency, but the VAT amount must also be stated in zlotys. It is converted at the NBP average rate (Narodowy Bank Polski, table A) for the last business day before the sale date. How to do it: foreign currency invoice.

    Split payment (MPP)

    MPP (mechanizm podzielonej płatności) is split payment: the buyer pays the invoice in two parts, the net amount to the seller's regular account and the VAT to the seller's separate VAT account, which can only be used to pay taxes.

    Split payment is mandatory when the invoice totals 15,000 PLN gross or more and contains at least one item from Annex 15 to the VAT Act (załącznik 15): electronics — phones, laptops, processors, consoles — steel, fuel, car parts, gold and more; the full list is in the annex itself.

    Such an invoice must carry the note “mechanizm podzielonej płatności”, otherwise a penalty applies. How to do it: split payment in Elbuz.

    Advance invoices

    Elbuz does not issue advance invoices (zaliczkowa, rozliczeniowa). If the buyer pays upfront, issue one regular invoice after full payment and shipment. If the law requires a separate advance invoice (for example, payment and shipment in different months), issue the advance and final invoices manually in Aplikacja Podatnika KSeF and do not send the Elbuz document to KSeF.

    How to get a KSeF token

    A token is the key Elbuz uses to sign in to KSeF on behalf of your company. The company creates it itself in the free Aplikacja Podatnika KSeF, enters it in Elbuz once and can revoke it at any time.

    1. Sign in to Aplikacja Podatnika KSeF with Profil Zaufany, e-dowód or a qualified signature.
    2. Open “Tokeny” → “Generuj token”.
    3. Select the “Wystawianie faktur” and “Przeglądanie faktur” permissions. Without the first, invoices will not be sent; without the second, incoming invoices will not arrive.
    4. Copy the token. It is shown in full only once — keep it until you paste it into Elbuz.

    What to do if a spółka has no qualified seal

    A sole trader (JDG) can access their NIP right away. A sp. z o.o. signs in to Aplikacja Podatnika with its qualified seal or via a person authorized by ZAW-FA. With neither, first file ZAW-FA with the tax office; processing takes a few days. Then that person signs in under the company's NIP and creates the token.

    In Aplikacja Podatnika you can restrict a token to a list of IP addresses. Then a stolen token will not work anywhere except on the servers you listed.

    How to connect your company in Elbuz

    It is the company that sends the invoice to KSeF, so Elbuz first needs to know which of your companies is Polish. In the contacts directory, open your company, select the “My company” checkbox and enter the NIP in the “TIN” field. Until such a company exists, the “KSeF (Poland)” window does not show the connect button.

    The KSeF (Poland) window with the connected company row
    1Connection state
    2Row action icons
    3Connect a company
    1. Connection state — shows Connected and when it was last checked.
    2. Row action icons — check the connection, receive incoming invoices now, edit or disconnect.
    3. Connect a company — adds another company to KSeF.
    1. Open the “KSeF (Poland)” window and click “Connect a company”.
    2. In the “Your company” field, select the company. An empty NIP field is filled in from its card; make sure it is the NIP of this company, 10 digits.
    3. Paste the token into the “KSeF token” field.
    4. In the “KSeF environment” field, keep “Production (invoices are legally binding)”.
    5. Click “Save”. Elbuz immediately signs in to KSeF with this token.

    If sign-in succeeds, the company row shows the “Connected” state and the check time, with the message “KSeF accepted the token — the connection works” at the top. If it fails, the window stays open and a red message gives the reason, most often “KSeF did not accept the token: check the NIP, the token validity and rights”.

    The KSeF connection form for a company
    1KSeF token
    2KSeF environment
    3Default VAT rate
    4Send to KSeF when the invoice is posted
    5Receive incoming invoices from KSeF
    6Offline certificate files
    7Save
    1. KSeF token — pasted here; stored encrypted and not shown after saving.
    2. KSeF environment — Production, Demo or Test.
    3. Default VAT rate — used for lines that have no rate.
    4. Send to KSeF when the invoice is posted — automatic sending switch.
    5. Receive incoming invoices from KSeF — turns on purchase invoices every 15 minutes.
    6. Offline certificate files — .crt and .key for offline mode.
    7. Save — stores the connection and checks it.

    Once saved, the token is stored encrypted and is never shown again: the field shows only its last four characters. To replace the token, click the pencil in the company row, paste the new one and save.

    KSeF environment

    EnvironmentWhat it is for
    Production (invoices are legally binding)Everyday work. Every accepted invoice is a real invoice of your company.
    Demo (pre-production, for checks)A trial run with the company's real token, but with no legal effect. A demo token is created in the demo version of Aplikacja Podatnika.
    Test (made-up data)Checks with made-up NIPs. There is no real company there.

    One company can have one connection in each environment. If there are several connections, invoices go through production. In the card of a document sent to demo or test, the status has a “demo” or “test” mark next to it.

    Default VAT rate and exemption basis

    Every KSeF invoice line has a VAT rate. Elbuz takes the product's rate — from the “VAT” column or, if it is 0, from its tax class — if it is 23, 8 or 5%; otherwise the connection's “Default VAT rate” (23% by default). Delivery gets that rate too, as a separate invoice line.

    Prices in Elbuz documents already include tax, so VAT is calculated from the line amount: at a 23% rate and an amount of 123.00 PLN, the net is 100.00 and VAT is 23.00.

    If you sell at the “zw” rate (VAT exemption), fill in the “VAT exemption basis”, for example “art. 113 ust. 1 ustawy o VAT”. Without it, an invoice with a “zw” line will not be sent.

    Send when posted

    Turn on “Send to KSeF when the invoice is posted”, and every sales invoice or invoice of this company goes to KSeF the moment it is posted. Without this checkbox, invoices are sent with the button in the card.

    Disconnect a company

    The button with a crossed-out chain in the company row deletes the token from Elbuz. Invoices already sent stay in KSeF, and their numbers and UPOs stay in the document cards. The token itself remains valid in KSeF until you revoke it in Aplikacja Podatnika.

    How to send an invoice to KSeF

    What goes to KSeF is a posted sales invoice or invoice of a company connected to KSeF. The card of such a document gets a “KSeF” tab.

    1. Check the buyer: a company name or the payer name. For a company from Poland — the NIP in the “TIN” field of the contact card. An invalid NIP is not rejected: the invoice goes without an identifier. For a buyer from the EU — the VAT ID: the number from the order, the “VAT ID” field or the TIN of the card; it goes into the invoice as a country code and a number (KodUE and NrVatUE). Enter a SIRET or Codice Fiscale in “VAT ID”; they are passed as another tax number. Set the country in the card: an empty one counts as Poland. Without a number, the invoice goes without a buyer identifier.
    2. Post the document. Until it is posted, the “KSeF” tab says “Post the document first — only a posted invoice goes to KSeF.”
    3. On the “KSeF” tab, click “Send to KSeF” and confirm.

    Before sending, Elbuz checks that nothing is missing: the seller company, items, document number, buyer, the basis for “zw”. Anything missing is shown right away, and the invoice is not queued. Otherwise the invoice is queued and usually gets a KSeF number within a few seconds.

    KSeF section of a sales invoice with the Accepted status, KSeF number and XML/UPO links
    1Accepted status
    2XML FA(3) download
    3UPO receipt
    1. Accepted — KSeF has accepted the invoice.
    2. XML FA(3) — the invoice file sent to KSeF.
    3. UPO — the official receipt confirming acceptance.
    Invoice statuses on the “KSeF” tab
    StatusWhat it meansWhat to do
    Not sentThe invoice has not gone to KSeF yetClick “Send to KSeF”
    QueuedWaiting to be sent. If KSeF did not respond, a yellow error text appears under the statusNothing: Elbuz retries by itself
    ProcessingKSeF has received the invoice and is checking itWait or click “Refresh status”
    AcceptedThe invoice is issued and has a KSeF numberPrint it and give it to the buyer
    RejectedKSeF or the Elbuz check did not let the invoice through; the reason is in redFix the reason and click “Send again”
    Sending errorKSeF did not respond, attempts are used upClick “Send again”

    A rejected invoice is visible right away: a red status, the reason text from KSeF and the “Send again” button. What common reasons mean is covered in troubleshooting.

    An accepted invoice shows the KSeF number, the sending and acceptance dates and three buttons on the tab:

    • “XML FA(3)” — download the invoice exactly as KSeF received it;
    • “UPO” — the official confirmation of receipt (Urzędowe Poświadczenie Odbioru). It arrives a little later than the number; until then, the “Refresh status” button is shown;
    • “Verify in KSeF” — open the invoice on the KSeF verification page, the same one the QR code opens.

    The document's “History” records when the invoice was sent, accepted or rejected. You get a notification about a rejection.

    An invoice sent to KSeF cannot be unposted or changed: Elbuz replies “The invoice was sent to KSeF — it cannot be changed, only corrected with a correcting invoice.” Check the amounts and the buyer before sending.

    Print form with a QR code

    When you connect a company for the first time, Elbuz adds the “Faktura VAT (KSeF)” print template to the sales invoice and the invoice. In the document card, click the arrow next to “Print” and select this template. To print it with the button without choosing, set it in the “Default print template” field.

    The form is in Polish: seller and buyer with NIPs, lines with the VAT rate, net and gross, totals for each rate, the amount due. At the bottom is a QR code with the KSeF number under it. The buyer scans the code and sees the invoice in KSeF.

    The QR code appears once the invoice has been sent. You can change the template in the print templates directory — more in Document directories.

    Invoices in euros or another currency

    Issue the document in the currency you need, as usual. When sending, Elbuz takes the NBP average rate for the last business day before the sale date and adds the VAT amount in zlotys for each rate to the invoice. The sale date is the document's shipment date, or the posting date if there is none.

    On the print form, the totals get a “VAT w PLN” column, with the rate, the NBP table number and its date below them.

    If the NBP service does not respond, the invoice is not sent, with the message “No NBP rate for EUR — the NBP service did not respond, try again later.” Send it again in a few minutes.

    Split payment (MPP)

    Mark the Annex 15 products, and Elbuz does the rest.

    • One product: product card → “Statuses and flags” → “KSeF” group → “Split payment (MPP, Annex 15)”. The group is visible only when KSeF is connected.
    • Many products: in the product grid, turn on the “Split payment (MPP, Annex 15)” column in the column picker (it is hidden by default), select the products and click “Set value”.
    Product card, “Statuses and flags”: the KSeF group with the “Split payment (MPP, Annex 15)” toggle
    1Split payment (MPP, Annex 15)
    1. Turn it on for goods from Annex 15; the “KSeF” group appears only when KSeF is connected.

    When sending, Elbuz marks the invoice as MPP if its gross total is 15,000 PLN or more and it contains at least one marked product. A foreign currency invoice is compared with the threshold at the NBP rate. The “Faktura VAT (KSeF)” print form then shows the note “mechanizm podzielonej płatności”.

    The threshold applies to the whole invoice: a marked product in an invoice for a smaller amount does not turn MPP on.

    How to receive incoming invoices

    In the connection window, turn on “Receive incoming invoices from KSeF”. Every 15 minutes Elbuz fetches from KSeF the invoices where your company is the buyer and makes a purchase invoice from each. The first time, it takes invoices for the last 30 days.

    Purchase invoice created from KSeF, with the Source tile and a note holding the seller's number and KSeF number
    1Source tile
    2Note with seller and KSeF numbers
    1. Source — shows the document came from KSeF.
    2. Note — holds the seller's invoice number and the KSeF number.
    What goes into the purchase invoice
    From the invoiceWhere in Elbuz
    SellerA contact found by NIP. If none is found, a new one is created in the “Supplier” group
    Seller's invoice number and KSeF numberThe “Note” field
    LinesItems with names and amounts including tax; the catalog product is looked up by barcode (GTIN), SKU and exact name; if none is found, a new one is created in the service category “Products - ksef - ‹NIP› ‹seller name›”
    Payment term and currencyThe document's payment term and currency
    Original invoiceThe “KSeF” tab, the “XML FA(3)” button, the “Received from KSeF” status

    The invoice arrives unposted, in the default status: stock does not change until you check and post it. The same KSeF invoice is never imported twice.

    To skip the 15-minute wait, click the inbox button “Receive incoming now” in the company row. A message shows how many new invoices have arrived.

    How to issue an invoice when KSeF does not respond

    Polish law lets you issue an invoice offline and send it to KSeF later, by the end of the next business day. Such an invoice carries two QR codes; the second is signed with a KSeF Offline certificate. Without this certificate there is no “Issue offline” button — the invoice just waits in the queue until KSeF responds.

    Upload the Offline certificate

    1. In Aplikacja Podatnika, open “Certyfikaty” → “Wniosek o certyfikat”, choose the Offline type and save both files: the certificate (.crt) and the key (.key).
    2. In the “KSeF (Poland)” window, open the company connection with the pencil. The “KSeF certificate for offline mode” block is available only for a saved connection.
    3. Drag both files into the frame or click “Choose files”, enter the “Key password” and click “Upload certificate”.

    Elbuz checks that the key matches the certificate, the password is correct, the certificate has not expired and was issued for the NIP of this connection. After that, the block shows the certificate number and its expiry date. A KSeF certificate is valid for up to two years — then upload a new one.

    Issue an invoice offline

    On the “KSeF” tab of a posted invoice, click “Issue offline” and confirm. You can print the invoice and give it to the buyer right away.

    The button is available for an invoice not sent yet, a rejected one or one with a “Sending error”. An invoice already in the queue waits for KSeF as usual. So with “Send to KSeF when the invoice is posted” on, the invoice is queued on posting — turn this checkbox off during an outage.

    • An “OFFLINE” mark appears next to the status, along with the line “Issued offline — Elbuz sends it to KSeF by itself; deadline …”. The deadline is counted in Polish business days, taking holidays into account.
    • The print form has two QR codes: the first labeled “OFFLINE” instead of the KSeF number, the second labeled “CERTYFIKAT”.
    • Elbuz sends to KSeF exactly the invoice that was printed and keeps trying until KSeF accepts it. After acceptance, the KSeF number and UPO appear, as for a regular invoice.
    An offline invoice can no longer be changed: its content is fixed in the QR codes the buyer has received.

    How to correct an accepted invoice

    An accepted invoice is corrected with a correcting invoice (KOR). Elbuz builds it from a document linked to the original invoice that KSeF has already accepted.

    What happenedWhat to doWhat goes to KSeF
    The buyer returned goodsIn the card of the accepted invoice: “More” → “Create a new document based on this” → “Return from customer”. Keep the returned items, post the document and click “Send to KSeF”A KOR with negative quantity and amount, reason “Zwrot towaru”
    An amount or an item needs to changeBased on the accepted invoice, create a new sales invoice or invoice with the difference, post it and send itA KOR with the items as in the document, reason “Korekta”

    A return is linked to the invoice if it was created from it, is linked to it or belongs to the same order. The “KSeF” tab appears in the return only when such an accepted invoice is found.

    For a return, the “Faktura VAT (KSeF)” template prints a “Faktura korygująca” with the number, date and KSeF number of the original invoice and the correction amount.

    Scenarios

    An online store in Poland: invoices go out by themselves

    What to do. Connect the company with the “Send to KSeF when the invoice is posted” checkbox. For business buyers, issue a sales invoice and post it as usual.

    What you get. The KSeF number appears in the card a few seconds after posting; the print form with the QR code is ready to send to the buyer.

    What will not happen. If something is missing in the document, it becomes “Rejected” with a reason — the “KSeF” tab tells you what to fix.

    Purchasing from Polish suppliers

    What to do. Turn on “Receive incoming invoices from KSeF”.

    What you get. Supplier invoices turn into purchase invoices by themselves, with the supplier found by NIP. All you have to do is check and post them.

    KSeF is unavailable on the shipping day

    What to do. Upload the Offline certificate in advance. On the day of the outage, do not send the invoice the usual way — click “Issue offline” right away and print it.

    What you get. The buyer gets the invoice with two QR codes immediately, and it reaches KSeF by itself as soon as the system is back up.

    Test first, then go live

    What to do. Create a token in the demo version of Aplikacja Podatnika and connect the company in the “Demo (pre-production, for checks)” environment. Send a few invoices.

    What you get. You see the whole path — number, UPO, QR — with no legal consequences. Then add a “Production” connection with the live token: invoices will go through it.

    What to do when KSeF rejects an invoice

    Troubleshooting common problems
    What you seeWhyWhat to do
    “Rejected”, text “Duplikat faktury. Faktura o numerze KSeF: … została już prawidłowo przesłana…” (duplicate invoice: an invoice with this KSeF number has already been sent) KSeF already has an invoice from this seller with the same number Check whether the invoice has already been issued. If it is a different document, change the number and click “Send again” (sending)
    “KSeF did not accept the token: check the NIP, the token validity and rights” The token was revoked, lacks the required permissions, or the NIP is wrong Create a new token with the “Wystawianie faktur” and “Przeglądanie faktur” permissions and replace it in the connection (token)
    The invoice stays “Queued” for a long time, with a yellow error text under the status KSeF is not responding or is unavailable Nothing: Elbuz retries every 5 minutes. An invoice that is already queued cannot be issued offline — only an unsent one can (offline)
    “Sending error” KSeF did not respond to 10 attempts in a row Check the connection with the “Check connection” button and click “Send again” in the invoice
    “Some lines use the “zw” rate — enter the exemption basis in the “KSeF” window.” For the “zw” rate, KSeF requires an exemption basis Fill in the “VAT exemption basis” in the connection (VAT rate)
    “The buyer is missing: fill in the contact or the payer name.” The document has neither a contact nor a payer name Select a contact in the document details and send again
    “The document company is not connected to KSeF — connect it in the “KSeF” window.” The document has a company selected that has no connection Connect the company or select a connected one in the document

    FAQ

    How much does KSeF cost in Elbuz?

    Nothing extra: the integration is included in your Elbuz plan, and there is no per-invoice fee. KSeF itself is free for taxpayers.

    Do I need to register Elbuz with the Polish Ministry of Finance?

    No. KSeF does not certify software: Elbuz signs in with your token in the context of your company's NIP, and the invoice is issued on behalf of the company.

    Does the token expire?

    No, the token is valid until you revoke it in Aplikacja Podatnika. If it is revoked, the connection gets the “Error” state — see troubleshooting.

    I made a mistake in an accepted invoice. How do I fix it?

    An accepted invoice cannot be changed in KSeF or in Elbuz — issue a correcting invoice based on it, see correcting an accepted invoice.

    Can I send an invoice in euros?

    Yes. Elbuz also adds the VAT amount in zlotys at the NBP rate — see foreign currency invoice.

    Does an invoice for a private individual go to KSeF?

    Yes, if you send it: Elbuz takes the payer name from the document. A private individual does not need a NIP.

    Where to find it and who has access

    Menu
    Directories → Documents → KSeF (Poland)
    Other entry points
    the card of a sales invoice or an invoice, “KSeF” tab
    Access right
    the “KSeF (Poland)” window in group permissions; by default, only the administrators group
    Prepare
    your own company with a NIP in contacts, with the “My company” checkbox

    KSeF is included in your Elbuz plan: there is no separate fee for the connection or per invoice. KSeF itself is free for taxpayers.

    Related topics

    Was this article helpful?

    Missing a feature? Tell us.

    We will add it for free if other users need it too.

    If only you need it, we will agree on it separately.

    Article contents

    Suggest an improvement

    Try Elbuz free