內容簡介
Invoicing Integration for iFirma and WooCommerce 外掛將您的 WooCommerce 商店與 iFirma 會計系統連接，讓您能夠從訂單畫面生成發票、下載 PDF 檔案，並允許客戶從「我的帳戶」下載文件，提升商店的管理效率。
【主要功能】
• 手動發票生成 - 從 WooCommerce 訂單編輯畫面直接創建發票
• 客戶同步 - 與 iFirma 承包商同步客戶資料
• NIP 欄位支援 - 在結帳時新增 NIP 號碼欄位
• WooCommerce Blocks 支援 - 與 Gutenberg 結帳區塊相容
• 進階增值稅映射 - 將 WooCommerce 稅類映射到 iFirma 增值稅代碼
• 發票下載 - 從 WordPress 管理後台直接下載 PDF
外掛標籤
開發者團隊
② 後台搜尋「Invoicing Integration for iFirma and WooCommerce」→ 直接安裝（推薦）
原文外掛簡介
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.
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
PRO Features
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
Get PRO Version
Requirements
WordPress 5.8 or higher
WooCommerce 5.0 or higher
PHP 7.4 or higher
Active iFirma account with API access
External services
This plugin connects to two third-party/external services: iFirma API (for invoicing) and NBP API (for exchange rates).
What is iFirma API?
iFirma is a Polish online accounting system that provides invoicing and accounting services for businesses. This plugin uses their official API to:
* Create and manage customers (contractors) in your iFirma account.
* Generate invoices (FREE).
* Generate proformas and rachunki (PRO).
* Download document PDFs.
What data is sent and when?
The plugin sends the following data to iFirma API (https://api.ifirma.pl/) in these situations:
When you click “Create Invoice” (or when automation triggers document generation in PRO version):
* Customer billing information: first name, last name, company name, VAT number (NIP), email, phone number, billing address (street, city, postal code, country).
* Order information: order items (product names, quantities, prices, VAT rates), shipping details, payment method, order date, order total.
When the plugin connects to iFirma API (on settings page load or when needed):
* Your API credentials entered in the plugin settings (for authentication).
* Requests to retrieve data required for issuing documents (e.g. templates/series/settings where applicable).
No data is sent automatically without your action in FREE version. The plugin communicates with iFirma API when:
* You manually create an invoice from the order screen.
* You open the plugin settings page (to test the connection and load configuration).
* You enable automatic document generation in PRO version (if installed).
Service provider information
Service name: iFirma API
Service URL: https://www.ifirma.pl/
API documentation: https://api.ifirma.pl/
Terms of Service: https://pomoc.ifirma.pl/pomoc-kategoria/oferta-serwisu-ifirma/regulaminy/
Privacy Policy: https://www.ifirma.pl/rodo/polityka-prywatnosci-ifirma-pl/
What is NBP API?
NBP (Narodowy Bank Polski) API is the Polish National Bank’s public API that provides official exchange rates for foreign currencies. This plugin uses it to obtain exchange rates when generating invoices in foreign currencies (e.g. EUR, USD) or when issuing WDT/OSS documents with non-PLN amounts. The rate is needed to convert amounts to PLN for iFirma according to Polish accounting rules.
What data is sent to NBP and when?
When you create an invoice in a foreign currency (or when automation triggers it in PRO):
* The plugin sends a GET request to NBP API with the currency code (e.g. EUR, USD) and the invoice/order date in the URL. No personal data, customer data, or order details are sent.
* Example URL: https://api.nbp.pl/api/exchangerates/rates/A/EUR/2024-01-15/?format=json
* The response (exchange rate) is cached for 24 hours to reduce requests.
No data is sent to NBP without creating a document that requires a foreign currency rate. The request happens only when an invoice (or proforma/rachunek in PRO) is being generated and the order currency is not PLN.
NBP service provider information
Service name: NBP API (Narodowy Bank Polski)
Service URL: https://api.nbp.pl/
API documentation: https://api.nbp.pl/
Privacy Policy: https://nbp.pl/o-nbp/kontakt/regulaminy/
By using this plugin, you acknowledge that customer and order data will be transmitted to iFirma for invoice generation purposes, and that currency codes and dates may be sent to NBP API to obtain exchange rates. You are responsible for ensuring compliance with applicable data protection laws (including GDPR) and informing your customers about this data processing.
