Configuration

All settings for FCHub Fakturownia are managed through FluentCart's integration settings panel. You can also override the core credentials using wp-config.php constants for environments where you don't want secrets stored in the database.

Settings Location

Navigate to: FluentCart > Integrations > Fakturownia (click the Settings button on the Fakturownia card)

Or go directly to:

/wp-admin/admin.php?page=fluent-cart#/integrations/fakturownia

When connected, the page header shows a green "Connected to your-domain.fakturownia.pl" status. If credentials are invalid, a red error banner appears above the form.

Connection Settings

These are the required fields to connect your Fakturownia account.

Fakturownia Domain

Your Fakturownia subdomain. If your Fakturownia URL is https://mojafirma.fakturownia.pl, enter mojafirma.

You can also enter the full domain (e.g., mojafirma.fakturownia.pl). The plugin validates the domain format and only accepts *.fakturownia.pl domains — custom domains or arbitrary hostnames are rejected for security.

API Token

Your Fakturownia API authorization token. This is used to authenticate all API requests.

Department ID

The Fakturownia department ID is optional but recommended. When set, the plugin pulls seller information (company name, address, bank account, tax ID) from the specified department in Fakturownia.

To find your department ID:

1. Go to Settings > Company/Department in Fakturownia
2. Click on the department you want to use
3. The department ID is visible in the URL: https://app.fakturownia.pl/departments/XXXXX

If no department ID is provided, the plugin falls back to using your WordPress site name as the seller name.

Invoice Settings

These settings control how invoices are generated.

Invoice Type (Kind)

The type of document to create in Fakturownia.

Payment Type

The payment method shown on the invoice. This is the default value. The plugin also supports automatic mapping from FluentCart payment gateways -- see the payment type mapping section.

Invoice Language

The language used for invoice labels, headers, and text.

KSeF Auto Send

When enabled, every invoice created through the plugin is automatically submitted to KSeF (Krajowy System e-Faktur) via Fakturownia's built-in KSeF integration.

Checkout NIP Field

Controls whether the "I want a company invoice" checkbox appears at checkout.

When enabled, customers see a "I want a company invoice" checkbox during checkout. Checking it reveals a NIP (tax ID) input field. The NIP is stored with the order and used to create a B2B invoice with the customer's company details.

See the NIP at Checkout page for full details on how this works.

wp-config.php Constants

For production environments, staging/production parity, or CI/CD workflows, you can define the core credentials as PHP constants in your wp-config.php file. These constants override any values stored in the database.

// Fakturownia domain (subdomain or full domain)
define('FCHUB_FAKTUROWNIA_DOMAIN', 'mojafirma');

// Fakturownia API authorization token
define('FCHUB_FAKTUROWNIA_API_TOKEN', 'your-api-token-here');

// Department ID (optional)
define('FCHUB_FAKTUROWNIA_DEPARTMENT_ID', '12345');

This approach is recommended if you:

• Use different credentials for staging and production environments
• Want to keep API tokens out of the database for security
• Deploy with environment-specific configuration files
• Use a secrets manager that populates wp-config.php

Saving and Validating

When you click Save Settings in the FluentCart integration panel, the plugin automatically validates your API connection by making a test request to Fakturownia. If the connection is successful, the integration status is set to active and you'll see a confirmation message.

If the API test fails, your settings are still saved, but the integration status remains inactive. You'll see an error message indicating what went wrong -- typically an invalid domain or API token.

Complete Settings Reference