Configuration
FakturaPL has a 6-tab configuration panel. This guide covers each tab in detail.
Connection Tab
The Connection tab manages your Fakturownia API connection.
- API Token β Your Fakturownia.pl or InvoiceOcean API authorization code
- Custom Domain β Leave empty to auto-detect from your token. Set manually if you use a custom domain (e.g.,
yourcompany.fakturownia.pl) - Test Connection β Click to verify the API connection is working
Invoice Rules Tab
This is FakturaPL's most powerful feature. Define what happens at each order status change.
Available Actions
| Action | Description | |---|---| | Create VAT Invoice | Creates a full VAT invoice in Fakturownia | | Create Proforma | Creates a proforma (advance) invoice | | Create Receipt | Creates a receipt (paragon) | | Mark as Paid | Marks the existing invoice as paid | | Send Email | Sends the invoice to the customer via Fakturownia | | Cancel Invoice | Cancels the invoice in Fakturownia |
Each rule also has an email toggle β enable it to automatically send the invoice to the customer when the action fires.
Document Settings Tab
- Department β Select from a dropdown loaded from your Fakturownia account
- Category β Optional invoice category for organization
- Buyer Name Format β Choose how the buyer name appears on the invoice (company name, full name, or both)
- Bilingual Invoices β Enable to generate invoices in two languages
Payment Mapping Tab
Map each PrestaShop payment method to the correct Fakturownia payment type:
- Bank Transfer β
transfer - Credit Card β
card - PayPal β
paypal - Cash on Delivery β
cash
FakturaPL dynamically loads all active payment modules from your PrestaShop installation.
Compliance Tab
EU OSS (One Stop Shop)
Enable to automatically flag cross-border B2C sales. Required if you sell to consumers in other EU countries.
Split Payment (MPP)
Enable for Polish B2B invoices. Automatically applies the "mechanizm podzielonej pΕatnoΕci" annotation for invoices over 15,000 PLN.
GTU Codes
Map your product categories to GTU codes for Polish JPK reporting. FakturaPL supports all 13 GTU groups (GTU_01 through GTU_13).
Reverse Charge
Enable for EU B2B transactions. Automatically applies reverse charge annotations when the buyer provides a valid EU VAT number.
Advanced Tab
- OID Deduplication β Prevent duplicate invoices when payment gateways retry callbacks
- Replace PS Invoicing β Replace PrestaShop's built-in invoice system with Fakturownia invoices in the customer account
- Webhook Sync β Enable real-time sync of invoice status changes from Fakturownia to PrestaShop
- PDF Cache β Cache downloaded PDF invoices locally for faster access