Получение токена доступа к API Честного знака

Статья в разработке!

Функционал доступен с релиза 2.8.3.

Содержание

Введение

API токен – это временный пароль, с помощью которого можно взаимодействовать с API Честного знака от имени сотрудника организации.

В программе настроено получение токена через расширение КриптоПро браузера. Для подписания токена используется приложение 5S Sign (sign.5systems.ru). Для этого в формируемую ссылку передается кодовая строка, полученная в “Честном знаке”, после ее подписания сертификатом происходит получение токена.

Примечание: Работа с маркировками в программе возможна без получения токена путем сканирования кода маркировки как на этапе приемки, так и на этапе выдачи товара.

После получения токена открываются следующие возможности в программе:

     1. Проверка состояния кода маркировки
     2. Получение информации
     3. Расшифровка кода
     4. Автоматический вывод кодов маркировки из оборота

Обработка “API токен Честный знак”

Обработка “API токен Честный знак” появляется после записи интеграции в меню программы в разделе Запчасти и склад → Продажи → Обработки:

В таблицу на форму обработки выводятся те организации, у которых есть интеграция с “Честным знаком”. Организации определяются автоматически по подразделениям из настроек интеграции – см. в статье.

При выделении курсором строки с организацией на нижней панели отображается информация об активности токена с датой и временем окончания его действия. 

Для обновления токена следует нажать кнопку “Обновить”:

Открывается QR-код со ссылкой для перехода к странице получения токена: можно скопировать ссылку и открыть ее в браузере либо перейти в браузер по кнопке “Открыть ссылку в браузере”. 

Важные комментарии:

     1. Рекомендуется использовать Яндекс-браузер.
     2. В браузере должно быть установлено расширение КриптоПро (см. в статье “Регистрация в системе Честный знак”).
     3. Необходима учетная запись в 5S Cloud.

При открытии ссылки в браузере производится переход к авторизации в 5S Cloud:

Необходимо ввести учетные данные пользователя 5S Cloud – имя и пароль. При этом открывается приложение 5S Sign. На странице “Создание подписи” следует выбрать сертификат и нажать кнопку "Создать подпись":

При этом появится токен:

Информация о новом токене автоматически приходит в программу и отображается на нижней панели формы обработки обновления токена:

Важно: Токен обновляется на 8 часов – это срок его действия.

Получить токен можно также через форму настройки интеграции с API – см. в статье.