Как адаптировать КАТАП 1.1 для работы с УТМ версии 4.2?

← На главную

Переход на 4-ю версию УТМ стал обязательным требованием для всех участников оборота алкогольной продукции. В данной статье мы разберем по шагам, как доработать интеграцию учетной системы (на примере КАТАП) для корректной работы с новым форматом обмена.

Основные этапы доработки обмена с УТМ 4.2

Для обеспечения стабильной работы системы нам необходимо внести изменения в несколько ключевых подсистем 1С. Разберем каждый этап подробнее:

Обновление XDTO-пакетов и структуры данных: В первую очередь необходимо обновить XML-схемы, соответствующие спецификации УТМ 4.2. Это включает в себя правку перечислений и справочников, описывающих виды объектов.
Модернизация общих модулей выгрузки: Мы должны изменить логику формирования запросов в общих модулях, чтобы данные выгружались в новом формате, требуемом регулятором.
Доработка обработки загрузки документов: Необходимо переписать механизмы приема документов, чтобы они корректно обрабатывали ответы сервера и структуру данных 4-й версии.

Особенности обработки ТТН и входящих тикетов

Одной из наиболее критичных задач является корректная обработка входящих тикетов. В актуальных версиях УТМ тикет может поступить раньше самой ТТН, что требует от нас реализации механизма ожидания и сопоставления данных.

Разберем, на что стоит обратить внимание при написании кода обработки:

При работе с Route (транспортными накладными) важно учитывать специфику входящих ответов. В некоторых случаях нам приходится прибегать к «парсингу» комментариев, так как стандартные поля тикетов не всегда содержат исчерпывающую информацию. Также необходимо предусмотреть вырезание fsrarid из данных ТН, если это требуется текущими спецификациями.

Реализация логики обмена в коде

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


// Пример логики парсинга ответа от УТМ
Функция ОбработатьОтветСервера(ОтветСервера) Экспорт
    // Проверяем версию протокола
    Если ОтветСервера.Версия = "4.2" Тогда
        // Выполняем специфичный для 4-й версии парсинг комментариев
        ТекстКомментария = ОтветСервера.Комментарий;
        Результат = ПарситьКомментарийДляТН(ТекстКомментария);
        // Заполняем объекты системы
        ЗаписатьРезультатВРегистры(Результат);
    КонецЕсли;
КонецФункции

При анализе входящих документов мы используем XDTO пакеты для преобразования XML-структур в объекты 1С. Важно убедиться, что все типы данных, определенные в схемах УТМ, верно сопоставлены с типами 1С.

Практические советы и рекомендации

Чтобы избежать ошибок при переходе, следуйте данным рекомендациям:

Не полагайтесь на порядок поступления документов: Всегда реализуйте алгоритм поиска связанных документов по идентификаторам, даже если ТТН еще не загружена в базу.
Учитывайте специфику Route: Работа с этим типом объектов требует повышенного внимания к формату данных. При необходимости используйте отладчик для просмотра сырых XML-ответов от УТМ.
Очистка метаданных: Не забывайте удалять неактуальные идентификаторы, такие как fsrarid, из полей, где они более не поддерживаются форматом 4.2, чтобы избежать ошибок при валидации на стороне сервера ЕГАИС.

Работа с УТМ 4.2 — это задача, требующая внимательного отношения к деталям обмена. Несмотря на необходимость применения «костылей» в виде парсинга комментариев, системный подход к обновлению модулей интеграции позволит обеспечить бесперебойную работу вашего предприятия в системе ЕГАИС.