Как получить токены KSeF

Сгенерируйте токен аутентификации в портале KSeF и подключите его к eKsięgowy AI.

Чтобы отправлять и получать счета-фактуры через KSeF, eKsięgowy AI требуется токен аутентификации, выданный порталом KSeF. Это руководство проведёт вас через процесс его генерации и вставки в приложение. Вам понадобится Квалифицированная электронная подпись (KEP) или Доверенный профиль (Profil Zaufany).

Сначала используйте тестовую среду

Сгенерируйте токен в тестовой среде KSeF, убедитесь, что он работает в eKsięgowy AI, затем повторите процесс для продакшна.

Откройте портал KSeF

Откройте портал KSeF в новой вкладке. Сначала используйте тестовую среду, чтобы проверить настройку; перейдите на продакшн, когда будете уверены.

Страница входа Приложения налогоплательщика KSeF. Выберите Login.gov.pl (mObywatel, банкинг, Profil Zaufany) или Certyfikat kwalifikowany.

Войдите и выберите субъект

После нажатия на выбранный способ входа завершите аутентификацию (mObywatel, банкинг или Profil Zaufany через Login.gov.pl, либо ваш квалифицированный сертификат). Вернувшись в KSeF, введите NIP субъекта, от имени которого будете действовать.

Выбор идентификатора субъекта (NIP) — Введите NIP компании, от имени которой будете выставлять и получать счета-фактуры.

Откройте раздел «Токены»

После входа перейдите в боковом меню по пути Uprawnienia → Tokeny.

Главная KSeF с боковым меню, содержащим Tokeny — Главная KSeF. Боковое меню содержит Faktury, Historia sesji, Uprawnienia, Tokeny и Certyfikaty.

Заполните форму токена

В боковом меню откройте Tokeny → Generuj token. Дайте токену узнаваемое имя (например, «eKsiegowyAI»). Ниже имени отметьте права, нужные eKsięgowy AI: «wystawianie faktur» (выставление счетов) и «przeglądanie faktur» (просмотр счетов). Не давайте административных прав.

Форма генерации токена с полем имени и чекбоксами прав — Форма токена: поле имени вверху, чекбоксы прав ниже.

Сгенерируйте и подождите

Нажмите «Generuj token» внизу формы. KSeF поставит запрос в очередь — экран статуса покажет «W realizacji» (в процессе). Нажимайте «Odśwież» периодически, чтобы обновить статус. Генерация может занять несколько минут.

Экран идущей генерации токена — Экран статуса «Generowanie tokena» — нажмите «Odśwież», чтобы обновить.

Скопируйте токен

После завершения генерации экран показывает «Zakończono pomyślnie» (успешно завершено). Токен появляется в поле копирования с кнопкой «Kopiuj». KSeF предупреждает: «Token wyświetlany jest tylko raz» — сразу же скопируйте его в менеджер паролей.

Сгенерированный токен с кнопкой Kopiuj — Генерация токена завершена. Нажмите «Kopiuj» и сохраните токен в надёжном месте.

Токен показывается только один раз

Если вы его потеряете, необходимо сгенерировать новый. Храните его в менеджере паролей или в общем хранилище секретов вашей команды.

Вставьте токен в eKsięgowy AI

Откройте настройки KSeF в нашем приложении. Выберите «Direct KSeF API» как режим интеграции и соответствующую среду (Production, Demo или Test — ту же, в которой вы сгенерировали токен). Вставьте токен в поле «KSeF Authorization Token», введите NIP и нажмите «Save Settings».

Страница настроек KSeF в eKsięgowy AI — Страница /ksef/settings — введите токен и NIP, затем нажмите Save Settings.