SoftBlaze
FakturaPLDocumentationTroubleshooting

Troubleshooting

Connection Issues

"API connection failed" error

Cause: The Fakturownia API token is incorrect or the API is temporarily unavailable.

Solution:

  1. Verify your API token in Fakturownia: Settings → Account → Integration → API Authorization Code
  2. Make sure you're using the API Authorization Code, not the OAuth token
  3. Check that your server can reach fakturownia.pl (no firewall blocking outbound HTTPS)
  4. Try clicking "Test Connection" again — the API may have been temporarily unavailable

"Custom Domain" field

If you use a white-label Fakturownia domain (e.g., invoices.yourcompany.pl), enter it in the Custom Domain field. Leave it empty for standard fakturownia.pl accounts.

Invoice Issues

Invoices not created automatically

Check these in order:

  1. Verify the Invoice Rules tab has rules configured for the order status that changed
  2. Check that the rule has the correct action (e.g., "Create VAT Invoice")
  3. Look at the PrestaShop logs for any FakturaPL error messages
  4. Verify the API connection is still active (Connection tab → Test Connection)

Duplicate invoices

Cause: Payment gateway retrying the callback webhook.

Solution: Enable OID Deduplication in the Advanced tab. This adds a unique order identifier to each invoice request and prevents duplicates.

Wrong payment type on invoice

Cause: Payment method mapping is not configured.

Solution: Go to the Payment Mapping tab and map each PrestaShop payment method to the correct Fakturownia payment type.

Customer Dashboard

"My Invoices" page not showing

Cause: The "Replace PS Invoicing" option is not enabled.

Solution: Go to Advanced tab → enable "Replace PrestaShop built-in invoicing". This adds the Fakturownia invoices to the customer's account page.

PHP Compatibility

Errors on PHP 8.1+

FakturaPL is fully compatible with PHP 8.1, 8.2, 8.3, and 8.4. If you're experiencing errors:

  1. Make sure you're running FakturaPL v1.0.0 or newer
  2. Check that no other modules are conflicting (disable other Fakturownia-related modules)
  3. Clear PrestaShop's cache: Advanced Parameters → Performance → Clear Cache

Still Need Help?

Contact us at hi@softblaze.net with:

  • Your PrestaShop version
  • Your PHP version
  • The error message or screenshot
  • Steps to reproduce the issue

We typically respond within 24 hours on business days.

Documentation

InstallationConfigurationTroubleshootingAPI Reference