Как получить уникальный идентификатор (GUID/УИД) в 1С 8.3: запросы, код и консоль

Уникальные идентификаторы в 1С:Предприятие 8.3 — это основа для работы с объектами через код, обмены данными и интеграции. Без них невозможно однозначно сослаться на справочник, документ или запись регистра. Но как их получить, если под рукой только запрос, консоль отладки или ограниченный доступ к конфигуратору?

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

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

1. Что такое уникальный идентификатор в 1С 8.3 и зачем он нужен

В 1С:Предприятие каждый объект (справочник, документ, элемент перечисления) имеет два ключевых идентификатора:

• 🔹 Ссылка — уникальный адрес объекта в базе, который включает тип (например, СправочникСсылка.Номенклатура) и внутренний ID. Используется для обращения к объекту из кода.
• 🔹 УИД (GUID) — глобальный уникальный идентификатор в формате UUID (например, 550e8400-e29b-41d4-a716-446655440000). Нужен для обмена данными между базами, интеграции с внешними системами и восстановления ссылок после переноса.

Разница между ними критична: ссылка может измениться при переносе данных (например, после выгрузки/загрузки через XML), а УИД остаётся неизменным. Поэтому для надёжных интеграций всегда используют GUID.

Где применяются идентификаторы:

• 📤 Обмен данными между базами 1С (например, через Универсальный формат обмена или EnterpriseData).
• 🔗 Интеграция с сайтами, CRM, ERP-системами (через REST API, JSON или прямые запросы к базе).
• 🔍 Поиск и восстановление объектов после сбоев или миграций.
• 🛠️ Отладка и анализ данных через Консоль запросов или SQL.

⚠️ Внимание: В некоторых конфигурациях (например, 1С:Бухгалтерия 3.0) УИД может автоматически генерироваться только для новых объектов. Старые элементы справочников или документы могут не иметь GUID — это придётся учитывать при обмене.

2. Способ 1: Получение УИД через интерфейс 1С (без кода)

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

Шаги для справочников и документов:

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

Для регистров сведений и накопления:

• 📌 Откройте регистр через меню Операции → Регистры.
• 📌 Выделите нужную запись и нажмите Ещё → Информация.
• 📌 УИД будет в разделе Служебные данные.

Если поле УИД пустое — значит, идентификатор не был сгенерирован автоматически. В этом случае его можно создать вручную через код (см. раздел 4).

3. Способ 2: Запросом на языке 1С (в консоли или коде)

Если нужно получить УИД для множества объектов или автоматизировать процесс, используйте запросы на языке 1С. Этот метод работает в Консоли запросов (доступна в конфигураторе) или в коде модуля.

Пример 1. Получение УИД для элементов справочника:

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

Пример 2. УИД для документов:

ВЫБРАТЬ
Документ.РеализацияТоваровУслуг.Ссылка КАК Ссылка,
Документ.РеализацияТоваровУслуг.УникальныйИдентификатор КАК УИД
ИЗ
Документ.РеализацияТоваровУслуг КАК Документ.РеализацияТоваровУслуг
ГДЕ
Документ.РеализацияТоваровУслуг.Номер ="РТ-000001"

Пример 3. УИД для записей регистра сведений:

ВЫБРАТЬ
РегистрСведений.ЦеныНоменклатуры.Ссылка КАК Ссылка,
РегистрСведений.ЦеныНоменклатуры.УникальныйИдентификатор КАК УИД
ИЗ
РегистрСведений.ЦеныНоменклатуры КАК РегистрСведений.ЦеныНоменклатуры
ГДЕ
РегистрСведений.ЦеныНоменклатуры.Номенклатура = &Номенклатура

Чтобы выполнить запрос в конфигураторе:

1. Откройте Сервис → Консоль запросов.
2. Вставьте код запроса и нажмите Выполнить.
3. Результаты отобразятся в нижней панели. Скопируйте столбец УИД.

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

Проверьте права доступа (нужны права на чтение объекта)

Убедитесь, что объект существует в базе

Для регистров укажите ключевые поля (например, Номенклатура + Период)

Скопируйте УИД в буфер обмена сразу после выполнения запроса-->

4. Способ 3: Программное получение УИД (для разработчиков)

Если вам нужно получить УИД в коде (например, для обработки или внешней печатной формы), используйте встроенные методы платформы. Это самый гибкий способ, который работает даже для объектов без автоматически сгенерированного идентификатора.

Пример 1. Получение УИД для справочника:

СсылкаНаОбъект = Справочники.Номенклатура.НайтиПоНаименованию("Товар 1");
Если Не СсылкаНаОбъект.Пустая Тогда
УИД = СсылкаНаОбъект.УникальныйИдентификатор;
Сообщить("УИД:" + УИД);
Иначе
Сообщить("Объект не найден!");
КонецЕсли;

Пример 2. Генерация УИД, если его нет:

СсылкаНаОбъект = Документы.РеализацияТоваровУслуг.НайтиПоНомеру("РТ-000001");
Если СсылкаНаОбъект.УникальныйИдентификатор.ПустойУникальныйИдентификатор Тогда
НовыйУИД = Новый УникальныйИдентификатор;
СсылкаНаОбъект.УстановитьУникальныйИдентификатор(НовыйУИД);
СсылкаНаОбъект.Записать;
Сообщить("Сгенерирован новый УИД:" + НовыйУИД);
КонецЕсли;

Пример 3. Получение УИД для записи регистра:

ЗаписьРегистра = РегистрыСведений.ЦеныНоменклатуры.СоздатьМенеджерЗаписи;
ЗаписьРегистра.Номенклатура = Справочники.Номенклатура.НайтиПоНаименованию("Товар 1");
ЗаписьРегистра.Период = ТекущаяДата;
Если ЗаписьРегистра.НайтиПоРеквизиту("Номенклатура", ЗаписьРегистра.Номенклатура) Тогда
УИД = ЗаписьРегистра.УникальныйИдентификатор;
Сообщить("УИД записи:" + УИД);
КонецЕсли;

Критичная деталь: После ручной генерации УИД обязательно вызовите метод Записать для объекта, иначе идентификатор не сохранится в базе!

5. Способ 4: Через SQL-запрос (для администраторов)

Если у вас есть доступ к SQL-серверу (например, Microsoft SQL Server или PostgreSQL), можно получить УИД напрямую из таблиц базы данных. Этот метод полезен для массового экспорта идентификаторов или отладки.

Структура хранения УИД в 1С 8.3:

• 🗃️ Для справочников: таблица _Reference{ID} (например, _Reference123), поле RefUID.
• 📄 Для документов: таблица _Document{ID} (например, _Document456), поле DocUID.
• 📊 Для регистров: таблица _InfoRg{ID} или _AccumRg{ID}, поле RecordUID.

Пример SQL-запроса для справочника Номенклатура:

SELECT
t._IDRRef AS Ссылка,
t._RefUID AS УИД,
t._Description AS Наименование
FROM
_Reference123 AS t -- Замените 123 на реальный ID таблицы справочника
WHERE
t._Description LIKE'%Товар%'

1. Откройте Конфигуратор 1С.
2. Перейдите в Администрирование → Поддержка и обслуживание → Таблицы информационной базы.
3. Найдите нужный справочник/документ и посмотрите его физическое имя таблицы.

Пример кода для внешней обработки:

&НаКлиенте
Процедура ПолучитьУИД(Команда)
Объект = Объекты.ТекущийОбъект;
Если Объект.УникальныйИдентификатор.ПустойУникальныйИдентификатор Тогда
Предупреждение("УИД не назначен! Сгенерировать новый?", КодВопроса.ДаНет);
Если КодВозврата = КодВозвратаДиалога.Да Тогда
Объект.УстановитьУникальныйИдентификатор(Новый УникальныйИдентификатор);
Объект.Записать;
КонецЕсли;
КонецЕсли;
Сообщить("УИД:" + Объект.УникальныйИдентификатор);
КонецПроцедуры

SELECT name FROM sys.tables WHERE name LIKE'_Reference%'

УИД = Перечисления.ВидыНоменклатуры.Товар.УникальныйИдентификатор;
Сообщить(УИД);

НовыйУИД = Новый УникальныйИдентификатор;
Перечисления.ВидыНоменклатуры.Товар.УстановитьУникальныйИдентификатор(НовыйУИД);

УИДДокумента = Документ.Ссылка.УникальныйИдентификатор;
Номенклатура = Документ.Товары[0].Номенклатура;
Сообщить("Идентификатор строки:" + УИДДокумента +" +" + Номенклатура.УникальныйИдентификатор);

Выборка = Справочники.Номенклатура.Выбрать;
Пока Выборка.Следующий Цикл
Если Выборка.УникальныйИдентификатор.ПустойУникальныйИдентификатор Тогда
Выборка.Ссылка.УстановитьУникальныйИдентификатор(Новый УникальныйИдентификатор);
Выборка.Ссылка.Записать;
КонецЕсли;
КонецЦикла;