Что такое УИД в 1С и как с ним работать

УИД (уникальный идентификатор, также GUID) в 1С — это внутренний идентификатор, который платформа автоматически присваивает каждому ссылочному объекту базы: документу, элементу справочника, плану счетов и другим сущностям. Он состоит из 32 шестнадцатеричных символов и выглядит примерно так: 3f2504e0-4f89-11d3-9a0c-0305e82c3301.

В отличие от кода или номера, которые видит пользователь, УИД скрыт внутри базы и не меняется на протяжении всей жизни объекта. Именно по нему платформа однозначно определяет, о каком именно элементе идёт речь, даже если у двух контрагентов совпадают наименования и коды.

Понимание того, как устроен и где используется УИД, необходимо при обмене данными между базами, интеграции с внешними системами, поиске «битых» ссылок и разработке обработок. Ниже разобраны способы получения УИД, его роль в обменах, типичные проблемы и ограничения.

Что такое УИД и чем он отличается от кода и номера

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

Формат УИД соответствует стандарту GUID (Globally Unique Identifier): 128-битное значение, записываемое в виде пяти групп шестнадцатеричных цифр через дефис. Вероятность совпадения двух случайно сгенерированных идентификаторов практически нулевая, что позволяет использовать их для объединения данных из разных источников.

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

Где платформа использует УИД

Основная область применения УИД — обмен данными. В планах обмена, универсальных форматах EnterpriseData, конвертации данных и типовых синхронизациях объекты сопоставляются именно по уникальным идентификаторам. Благодаря этому при повторной выгрузке документ не дублируется в базе-приёмнике, а обновляется.

УИД также участвует в работе следующих механизмов:

• синхронизация с внешними системами через веб-сервисы, HTTP-сервисы и COM-соединения;
• регистрация изменений в планах обмена — платформа хранит ссылки, в основе которых лежат УИД;
• навигационные ссылки вида e1cib/data/Справочник.Контрагенты?ref=..., где в конце зашит идентификатор объекта;
• средства сопоставления объектов при загрузке из файлов (XML, Excel) через типовые обработки.

Для разработчика УИД — способ передать «указатель» на объект за пределы базы: например, сохранить идентификаторы номенклатуры в сторонней CRM, чтобы потом корректно формировать заказы через API.

Как получить УИД объекта программно

Во встроенном языке 1С идентификатор получается методом УникальныйИдентификатор(), вызванным у ссылки. Результат — значение типа «УникальныйИдентификатор», которое при необходимости преобразуется в строку.

КонтрагентСсылка = Справочники.Контрагенты.НайтиПоКоду("000000123");
Если Не КонтрагентСсылка.Пустая() Тогда
УИДСтрокой = Строка(КонтрагентСсылка.УникальныйИдентификатор());
Сообщить(УИДСтрокой); // например: 3f2504e0-4f89-11d3-9a0c-0305e82c3301
КонецЕсли;

Обратная задача — найти объект по известному УИД — решается конструктором Новый УникальныйИдентификатор(СтрокаУИД) и методом ПолучитьСсылку():

УИД = Новый УникальныйИдентификатор("3f2504e0-4f89-11d3-9a0c-0305e82c3301");
СсылкаНаОбъект = Справочники.Контрагенты.ПолучитьСсылку(УИД);
Если СсылкаНаОбъект.ПолучитьОбъект() = Неопределено Тогда
Сообщить("Объект с таким УИД не найден — возможно, битая ссылка");
КонецЕсли;

УИД = Новый УникальныйИдентификатор("3f2504e0-4f89-11d3-9a0c-0305e82c3301");
Ссылка = Справочники.Контрагенты.ПолучитьСсылку(УИД);
Если Ссылка.ПолучитьОбъект() = Неопределено Тогда
    Сообщить("Объект не найден");
КонецЕсли;

Узнать УИД без программирования можно через навигационную ссылку: в режиме предприятия откройте объект и выполните «Получить ссылку» (или скопируйте ссылку через меню). Фрагмент после ref= содержит идентификатор в искажённом (переставленном) виде — для точного сопоставления надёжнее использовать программные методы или специализированные обработки.

УИД при обмене и интеграции между базами

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

Если объект был создан в приёмнике вручную до начала обмена, его УИД отличается от УИД аналогичного объекта в источнике. Тогда при синхронизации возможны дубли: система видит два разных идентификатора и честно создаёт второй элемент. Для таких случаев в типовых конфигурациях предусмотрены правила сопоставления по реквизитам (ИНН, наименование) и инструменты ручного сопоставления.

При интеграции с внешними системами рекомендуется хранить УИД 1С во внешней системе как внешний ключ. Тогда повторная отправка данных не порождает дубли, а поиск объекта по идентификатору выполняется быстрее, чем поиск по реквизитам.

Битые ссылки и роль УИД в их появлении

«Битая» ссылка — это ссылка на объект, который был физически удалён из базы (минуя контроль ссылочной целостности, например при нештатной загрузке или прямом удалении). В формах и отчётах она отображается как «Объект не найден» с указанием УИД в угловых скобках.

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

1. 1
   Скопируйте УИД из сообщения «Объект не найден» или из текста ошибки
2. 2
   Найдите объект с таким УИД в резервной копии или базе-источнике
3. 3
   Перенесите объект в рабочую базу обработкой с сохранением ссылки (ПолучитьСсылку + запись объекта)
4. 4
   Проверьте, что в форме документа ссылка отображается корректно, а не как «Объект не найден»

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

Ограничения и типичные ошибки при работе с УИД

Первое ограничение: УИД нельзя изменить штатными средствами пользователя. Попытки «подогнать» идентификаторы правкой таблиц СУБД напрямую почти гарантированно приводят к повреждению базы и потере поддержки. Все манипуляции выполняются только через встроенный язык.

Второе: строковое представление УИД в навигационной ссылке (после ref=) отличается от стандартного GUID перестановкой байтов. Сравнивать эти строки напрямую нельзя — сопоставляйте идентификаторы программно, через тип «УникальныйИдентификатор».

Третье: метод ПолучитьСсылку(УИД) не проверяет существование объекта — он просто формирует ссылку. Проверка выполняется отдельно через ПолучитьОбъект() или запрос, иначе легко записать в базу ссылку на несуществующий элемент.

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

Храните УИД как строку в интеграционных регистрах и внешних системах, но при передаче внутрь 1С всегда преобразуйте её обратно в тип «УникальныйИдентификатор» — это исключает ошибки регистра и форматирования. Для журналирования интеграций фиксируйте и УИД, и представление объекта: по одному идентификатору человеку сложно понять, о каком элементе идёт речь.

При проектировании обменов решите заранее, какая база является «мастером» для каждого типа справочников. Если объект создаётся в обеих системах, определите правила сопоставления по ключевым реквизитам до запуска синхронизации — это дешевле, чем разбирать дубли после.

Частые вопросы