Invoicing Integration for wFirma and WooCommerce

Description

Invoicing Integration for wFirma and WooCommerce connects your WooCommerce store with the popular wFirma accounting system used by thousands of Polish businesses.

Key Features (FREE)

• Manual Invoice Generation – Create invoices directly from WooCommerce order edit screen
• Customer Synchronization – Automatically sync customer data with wFirma contractors
• NIP Field Support – Add VAT number field to checkout (compatible with nip-field-woocommerce plugin)
• WooCommerce Blocks Support – Full compatibility with Gutenberg checkout blocks
• Advanced VAT Mapping – Map WooCommerce tax classes to wFirma VAT codes (23%, 8%, 5%, zw, np, 0%)
• Invoice Download – Download invoices directly from WordPress admin
• Customer Download – Allow customers to download their invoices from My Account page
• Global Invoice Notes – Set default notes (uwagi) for all invoices and proformas with variable placeholders ({order_number}, {customer_name}, etc.)
• Detailed Logging – Track all 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 pending orders
• Receipt (Paragon) Support – Automatic receipt generation for retail customers, including fiscal receipts (paragony fiskalne) and sales receipts (dowody sprzedaży / paragony niefiskalne)
• Receipt Notes – Set default notes (uwagi) for all receipts with variable placeholders ({order_number}, {customer_name}, etc.)
• Email with PDF Attachments – Send invoices directly to customers as PDF attachments
• Bulk Document Generation – Generate invoices, proformas, and receipts for multiple orders at once with progress tracking
• Bulk Email Sending – Send invoices and proformas by email to multiple customers in bulk operations
• MOSS / EU VAT OSS Support – Automatic MOSS handling for digital services sold to EU customers with proper VAT evidence
• Advanced Automation – Configure multiple trigger statuses and conditions
• Ryczałt ewidencjonowany – Global and per-product flat-rate tax (ryczałt) settings with automatic lumpcode on invoices and receipts
• Dekretacja – Accounting classification for invoices
• Warehouse Integration – Bi-directional stock sync between WooCommerce and wFirma
• Real-time Webhooks – Instant stock updates from wFirma
• WooCommerce Subscriptions – Full support for recurring invoices
• 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 wFirma account with API access

External services

This plugin relies on the wFirma API, a third-party accounting service, to generate invoices and manage customer data.

What is wFirma API?

wFirma 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 wFirma account.
* Generate invoices and proforma invoices (PRO version).
* Generate receipts (paragony fiskalne) and sales receipts (dowody sprzedaży / paragony niefiskalne) for retail customers (PRO version).
* Retrieve bank accounts, VAT codes, and other accounting data from your wFirma account.
* Download invoice PDFs.
* Synchronize warehouse stock between WooCommerce and wFirma (PRO version).

What data is sent and when?

The plugin sends the following data to wFirma API (https://api2.wfirma.pl/) in these situations:

When you click “Create Invoice” or when automatic invoice generation is triggered (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 wFirma API (on settings page load or when needed):
* Your wFirma Access Key and Secret Key (for authentication).
* Requests to retrieve your account settings: bank accounts, VAT codes, income categories, warehouse data (PRO version).

No data is sent automatically without your action. The plugin only communicates with wFirma API when:
* You manually create an invoice from the order screen.
* You enable automatic invoice generation in PRO version.
* You open the plugin settings page (to load account configuration).
* Warehouse synchronization is enabled in PRO version (webhook).

Service provider information

• Service name: wFirma API
• Service URL: https://www.wfirma.pl/
• API documentation: https://doc.wfirma.pl/
• Terms of Service: https://pomoc.wfirma.pl/-regulamin-swiadczenia-uslug
• Privacy Policy: https://pomoc.wfirma.pl/-polityka-prywatnosci

By using this plugin, you acknowledge that customer and order data will be transmitted to wFirma for invoice generation purposes. You are responsible for ensuring compliance with applicable data protection laws (including GDPR) and informing your customers about this data processing.