How to add a Fakturownia.pl integration
Connect a Fakturownia.pl account to the selected company in KSeFGPT, verify the access details, and save an active integration. You will need the account subdomain and a Fakturownia API token.
- Module
- Integrations
- Reading time
- 4 min
- Difficulty
- You could do this with your eyes closed :)
- Published
- August 16, 2026
- Updated
- August 20, 2026
- Author
- Rafał Zeidler
- Format
- Written guide and video
Written procedure
What you will do
You will connect a Fakturownia.pl account to the selected company in KSeFGPT. Before saving, you will check whether the subdomain and API token allow KSeFGPT to connect to the correct account.
The completed integration will be available in Integrations. It lets you fetch invoices from Fakturownia and submit them to KSeF, as well as send invoices from KSeF in the other direction - to Fakturownia.
Requirements
Before you start
Make sure the company you want to link to the Fakturownia.pl account is selected in KSeFGPT. The integration is saved for this specific company.
Treat the API token like a password. Do not paste it into messages, support tickets, or screenshots. KSeFGPT masks the token in the form and stores it in encrypted form after saving.
| Item | Requirement |
|---|---|
| KSeFGPT access | The company owner or an organization member with the integrations:manage permission. The Automation feature must be included in the plan. |
| External account | An active Fakturownia.pl account that you want to connect to the selected company. |
| Subdomain | The part of the address before .fakturownia.pl, for example company-demo from company-demo.fakturownia.pl. |
| API token | A Fakturownia.pl token: Settings → API → Authorization API Token. |
| Starting point | After signing in, select the correct company and open Integrations. |
| Time required | About 3 minutes. |
Process recording
The recording shows how to select Fakturownia, enter the subdomain and API token, test the connection, and save the active integration.
Prepare the Fakturownia.pl API token
Sign in to Fakturownia.pl and go to Settings → API → Authorization API Token. Copy the token for the account you want to connect to KSeFGPT.
Also note the account subdomain. If the address is company-demo.fakturownia.pl, enter only company-demo in KSeFGPT - without https:// and without the .fakturownia.pl suffix.
Select the Fakturownia integration
In Integrations, select Add integration. If you do not have any connections yet, you can use Add first integration in the center of the page.
In the Add integration dialog, select Fakturownia. The Configure Fakturownia form will open with the Name, Fakturownia.pl subdomain, and API token fields.
Enter the connection details
In Name, keep Fakturownia or enter a name that helps you identify the account, for example Fakturownia - domestic sales.
In Fakturownia.pl subdomain, enter only the part of the address before .fakturownia.pl. The subdomain may contain lowercase letters, digits, and hyphens, but a hyphen cannot appear at the beginning or end. Then paste the API token you copied.
Once all three fields are complete, Test connection and Save become available.
Test the connection
Select Test connection. KSeFGPT checks the subdomain and token without saving a new integration.
With valid details, the button changes to Connected. The backend confirmation may appear in Polish as Połączono z Fakturownią. even when you use the English interface. If you change the subdomain or token, the test result is cleared - run the test again for the new details.
Save the integration
After a successful test, select Save. While the integration is being saved, the button shows Saving..., and the configuration dialog closes when the operation succeeds.
You will see Integration added successfully. and a card with the name you selected, the Fakturownia type, and the Active status.
Final state
Check the result
Find the new card in Integrations. It should show the name you assigned, the Fakturownia description, and the Active status.
Edit lets you change the name, subdomain, or token later. Test on the saved card provides a general configuration confirmation; use Test connection in the form when you need to verify the access details.
Diagnostics
If something does not work
Compare the message or form behavior you see with the table below.
| Symptom | Likely cause | What to do |
|---|---|---|
| Integrations is not visible or the screen is locked | The Automation feature is not included in the plan, or an organization member does not have the integrations:manage permission. | Check the plan or ask the organization owner to assign a group with the integrations:manage permission. |
| KSeFGPT asks you to select a company | No company is active in the account switcher. | Select the company for which you want to create the integration, then open Integrations again. |
| You see Invalid subdomain | You entered the full address, used unsupported characters, or placed a hyphen at the beginning or end. | Enter only the part before .fakturownia.pl, using lowercase letters, digits, and optional hyphens. |
| Save is unavailable | The name, a valid subdomain, or the API token is missing. | Complete all three fields. If the subdomain is invalid, correct it according to the message below the form. |
| You see Nie udało się połączyć z Fakturownią. and Unauthorized - check API token | Fakturownia.pl rejected the API token. These backend messages may remain in Polish in the English interface. | Copy the current token from Settings → API in the correct account and run the test again. |
| The test ends with Failed to run the connection test. | KSeFGPT did not receive a response from the connection testing service. | Do not save the integration without verification. Wait a moment and run the test again. If the problem persists, contact support without sending the token. |
| The new card does not appear after saving | The save operation did not complete successfully or the view was not refreshed. | Check the notification in the top-right corner. If no success confirmation appeared, open the form again. Do not include the token in a support ticket. |
What next
To fetch documents from Fakturownia, go to Invoices → Import and select Integrations. Choose the saved integration, document type, and date range, then fetch the invoice list. You can review a preview, download the XML, or submit selected documents to KSeF.
To send invoices in the opposite direction, open invoice export and choose To Fakturownia as the destination. KSeFGPT supports sales and purchase documents and shows the result separately for each invoice.
If you change the token in Fakturownia.pl, return to Integrations, select Edit on the relevant card, paste the new token, test the connection, and save the change.
Connect Fakturownia.pl to KSeFGPT
Sign in, select a company, and add the connection using its subdomain and API token.
Related instructions
How to add a Slack integration in KSeFGPT
Enter an incoming webhook URL and an optional channel, send a test message and save the active connection for the selected company.
How to fetch invoices from Fakturownia.pl and submit them directly to KSeF
Fetch sales invoices through a saved integration, select the correct documents, and submit them to KSeF without downloading and manually uploading XML files.