Письмова процедура

Що ви зробите

Ви виберете компанію в налаштуваннях KSeFGPT і підключите її до KSeF за допомогою одного з двох типів облікових даних: токена або сертифіката.

Для сертифіката можна завантажити наявну пару приватного ключа й сертифіката або підписати Довіреним профілем одноразову заяву, завантажену з KSeFGPT, а потім надіслати підписаний XML-файл.

Після збереження облікових даних KSeFGPT зможе виконувати операції в KSeF від імені цієї компанії в межах наданих дозволів.

Вимоги

Перш ніж почати

З’єднання зберігається окремо для кожної компанії. Перед початком переконайтеся, що потрібну компанію вже додано до KSeFGPT.

Елемент	Вимога
Доступ	Можливість відкрити Налаштування та керувати авторизацією KSeF.
Компанія	Компанія, додана до KSeFGPT із правильним податковим номером NIP.
Початкова точка	Після входу відкрийте Налаштування, а потім вкладку З’єднання KSeF.
Дані для з’єднання	Токен KSeF, наявна пара приватного ключа й сертифіката або доступ до Довіреного профілю особи, уповноваженої підписати заяву на сертифікат для вказаного NIP.

Відео процесу

Відео показує створення сертифіката для з’єднання з KSeF.

2:42

Як створити сертифікати KSeF і підключити застосунок у тестовому середовищі

01Крок

Виберіть компанію

На вкладці З’єднання KSeF знайдіть розділ Облікові дані KSeF. KSeFGPT показує окрему картку для кожної компанії, доданої до облікового запису.

На потрібній картці перевірте назву компанії та NIP. Якщо з’єднання ще не налаштовано, ви побачите повідомлення про відсутність облікових даних для цієї компанії та кнопки для початку налаштування.

02Крок

Виберіть тип облікових даних

KSeFGPT підключається до KSeF за допомогою токена або сертифіката. Для сертифіката можна завантажити наявні файли або скористатися окремою кнопкою Довіреного профілю, щоб підписати й завантажити одноразову заяву.

Облікові дані	Що підготувати	Як відбувається налаштування
Токен	Токен доступу, створений у застосунку KSeF.	Вставте токен у KSeFGPT і збережіть облікові дані.
Сертифікат - наявні файли	Приватний ключ .key або .pem, сертифікат .crt, .cer або .pem та, за потреби, пароль ключа.	Завантажте приватний ключ і файл сертифіката.
Сертифікат - через Довірений профіль	Доступ до Довіреного профілю особи, уповноваженої діяти для NIP компанії.	Завантажте одноразову заяву, підпишіть її на gov.pl і завантажте підписаний XML-файл, щоб KSeFGPT налаштував сертифікат.

Налаштування з’єднання KSeF у KSeFGPT з варіантами сертифіката й токена — Крок 2

Варіант 1. Токен KSeF

На картці компанії виберіть Додати облікові дані, а потім Токен. У поле Токен KSeF вставте токен доступу, який ви раніше створили в застосунку KSeF.

Натисніть Додати. KSeFGPT перевірить токен перед збереженням. Якщо токен неправильний або його відкликано, ви побачите відповідне повідомлення.

Варіант 2A. Сертифікат KSeF із файлів

На картці компанії виберіть Додати облікові дані, а потім Сертифікат. У KSeFGPT цей спосіб позначено як стандартний.

Додайте приватний ключ у форматі .key або .pem та сертифікат у форматі .crt, .cer або .pem. Якщо ключ зашифрований, також введіть пароль у необов’язковому полі Пароль ключа.

Натисніть Зберегти PEM-сертифікат. Після успішної перевірки у списку облікових даних з’являться власник сертифіката й термін його дії.

Варіант 2B. Сертифікат KSeF через Довірений профіль

У цьому процесі Довірений профіль не є окремим способом автентифікації в KSeF. Він використовується для підписання одноразової заяви, потрібної для з’єднання сертифікатом. На картці компанії виберіть Підключити через Довірений профіль. KSeFGPT підготує заяву, пов’язану з компанією та її NIP.

На кроці Завантажити заяву збережіть підготовлений файл. Потім виберіть Відкрити gov.pl і підписати заяву, увійдіть за допомогою Довіреного профілю, підпишіть документ і збережіть підписаний файл на пристрої.

Поверніться до KSeFGPT, перейдіть до кроку Завантажити файл і виберіть підписаний XML-файл. Наприкінці натисніть Завершити й підключити. KSeFGPT використає підписану заяву, щоб завершити налаштування з’єднання з KSeF через сертифікат.

Варіант 2B. Сертифікат KSeF через Довірений профіль

Кінцевий стан

Перевірте результат

Після збереження токена або сертифіката нові облікові дані з’являться на картці потрібної компанії. Для сертифіката KSeFGPT покаже власника й термін дії, а для токена — замасковану частину значення.

Після завантаження заяви, підписаної Довіреним профілем, закрийте вікно та перевірте, чи облікові дані сертифіката відображаються на картці компанії.

Діагностика

Якщо щось не працює

Порівняйте повідомлення в KSeFGPT із найпоширенішими причинами відхилення з’єднання.

Ознака	Імовірна причина	Що зробити
Токен відхилено	Токен неправильний або його відкликано в KSeF.	Створіть або скопіюйте правильний токен і спробуйте ще раз.
Не вдається зберегти сертифікат	Немає ключа чи сертифіката або пароль зашифрованого ключа неправильний.	Перевірте пару файлів .key/.crt і пароль ключа.
NIP у сертифікаті не відповідає компанії	Сертифікат належить іншому суб’єкту.	Виберіть сертифікат, виданий для компанії, яку налаштовуєте в KSeFGPT.
Термін дії заяви на сертифікат минув	Заяву не підписано Довіреним профілем і не завантажено протягом строку її дії.	Виберіть Створити повторно та підпишіть нову заяву.
Підписану заяву відхилено	Особа, яка підписала заяву, не має дозволу діяти для вказаного NIP у KSeF.	Перевірте її повноваження, зокрема необхідну довіреність ZAW-FA.