Работа с ГИС МТ по API.

Для реализации возможности работы с маркированными товарами (обувью, одеждой и пр.) в систему Айтида был добавлен модуль, позволяющий выполнять следующие операции:

1. Формировать файлы для запроса GTIN маркируемой продукции.
2. Запрос кодов маркировки для начального остатка продукции.
3. Ввод в оборот начальных остатков продукции.
4. Перемаркировка продукции.
5. Списание кодов маркировки продукции.
6. Получение входящих ТТН с маркированной продукцией.
7. Отправка исходящих ТТН с маркированной продукцией.

Предварительные настройки

Подключение к ГИС МТ.

На примере работы с обувными товарами. Перед началом работы с модулем Маркировка необходимо зарегистрироваться в личном кабинете ГИС МТ согласно инструкции https://честныйзнак.рф/business/projects/footwear/ раздел Инструкция по началу работы в системе маркировки обуви:

После регистрации в личном кабинете ГИС МТ необходимо получить и сохранить следующие данные:

1. OMS ID - идентификатор станции управления заказами кодов маркировки. Необходим для получения кодов маркировки для начального остатка продукции.
2. Идентификатор соединения – необходим для получения кодов маркировки для начального остатка продукции.

Для получения этих идентификаторов необходимо:

1. Авторизоваться в СУЗ-Облако. Участники товарной группы «Табак» для перехода в СУЗ должны использовать прямую ссылку (URL-адрес) на СУЗ. Участникам товарной группы «Лекарственные препараты для медицинского применения» после авторизации в ФГИС МДЛП необходимо перейти в раздел «Профиль», затем нажать на кнопку «Заказ SGTIN».

Участникам иных товарных групп после авторизации в ФГИС МТ под пользователем с ролью «Администратор» необходимо в левом верхнем углу нажать на кнопку и в контекстном меню выбрать значение «Станция управления заказами».

2. После успешной авторизации в СУЗ вам необходимо перейти в раздел «Устройства» (кнопка расположена в боковом меню слева). Данный раздел доступен для просмотра всем пользователям участника товарной группы «Лекарственные препараты для медицинского применения». Для редактирования пользователям с ролью «Администратор». Для иных товарных группы данный раздел для просмотра и редактирования доступен только пользователям с ролью «Администратор».

3. Перейдя в раздел «Устройства», вы сможете увидеть весь список клиентских устройств участника. В верхнем правом углу вы можете просмотреть OMS ID (у каждого участника он разный). Также OMS ID доступен для просмотра в профиле участника. Идентификатор соединения указан в поле «Идентификатор соединения» (у каждого устройства он разный).

Если в разделе «Устройства» не перечислено ни одного устройства – вы можете добавить его самостоятельно.

4. Для добавления нового устройства необходимо нажать на кнопку “Создать устройство” в левом верхнем углу экрана.

5. Идентификатор соединения генерируется автоматически после создания устройства. В поле «Тип» необходимо выбрать значение «АСУ ТП». В поле «Режим отправки отчетов» необходимо выбрать значение «Автоматически». Наименование указывается произвольно.

6. После заполнения формы нового устройства – необходимо нажать на кнопку «Создать».

Созданное устройство отобразится в списке клиентских устройств (см. иллюстрацию к п.3).

7. Устройство можно удалить, для этого необходимо нажать на кнопку с тремя точками в строке устройства и нажать на кнопку «Удалить».

Удаление необходимо подтвердить в диалоговом окне.

ИНФОРМАЦИЯ

Журнал обмена с ГИС МТ записывается в файл, имя которого указано в константе _МАРКИРОВКАИМЯФАЙЛАЖУРНАЛА. Если такой константы нет в системе, то по умолчанию используется имя файла C:\Users\[Имя пользователя]\AppData\Roaming\Itida\marking_http.log

Подключение и настройка модуля Маркировка

Для подключения модуля Маркировка необходимо добавить в систему меню программы пункт Модуль Маркировка (название пункта может быть изменено партнёром по его усмотрению). В дистрибутивной базе данный пункт расположен в меню Сервис. Для самостоятельного подключения этого пункта необходимо использовать команду DO FORM markingform.

Для отображения добавленного пункта в меню необходимо перезапустить систему Айтида.

Первый запуск модуля необходимо произвести от имени пользователя с правами администратора. В этом случае будет доступен функционал по настройке модуля:

Настройка модуля производится для каждой торговой точки, на которых предполагается обмен данными с ГИС МТ, и для каждой товарной группы, подлежащей маркировке. В окне настройки необходимо задать следующие параметры:

1. Раздел Параметры доступа к ГИС Маркировка.

• Сертификат – необходимо выбрать сертификат для электронной подписи документов, отправляемых в ГИС МТ. Это должен быть тот же сертификат. С которым производилась регистрация в личном кабинете ГИС. Сертификат должен располагаться в хранилище Личных сертификатов компьютера.
• ИД СУД – необходимо ввести ранее сохранённое значение OMS ID.
• ИД Соединения – необходимо ввести ранее сохранённое значение идентификатора соединения.
• URL СУЗ – позволяет указать URL для доступа к СУЗ, отличный от стандартного. URL СУЗ можно узнать, если зайти в ЛК ЧЗ, из него перейти в СУЗ и посмотреть на строку URL в браузере

• Группа маркировки – необходимо выбрать группу маркируемых товаров. Для обуви выбирается Обувь, для работы с табачной продукцией выбирается Табачная продукция и т. д. Выбор группы маркировки влияет на функциональные возможности модуля Маркировка. Например, для табачной продукции обмена по API со стороны ГИС МТ не предусмотрен.

ВНИМАНИЕ

Обратите внимание, что в конфигурации Айтида Малый бизнес доступна работа только с группами маркировки Обувь и Табак.

• Если предполагается работа в тестовом контуре ГИС МТ, то необходимо установить признак Тестовый контур.
• Кнопка Проверить авторизацию позволяет проверить подключение и авторизацию на серверах ГИС МТ. В случае успешного подключения будет выведено сообщение об успешной проверке. Иначе – сообщение об ошибке.

ВНИМАНИЕ

Перед проверкой авторизации необходимо сохранить изменения в базе данных.

ВНИМАНИЕ

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

1. В разделе Папки для создания новых объектов необходимо выбрать папки справочников, в которых будут создаваться новые товары и контрагенты. Данные, загружаемые из ГИС МТ содержат в себе не только коды маркировки, но и реквизиты поставщиков товаров, а также названия самих товаров. При загрузке неопознанные контрагенты и товары будут созданы в указанных папках. При создании новых карточек товара будет учитываться, какая группа ресурсов указана в выбранной папке. В новые карточки будет перенесена информация, заданная в группе ресурсов так, как если бы эта группа была выбрана в карточке товара интерактивным путем.

1. В разделе Параметры создаваемых документов необходимо выбрать Организацию и Склад, для которых будут создаваться документы. Если эти параметры не будут выбраны, то в процессе создания документов значения будут подставлены из настроек пользователя, осуществляющего операцию загрузки.
2. Кнопки Добавить предприятие в список, Изменить название предприятия в списке и Удалить предприятие из списка позволяют формировать список предприятий для работы.