GUID электронного документа в 1С: где посмотреть и как использовать

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

Знать GUID документа нужно при обмене данными между базами, при поиске «битых» ссылок, при отладке интеграций с внешними системами (сайт, CRM, ЭДО), а также когда по ошибочной записи в логе требуется найти конкретный документ. Проблема в том, что в стандартном интерфейсе 1С GUID не отображается — его нужно получать специальными способами.

Ниже разобраны рабочие методы: от простого программного кода до консоли запросов и универсальных обработок, а также обратная задача — найти документ по известному GUID.

Где хранится GUID и почему его не видно в интерфейсе

Платформа 1С хранит ссылку на объект как 16-байтовое значение в поле _IDRRef таблицы базы данных. В пользовательском интерфейсе отображаются только представления объекта — номер, дата, наименование. GUID считается служебной информацией и в типовых формах документов не выводится.

Это сделано намеренно: идентификатор не нужен рядовому пользователю, а его случайное использование (например, вручную скопированный GUID в другой базе) может привести к ошибкам ссылочной целостности. Поэтому все способы просмотра GUID относятся к инструментам администратора или разработчика.

Важно понимать разницу: GUID привязан к конкретной базе. Один и тот же документ в двух разных базах (например, после обмена) может иметь одинаковый GUID — если обмен выполнялся штатными механизмами синхронизации, — либо разные, если документы создавались независимо.

Способ 1. Получить GUID через встроенный язык 1С

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

// Получить GUID известной ссылки
СсылкаНаДокумент = Документы.РеализацияТоваровУслуг.НайтиПоНомеру("00000000123", ТекущаяДатаСеанса());
Если Не СсылкаНаДокумент.Пустая() Тогда
    ГУИД = СсылкаНаДокумент.УникальныйИдентификатор();
    Сообщить(Строка(ГУИД)); // например: 8a3f2c1e-5b7d-4e9a-b1c2-3d4e5f6a7b8c
Иначе
    Сообщить("Документ не найден");
КонецЕсли;

Строковое представление GUID получают функцией Строка() или XMLСтрока(). Для передачи во внешние системы обычно используют именно строковый формат через дефисы — он стандартен для веб-сервисов и REST-интеграций.

Если код выполняется в управляемом приложении, помните про контекст: на клиенте доступ к запросам и поиску по номеру ограничен. Выполняйте такой код на сервере (директива &НаСервере) или в фоновом задании.

Способ 2. Консоль запросов и консоль кода

Если конфигурация работает в режиме управляемого приложения и есть доступ к пункту «Все функции», откройте стандартную обработку «Консоль запросов» или используйте популярные инструменты разработчика (например, «Инструменты разработчика» — ИР). Через запрос GUID получают функцией языка запросов:

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

Запрос вернёт ссылку; чтобы увидеть сам GUID, в консоли кода дополнительно выполните Строка(Ссылка.УникальныйИдентификатор()). В некоторых консолях (ИР и аналоги) GUID ссылки отображается автоматически в таблице результата отдельной колонкой.

1. 1
   Откройте базу в режиме 1С:Предприятие под пользователем с правами администратора
2. 2
   Откройте консоль кода (через «Все функции» или внешнюю обработку)
3. 3
   Вставьте код поиска документа и вывода УникальныйИдентификатор()
4. 4
   Выполните код и скопируйте строку GUID из окна сообщений
5. 5
   Проверьте результат: найдите документ обратным поиском по GUID

Способ 3. GUID в URL при веб-доступе и в строке навигационной ссылки

Если база опубликована на веб-сервере или используется тонкий клиент, у каждого открытого объекта есть навигационная ссылка вида e1cib/data/Документ.РеализацияТоваровУслуг?ref=8a3f2c1e5b7d4e9ab1c23d4e5f6a7b8c. Получить её можно через команду «Получить ссылку» (кнопка в форме объекта или сочетание в меню «Ещё»).

Фрагмент после ref= — это тот же GUID, но без дефисов и с переставленными группами байтов (платформа хранит идентификатор в перевёрнутом порядке внутри групп). Простое удаление дефисов из обычного GUID не даст ссылочный формат — потребуется перестановка. Поэтому для обмена используйте либо стандартный GUID из кода, либо навигационную ссылку целиком.

Обратная задача: найти документ по известному GUID

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

СтрокаГУИД = "8a3f2c1e-5b7d-4e9a-b1c2-3d4e5f6a7b8c";
Ид = Новый УникальныйИдентификатор(СтрокаГУИД);
Найден = Ложь;
Для Каждого ВидДокумента Из Метаданные.Документы Цикл
    Ссылка = Документы[ВидДокумента.Имя].ПолучитьСсылку(Ид);
    Если Ссылка.ПолучитьОбъект() <> Неопределено Тогда
        Сообщить("Найден: " + Ссылка);
        Найден = Истина;
        Прервать;
    КонецЕсли;
КонецЦикла;
Если Не Найден Тогда
    Сообщить("Объект с таким GUID отсутствует (битая ссылка или другая база)");
КонецЕсли;

Проверка ПолучитьОбъект() <> Неопределено отличает реально существующий документ от «битой ссылки» — ситуации, когда GUID есть, но сам объект удалён или никогда не существовал в этой базе. На больших базах перебор всех видов документов занимает время; если тип объекта известен из контекста лога, ограничьтесь одним видом.

Типичные ошибки и ограничения

Ещё одно ограничение: у незаписанного (нового) объекта GUID уже существует в памяти, но в базе его нет до записи. Если интеграция получает GUID до записи документа и документ потом не записали, во внешней системе останется «висячий» идентификатор.

Проверка результата

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