Как настроить новый обработчик ShtrihMkkt.epf для касс Штрих-М в 1С:Управление торговлей 10.3?

Программист 1С v8.3 (Обычные формы) 1С:Управление торговлей Управленческий учет Торговля и дистрибуция
← На главную

С переходом на новые форматы фискальных данных (ФФД 1.2) и обязательную маркировку товаров «Честный ЗНАК», пользователи устаревших, но все еще актуальных конфигураций, таких как УТ 10.3, УПП 1.3 и КА 1.1, столкнулись с необходимостью обновления механизмов взаимодействия с контрольно-кассовой техникой (ККТ). Рассмотрим процесс внедрения и настройки нового обработчика ShtrihMkkt.epf версии 3.00, который поддерживает API 2.05 и позволяет корректно работать с маркированной продукцией.

Зачем переходить на версию 3.00 и API 2.05?

Проанализируем основные причины появления данной версии. Основное изменение в API 2.05 заключается в реализации механизмов передачи кодов маркировки и получения ответов от ОИСМ (Отраслевой информационной системы маркировки). Старые версии драйверов и обработок не умели корректно обрабатывать статусы проверки кода маркировки перед пробитием чека, что приводило к ошибкам при работе с молочной продукцией, водой, обувью и другими категориями маркированных товаров. Разберем по шагам, что требуется для стабильной работы этой системы.

Технические требования к системе

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

Обновление компонентов и драйверов

Рассмотрим процесс подготовки драйвера. Выясним причину, по которой необходимо использовать именно версию 5.16.877. В этом релизе разработчики «Штрих-М» исправили критические ошибки «зависания» порта при передаче длинных структур данных, которые возникают при формировании запроса к серверу ОИСМ. Кроме того, реализована поддержка современных моделей, таких как Штрих-ФР-02Ф.

Не забудем про внешнюю компоненту ShtrihM_KKT_2.dll. При установке новой обработки версии 3.00 крайне важно убедиться, что старая библиотека удалена из каталога установки платформы 1С или каталога базы данных. Если система продолжит использовать старую библиотеку, API 2.05 не будет инициализировано, и вы получите ошибку о несовместимости версий или невозможности работы с маркировкой.

Тонкая настройка параметров связи («Колдовство с параметрами»)

Часто после простой установки обработки пользователи жалуются на нестабильную работу. Разберем, какие параметры связи в настройках торгового оборудования требуют корректировки:

  1. Таймаут приема: По умолчанию он может составлять 100-150 мс. Для работы с ФФД 1.2 и маркировкой этого недостаточно. Рекомендуется установить значение в диапазоне от 300 до 1000 мс. Это связано с тем, что касса ждет ответа от сервера «Честного ЗНАКА», и 1С должна «дождаться» окончания этой операции без разрыва соединения с драйвером.
  2. Таймаут ОИСМ: Этот параметр настраивается непосредственно в свойствах драйвера «Штрих-М». Его также стоит увеличить до 3000-5000 мс, чтобы избежать ошибок при проверке статуса кодов.
  3. Протокол обмена: В настройках обработки 3.00 выберите «Протокол 1» или «Протокол 2». Выбор зависит от версии прошивки вашей кассы. Если при попытке пробития чека возникает ошибка «Команда не поддерживается», попробуйте сменить протокол.
  4. Тип подключения: Если ваша касса подключена по USB, но работает через виртуальный COM-порт, на ОС Windows Server x64 могут возникать задержки. Рекомендуется перевести кассу в режим RNDIS (Ethernet over USB) и подключаться к ней по TCP/IP (сокеты). Это значительно повышает стабильность передачи данных.

Известные проблемы и способы их решения

Проанализируем ситуацию с «багами», которые могут возникнуть при использовании новой обработки. Пользователи отмечают медленное открытие формы настроек параметров (задержка до 15 секунд). Это нормальное поведение для API 2.05 в среде обычных форм 1С на 64-битных серверах, так как происходит длительная инициализация COM-объектов.

Если вы столкнулись с тем, что в чеке печатаются лишние технические строки о проверке кодов маркировки, это исправляется обновлением прошивки самой ККТ. Для корректной работы с API 2.05 прошивка должна быть не ниже версии конца 2023 года.

Посмотрим на пример того, как программно может выглядеть инициализация параметров (на уровне логики обработки):


// Пример логики установки таймаута для API 2.05
ОбъектДрайвера.Timeout = 500; // Увеличенный таймаут для стабильности
ОбъектДрайвера.OISMTimeout = 5000; // Таймаут проверки маркировки
ОбъектДрайвера.Connect(); // Установка соединения

Резюме

Использование связки ShtrihMkkt.epf v3.00 + DrvFR 5.16.877 является рабочим решением для поддержки ФФД 1.2 в старых конфигурациях 1С. Основным залогом успеха здесь является правильная настройка таймаутов и использование актуальной прошивки ККТ. Несмотря на некоторые «подглючивания», данная версия позволяет полноценно работать с маркированным товаром и соблюдать требования законодательства.

← На главную