Получение токена доступа к 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 – см. в статье.