Changelog

v1.2.0 — March 2026

New Features

Also Mark as Paid Checkbox

Available on any "Create VAT Invoice" or "Create Proforma" rule in the Invoice Rules tab. When enabled, the invoice is created and marked as paid in a single API call — no separate "Mark as Paid" rule needed.

Migration note: If you previously had a two-rule sequence (Create VAT Invoice on "Payment accepted" + Mark as Paid on "Shipped"), you can now consolidate to a single rule on "Payment accepted" with "Also Mark as Paid" enabled. The separate "Mark as Paid" rule can be set to "No Action".

Sell Date Source Setting

Choose whether the invoice sell date uses the original order date or the date the invoice was created in Fakturownia. Found in the Document Settings tab.

Default after upgrade: Order date. For most stores this is the correct setting — no action required after upgrading.

When you might change it: If your invoicing workflow involves creating invoices days or weeks after the order was placed (e.g., monthly batch invoicing for subscription stores), using "Invoice creation date" may better reflect the actual billing period. Consult your accountant.

Payment Terms Setting

Set the payment deadline (5, 7, 10, 14, 21, 30, 60, 90 days, end of month, or custom) directly from the module configuration in the Document Settings tab. Previously, payment terms had to be set as the default in your Fakturownia account settings, affecting all invoices regardless of how they were created.

Migration note: If you currently manage payment terms in Fakturownia's default settings and they are already correct for all your invoices, leave this new setting unset (value: 0 = inherit Fakturownia account default). Only configure it here if you need different terms for invoices created by this PrestaShop integration specifically.

Improvements

• EU OSS validation enhanced: The OSS flag is no longer applied to sales to the UK, Norway, Switzerland, Liechtenstein, Iceland, or other non-EU countries. Previously, any order with a buyer country different from Poland was flagged for OSS — now a strict EU member state list is checked. If you sell to non-EU European countries and had incorrect OSS flagging before, audit your recent invoices with your accountant.

• PDF Cache now event-driven: The cached PDF is invalidated immediately when Fakturownia reports a change to the invoice via webhook, rather than waiting for the 24-hour TTL. This requires Webhook Sync to be enabled in the Advanced tab. Stores without Webhook Sync continue to use the 24-hour TTL.

• NIP field label is now translatable: The "Company NIP" label at checkout can now be customised per language via PrestaShop's translation system (International → Translations → Modules translations). Useful for stores serving international customers who do not recognise "NIP" — change it to "Tax ID" or "VAT number" for your English or German language versions.

Bug Fixes

• Fixed: Invoice column in the admin orders list did not appear on PrestaShop 9.x due to a hook signature change in PS 9. The actionAdminOrdersListingFieldsModifier hook now uses the correct parameter structure for both PS 8.x and 9.x.

• Fixed: Race condition on very high-traffic stores where two simultaneous payment gateway webhooks could both trigger invoice creation within the same millisecond, defeating OID Deduplication. Deduplication now uses a database-level advisory lock to serialise concurrent requests for the same order ID.

v1.1.0 — January 2026

New Features

Seller Name Override

Override the seller name on invoices without changing your Fakturownia account settings. Enter a value in Document Settings → Seller Name Override. Leave blank to use the Fakturownia account default.

Use case: A single Fakturownia account is shared across two PrestaShop stores for different brands. Store A uses "Brand Alpha sp. z o.o." and Store B uses "Brand Beta s.c." — set the override in each store's module configuration.

Seller Contact Person

Set the contact person name printed on invoices. Configured per PrestaShop shop in Document Settings. Leave blank to use the Fakturownia account default.

Show Bank Account Toggle

Hide your bank account number on invoices for card-only or prepaid stores. Previously the bank account was always shown if configured in Fakturownia. Disable this in Document Settings for stores where showing bank account details would confuse card-paying customers.

Internal Note Sync

When enabled in Document Settings, the PrestaShop order note (added by staff or the customer at checkout) is copied to Fakturownia's internal note field on the invoice. Internal notes are not printed on the invoice PDF — they are visible only in the Fakturownia panel.

Notes Before / After Positions

Add free-text blocks to invoices above and below the line-item table. Configured in Document Settings. Supports plain text only (no HTML). Common uses: bank account details for proformas, legal disclaimers, project references.

Webhook Sync

Real-time invoice status updates from Fakturownia back to PrestaShop. When an invoice is marked paid or cancelled in Fakturownia, the ps_fakturapl_invoices record is updated automatically.

Setup required after upgrading: Go to Advanced tab → enable "Webhook Sync" → copy the webhook URL shown → register it in your Fakturownia account under Settings → Integrations → Webhooks.

Improvements

• Configuration panel redesigned with 6 tabs (previously 4). Payment Mapping and Compliance are now separate tabs instead of being embedded in the main settings tab. All existing settings were migrated automatically — no configuration loss during upgrade.

• Payment method mapping now loads all active payment modules from PrestaShop dynamically. Previously required manually typing module names. After upgrading, open the Payment Mapping tab and confirm all your payment modules are listed and correctly mapped.

• GTU code mapping expanded to support all 13 GTU groups (GTU_01 through GTU_13). Previously only GTU_01 through GTU_07 were available. Stores selling electronics (GTU_06), intangible services (GTU_12), or transport services (GTU_13) should configure the additional codes after upgrading.

Bug Fixes

• Fixed: Reverse Charge was applied when the buyer's VAT number was from the same country as the store (e.g., a Polish NIP on a Polish store). Reverse Charge now correctly requires the buyer's country to be different from the store's country.

• Fixed: PHP 8.2 deprecation warning (Deprecated: Creation of dynamic property) in the API client class. No functional impact, but the warning was visible in PHP error logs on 8.2+ installs.

Migration Notes for v1.0.x → v1.1.0

After upgrading, review these new settings and activate them as needed:

1. Payment Mapping tab: Open and confirm all payment modules are mapped correctly (the tab now loads dynamically).
2. Compliance tab: GTU_08 through GTU_13 are now available. If your products fall in these categories, add the mappings.
3. Advanced tab: Webhook Sync is off by default. Enable and configure it if you want real-time status updates from Fakturownia.
4. Document Settings: Four new fields (Seller Name Override, Seller Contact Person, Notes Before, Notes After, Internal Note). All are blank/off by default — configure as needed.

v1.0.0 — October 2025

Initial public release of Fakturownia Pro for PrestaShop.

Features at Launch

Invoice automation:

• Per-status invoice rules: Create VAT Invoice, Create Proforma, Create Receipt, Mark as Paid, Send Email, Cancel Invoice, Create Correction
• Email toggle per rule for automatic invoice delivery to buyers
• Runs on every PrestaShop order status change in real time

Configuration:

• 4-tab configuration panel: Connection, Invoice Rules, Document Settings, Advanced
• Buyer Name Format (full name, company, both)
• NIP field at checkout for B2B buyers

Tax compliance:

• EU OSS support for cross-border B2C sales (basic EU member check)
• Split Payment (MPP) annotation for Polish invoices over 15,000 PLN
• GTU code mapping for categories GTU_01 through GTU_07
• Reverse Charge for EU intra-community B2B sales
• OID Deduplication to prevent duplicate invoices from gateway retries

Customer portal:

• Replace PS Invoicing — Fakturownia invoice panel on customer order detail pages
• Customer My Invoices section in account dashboard
• PDF Cache for high-traffic stores

Admin tools:

• Invoice column in admin orders list
• Manual invoice creation button on order detail page (for historical orders)

Technical:

• Compatible with PrestaShop 8.0–9.0.3 and PHP 8.1–8.4
• Multistore support with per-shop configuration

Updating to the Latest Version

Download the latest version from your plugkit.io account (login → My Orders → Downloads) and upload the ZIP file via Modules → Module Manager → "Upload a module". PrestaShop detects the existing installation and updates in place — your configuration is preserved.

After every upgrade:

1. Clear PrestaShop cache: Advanced Parameters → Performance → Clear cache
2. Open the module configuration and review any new settings added in this version (see migration notes above)
3. Test a rule manually on a test order to confirm the upgrade was successful

Next Steps

• Installation — fresh install guide with post-install checklist
• Configuration — review new settings after an update
• Troubleshooting — issues after updating? Start here