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.