Invoicing Integration for iFirma and WooCommerce
| 开发者 | devikit |
|---|---|
| 更新时间 | 2026年5月7日 17:06 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 6.9 |
| 版权: | GPLv3 |
| 版权网址: | 版权信息 |
详情介绍:
Invoicing Integration for iFirma and WooCommerce connects your WooCommerce store with the iFirma accounting system.
Generate invoices from the order screen, download PDFs, and let customers download documents from My Account. The plugin supports WooCommerce Blocks checkout and HPOS.
https://youtu.be/XJUJdKuv8CA
Key Features (FREE)
- Manual Invoice Generation - Create invoices directly from WooCommerce order edit screen
- Customer Synchronization - Sync customer data with iFirma contractors
- NIP Field Support - Add NIP number field to checkout (compatible with nip-field-woocommerce plugin)
- WooCommerce Blocks Support - Compatibility with Gutenberg checkout blocks
- Advanced VAT Mapping - Map WooCommerce tax classes to iFirma VAT codes/rates (23%, 8%, 5%, zw, 0%)
- Lump Sum (Ryczałt) Support - Add lump sum tax rate (ryczałt) to invoice positions (global default + per product/variation)
- Invoice Download - Download PDFs directly from WordPress admin
- Customer Download - Allow customers to download invoices from My Account → View Order
- Detailed Logging - Track API communications for debugging
- HPOS Compatible - Full support for WooCommerce High-Performance Order Storage
- Automatic Invoice Generation - Create invoices automatically on order status change
- Automatic Proforma Invoices - Issue proformas automatically for selected statuses
- Rachunki Support - Generate non-VAT documents (rachunki) when applicable
- Email with PDF Attachments - Send documents to customers as PDF attachments
- Bulk Operations - Generate documents and download PDFs for multiple orders with progress tracking
- GTU / PKWiU / Units - Product-level fields + global defaults in settings
- Global Invoice Notes - Define global invoice notes in settings (supports placeholders)
- Priority Support - Direct access to our support team
- Automatic Updates - Get new features and fixes automatically
- WordPress 5.8 or higher
- WooCommerce 5.0 or higher
- PHP 7.4 or higher
- Active iFirma account with API access
安装:
- Upload the plugin files to
/wp-content/plugins/invoicing-integration-for-ifirma-and-woocommerce/ - Activate the plugin through the 'Plugins' menu in WordPress
- Go to WooCommerce → iFirma
- Enter your iFirma API keys and test the connection
- Configure VAT mapping and invoice settings
屏幕截图:
常见问题:
Where do I find my iFirma API keys?
Log in to your iFirma account and generate/copy the keys in: Configuration → Extensions and integrations → API.
Does this work with WooCommerce Blocks?
Yes, the plugin is compatible with both classic checkout and WooCommerce Blocks checkout.
Can customers download their invoices?
Yes, customers can download invoices from the My Account → View Order page after an invoice has been created.
Is this compatible with NIP Field WooCommerce plugin?
Yes. The plugin detects popular NIP field plugin and avoids duplicating the field.
更新日志:
1.0.16
- Docs: minor readme updates.
- Docs: minor readme updates.
- Fix: contractor sync and invoices — empty billing postcode (
KodPocztowy) rejected by iFirma API (“adres.kodPocztowy nie może być puste”) while WooCommerce often has no postcode (e.g. UAE/Dubai and other countries, or omitted at checkout); we now substitute a configurable non-empty placeholder (default-). Override via WordPress filterdevikit_ifirma_empty_postcode_placeholder.
- Fix: OSS invoices — iFirma rejects
KrajDostawy/Kontrahent.KodKrajuGR (“Nieprawidłowy kraj dostawy… dwuliterowy kod ISO kraju z UE”); WooCommerce uses GR for Greece but the EU/VAT code expected in these fields is EL — same normalization as forPrefiksUE. ContractorKodKrajuon sync also maps GR → EL.
- Docs: readme screenshots section updated for WordPress.org asset screenshots (screenshot-1 through screenshot-10).
- Fix: contractor sync / WDT — Greek customers billing as GR: iFirma requires EU VAT prefix EL, not ISO
GR;Kontrahent.PrefiksUEis now normalized (fixes "Podana wartość Kontrahent.PrefiksUE przyjmuje nieprawidłową wartość" when only a numeric tax/VAT-like ID is entered).
- Fix: invoices for customers from Romania (RO) and Portugal (PT) failed with "Podana wartość pola Jezyk przyjmuje nieprawidłową wartość" — iFirma API does not support
roorptlanguage codes; both now fall back toen(English).
- New: append "Reverse charge" (translatable) to invoice notes for orders billed outside Poland and outside the EU when a tax identifier (NIP / EU VAT / Tax ID) is saved on the order.
- Fix: customer My Account invoice PDF download uses the same iFirma document type as the admin button (
_ifirma_invoice_type: foreign, OSS, WDT), not always domestic.
- Fix: when WooCommerce prices are entered including tax, send gross unit prices to iFirma with
LiczOdBRT (domestic, proforma, foreign currency, OSS, WDT, rachunek, corrections). Aligns document totals and VAT split with order totals charged at checkout.
- Fix: non-Poland billing addresses use
fakturawaluta(not domesticfakturakraj) even when the order is in PLN — avoids issuing Polish domestic invoices for foreign companies. - Fix:
fakturawalutain PLN — do not send exchange-rate related fields (e.g.KursWalutyWidoczny, NBP rate); fixes iFirma error about exchange rate only applying to non-PLN invoices.
- Fix: WDT invoices — add required API field Waluta and NBP rate when the document currency is not PLN.
- Fix: contractors and WDT — send Kontrahent.PrefiksUE only for valid EU member-state VAT prefixes; avoid invalid values for non-EU customers or non-EU tax IDs (iFirma API validation).
- Compatibility: resolve order tax identifier (NIP / EU VAT / foreign Tax ID) from multiple order meta keys so values saved by third-party plugins (WooCommerce EU VAT Number, nip-field-for-woocommerce, custom checkout fields, etc.) are sent to iFirma under the NIP label.
- New filters:
devikit_ifirma_order_tax_id_meta_keys(customize the list of checked meta keys) anddevikit_ifirma_order_tax_id(override the resolved value).
- Fix: save_admin_order_nip - handle WP_Post passed by woocommerce_process_shop_order_meta in some WooCommerce versions
- Plugin title: Invoicing Integration for iFirma and WooCommerce
- Editable NIP field in order meta (admin order edit screen)
- 5-minute delay for automatic invoice email (KSeF processing)
- Order column: total mismatch indicator (order vs document sum) with tooltip
- Compiled translations (pl_PL.mo)
- Initial release
- Manual invoice generation
- Customer synchronization
- Advanced VAT mapping
- Customer invoice download
- NIP field support with compatibility
- HPOS compatibility
- WooCommerce Blocks checkout support