Як додати інтеграцію з Fakturownia.pl?
Підключіть обліковий запис Fakturownia.pl до вибраної компанії у KSeFGPT, перевірте дані доступу та збережіть активну інтеграцію. Вам знадобляться субдомен облікового запису й токен API з Fakturownia.
- Модуль
- Інтеграції
- Час читання
- 4 хв
- Рівень складності
- Ви зробите це із заплющеними очима :)
- Опубліковано
- 16 серпня 2026
- Оновлено
- 20 серпня 2026
- Автор
- Rafał Zeidler
- Формат
- Текстова інструкція та відео
Письмова процедура
Що ви зробите
Ви підключите обліковий запис Fakturownia.pl до вибраної компанії у KSeFGPT. Перед збереженням перевірите, чи дають указаний субдомен і токен API змогу KSeFGPT підключитися до потрібного облікового запису.
Готова інтеграція буде доступна в модулі Інтеграції. Вона дає змогу отримувати рахунки з Fakturownia та передавати їх до KSeF, а також надсилати рахунки у зворотному напрямку - з KSeF до Fakturownia.
Вимоги
Перш ніж почати
Перевірте, чи у KSeFGPT вибрано компанію, з якою потрібно пов’язати обліковий запис Fakturownia.pl. Інтеграція зберігається саме для цієї компанії.
Ставтеся до токена API як до пароля. Не вставляйте його в повідомлення, звернення до служби підтримки чи знімки екрана. У формі KSeFGPT токен приховано, а після збереження він зберігається в зашифрованому вигляді.
| Елемент | Вимога |
|---|---|
| Доступ у KSeFGPT | Власник компанії або учасник організації з дозволом integrations:manage. Функція Автоматизація має бути доступна в тарифі. |
| Зовнішній обліковий запис | Активний обліковий запис Fakturownia.pl, який потрібно підключити до вибраної компанії. |
| Субдомен | Частина адреси перед .fakturownia.pl, наприклад firma-demo з адреси firma-demo.fakturownia.pl. |
| Токен API | Токен із Fakturownia.pl: Налаштування → API → Авторизаційний токен API. |
| Початкова точка | Після входу виберіть потрібну компанію та відкрийте модуль Інтеграції. |
| Час виконання | Близько 3 хвилин. |
Відео процесу
Відео показує вибір Fakturownia, введення субдомену й токена API, перевірку з’єднання та збереження активної інтеграції.
Підготуйте токен API з Fakturownia.pl
Увійдіть до Fakturownia.pl і відкрийте Налаштування → API → Авторизаційний токен API. Скопіюйте токен облікового запису, який потрібно підключити до KSeFGPT.
Також запишіть субдомен облікового запису. Якщо адреса має вигляд firma-demo.fakturownia.pl, у KSeFGPT введіть лише firma-demo - без https:// і без закінчення .fakturownia.pl.
Виберіть інтеграцію Fakturownia
У модулі Інтеграції натисніть Додати інтеграцію. Якщо підключень ще немає, скористайтеся кнопкою Додати інтеграцію в центрі сторінки.
У вікні Додати інтеграцію виберіть Fakturownia. Відкриється форма Налаштувати Fakturownia з полями Назва, Субдомен Fakturownia.pl і Токен API.
Введіть дані з’єднання
У полі Назва залиште Fakturownia або введіть назву, за якою можна розпізнати обліковий запис, наприклад Fakturownia - продажі в Польщі.
У полі Субдомен Fakturownia.pl введіть лише частину адреси перед .fakturownia.pl. Субдомен може містити малі літери, цифри й дефіс, але дефіс не може стояти на початку чи в кінці. Потім вставте скопійований Токен API.
Після заповнення всіх трьох полів стануть доступними кнопки Перевірити з'єднання та Зберегти.
Перевірте з’єднання
Натисніть Перевірити з'єднання. KSeFGPT перевірить субдомен і токен без збереження нової інтеграції.
Якщо дані правильні, кнопка змінить стан на Підключено. Підтвердження від бекенду може відображатися польською як Połączono z Fakturownią. навіть в українському інтерфейсі. Якщо змінити субдомен або токен, результат тесту буде очищено - виконайте тест повторно з новими даними.
Збережіть інтеграцію
Після успішного тесту натисніть Зберегти. Під час операції кнопка показуватиме Збереження..., а після успішного завершення вікно налаштування закриється.
З’явиться підтвердження Інтеграцію додано та картка з вибраною назвою, типом Fakturownia й позначкою Активна.
Кінцевий стан
Перевірте результат
Знайдіть нову картку в модулі Інтеграції. Вона має містити задану назву, опис Fakturownia та статус Активна.
Кнопка Редагувати дає змогу пізніше змінити назву, субдомен або токен. Кнопка Тест на збереженій картці показує загальне підтвердження налаштування. Для надійної перевірки даних доступу використовуйте у формі кнопку Перевірити з'єднання.
Діагностика
Якщо щось не працює
Порівняйте видиме повідомлення або поведінку форми з наведеною нижче таблицею.
| Ознака | Імовірна причина | Що робити |
|---|---|---|
| Модуль Інтеграції не відображається або екран заблоковано | Функція Автоматизація недоступна в тарифі або учасник організації не має дозволу integrations:manage. | Перевірте тариф або попросіть власника організації призначити групу з дозволом integrations:manage. |
| KSeFGPT просить вибрати компанію | У перемикачі облікового запису немає активної компанії. | Виберіть компанію, для якої потрібно створити інтеграцію, і знову відкрийте модуль Інтеграції. |
| Ви бачите Неправильний субдомен | Введено повну адресу, використано недозволені символи або дефіс стоїть на початку чи в кінці. | Введіть лише частину перед .fakturownia.pl, використовуючи малі літери, цифри та, за потреби, дефіси. |
| Кнопка Зберегти недоступна | Не вказано назву, правильний субдомен або токен API. | Заповніть усі три поля. Якщо субдомен неправильний, виправте його відповідно до повідомлення під формою. |
| Ви бачите Nie udało się połączyć z Fakturownią. і Unauthorized - check API token | Fakturownia.pl відхилила токен API. Ці повідомлення бекенду можуть залишатися польською та англійською в українському інтерфейсі. | Скопіюйте актуальний токен у розділі Налаштування → API потрібного облікового запису та повторіть тест. |
| Тест завершується повідомленням Не вдалося виконати тест з'єднання. | KSeFGPT не отримав відповіді від сервісу перевірки з’єднання. | Не зберігайте інтеграцію без перевірки. Трохи зачекайте й повторіть тест. Якщо проблема не зникає, зверніться до служби підтримки, не надсилаючи токен. |
| Після збереження нова картка не з’явилася | Збереження не завершилося успішно або подання не оновилося. | Перевірте повідомлення у верхньому правому куті. Якщо підтвердження не було, знову відкрийте форму. Не додавайте токен до звернення у службу підтримки. |
Що далі
Щоб отримати документи з Fakturownia, відкрийте Рахунки → Імпорт і виберіть Інтеграції. Укажіть збережену інтеграцію, тип документів і період, а потім отримайте список рахунків. Ви можете перевірити попередній перегляд, завантажити XML або надіслати вибрані документи до KSeF.
Щоб передати рахунки у зворотному напрямку, відкрийте експорт рахунків і виберіть До Fakturownia як місце призначення. KSeFGPT підтримує документи продажу та закупівлі й показує результат окремо для кожного рахунку.
Якщо ви зміните токен у Fakturownia.pl, поверніться до модуля Інтеграції, натисніть Редагувати на потрібній картці, вставте новий токен, перевірте з’єднання та збережіть зміни.
Підключіть Fakturownia.pl до KSeFGPT
Увійдіть, виберіть компанію та додайте підключення за допомогою субдомену й токена API.
Пов’язані інструкції
Як додати інтеграцію зі Slack у KSeFGPT?
Введіть URL incoming webhook та необов'язковий канал, надішліть тестове повідомлення і збережіть активне з'єднання для вибраної компанії.
Як отримати рахунки з Fakturownia.pl і надіслати їх безпосередньо до KSeF?
Отримайте рахунки продажу через збережену інтеграцію, виберіть потрібні документи та надішліть їх до KSeF без завантаження й ручного додавання XML-файлів.