ByteWave Faktury

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/

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.