About this plugin
ByteWave Faktury is a plugin that integrates your WooCommerce store with the Polish National e-Invoice System (KSeF), operated by the Polish Ministry of Finance.
The plugin allows you to generate structured XML e-invoices (FA(3) schema), validate them and send them to KSeF – directly from the WooCommerce admin panel.
Features in the free version
- Manual issuance of KSeF invoices from a WooCommerce order screen
- XML generation compliant with the FA(3) schema
- XSD validation of documents before sending
- Sending invoices to KSeF (test and production environments)
- Processing result from KSeF: KSeF number for accepted invoices, rejection reason for rejected ones
- Downloading UPO (Official Receipt Confirmation)
- KSeF token encryption (XChaCha20-Poly1305) and session encryption (AES-256-CBC + RSA)
- Settings panel with connection test
- Private storage of XML and UPO files in a randomly named, access-protected directory
- Compatibility with HPOS (High-Performance Order Storage) and classic CPT
- Full Polish language support
Companion Pro plugin
org)
that adds advanced automation features when installed alongside the Free version:
- Automatic invoice issuance after order payment
- Bulk invoice issuance and sending (bulk actions)
- Reports dashboard with statistics and KPIs
- Operations audit log
- KSeF availability monitoring with email alerts
The Pro plugin is distributed from the author’s website and is not required for
the Free version to work. pl/
Requirements
- WordPress 6.0 or newer
- WooCommerce 8.0 or newer
- PHP 7.4 or newer
- PHP Sodium extension (libsodium) – required for token encryption
- Active KSeF account with a generated authorization token
External services (Third-Party Services)
This plugin connects to the following external services. Full disclosure below.
Service: Polish National e-Invoice System (KSeF), operated by the Polish Ministry of Finance.
What the service is and what it is used for:
KSeF is the official electronic invoicing system of the Republic of Poland (Krajowy System e-Faktur). This plugin uses the KSeF API to submit structured XML invoices generated from WooCommerce orders, retrieve their status, and download the official receipt confirmation (UPO, Urzędowe Poświadczenie Odbioru). Communication with the KSeF API is the core functionality of this plugin and the integration cannot be performed locally.
What data is sent, and under what circumstances:
Data is transmitted to the KSeF API only after explicit user action: clicking the “Wystaw fakturę” (Issue invoice) button on an order, or when the WordPress cron worker processes a previously-queued invoice that the user has manually created.
The following fields are sent: seller business data (Tax ID / NIP, company name, address), buyer business data (NIP or personal identifier, name, address), invoice line items (product names, quantities, unit prices, VAT rates, totals), invoice metadata (issue date, due date, payment method, currency, invoice number). The encrypted KSeF API authorization token (configured by the site owner in plugin settings) is sent in each request to authenticate the connection.
No usage analytics, telemetry, or personally identifiable data unrelated to the invoice is transmitted.
API endpoints used:
pl/v2
pl/v2
Service information and legal documents:
pl/ksef/
pl/web/finanse/polityka-prywatnosci
pl/ksef/strefa-deweloperow/
Service: National Bank of Poland (NBP) Web API – exchange rates.
What the service is and what it is used for:
Polish VAT law requires the VAT amount on an invoice issued in a foreign currency (for example EUR) to be stated in Polish zloty, converted with the average NBP exchange rate from the last business day before the tax point. The plugin downloads this public exchange rate from the NBP Web API.
What data is sent, and under what circumstances:
Only when an invoice is generated for an order placed in a currency other than PLN. The request contains only the currency code and a date range (for example EUR and the ten days before the sale date). No personal, order or store data is sent.
Downloaded rates are cached for a week. Developers can supply the rate from another source with the bwksef_exchange_rate filter.
API endpoint used:
pl/api/exchangerates/rates/a/
Service information and legal documents:
html
pl/en/privacy-policy/
This plugin does not communicate with any other external servers. It does not collect analytics or telemetry, does not phone home, does not load remote assets, and does not contact any author-owned backend.