При интеграции учетных систем с Универсальным транспортным модулем (УТМ) ЕГАИС разработчики нередко сталкиваются с неясностями в официальной документации. Типичный пример — структура документа ActFixBarCode (Акт фиксации штрихкодов), в примере которого под тегом <ce:amc> приведен нетипичный буквенно-цифровой код длиной 71 символ. Разберем подробно, что означает данный тег, какие реальные данные в него должны попадать и по каким правилам работает данный документ в контуре ЕГАИС и типовых конфигурациях 1С.
В примере схемы документа ActFixBarCode из руководства пользователя приводится фрагмент XML следующего вида:
<awr:MarkInfo>
<ce:amc>09001785400000118984310PX8051522100000476712617218613594213116182124151</ce:amc>
</awr:MarkInfo>
Если посчитать количество символов в значении тега <ce:amc>, получается 71 символ. Это вызывает закономерные вопросы у разработчиков, поскольку стандартные форматы марок алкогольной продукции имеют иную длину:
Выясним причину появления 71-значной строки: в официальных примерах документации ФСРАР часто использует искусственные псевдокоды (заглушки) для демонстрации общей структуры XML-сообщения. В реальной работе отправка такой 71-символьной строки приведет к ошибке валидации XML-схемы на уровне XSD еще до отправки в базу данных ЕГАИС.
Аббревиатура amc расшифровывается как Alcohol Mark Code (код алкогольной марки). Тег <awr:MarkInfo> содержит массив тегов <ce:amc>, каждый из которых представляет собой считанный сканером полный код марки единицы алкогольной продукции.
В реальном обмене в тег <ce:amc> передаются строго валидные значения:
22N00001CJJRHTDK27T3SY161031001002700AKKZE80MK3TVKUQMDVCJO9E0P17O75J).При формировании исходящего документа учетная система должна помещать в каждый узел <ce:amc> отдельную физическую марку, привязываемую к выбранной партии.
Рассмотрим, для чего применяется документ «Акт фиксации штрихкодов» (ActFixBarCode):
FB-).Важно: документ ActFixBarCode не увеличивает и не уменьшает количественные остатки на Регистре 1 (Склад) или Регистре 2 (Торговый зал). Он лишь наполняет Регистр 3 информацией о привязке конкретных марок к существующему остатку по справке РФУ-2.
Проанализируем ключевые системные ограничения ЕГАИС при работе с актом фиксации штрихкодов:
<ce:amc>, не должно превышать свободный количественный остаток продукции по указанной справке FB- на Регистре 1.ActUnFixBarCode.В конфигурациях 1С (ERP, КА, УТ, Розница, УНФ) для работы с данным механизмом предусмотрен документ «Акт фиксации штрихкодов ЕГАИС» («Привязка штрихкодов к партии ЕГАИС»).
При интеграции через торговое оборудование обратите внимание на следующие нюансы:
CR/LF, перехватываемого драйвером).<awr:MarkInfo> и <ce:amc> с правильной длиной и структурой данных.