Экран Конфигурация KSeF делает одну вещь: «Подключитесь к Национальной системе электронных фактур Польши (KSeF), чтобы отправлять счета-фактуры электронно». Сам токен вы генерируете не здесь, а в портале KSeF — Heltio его хранит и использует при каждой отправке.
Сверху экрана стоит напоминание: «KSeF (Национальная система электронных фактур Польши) обязателен для транзакций B2B с НДС с 1 февраля 2026 г.» Медицинские услуги, освобождённые от НДС, по-прежнему отправляются в KSeF, но с признаком BrakID для анонимных пациентов.
Как это сделать
Сгенерируйте токен в портале KSeF
Токен создаётся на стороне Министерства финансов. Поле в Heltio подсказывает прямо: «Сгенерируйте этот токен на портале KSeF в разделе „Ключи API"». Сгенерируйте его для того же NIP, на который вы выставляете счета.
Выберите среду
В разделе Доступ к API есть две возможности:
- Sandbox (Тест) — «Тестовая среда. Безопасна для использования с реальными данными».
- Продакшн — «Продакшн-KSeF. Отправленные сюда счета-фактуры имеют юридическую силу».
После выбора продакшна экран показывает предупреждение: «Режим продакшн: отправленные сюда счета-фактуры создают юридические обязательства». Тестовый токен не сработает в продакшне и наоборот — это два отдельных токена.
Экран лежит в настройках кабинета и имеет постоянную компоновку: (1) список пунктов слева — Конфигурация KSeF стоит в группе Настройка расчётов и фискальные, (2) раздел Доступ к API с выбором среды, (3) поле токена, (4) сохранение изменений.
Вставьте токен и сохраните
Поле Токен API KSeF принимает вставленное значение и больше его не показывает. После сохранения на этом месте видно Токен установлен, а рядом кнопку Заменить токен на случай ротации.
Проверьте подключение
Проверить подключение открывает и закрывает сессию в KSeF. Успех подтверждается сообщением Подключение успешно. KSeF доступен. Сделайте это до выставления первого счёта — иначе о плохом токене вы узнаете уже на документе, который ушёл в оборот.
Наблюдайте за состоянием системы
Панель Состояние системы показывает четыре вещи:
- Последняя успешная сессия — либо Никогда, если её ещё не было.
- Состояние токена — Действителен, Скоро истекает или Истёк или недействителен.
- Офлайн-очередь — сколько счетов ждёт повторной отправки.
- Среда — Sandbox или Продакшн.
Кнопка Повторить неудавшиеся отправки возвращается к счетам, отклонённым и застрявшим в офлайн-режиме; её подтверждает сообщение Неудавшиеся отправки поставлены в очередь.
Когда что-то не работает
KSeF token not configured
Что это значит: Нажата **Проверить подключение**, прежде чем был сохранён хоть какой-то токен. Это сообщение приходит с сервера и появляется на английском.
Истёк или недействителен
Что это значит: Состояние токена на панели **Состояние системы**. Токен потерял силу, был аннулирован в портале KSeF либо принадлежит другой среде.
Система KSeF отклонила этот счёт-фактуру. Выставьте корректировку, чтобы исправить и отправить повторно.
Что это значит: Документ дошёл до KSeF и был отклонён — чаще всего из-за данных покупателя или несовпадающего NIP.
Офлайн-режим
Что это значит: Статус счёта в списке. Подсказка над ним объясняет: KSeF был недоступен в момент выставления, документ ждёт в очереди, а срок составляет 7 дней.
Не удалось загрузить настройки KSeF.
Что это значит: Экран не получил ответа от сервера.
У кого есть доступ
Админ кабинета«Настройка KSeF доступна только Администраторам клиники.» Остальным ролям экран показывает замок и отсылает к администратору. Сохранение токена остаётся в журнале аудита.
Входящие счета от поставщиков попадают отдельно, в Ящик KSeF.
Связанные материалы
- Счета и KSeF — выставление и статусы отдельных документов.
- Онлайн-касса — чеки, то есть другая сторона обязанностей.
- Налоговый отчёт и JPK — сводки для бухгалтерии.
Связанные функции
Счета-фактуры и KSeF
Выставление счетов, проформ и корректировок, отправка в Национальную систему электронных фактур (KSeF) и Ящик KSeF со счетами от поставщиков. Нумерация, данные продавца и основание освобождения от НДС задаются один раз, в Расчётах.
Онлайн-касса
Печать чеков из Heltio на фискальной кассе, стоящей в регистратуре, — через программу-посредник Heltio Bridge. Список чеков уже работает; экран, на котором подключают мост и кассу, временно закрыт.
Сводка НДС и JPK
Месячная сводка по НДС кабинета и файл CSV для импорта в бухгалтерскую программу. Heltio не создаёт официальный файл JPK_V7 в XML — она даёт данные, из которых бухгалтерия этот файл собирает.