Код УТ в 1С: назначение, где искать и как использовать в конфигурациях Управление Торговлей

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

В этой статье мы подробно разберём, что такое код УТ в 1С, в каких версиях конфигурации он встречается (от УТ 10.3 до УТ 11.5), как его правильно заполнять и где он хранится в базе данных. Также вы узнаете, какие ошибки чаще всего допускают пользователи при работе с этим полем и как их избежать. Если вы администрируете или разрабатываете решения на базе 1С:УТ, эта информация поможет избежать типичных проблем с обменом данными и интеграцией.

Что такое код УТ в 1С и зачем он нужен

Код УТ (или код управления торговлей) — это уникальный идентификатор, который присваивается объектам в конфигурациях 1С:Управление Торговлей для обеспечения корректного обмена данными между разными базами или системами. В отличие от стандартного Кода (например, у номенклатуры или контрагента), который обычно заполняется пользователем вручную, код УТ чаще всего генерируется автоматически и используется внутренними механизмами платформы.

Основные функции кода УТ:

• 🔄 Синхронизация данных между разными базами (например, между УТ 11 и Бухгалтерией 3.0 или Розницей 2.3).
• 📊 Идентификация объектов при обмене через Универсальный формат обмена (УФ) или EnterpriseData.
• 🔍 Поиск и сопоставление однотипных объектов в разных информационных базах (например, одной и той же номенклатуры в УТ и ERP).
• 🛠️ Поддержка механизмов миграции данных при переходе на новые версии конфигурации.

Важно понимать, что код УТ — это не то же самое, что и Уникальный идентификатор (UID) или Ссылка на объект. Он не является глобальным (как GUID), а используется только в рамках обмена данными между системами на базе 1С:Предприятие. Например, если вы выгружаете номенклатуру из УТ 11.5 в Бухгалтерию 3.0, то именно по коду УТ система определит, что это один и тот же товар, даже если его наименования или артикулы в базах различаются.

⚠️ Внимание: В некоторых версиях 1С:УТ (например, УТ 10.3) код УТ мог называться КодДляОбмена или ВнешнийКод. Это наследие старых конфигураций, но суть остаётся той же — уникальная идентификация объекта для обмена.

Где хранится код УТ в конфигурациях 1С:Управление Торговлей

Локализация кода УТ зависит от версии конфигурации и типа объекта. В современных редакциях (УТ 11.4, УТ 11.5) это поле обычно скрыто от пользователя и заполняется автоматически, но его можно найти в метаданных или через Конфигуратор. Рассмотрим основные объекты, где используется код УТ:

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

1. Откройте нужный справочник (например, Номенклатура).
2. Перейдите в Все действия → Изменить форму.
3. Добавьте на форму поле КодУТ или КодДляОбмена.
4. Сохраните изменения и обновите форму.

Как формируется код УТ в разных версиях 1С:УТ

Алгоритм генерации кода УТ зависит от редакции конфигурации. В старых версиях (например, УТ 10.3) он часто заполнялся вручную или через обработки, а в новых (УТ 11.4+) — автоматически по заданным правилам. Рассмотрим основные подходы:

1. Автоматическая генерация (УТ 11.4, 11.5)

В современных конфигурациях код УТ формируется по шаблону, который можно настроить в Конфигураторе. Например, для номенклатуры это может быть комбинация:

АРТ[Артикул]-[ПрефиксБазы]

Где:

• [Артикул] — артикул товара из справочника.
• [ПрефиксБазы] — уникальный префикс вашей информационной базы (настраивается в параметрах обмена).

2. Ручной ввод (УТ 10.3, устаревшие конфигурации)

В старых версиях код УТ часто приходилось заполнять вручную или через обработки. Например, для контрагентов использовался формат:

КЛИЕНТ_[ИНН]_[КПП]

Это помогало избегать дублирования при обмене с бухгалтерией, но требовало дисциплины от пользователей.

3. Гибридный подход (УТ 11.1–11.3)

В промежуточных версиях код УТ мог формироваться частично автоматически (например, для новых объектов), а для старых данных требовалось дозаполнение через обработку ЗаполнениеКодовУТ.epf.

⚠️ Внимание: Если вы мигрируете с УТ 10.3 на УТ 11.5, обязательно проверьте заполненность кодов УТ для всех справочников перед обменом. В противном случае возможны ошибки типа "Не найден объект с кодом УТ:...".

Типичные ошибки при работе с кодом УТ и как их избежать

Неправильное использование кодов УТ — одна из главных причин сбоев при обмене данными между базами. Рассмотрим наиболее распространённые ошибки и способы их решения:

1. Дублирование кодов УТ

Если два разных объекта имеют одинаковый код УТ, при обмене данные могут перезаписываться или теряться. Например, если в УТ и Рознице есть номенклатура с одинаковым кодом УТ, но разными наименованиями, то при синхронизации один товар заменит другой.

Решение: Перед обменом выполните проверку на дубли через запрос:

ВЫБРАТЬ
КодУТ,
КОЛИЧЕСТВО(*) КАК Количество
ИЗ
Справочник.Номенклатура
ГРУППИРОВАТЬ ПО
КодУТ
ИМЕЮЩИЕ
КОЛИЧЕСТВО(*) > 1

2. Пустые коды УТ

Если код УТ не заполнен, объект не будет найден при обмене. Эточная проблема при миграции данных из старых баз.

Решение: Используйте обработку массового заполнения кодов УТ (например, ЗаполнитьКодыУТ.epf). В УТ 11.5 это можно сделать через Администрирование → Поддержка и обслуживание → Заполнение кодов УТ.

3. Несовпадение форматов кодов

Если в одной базе код УТ формируется как АРТ123, а в другой — как TOV-123, обмен не сработает.

Решение: Настройте единый формат генерации кодов УТ в параметрах обмена (Администрирование → Настройки обмена данными).

Как редактировать или сбросить код УТ в 1С:УТ

Иногда требуется изменить или сбросить код УТ — например, при слиянии баз или исправлении ошибок. Делать это нужно осторожно, так как некорректные действия могут нарушить связь между объектами в разных системах.

Способ 1: Ручное редактирование

Для единичных объектов можно изменить код УТ в карточке:

1. Откройте справочник (например, Номенклатура).
2. Найдите нужный элемент и откройте его на редактирование.
3. Включите отображение всех реквизитов (Ещё → Изменить форму).
4. Найдите поле КодУТ и измените его значение.
5. Сохраните изменения.

Способ 2: Массовое изменение через обработку

Для пакетного изменения используйте стандартную обработку Групповое изменение реквизитов или напишите собственный скрипт. Пример кода для сброса кодов УТ у номенклатуры:

Выборка = Справочники.Номенклатура.Выбрать;
Пока Выборка.Следующий Цикл
Объект = Выборка.ПолучитьОбъект;
Объект.КодУТ ="";
Объект.Записать;
КонецЦикла;

⚠️ Внимание: После массового изменения кодов УТ обязательно выполните полную выгрузку и загрузку данных в связанные базы, чтобы избежать рассинхронизации. В противном случае объекты могут"потеряться" при следующем обмене.

Примеры использования кода УТ в обмене данными

Рассмотрим практические сценарии, где код УТ играет ключевую роль.

Сценарий 1: Обмен между УТ 11.5 и Бухгалтерией 3.0

При выгрузке документов Реализация товаров и услуг из УТ в Бухгалтерию система сопоставляет:

• 📄 Документы — по КодУТДокумента.
• 📦 Номенклатуру — по КодУТ.
• 👤 Контрагентов — по КодДляОбмена.

Если коды не совпадают, в Бухгалтерии создадутся дубли вместо обновления существующих записей.

Сценарий 2: Синхронизация с интернет-магазином на Битрикс

При интеграции 1С:УТ с сайтом на 1С-Битрикс код УТ используется для:

• 🔄 Связывания товаров в 1С и на сайте.
• 📈 Обновления остатков и цен.
• 🛒 Передачи заказов из интернет-магазина в УТ.

Например, в Битриксе код УТ может храниться в свойстве товара XML_ID.

Отличия кода УТ от других идентификаторов в 1С

Часто код УТ путают с другими уникальными идентификаторами в 1С. Разберём ключевые различия:

Когда использовать код УТ, а когда — ссылку?

• 🔗 Ссылка нужна для работы внутри одной базы (например, в запросах или при программировании).
• 🔄 Код УТ — для обмена между разными базами.
• 🌍 UID (GUID) — для интеграции с внешними системами (например, CRM или WMS).

FAQ: Частые вопросы о коде УТ в 1С

ВЫБРАТЬ
Ссылка КАК Ссылка,
Наименование КАК Наименование
ИЗ
Справочник.Номенклатура
ГДЕ
КодУТ ="АРТ00123-МСК"