К статье
Практический материал

Разработка и Конфигурация · 10 мин

Как посмотреть GUID документа в 1С

Способы узнать GUID документа в 1С: через конфигуратор, встроенный язык, запрос, обработку и отладчик. Примеры кода, ошибки и ответы на вопросы.

GUID (уникальный идентификатор) документа в 1С — это строка вида «8b3f6c2a-1d4e-11ec-9a03-0242ac130003», которая однозначно определяет объект в базе и во всех связанных системах. Он нужен при настройке обменов, поиске «битых» ссылок, интеграции с внешними сервисами и разборе ситуаций, когда документ вроде бы есть, но найти его по номеру не получается.

Стандартного пункта «показать GUID» в пользовательском интерфейсе типовых конфигураций нет: идентификатор считается служебной информацией. Однако получить его можно несколькими способами — от встроенного языка и консоли запросов до отладчика и специальных обработок. Выбор зависит от того, есть ли у вас права разработчика, доступ к конфигуратору и насколько часто возникает такая задача.

Ниже разобраны рабочие методы с примерами кода, ограничения каждого подхода и типичные ошибки, из-за которых вместо GUID получают пустую строку или идентификатор не того объекта.

Что такое GUID документа и где он хранится

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

Важно понимать: GUID принадлежит ссылке, а не данным документа. Если документ удалить и создать заново с теми же реквизитами, идентификатор будет другим. Именно поэтому обмены данными между базами опираются на GUID, а не на номер или дату документа.

В клиент-серверном варианте GUID хранится в таблицах СУБД в поле _IDRRef (в бинарном виде), в файловой базе — внутри файла 1Cv8.1CD. Напрямую лезть в таблицы SQL за идентификатором не нужно: платформа предоставляет штатные методы, которые делают это безопасно.

Как узнать GUID через встроенный язык 1С

Основной способ — метод УникальныйИдентификатор(), который есть у любой ссылки. Если у вас есть переменная со ссылкой на документ, идентификатор получается одной строкой:

ДокументСсылка = Документы.РеализацияТоваровУслуг.НайтиПоНомеру("0000-000123", ТекущаяДатаСеанса());

Если Не ДокументСсылка.Пустая() Тогда

ГУИД = ДокументСсылка.УникальныйИдентификатор();

Сообщить(ГУИД);

КонецЕсли;

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

Обратная задача — найти документ по известному GUID — решается через конструктор и метод ПолучитьСсылку:

ГУИД = Новый УникальныйИдентификатор("8b3f6c2a-1d4e-11ec-9a03-0242ac130003");

ДокументСсылка = Документы.РеализацияТоваровУслуг.ПолучитьСсылку(ГУИД);

Если ДокументСсылка.ПолучитьОбъект() = Неопределено Тогда

Сообщить("Документ с таким GUID не найден");

КонецЕсли;

bsl
ГУИД = ДокументСсылка.УникальныйИдентификатор();
Сообщить(Строка(ГУИД));

Как посмотреть GUID через отладчик без изменения кода

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

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

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

Как получить GUID через консоль кода или внешнюю обработку

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

Для регулярной работы удобнее простая внешняя обработка: поле выбора документа, кнопка и вывод GUID на форму. Такую обработку можно передать пользователям без доступа к конфигуратору — они смогут самостоятельно копировать идентификаторы для обращений в поддержку или сверки обменов.

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

Как найти GUID через запрос и «Все функции»

Язык запросов 1С не возвращает GUID напрямую — поле «Ссылка» в результате запроса нельзя преобразовать в строку идентификатора средствами запроса. Но можно выбрать ссылки запросом, а затем в обходе результата вызвать УникальныйИдентификатор() для каждой строки. Это удобно, когда нужны GUID сразу нескольких документов, например для выгрузки в файл сверки.

В типовых конфигурациях на БСП (Библиотека стандартных подсистем) иногда доступна команда «Вывести список» или универсальные отчёты, где ссылку можно вывести представлением. Это не GUID, а текстовое представление вида «Реализация товаров 0000-000123 от 12.05.2026» — не путайте их, для интеграций нужен именно идентификатор.

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

Типичные ошибки при работе с GUID

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

Вторая ошибка — работа с несохранённым документом. Пока объект не записан, ссылка может быть пустой, и идентификатор вернётся некорректный или вызовет ошибку. Всегда проверяйте Пустая() перед получением GUID.

Третья группа проблем — «битые ссылки»: GUID в сообщении об ошибке есть, а документа в базе нет (удалён или обмен не догрузил). В этом случае ПолучитьСсылку() вернёт ссылку, но ПолучитьОбъект() даст Неопределено — это и есть признак отсутствующего объекта.

Типичные ошибки
01
Вызов УникальныйИдентификатор() у объекта вместо ссылки — получение ошибки метода; решение: обращаться через .Ссылка
02
Получение GUID до записи нового документа — пустая или некорректная ссылка; решение: сначала Записать()
03
Передача GUID без типа документа во внешнюю систему — невозможность однозначно найти объект; решение: передавать пару «тип + GUID»
04
Поиск документа по GUID в неправильной базе — идентификаторы уникальны, но документ живёт только в своей базе

Как проверить результат и границы самостоятельной работы

Проверить корректность полученного GUID просто: выполните обратный поиск через ПолучитьСсылку() и сравните номер и дату найденного документа с исходным. Если они совпадают — идентификатор верный. Если объект не найден, либо GUID от другой базы, либо документ удалён.

Все описанные способы только читают данные и безопасны для базы. Риск появляется, когда GUID начинают использовать для прямого изменения данных: подстановки ссылок в записи, восстановления удалённых документов через УстановитьСсылкуНового() или правки таблиц SQL вручную. Такие операции выполняйте только на копии базы и при понимании механизмов ссылочной целостности.

Контрольные точки

Как проверить результат

Обратный поиск по GUID
Норма

Документ найден, номер и дата совпадают с исходным

Тревожный признак

ПолучитьОбъект() вернул Неопределено — ссылка битая или база не та

Формат строки GUID
Норма

36 символов, 4 дефиса, шестнадцатеричные знаки

Тревожный признак

Лишние символы, пробелы или русские буквы — строка повреждена при копировании

Ссылка перед получением GUID
Норма

Проверка Пустая() возвращает Ложь

Тревожный признак

Ссылка пустая — документ не найден по номеру или не записан

Часто задаваемые вопросы

Можно ли посмотреть GUID документа без прав администратора?

Штатного интерфейса для этого нет. Если в базе подключена внешняя обработка просмотра GUID, достаточно прав на её запуск. Иначе попросите администратора или разработчика выполнить поиск — это занимает меньше минуты.

Меняется ли GUID при перепроведении или редактировании документа?

Нет. Идентификатор привязан к ссылке и не меняется при любых изменениях реквизитов, отмене проведения или пометке удаления. GUID исчезает только вместе с физическим удалением объекта из базы.

Как найти документ, если известен только GUID из сообщения об ошибке?

Используйте метод ПолучитьСсылку() для нужного вида документа, затем проверьте, существует ли объект. Если вид документа неизвестен, применяют универсальные обработки поиска по GUID, перебирающие все типы ссылок.

Одинаков ли GUID документа в разных базах после обмена?

В типовых механизмах обмена (Конвертация данных, EnterpriseData) GUID сохраняется: документ в базе-приёмнике создаётся с тем же идентификатором. Это позволяет однозначно сопоставлять объекты между базами.

Можно ли получить GUID нескольких документов сразу списком?

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

Что означает GUID из нулей «00000000-0000-0000-0000-000000000000»?

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

Итог

Что важно запомнить

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