FakturFlow – E-Invoicing for KSeF
| 开发者 | simmotorlp |
|---|---|
| 更新时间 | 2026年7月12日 00:17 |
| PHP版本: | 8.1 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- Generate FA(3) structured invoice XML from any WooCommerce order.
- Validate against the official Ministry of Finance schema before sending.
- Submit to KSeF (test, demo and production environments) using the official API 2.0.
- Track submission status and download the UPO (Urzędowe Poświadczenie Odbioru — official proof of receipt).
- KOD I verification QR code, generated per the official Ministry of Finance specification.
- NIP field at checkout (classic and block checkout) with checksum validation — orders with a NIP are detected as B2B automatically.
- Correction invoices (faktury korygujące) from refunds — every refund gets its own KOR document referencing the original invoice by KSeF number; generate, send and download its UPO from the order screen.
- KSeF token stored encrypted at rest, never logged.
- HPOS (custom order tables) and checkout-blocks compatible.
- Full Polish (pl_PL) translation included.
- Direct connection, no middlemen. Most KSeF options for WooCommerce route your invoices through an external accounting SaaS or a vendor's cloud. FakturFlow talks straight to the Ministry of Finance API — your invoice data never touches a third-party server.
- Free means free. No invoice limits, no per-invoice fees, no monthly subscription for the core flow. Accounting SaaS plans start around 100-360 zl/year and meter your invoices; here the full manual flow costs nothing, forever.
- One plugin, not a plugin + paid add-on. You don't need a separate invoicing plugin as a base — KSeF is not a bolt-on here, it's what this plugin is built around: FA(3) with local XSD validation, UPO, the KOD I verification QR, and corrections.
- Built for modern WooCommerce. HPOS, checkout blocks, a checksum-validated NIP field in both checkout variants.
- Private by design. Encrypted token storage, zero telemetry — the only server your store talks to is the Ministry's.
- phpseclib/phpseclib 3.x — RSA-OAEP-SHA256, required for the KSeF session-key handshake (PHP's own openssl extension cannot do OAEP with SHA-256).
- chillerlan/php-qrcode — pure-PHP QR code rendering for the KOD I verification code (no GD/Imagick requirement).
- paragonie/constant_time_encoding and paragonie/random_compat — dependencies of the above.
安装:
- Install and activate the plugin (WooCommerce must be installed and active).
- Go to WooCommerce → KSeF Invoices.
- Choose the environment — start with Test.
- Enter your seller NIP and seller name.
- Log into the KSeF web application (https://ksef.mf.gov.pl/) with your Trusted Profile or qualified certificate and generate a token with InvoiceWrite and InvoiceRead permissions. Paste it into the settings — it is stored encrypted.
- Use Test connection to confirm your hosting allows outgoing HTTPS to KSeF.
- Open a B2B order (one with a buyer NIP), generate and validate the FA(3) invoice, send it to KSeF and download the UPO. Once a full test cycle works, switch the environment to Production.
屏幕截图:
常见问题:
Does the plugin work without an accounting system?
Yes. It talks directly to the official KSeF API 2.0 of the Ministry of Finance — no intermediary and no per-invoice fees. You generate, validate and submit FA(3) invoices from the WooCommerce order screen.
What about consumer (B2C) orders?
Only orders with a buyer NIP (tax ID) are routed to KSeF. Consumer orders keep the regular WooCommerce checkout flow — KSeF stays optional for them.
Does it work with HPOS and the block checkout?
Yes. The plugin is fully compatible with High-Performance Order Storage (custom order tables) and with the Checkout block — the NIP field is registered through the Additional Checkout Fields API and behaves identically in both checkout variants.
Where do I get a KSeF token?
Log into the KSeF web application (https://ksef.mf.gov.pl/) with your Trusted Profile (Profil Zaufany) or qualified certificate, go to permissions management, and generate a token with InvoiceWrite and InvoiceRead permissions. Paste it into the plugin settings (WooCommerce → KSeF Invoices) — it is stored encrypted.
Does the plugin send data to third parties?
No. Invoice data is sent only to the official Ministry of Finance API (test, demo or production environment, as chosen in your settings). The one exception is the verification link encoded in the KOD I QR code itself — when scanned it points to the Ministry of Finance's public invoice-verification lookup, per the official verification-code specification. See the "External services" section below for the exact endpoints.
Does uninstalling the plugin delete my issued invoices?
No. Generated invoice and UPO XML files (under wp-content/uploads/ksef-invoices/) are legal/tax records and are not deleted on uninstall — only the plugin's own settings (environment, seller data, token) are removed. If you also want the stored files gone, remove them manually after archiving/exporting them.
更新日志:
- New: a short FakturFlow Pro section on the settings page and a "Go Pro" link on the plugins list (both hidden automatically when the Pro add-on is active).
- Renamed again to resolve a follow-up wp.org review finding: "WooCommerce" is not permitted in the plugin name or slug at all, so it's dropped from both. New slug:
fakturflow-ksef.
- Renamed to resolve a wp.org review trademark/slug finding (new slug:
fakturflow-ksef-and-woocommerce). Upgraded chillerlan/php-qrcode to 6.0.1 and hardened the KOD I QR output withwp_kses().
- Initial release: FA(3) generation with offline schema validation, direct KSeF API 2.0 submission with UPO download, order metabox and status column, checkout NIP field (classic + blocks), KOD I verification QR, correction invoices (faktury korygujące) from refunds, encrypted token storage.