Poland KSeF Inbound

Poland KSeF Inbound

Pull supplier FA(3) e-invoices from KSeF into vendor bills — with UPO tracking

Closes the receive side of Poland's Krajowy System e-Faktur (KSeF), the National e-Invoice System run by the Ministry of Finance. Where the wave-1 connector sends your customer invoices, this module polls KSeF for the structured FA(3) invoices your suppliers issued to you, downloads each one, parses it, and creates the matching vendor bill in Odoo.

Compatible with Odoo 18, Odoo 19 and Odoo 20 Community and Enterprise.

Inbound query & download

Opens a KSeF 2.0 session with your authorisation token, queries the inbound set (you as the buyer) over a date window, pages through the results and downloads each FA(3) document — reusing the wave-1 connector's session client and the shared e-Invoice Core Engine REST transport.

FA(3) parser

A defensive, namespace-aware reader for the Ministry of Finance Faktura schema (Naglowek, Podmiot1/Podmiot2, per-rate P_13/P_14 buckets, FaWiersz lines) that turns a cleared inbound invoice into structured data — resilient to schema revisions.

Vendor-bill creation

Resolves the supplier by NIP (or creates it from the FA(3) identity), resolves the matching purchase VAT tax per rate, builds the bill lines and reconciles totals. Review each document in the inbox first, or let valid invoices become draft bills automatically.

Auditable inbox

One record per fetched document, de-duplicated by KSeF reference, holding the raw XML, the validation report and a link to the created bill. The KSeF reference and UPO acknowledgement are stamped on both the inbox record and the vendor bill.

Disclosure

This module connects only to the KSeF endpoint you configure (test, demo or production) using your own KSeF authorisation token. It reads invoices addressed to you and writes them into your own database; no data is sent anywhere else. Requires the wave-1 l10n_pl_ksef_connector module and the e-Invoice Core Engine.

We provide the software only. It runs under your own KSeF registration and credentials (bring-your-own-key) and talks directly to the Ministry of Finance KSeF system. We are not a KSeF integrator, operator or intermediary and do not act on your behalf before the tax authority — the relationship is strictly between you (the taxpayer) and the Ministry of Finance. Product support is provided and the purchase is refundable under the marketplace terms.

Screenshots

Inbound Ksef Fa 3 Parsed Bil

Vendor Bill Created From The