Title: ByteWave Faktury Author: ByteWave Published: May 26, 2026 Last modified: June 17, 2026 --- Search plugins ![](https://ps.w.org/bytewave-ksef/assets/banner-772x250.png?rev=3549735) ![](https://ps.w.org/bytewave-ksef/assets/icon-256x256.png?rev=3549735) # ByteWave Faktury By [ByteWave](https://profiles.wordpress.org/bytewave/) [Download](https://downloads.wordpress.org/plugin/bytewave-ksef.1.0.1.zip) * [Details](https://vec.wordpress.org/plugins/bytewave-ksef/#description) * [Reviews](https://vec.wordpress.org/plugins/bytewave-ksef/#reviews) * [Installation](https://vec.wordpress.org/plugins/bytewave-ksef/#installation) * [Development](https://vec.wordpress.org/plugins/bytewave-ksef/#developers) [Support](https://wordpress.org/support/plugin/bytewave-ksef/) ## Description 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) * Invoice status preview (sent, accepted, rejected) * 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 outside the uploads directory * Compatibility with HPOS (High-Performance Order Storage) and classic CPT * Full Polish language support #### Companion Pro plugin ByteWave Faktury Pro is a separate companion plugin (not hosted on WordPress.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. More information: [https://ksef-woocommerce.pl/](https://ksef-woocommerce.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 one external third-party service. 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: * Production: https://api.ksef.mf.gov.pl/v2 * Test (sandbox): https://api-test.ksef.mf.gov.pl/v2 Service information and legal documents: * KSeF service homepage and terms of service: https://www.podatki.gov.pl/ksef/ * Privacy policy of the Polish Ministry of Finance: https://www.gov.pl/web/finanse/polityka-prywatnosci * KSeF API documentation (developer zone): https://www.podatki.gov.pl/ksef/strefa-deweloperow/ 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. ## Installation 1. Download the plugin ZIP file. 2. In the WordPress admin go to: Plugins > Add New > Upload Plugin. 3. Select the downloaded ZIP file and click “Install Now”. 4. Activate the plugin. 5. Go to KSeF > Settings. 6. Paste the KSeF authorization token (generated in the KSeF portal at podatki.gov. pl). 7. Set the seller Tax ID and choose the environment (test or production). 8. Click “Test connection” to verify the configuration. 9. Done — you can now issue KSeF invoices from WooCommerce orders. #### System requirements * PHP 7.4+ with the Sodium extension (check in phpinfo()) * WooCommerce 8.0+ * SSL certificate (HTTPS) — required by the KSeF API * KSeF authorization token ## FAQ ### Does the plugin require WooCommerce? Yes, the plugin requires WooCommerce installed and active in version 8.0 or newer. ### How do I obtain a KSeF token? You generate the authorization token in the KSeF portal at podatki.gov.pl. A trusted profile (ePUAP) or a qualified electronic signature is required. ### Is my data safe? The KSeF token is encrypted with the XChaCha20-Poly1305 algorithm (libsodium) and stored in the database in encrypted form. Communication sessions with KSeF are encrypted using AES-256-CBC + RSA. XML and UPO files are stored in a private directory outside public access. ### Does the plugin work with the KSeF test environment? Yes. In the settings you can choose the environment: test (sandbox) or production. We recommend starting with the test environment. ### Does the plugin work with HPOS (High-Performance Order Storage)? Yes, the plugin is fully compatible with both HPOS and the classic order storage mode (CPT). ### How does the free version differ from Pro? This Free plugin provides manual invoice issuance directly from each WooCommerce order screen, automatic queue processing for reliable delivery, and offline storage when the KSeF API is temporarily unavailable. The optional companion Pro plugin ( distributed separately at ksef-woocommerce.pl) adds advanced automation features such as auto-issue on order payment, bulk operations, reports dashboard, audit log and email alerts. ### Where can I get help? Use the support forum on WordPress.org or contact us via the form at [ksef-woocommerce.pl](https://ksef-woocommerce.pl/). ## Reviews There are no reviews for this plugin. ## Contributors & Developers “ByteWave Faktury” is open source software. The following people have contributed to this plugin. Contributors * [ ByteWave ](https://profiles.wordpress.org/bytewave/) [Translate “ByteWave Faktury” into your language.](https://translate.wordpress.org/projects/wp-plugins/bytewave-ksef) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/bytewave-ksef/), check out the [SVN repository](https://plugins.svn.wordpress.org/bytewave-ksef/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/bytewave-ksef/) by [RSS](https://plugins.trac.wordpress.org/log/bytewave-ksef/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.0.1 * Fix: saving settings from a companion extension no longer re-encrypts the stored KSeF token (prevents the token from becoming unreadable) * Fix: settings added by companion extensions are preserved on save instead of being dropped #### 1.0.0 * First public release * Integration with the KSeF API (test and production environments) * FA(3) XML generation with XSD validation * Manual invoice issuance from a WooCommerce order * Invoice status preview and UPO download * Token encryption (XChaCha20-Poly1305) and session encryption (AES-256-CBC + RSA) * Private storage of XML/UPO files * Settings panel with a connection test * Compatibility with HPOS and classic CPT * Full Polish localization ## Meta * Version **1.0.1** * Last updated **3 weeks ago** * Active installations **Fewer than 10** * WordPress version ** 6.0 or higher ** * Tested up to **7.0.1** * PHP version ** 7.4 or higher ** * Language * [English (US)](https://wordpress.org/plugins/bytewave-ksef/) * Tags * [faktury](https://vec.wordpress.org/plugins/tags/faktury/)[invoice](https://vec.wordpress.org/plugins/tags/invoice/) [ksef](https://vec.wordpress.org/plugins/tags/ksef/)[woocommerce](https://vec.wordpress.org/plugins/tags/woocommerce/) * [Advanced View](https://vec.wordpress.org/plugins/bytewave-ksef/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/bytewave-ksef/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/bytewave-ksef/reviews/) ## Contributors * [ ByteWave ](https://profiles.wordpress.org/bytewave/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/bytewave-ksef/)