Баланс лицевого счёта Честного Знака в заголовке программы для УТ 11.4

Расширение показывает остаток лицевого счёта Честного ЗНАКа прямо в заголовке главного окна 1С, например «ЧЗ: 7 072,18 руб.». Сумму видно постоянно, не нужно заходить в личный кабинет ГИС МТ, и пополнить счёт можно до того, как закончатся деньги на коды маркировки. Баланс запрашивается через True API раз в час регламентным заданием и при входе в программу. Открытые окна подхватывают новое значение в течение 5 минут. Если цифра давно не обновлялась, рядом показывается время, на которое она актуальна. Авторизация штатная: используется токен ИС МП, который конфигурация получает при обмене. Сертификат и пароль расширение не хранит. В настройках — организация и товарная группа (по умолчанию берутся из последнего документа маркировки), текущий баланс, текст последней ошибки и кнопка «Обновить баланс сейчас». Расширение устанавливается без изменения конфигурации.

Зачем это нужно

Коды маркировки Честного ЗНАКа оплачиваются с лицевого счёта в ГИС МТ. Когда деньги заканчиваются, заказ кодов останавливается, а узнают об этом обычно в самый неудобный момент — когда нужно срочно промаркировать поставку. Чтобы посмотреть остаток, приходится заходить в личный кабинет ГИС МТ, и делают это нечасто.

Расширение выводит остаток лицевого счёта прямо в заголовок главного окна 1С. Сумма всегда на виду у всех, кто работает в программе:

Управление торговлей, редакция 11 / ЧЗ: 7 072,18 руб.

Возможности

• Баланс в заголовке программы — у всех пользователей, без открытия отдельных форм.
• Автоматическое обновление по расписанию — регламентное задание раз в час запрашивает баланс в ГИС МТ.
• Свежая цифра без перезахода — открытые окна раз в 5 минут перечитывают сохранённое значение. Это лёгкий вызов на сервер, в ГИС МТ он не обращается.
• Обновление при входе — если значение старше часа, при входе в программу баланс обновляется в фоне. Это выручает и в файловой базе, где регламентные задания не выполняются.
• Видно, что цифра устарела — если баланс не обновлялся больше двух часов, в заголовке рядом с суммой появляется время: ЧЗ: 7 072,18 руб. (на 22.09 08:00).
• Форма настроек — текущий баланс, время получения, текст последней ошибки и кнопка «Обновить баланс сейчас».
• Штатная авторизация — используется токен ИС МП, который конфигурация сама получает при обмене. Сертификаты и пароли расширение не хранит.
• Без изменения конфигурации — всё сделано расширением, конфигурация остаётся на поддержке.

Как это работает

1. Регламентное задание СЧ_ОбновлениеБалансаЧестногоЗнака раз в час берёт действующий токен ИС МП и запрашивает баланс методом True API /api/v3/true-api/elk/product-groups/balance.
2. Полученная сумма сохраняется в константах расширения. Сервис отдаёт баланс в копейках, расширение переводит его в рубли.
3. Заголовок окна строится только из сохранённого значения, поэтому ни запуск программы, ни работа пользователей не ждут ответа ГИС МТ.
4. Если обновление не удалось, в заголовке остаётся последнее известное значение, а причина записывается в настройки и в журнал регистрации (событие «Баланс Честного ЗНАКа»).

Настройка

Раздел «НСИ и администрирование» → «Настройки баланса Честного ЗНАКа».

Если в базе одна организация и одна товарная группа, настройки можно не заполнять.

Установка

1. Загрузите расширение: «Администрирование» → «Печатные формы, отчёты и обработки» → «Расширения» → «Добавить из файла».
2. Снимите флаг «Безопасный режим»: расширению нужно отправлять HTTP-запросы в ГИС МТ.
3. Перезапустите программу. Регламентное задание предопределённое и включается само, расписание при необходимости меняется в «Регламентных и фоновых заданиях».
4. Выполните обмен с ИС МП, чтобы в базе появился токен True API, затем нажмите «Обновить баланс сейчас» в настройках.

Важно знать

• Токен ИС МП живёт 10 часов. Его создаёт конфигурация при обмене с ИС МП, потому что для подписи нужен сертификат пользователя. Регламентное задание подписывать не умеет и использует готовый токен. Если токен истёк, обновление пропускается до следующего обмена, а в заголовке остаётся последняя сумма с временем её получения.
• Токен СУЗ не подходит. Для баланса нужен токен True API. Если в течение дня работают только с заказом кодов через СУЗ, токен True API может не обновляться.
• Права. Заголовок видят все пользователи, дополнительные роли не нужны. Форма настроек доступна пользователям с ролью «Полные права».
• Не обращается в ГИС МТ чаще необходимого. Запрос в ГИС МТ — раз в час от регламентного задания и при входе, если значение устарело. Перечитывание раз в 5 минут берёт сумму из базы.

Совместимость

• «1С:Управление торговлей», редакция 11.4. Проверено на 11.4.14.181.
• Платформа 8.3.27 и выше.
• Требуется подключённая подсистема интеграции с ИС МП (Честный ЗНАК).
• Управляемое приложение: тонкий клиент и веб-клиент.

Состав расширения

• Константы: организация и товарная группа (настройки), баланс, дата баланса, ошибка обновления (сохранённое значение).
• Общие модули СЧ_БалансЧестногоЗнака*: сервер, вызов сервера, клиент, глобальный.
• Регламентное задание СЧ_ОбновлениеБалансаЧестногоЗнака.
• Общая форма СЧ_НастройкиБалансаЧестногоЗнака.
• Заимствованы: ОбщегоНазначенияКлиентПереопределяемый (обработчики &После), подсистема «Администрирование», роль «Полные права».

Все объекты расширения имеют префикс СЧ_, поэтому с другими доработками они не пересекаются.