Nestero Integration for Fakturownia

Nestero Integration for Fakturownia connects your store to Fakturownia.pl, a Polish invoicing and accounting service. Orders become VAT invoices without anyone retyping them.

The free version includes:

• connection to your Fakturownia account with an API token (the token is encrypted in the database and saved only after a successful connection test),
• automatic or manual VAT invoices triggered by the order statuses you choose,
• three modes: every order / only when the customer asks (checkbox plus every B2B order) / manual only,
• automation rules: business orders only, private orders only, skip orders worth zero,
• a tax number (NIP) field with checksum validation in the classic checkout, the block checkout, My Account and the order screen,
• customer deduplication in Fakturownia (external id / tax number) so you do not end up with two cards for one contractor,
• WooCommerce to Fakturownia VAT rate mapping per tax class, which tells a 0% rate apart from an exemption, and refuses to guess an unmapped rate,
• support for stores priced gross and net, plus a document total check after the invoice is issued,
• invoice delivery by e-mail: through WooCommerce (PDF fetched from the API, your own subject and body) or through Fakturownia,
• the invoice PDF attached to standard WooCommerce transactional e-mails,
• three layers of idempotency (lock, queue, oid_unique) so one order never produces two documents,
• detection of invoices issued outside the plugin, marked with an “external” badge,
• order screen actions: issue, retry, send e-mail, refresh status, cancel, unlink,
• retries with backoff (5 minutes up to 24 hours), with validation and authorisation errors handled separately,
• a dashboard, a filterable document list and logs that mask sensitive data,
• full HPOS and block checkout compatibility.

The Pro extension (sklep.nestero.pl) adds correction invoices for refunds, including partial and repeated ones, KSeF status synchronisation (webhook and polling, with the customer e-mail held back until the document receives its KSeF number) and bulk operations.

External services

This plugin relies on Fakturownia.pl (https://fakturownia.pl), an external invoicing service. The plugin cannot issue any document without it: every invoice is created in your own Fakturownia account, identified by your account subdomain and API token.

The plugin contacts the API only when there is something to do — when an invoice or a correction is issued, when a contractor is looked up or created, when an invoice PDF is downloaded, when an e-mail is sent through Fakturownia, and once a day for a connection health check.

Data sent: the order’s billing details (first and last name or company name, address, tax number, e-mail address, phone number) together with the order items, quantities, prices and VAT rates. Nothing is sent for orders that are not invoiced.

Endpoint: https://{your-account}.fakturownia.pl/*.json
API documentation: https://github.com/fakturownia/API
Terms of service: https://fakturownia.pl/regulamin
Privacy policy: https://fakturownia.pl/polityka-prywatnosci