內容簡介
ByteWave Faktury 是一款將 WooCommerce 商店與波蘭國家電子發票系統（KSeF）整合的外掛，能夠從 WooCommerce 控制台生成、驗證並發送結構化的 XML 電子發票，簡化發票處理流程。
【主要功能】
• 手動從 WooCommerce 訂單畫面發行 KSeF 發票
• 生成符合 FA(3) 結構的 XML
• 在發送前進行文件的 XSD 驗證
• 將發票發送至 KSeF（測試及生產環境）
• 下載 UPO（官方收據確認）
• 支援波蘭語界面
外掛標籤
開發者團隊
原文外掛簡介
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
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 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:
* 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/
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:
* https://api.nbp.pl/api/exchangerates/rates/a/
Service information and legal documents:
* NBP Web API documentation: https://api.nbp.pl/en.html
* NBP privacy policy: https://nbp.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.