PlugKit

Journal des modifications

Suivez chaque mise a jour de tous nos produits.

FakturaPL

v1.0.0

2026-03-30

Added — Invoice Rules

  • •**"Also Mark as Paid" checkbox** on create-invoice rules — create a VAT Invoice or Proforma and simultaneously mark it as paid in Fakturownia in a single rule, eliminating the need for a separate "Mark as Paid" step

Added — Document Settings (9 new settings)

  • •**Sell Date Source** — choose between order date and invoice creation date for the invoice sell date
  • •**Payment Terms** — set payment deadlines: 5, 7, 10, 14, 21, 30, 60, or 90 days, end of month, or custom
  • •**Internal Note** — pass PrestaShop order notes to Fakturownia's internal note field (panel-only, not printed on invoice)
  • •**Notes Before Positions** — custom text printed above the invoice line-item table
  • •**Notes After Positions** — custom text printed below the invoice line-item table
  • •**Seller Name Override** — override the default seller name from your Fakturownia account per-module
  • •**Seller Contact Person** — set a contact person name on invoices
  • •**Show Bank Account** — toggle bank account visibility on invoices

Improved — Compliance

  • •**OSS Validation** — now verifies that the buyer's country differs from the shop country AND is an EU member state before applying the OSS flag; prevents incorrect flagging for non-EU destinations (UK, Norway, Switzerland, etc.)
  • •**Reverse Charge** — when enabled, automatically sets tax to "exempt" (zw) on all positions, hides the tax column, and appends a reverse charge note to the invoice description

Security

  • •API tokens are sanitized from all log entries and error messages — tokens are never written to disk or displayed in the back office
  • •Webhook HMAC-SHA256 verification now uses timing-safe comparison to prevent timing-based forgery attacks
  • •All admin-displayed invoice data is HTML-escaped (XSS protection)
  • •Webhook idempotency prevents duplicate processing when the same event is delivered more than once

Performance

  • •**PDF caching (24h)** — invoice PDFs are cached locally; repeat requests are served from cache without an API call
  • •**PDF streaming** — large PDFs are streamed to a temp file rather than loaded fully into memory
  • •Database indexes added on frequently queried columns (`id_order`, `id_invoice`, `status`)
  • •Bulk operations continue on individual failure instead of aborting the entire batch

New API Fields

  • •`sell_date`, `issue_date`, `paid_date` — full date control
  • •`payment_to`, `payment_to_kind` — payment term deadlines
  • •`internal_note` — order notes passthrough
  • •`notes_before_positions`, `notes_after_positions`
  • •`seller_name`, `seller_person` — seller overrides
  • •`show_bank_account` — display toggle
  • •`quantity_unit` — per-position unit (szt., kpl., godz.)
  • •`additional_info` — PKWiU codes per position
  • •`exchange_currency`, `exchange_kind`, `exchange_currency_rate` — multi-currency support
  • •`exempt_tax_kind`, `np_tax_kind` — KSeF tax markers
  • •`cancel_reason` — reason for invoice cancellation

Fixed

  • •**NIP normalization** — Polish NIP numbers are now normalized before being sent to Fakturownia (strips PL prefix, dashes, and spaces). Resolves an issue where NIPs from some checkout modules were passed in a format Fakturownia rejected.
  • •**Partial refund corrections** — correction invoices now reflect the actual refunded amount instead of reversing the full invoice
  • •**Division by zero** — free products (zero unit price) no longer cause a fatal error during invoice creation
Factures correctives en cas de remboursement (partiel ou total)

v1.0.0

2026-03-30

Added — Invoice Rules

  • •**"Also Mark as Paid" checkbox** on create-invoice rules — create a VAT Invoice or Proforma and simultaneously mark it as paid in Fakturownia in a single rule, eliminating the need for a separate "Mark as Paid" step

Added — Document Settings (9 new settings)

  • •**Sell Date Source** — choose between order date and invoice creation date for the invoice sell date
  • •**Payment Terms** — set payment deadlines: 5, 7, 10, 14, 21, 30, 60, or 90 days, end of month, or custom
  • •**Internal Note** — pass Shopify order notes to Fakturownia's internal note field (panel-only, not printed on invoice)
  • •**Notes Before Positions** — custom text printed above the invoice line-item table
  • •**Notes After Positions** — custom text printed below the invoice line-item table
  • •**Seller Name Override** — override the default seller name from your Fakturownia account per-store
  • •**Seller Contact Person** — set a contact person name on invoices
  • •**Show Bank Account** — toggle bank account visibility on invoices

Improved — Compliance

  • •**OSS Validation** — now verifies that the buyer's country differs from the shop country AND is an EU member state before applying the OSS flag; prevents incorrect flagging for non-EU destinations (UK, Norway, Switzerland, etc.)
  • •**Reverse Charge** — when enabled, automatically sets tax to "exempt" (zw) on all positions, hides the tax column, and appends a reverse charge note to the invoice description

Security

  • •API tokens are sanitized from all log entries and error messages — tokens are never written to disk or displayed in the admin
  • •Webhook HMAC-SHA256 verification now uses timing-safe comparison to prevent timing-based forgery attacks
  • •Webhook idempotency prevents duplicate processing when the same event is delivered more than once

Performance

  • •**PDF caching (24h)** — invoice PDFs are cached locally; repeat requests are served from cache without an API call
  • •**PDF streaming** — large PDFs are streamed to a temp file rather than loaded fully into memory
  • •Database indexes added on frequently queried columns
  • •Bulk operations continue on individual failure instead of aborting the entire batch

New API Fields

  • •`sell_date`, `issue_date`, `paid_date` — full date control
  • •`payment_to`, `payment_to_kind` — payment term deadlines
  • •`internal_note` — order notes passthrough
  • •`notes_before_positions`, `notes_after_positions`
  • •`seller_name`, `seller_person` — seller overrides
  • •`show_bank_account` — display toggle
  • •`quantity_unit` — per-position unit (szt., kpl., godz.)
  • •`additional_info` — PKWiU codes per position
  • •`exchange_currency`, `exchange_kind`, `exchange_currency_rate` — multi-currency support
  • •`exempt_tax_kind`, `np_tax_kind` — KSeF tax markers
  • •`cancel_reason` — reason for invoice cancellation

Fixed

  • •**NIP normalization** — Polish NIP numbers are now normalized before being sent to Fakturownia (strips PL prefix, dashes, and spaces). Resolves an issue where NIPs from some checkout flows were passed in a format Fakturownia rejected.
  • •**Partial refund corrections** — credit notes now reflect the actual refunded amount instead of reversing the full invoice
  • •**Division by zero** — free products (zero unit price) no longer cause a fatal error during invoice creation
  • •**Draft order guard** — draft and incomplete Shopify orders are filtered out before invoice creation to prevent errors from orders with no payment
ReturnShield AI

v1.0.0

2026-03-24

Initial Release

  • •AI Return Reason Analyzer — NLP classifies return notes with 80% accuracy
  • •AI Action Queue with word-level diffs, evidence, and impact predictions
  • •Action Prioritizer ranks fixes by (savings x confidence / effort)
  • •Product Risk Scoring (0-100) based on 30+ signals per product
  • •Customer Risk Segmentation — 4 tiers from Low Risk to Serial Returner
  • •True Return Cost Calculator with all-in unit economics
  • •Real ROI tracking with before/after return rates and statistical significance
  • •Return fraud detection with serial returner scoring
  • •Bracketing pattern detection and automated fulfillment holds
  • •Sizing Social Proof Widget via product metafields
  • •Post-purchase "How's it fit?" emails 7 days after delivery
  • •Post-return surveys with conditional logic
  • •Shopify Flow integration — 4 triggers, 2 actions
  • •Automated alerts for return spikes, serial returners, and anomalies
  • •Monthly ROI email reports and AI-generated weekly digests
  • •6 languages: English, German, French, Spanish, Portuguese, Japanese
  • •Shopify OAuth with full GDPR compliance
  • •5-tier pricing from Free to Scale
Factures correctives en cas de remboursement (partiel ou total)

v0.9.0

beta — 2026-03-24

Initial Release

  • •Automatic invoice creation on order payment
  • •Credit notes automatically generated on refund
  • •Per-status invoice rules — define actions per order status
  • •Proforma invoice creation on order placement
  • •Auto-mark invoices as paid on fulfillment
  • •Auto-cancel invoices on order cancellation
  • •EU OSS (One-Stop Shop) compliance for cross-border B2C
  • •Split Payment (MPP) for Polish B2B transactions
  • •GTU codes for JPK reporting
  • •Reverse Charge support for intra-EU B2B
  • •NIP and EU VAT number validation
  • •Customer invoice dashboard in account area
  • •PDF invoice download from order status page
  • •Invoice attached to order confirmation email
  • •Multi-currency support — invoice in order currency
  • •Customizable invoice templates
  • •Bilingual invoices (language follows order)
  • •Bulk invoice generation for multiple orders
  • •Invoice status column in admin orders
  • •Duplicate prevention for payment retries
  • •Works with Fakturownia.pl and InvoiceOcean
  • •6 languages: English, German, French, Spanish, Portuguese, Polish
  • •Shopify OAuth with GDPR compliance
FakturaPL

v0.9.2

beta — 2026-03-22

Security

  • •**SSL verification always enforced** — debug mode no longer disables SSL peer/host verification (prevents MITM exposure of API tokens)
  • •**Webhook endpoint implemented** — new front controller with HMAC-SHA256 signature verification, payload size limits (64 KB), and proper HTTP status codes
  • •**External token sanitization** — tokens stored in DB are validated (alphanumeric, max 64 chars)

Fixed

  • •**Invoice duplicate race condition** — `id_order` column now UNIQUE with atomic `INSERT ... ON DUPLICATE KEY UPDATE`
  • •**API rate limit handling** — 429 responses trigger exponential backoff (up to 3 retries)

Improved

  • •Webhook payload storage capped at 64 KB to prevent table bloat
  • •Webhook cleanup method for processed webhooks older than 90 days
  • •User-Agent header reflects actual module version
FakturaPL

v0.9.1

beta — 2026-03-20

Added

  • •Invoice column in admin orders list with status badges
  • •Rich order detail panel with PDF download, resend email, convert Proforma to VAT
  • •Customer dashboard integration ("My Invoices" page with PDF downloads)
  • •Auto-refund correction invoices when credit slips are created
  • •OID deduplication to prevent duplicate invoices from payment gateway retries
  • •Option to replace PrestaShop's built-in invoicing with Fakturownia invoices

Improved

  • •Payment method mapping now loads all active payment modules dynamically
  • •Department dropdown fetches directly from Fakturownia API
  • •Better error messages when API connection fails

Fixed

  • •Webhook sync now correctly handles concurrent status updates
  • •PDF cache invalidation when invoice is modified in Fakturownia
HTMLBox Pro

v2.3.0

2026-03-15

Added

  • •A/B testing with automatic traffic splitting and conversion tracking
  • •Statistical significance calculator with confidence intervals
  • •Winner auto-selection when significance threshold is reached

Improved

  • •Code editor upgraded with better syntax highlighting and error detection
  • •Block list now shows conversion metrics inline

Fixed

  • •Cache invalidation now triggers correctly on block update in multistore mode
FakturaPL

v0.9.0

beta — 2026-02-15

Initial Release

  • •Per-status invoice rules (create VAT, Proforma, mark paid, cancel, correct)
  • •6-tab admin configuration panel (Connection, Rules, Documents, Payments, Compliance, Advanced)
  • •EU compliance: OSS, Split Payment (MPP), GTU codes, Reverse Charge
  • •NIP and EU VAT number validation
  • •Bilingual invoice support
  • •6 languages: Polish, English, German, French, Spanish, Italian
  • •PHP 8.1+ / PrestaShop 8.0+ compatible
  • •PSR-4 autoloading, no external dependencies
  • •Webhook signature verification and CSRF protection
HTMLBox Pro

v2.2.0

2026-02-01

Added

  • •Conditional display rules by country and zone
  • •Twig template support for dynamic content (customer name, cart total, language)
  • •Block duplication — one-click copy of any block with all settings

Improved

  • •WYSIWYG editor performance on large HTML blocks
  • •Hook selector now shows a visual wireframe of the storefront

Fixed

  • •Blocks with JavaScript no longer interfere with each other when on the same page
HTMLBox Pro

v2.1.0

2026-01-10

Added

  • •Date-based scheduling with start/end date and time
  • •Import/export blocks between multistore instances
  • •Responsive device visibility controls (desktop, tablet, mobile)
  • •Version history with one-click rollback

Improved

  • •Block list now supports bulk enable/disable
  • •Admin UI redesigned with cleaner layout and better mobile support

Fixed

  • •Multistore compatibility issue where blocks appeared on wrong shop
  • •Drag-and-drop ordering now persists correctly after page reload
HTMLBox Pro

v2.0.0

2025-12-01

Major Release

  • •Complete rewrite for PrestaShop 8.x/9.x compatibility
  • •New visual hook position selector with storefront wireframe
  • •New split-view editor (WYSIWYG + code side by side)
  • •New drag-and-drop block ordering within hooks
  • •New template library — save and reuse block designs
  • •New bulk operations (enable, disable, delete, export)
  • •6 languages: Polish, English, German, French, Spanish, Italian
  • •PHP 8.1+ required, PSR-4 autoloading, no external dependencies