Как перенести существующие коды маркировки обуви в 1С:КА 2.4 и настроить интеграцию с Честным ЗНАКОМ

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

При переходе на новую учетную систему, такую как 1С:Комплексная автоматизация 2.4, компании часто сталкиваются с проблемой: коды маркировки (КМ) на остатки или новые партии уже получены и даже сформированы в транспортные короба (агрегаты) в другой программе или в личном кабинете «Честного ЗНАКА». Рассмотрим, как правильно перенести эти данные в новую базу и настроить взаимодействие с системой ИС МП (ГИС МТ), чтобы избежать ошибок при выбытии продукции.

Импорт существующих кодов маркировки и агрегатов

Если на партию товара уже сгенерированы коды и они физически нанесены на коробки, нам не нужно заказывать их повторно через 1С. Разберем по шагам, как «познакомить» 1С:КА 2.4 с этими кодами:

  1. Загрузка кодов из внешнего файла: В разделе «Закупки» или «Склад и доставка» перейдем в рабочее место «Маркировка товаров ИС МП». Создадим новый документ Маркировка товаров ИС МП с видом операции «Маркировка остатков» (если это остатки) или выберем соответствующую операцию для ввода в оборот. В табличной части документа воспользуемся функцией загрузки из внешнего файла (CSV или Excel).
  2. Формирование структуры: При загрузке крайне важно сопоставить считанные коды с номенклатурой базы 1С. Проанализируем соответствие GTIN и характеристик. Если данные загружены корректно, система подтянет описание товаров.
  3. Синхронизация статусов: После того как коды попали в базу 1С, выделим их и нажмем кнопку «Запросить статус кодов маркировки». Система через API свяжется с ЦРПТ и обновит состояние кодов (например, «В обороте» или «Эмитирован»). Это критически важно для дальнейших операций отгрузки.
  4. Работа с агрегатами (коробами): Если обувь уже упакована в короба, и иерархия (связь КМ пар с КМ короба SSCC) уже зафиксирована в «Честном ЗНАКЕ», мы можем отразить это в документе Маркировка товаров ИС МП на закладке «Агрегирование». Рассмотрим ситуацию, когда нужно просто загрузить готовую структуру: 1С позволяет импортировать вложенность, если идентификаторы упаковок соответствуют стандартам системы.

Проблема настройки API: поиск OmsID (Connection ID)

Для настройки прямой интеграции 1С с СУЗ (Станцией управления заказами) требуется уникальный идентификатор OmsID. В процессе обновлений интерфейса «Честного ЗНАКА» пользователи часто теряют это поле из виду. Выясним причину: ЦРПТ регулярно меняет дизайн личного кабинета, и старые инструкции перестают работать.

Проанализируем технический способ получения этого параметра, если в интерфейсе СУЗ он скрыт:

  1. Откроем личный кабинет «Честного ЗНАКА» в браузере Google Chrome.
  2. Перейдем в раздел Станции управления заказами (СУЗ) и попробуем создать черновик любого заказа.
  3. Нажмем клавишу F12 (Инструменты разработчика) и выберем вкладку Network (Сеть).
  4. Найдем в списке сетевых запросов (после совершения действия на странице) запрос к API. Посмотрим на заголовки (Headers) или тело ответа (Response).
  5. В структуре JSON-ответа будет содержаться параметр omsId. Это длинная строка символов, которую необходимо скопировать и вставить в настройки интеграции в 1С:КА.

В современных релизах 1С этот параметр может называться Идентификатор соединения. Проверим также раздел «Устройства» в СУЗ, где отображается Connection ID — это актуальный аналог старого OmsID.

Настройка выбытия кодов маркировки

Одной из главных задач является корректное списание кодов при продаже. Рассмотрим основные сценарии выбытия в 1С:КА 2.4:

1. Розничная продажа:

При использовании рабочего места кассира (РМК) или оформлении документа Чек ККМ, сканирование кода маркировки является обязательным. После пробития чека информация передается оператору фискальных данных (ОФД), который, в свою очередь, сообщает в ЦРПТ о выводе кода из оборота. Дополнительных действий в 1С выполнять не требуется, если настроена связь с ОФД.

2. Оптовая продажа через ЭДО:

Разберем процесс для оптовиков. Выбытие происходит не в момент отгрузки, а в момент смены собственника. Мы формируем документ Реализация товаров и услуг, подбираем коды маркировки в специальном окне (иконка «печеньки» или ссылка «Подобрать и проверить маркированную продукцию»). На основании реализации создается Электронный УПД. Как только покупатель подпишет УПД в своей системе ЭДО, коды автоматически перейдут на его баланс в ГИС МТ.

3. Списание и вывод по иным причинам:

Если обувь была испорчена, потеряна или использована для собственных нужд, создадим документ Вывод из оборота ИС МП. Проанализируем доступные причины списания:

В этом документе мы либо сканируем коды, либо подбираем их из списка остатков. После проведения документа нажмем ссылку «передайте данные» для синхронизации с ГИС МТ.

Особенности ордерного склада

Посмотрим на ситуацию, когда на предприятии используется ордерная схема (разделение финансового и складского учета). Это часто вызывает сложности у кладовщиков. В 1С:КА 2.4 предусмотрено два варианта проверки КМ:

  1. Проверка в расходном ордере: В настройках системы можно установить флаг, позволяющий сканировать коды непосредственно в документе Расходный ордер на товары. Это наиболее логичный путь для склада, так как кладовщик видит реальный товар.
  2. Связь с реализацией: Если проверка выполнена в реализации, данные «пробрасываются» в складской ордер. В этом случае кладовщику остается только сверить количество, но доступ к кодам для уточнения сохраняется.

Технический совет по стабильности API

Поскольку программные интерфейсы ЦРПТ постоянно дорабатываются, мы рекомендуем регулярно проверять наличие установленных патчей для 1С. В разделе «НСИ и администрирование» — «Обслуживание» — «Обновление программы» — «Установленные исправления (патчи)» убедимся, что загружены все исправления, касающиеся БИП (Библиотеки интеграции с государственными информационными системами). Это решит большинство проблем с «зависаниями» при запросе токенов или отправке документов.

Для автоматизации работы с API в коде конфигурации используются методы объектов ИнтеграцияИСМП. Если вы планируете писать собственные обработки для массового выбытия, обратите внимание на следующий пример логики (псевдокод для понимания процесса):


// Пример инициализации параметров для работы с ИС МП
ПараметрыПодключения = ИнтеграцияИСМП.ПараметрыПодключения();
ПараметрыПодключения.ИдентификаторОрганизации = "Ваш_ИНН";
ПараметрыПодключения.АдресСервиса = "api.gismt.ru";

// Запрос токена авторизации
ТокенАвторизации = ИнтеграцияИСМП.ПолучитьТокен(ПараметрыПодключения);

Если ЗначениеЗаполнено(ТокенАвторизации) Тогда
    // Формирование запроса на статус кода
    РезультатЗапроса = ИнтеграцияИСМП.ПроверитьСтатусКодов(СписокКодов, ТокенАвторизации);
КонецЕсли;

Помните, что ручное управление API через код требует глубокого понимания документации «Честного ЗНАКА», поэтому по возможности используйте типовые механизмы документов Маркировка товаров ИС МП и Вывод из оборота ИС МП.

← На главную