Уникальный идентификатор 1С: получить UUID и найти объект

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

UUID, ссылка, код и номер

Внутри одной базы в обычном коде чаще передают ссылку. Для интеграции с внешней системой обычно хранят внешний ключ и UUID либо ссылку по согласованным правилам. Не используйте представление ссылки как постоянный идентификатор: оно предназначено для человека и зависит от формата.

Как получить идентификатор объекта

&НаСервереБезКонтекста
Функция ИдентификаторКонтрагента(СсылкаКонтрагента)
    Если Не ЗначениеЗаполнено(СсылкаКонтрагента) Тогда
        Возврат Неопределено;
    КонецЕсли;

    Возврат УникальныйИдентификатор(СсылкаКонтрагента);
КонецФункции

Функция возвращает значение типа УникальныйИдентификатор. Если его нужно передать в JSON или записать в текстовый лог, форматируйте значение единообразно и не меняйте регистр или символы без необходимости.

Поиск объекта по UUID

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

Что учитывать в интеграции

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

Типичные ошибки

• Используют номер документа для синхронизации. Номер может повторяться в разных базах или измениться при загрузке.
• Хранят только UUID без типа объекта. Код не понимает, каким менеджером искать объект.
• Принимают UUID от внешнего сервиса без проверки. Внешний идентификатор нужно сопоставлять с разрешёнными данными.
• Смешивают ссылку и строку UUID. В 1С это разные типы с разными методами работы.

Когда нужна доработка

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