B2Brouter for WooCommerce
| 开发者 | b2brouter |
|---|---|
| 更新时间 | 2026年6月1日 20:58 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.0 |
| 版权: | MIT |
| 版权网址: | 版权信息 |
详情介绍:
B2Brouter for WooCommerce connects your WooCommerce store with the B2Brouter platform to generate and send electronic invoices automatically — including the country-specific tax authority reporting required in Spain, France and Poland.
Built-in regulatory compliance
The plugin includes explicit support for the following e-invoicing regimes:
- Spain — Verifactu: automatic AEAT reporting with QR verification on every issued invoice.
- France — DGFiP: routing through the official PPF / Chorus Pro infrastructure.
- Poland — KSeF: automatic submission of invoices to the national KSeF system.
- Automatic or manual invoice generation — issue invoices on order completion or on demand from the order screen.
- Bulk invoice generation — process multiple completed orders at once via WooCommerce bulk actions.
- Standard and simplified invoices — IssuedInvoice (B2B with TIN) or IssuedSimplifiedInvoice (B2C without TIN), selected automatically.
- Credit notes for refunds — generated on demand when a WooCommerce refund is created against an invoiced order.
- PDF generation, caching and email attachment — store PDFs locally and attach them to order/customer/refund emails.
- Real-time invoice status via webhooks (HMAC-SHA256 signed) with optional 6-hour fallback polling.
- TIN / VAT field at checkout — works on both classic and block-based checkout (WooCommerce 8.6+); intra-EU reverse charge auto-detected.
- HPOS compatibility — native support for High-Performance Order Storage (Custom Order Tables).
- Peppol tax categories — automatic mapping (S, E, Z, NS, AE) from WooCommerce tax configuration.
- WordPress 5.8 or higher
- WooCommerce 5.0 or higher
- PHP 7.4 or higher
- Active B2Brouter eDocExchange subscription
安装:
- Download the plugin ZIP from the GitHub releases page (or install from the WordPress.org plugin directory once available).
- In WordPress admin, go to Plugins → Add New → Upload Plugin and select the ZIP file.
- Click Install Now, then Activate Plugin.
- Navigate to Invoices → Settings, paste your B2Brouter API key and click Validate Key.
- Choose Automatic or Manual invoice generation mode and configure series codes for invoices and credit notes.
- (Recommended) Configure webhooks under Invoices → Settings → Webhook Configuration for real-time status updates.
屏幕截图:
常见问题:
Do I need a B2Brouter account?
Yes. The plugin requires an active B2Brouter eDocExchange subscription. Sign up at app.b2brouter.net and obtain an API key under Developers → API Keys.
Where do I configure Verifactu, KSeF or Chorus Pro?
Authority-specific configuration (certificates, tokens, identifiers) is managed in your B2Brouter dashboard, not in the WordPress plugin UI. Once your dashboard is configured, the plugin transparently sends invoices through the appropriate regime.
Does the plugin work for countries outside Spain, France and Poland?
Yes. Beyond the explicitly supported compliance regimes, the plugin generates standard electronic invoices (UBL, Facturae, Peppol) for the rest of the EU, the UK and other jurisdictions supported by B2Brouter. Need explicit compliance for another country? Open an issue.
Is HPOS (High-Performance Order Storage) supported?
Yes. The plugin declares full compatibility with WooCommerce HPOS / Custom Order Tables.
How do I get real-time invoice status updates?
Enable webhooks under Invoices → Settings → Webhook Configuration. Copy the auto-generated webhook URL into your B2Brouter dashboard (Developers → Webhooks), then paste the generated webhook secret back into WordPress. Updates arrive in under one second; a 6-hour fallback poll keeps things reliable.
Is the TIN/VAT field shown at checkout?
Yes, automatically. It works with both classic shortcode-based checkout and the new block-based checkout (WooCommerce 8.6+). The value is stored in _billing_tin on the order and on the customer profile for reuse.
Are credit notes generated automatically?
Credit notes are generated on demand for WooCommerce refunds when the parent order has an invoice. They follow the country-specific format (e.g. Spanish rectifying invoices) and are accessible from the order admin and from the customer's My Account page.
Are tests included?
Yes. The plugin ships with a PHPUnit test suite. See docs/DEVELOPER_GUIDE.md in the repository for instructions.
更新日志:
1.0.6
Added:
- Invoice line descriptions now include customer-visible item options — WooCommerce variation attributes and options added by product add-on plugins (Product Add-Ons, YITH, Extra Product Options, etc.) — appended under the product name. Private (
_-prefixed) meta stays hidden and values already in the product name aren't duplicated.
- Line discounts (coupons, gift cards, affiliate discounts) are now represented on the invoice as a per-line allowance, so the taxable base and total match what the customer actually paid.
- Order-level fees — surcharges (gift wrap, COD/payment fees) and fee-based discounts (store credit, loyalty programs, manual adjustments) — now appear as document-level allowance/charge lines in the correct VAT bucket, so the invoice reconciles with the order.
- Credit notes / rectificatives no longer under-reverse VAT: refund lines (negative totals) now keep their original tax rate, so an ES rectificative totals the exact negative of the original invoice.
- Refund-invoice failures no longer trigger a fatal PHP error; order notes route to the parent order and the call is guarded.
- B2Brouter PHP SDK upgraded from 1.2 to 1.3. Default API version is now
2026-04-20. The plugin's refund / credit-note payload migrates from the flat top-level amend fields to the new structuredinvoice_references[]array. Resolves a long-standing latent bug along the way: the refund reason was being emitted asamended_reason(extrad), which no API version has ever accepted — Rails strong-params had been silently dropping it on every release. The new payload places the reason inside the reference object, so the refund reason now actually reaches the backend. - Outbound API requests now identify the plugin in their
User-Agentheader via the SDK'sapp_infooption, making plugin-originated calls distinguishable from raw SDK calls in B2Brouter's server logs. - Tested against WordPress 7.0 "Armstrong" with WooCommerce 10.7.
- Hardened invoice PDF cache path validation so privileged users can no longer coax the plugin into reading, deleting, or email-attaching files outside the configured PDF storage directory. The WooCommerce REST API can no longer write keys in the
_b2brouter_*namespace on orders or refunds. Reported privately and coordinated with Really Simple Plugins; huge thanks to their team.
- Release ZIP no longer ships development-only files from the bundled B2Brouter PHP SDK (
.env.example, the package's owntests/,docs/,examples/,.github/,phpunit.xml.dist,CHANGELOG.md,README.md). Surfaced by the WordPress.org Plugin Review Team.
- Declare WooCommerce as a plugin dependency via the
Requires Plugins: woocommerceheader (WordPress 6.5+). Older WordPress versions ignore the header and fall back to the existing PHP-side dependency check.
- Plugin header
Plugin URIandAuthor URIwere both set to the same value;Plugin URInow points at the WooCommerce integration documentation (https://www.b2brouter.net/docs/#/en/integration/woocommerce) so the two URIs are distinct, as required by the WordPress.org submission validator.
wp_postmeta access remains).
Added:
== External Services ==disclosure section listing the B2Brouter API endpoint, data sent/received, transmission triggers, and links to Terms and Privacy Policy.- Build-time validation in
build-release.sh: the release ZIP is rejected ifreadme.txt,uninstall.php, or the bundled SDK is missing.
- Plugin slug renamed from
b2brouter-woocommercetob2brouter-for-woocommercefor WordPress.org trademark compliance. The user-facing plugin name is unchanged; PHP constants, option keys, and extension hooks are preserved for compatibility. - Bulk "Generate B2Brouter Invoices" now runs through Action Scheduler instead of a synchronous loop — no more 504 timeouts on large selections. Progress visible under WooCommerce → Status → Scheduled Actions.
- Staging/production environment selector removed from the settings page. The plugin defaults to production; staging can be reached via the
B2BROUTER_API_BASEconstant. - B2Brouter PHP SDK upgraded to v1.2 (API version
2026-03-02). API-key validation now uses the SDK's newAccountService. - Uninstaller routes all filesystem operations through the WordPress
WP_FilesystemAPI. - Invoice due date now uses
wp_date()for timezone-stable formatting.
- All flagged output paths now run through appropriate escape functions (
esc_html__,esc_html,wp_kses_post,(int)casts). - Exception messages are escaped at throw time so any consumer that echoes them remains safe.
- All superglobal reads (
$_POST/$_GET/$_REQUEST) go throughwp_unslash()before sanitization; nonce verification uses the canonicalcheck_admin_referer()pattern. - Settings API options declare
sanitize_callback(strict whitelist for invoice mode).
- Orphan PDF metadata cleanup is now HPOS-aware. The previous implementation queried
wp_postmetadirectly and silently missed orders on HPOS-only stores.
- Documented explicit support for three national e-invoicing regimes: Spain Verifactu, France DGFiP (PPF / Chorus Pro) and Poland KSeF. General electronic invoicing (UBL / Facturae / Peppol) continues to work for the rest of the EU, the UK, and other countries supported by B2Brouter. Authority-specific credentials and identifiers are managed in the B2Brouter dashboard, not in the WordPress plugin UI.
- Initial translation files for Catalan, German, Spanish, French and English plus a
.pottemplate. - Bulk "Generate Invoice" action on the HPOS orders screen; non-completed orders are skipped with a scoped admin notice.
- Organizational unit selector when the connected B2Brouter account has multiple organizational units.
uninstall.phpcleans upb2brouter_*options, sync timestamps and cached PDFs when the plugin is deleted.
- Invoice numbering: removed sequential and custom numbering modes. Remaining modes are WooCommerce order number and automatic B2Brouter numbering.
- Status sync: finalized invoices are no longer re-polled; stale non-final invoices use exponential backoff.
- Service loading: admin services instantiated only in admin context and customer services only on the frontend.
- Logging: replaced
error_log()withwc_get_logger(). Plugin messages now appear under WooCommerce → Status → Logs (sourceb2brouter-for-woocommerce). - Filesystem operations: PDF reads, writes, deletions and directory operations now use the WP Filesystem API.
- Welcome page redesigned; admin menu cleaned up (Welcome is the default landing page).
- Customer invoice download reliability from My Account → Orders.
_b2brouter_invoice_datenow parsed in the site timezone.- Eliminated the duplicate save-success notice on the settings page.
- Real-time webhook integration (HMAC-SHA256 signed
issued_invoice.state_changeevents; 5-minute timestamp window). - Smart polling strategy with optional 6-hour fallback when webhooks are enabled.
- Admin menu renamed to "Invoices" with a new custom SVG icon.
- Fixed TIN field saving for HPOS-enabled stores (classic checkout and admin order editing).
- Upgraded to B2Brouter PHP SDK v1.0.0.
- Fixed credit note number collision for refunds.
- Fixed WordPress 6.7.0 translation loading timing.
- Fixed refund invoice generation under HPOS.
- Improved invoice status sync UX (real status on creation instead of generic "draft").
- New "List of Invoices" admin page with pagination, sorting and bulk PDF download.
- Invoice status sync system with hourly cron and color-coded badges.
- Customer invoice generation from My Account in manual mode.
- Customer credit note downloads from My Account.
- Exponential backoff retry for PDF downloads.
- First public beta. Automatic / manual / bulk invoice generation, credit notes for refunds, PDF caching and email attachment, TIN/VAT collection, HPOS compatibility.
CHANGELOG.md in the repository.