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

Другое · 8 мин

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

Как узнать идентификатор документа в 1С: где смотреть в форме, как получить программно и в запросе, отличие от номера, проверка и ограничения.

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

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

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

Что представляет собой идентификатор документа

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

1c
Объект = Ссылка.ПолучитьОбъект();
Идентификатор = Объект.Идентификатор;

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

Где посмотреть идентификатор в интерфейсе

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

Сравнение вариантов

Номер документа

Подходит для пользовательского поиска, но может повторяться и меняться.

Идентификатор

Подходит для точной ссылки и интеграции, но часто скрыт от обычного интерфейса.

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

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

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

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

Отличие номера документа и идентификатора

Номер документа предназначен для пользовательского учёта и может быть не уникальным в разрезе всей базы, особенно если нумерация ведётся по организациям или подразделениям. Идентификатор же привязан к конкретной записи и не меняется при корректировке номера. Использование номера вместо идентификатора при интеграции часто приводит к дублям или неверной привязке.

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

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

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

Открытие документа по полученному идентификатору
Норма

Открывается нужный документ с верным номером и датой

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

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

Ограничения, риски и проверка результата

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

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

Порядок действий
  1. 1
    Определите цель получения идентификатора
  2. 2
    Попробуйте найти поле в форме документа через раздел «Ещё» или «Свойства»
  3. 3
    Если поля нет, получите значение программно через объект документа
  4. 4
    Проверьте, что идентификатор открывает нужный документ
  5. 5
    Не переносите идентификатор между базами без уточнения

Когда идентификатор может быть недоступен

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

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

Типичные ошибки
01
Использование номера документа вместо идентификатора при интеграции
02
Ручное изменение значения идентификатора в форме или базе
03
Перенос идентификатора между разными информационными базами

Частые ошибки при работе с идентификатором

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

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

Итог

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

Идентификатор отличается от номера, лучше всего получается программно, проверяется открытием документа, и не переносится между базами.

Нужен ли идентификатор для обычного пользователя?

Обычно нет. Для работы в интерфейсе 1С достаточно номера, даты и контрагента. Идентификатор нужен преимущественно для интеграции, обмена данных и программной разработки.

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

Не рекомендуется. Номер может повторяться в разных организациях или меняться, тогда как идентификатор однозначно указывает на одну запись. Для надёжной связи используйте идентификатор.

Что делать, если идентификатор не виден в форме?

Проверьте права доступа и раздел «Ещё» или «Свойства». Если поле всё равно отсутствует, получение возможно программно или через конфигуратор при наличии прав разработчика.

Сохраняется ли идентификатор при копировании базы?

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

Безопасно ли вручную редактировать идентификатор?

Нет. Ручное изменение технического идентификатора может нарушить связи с другими документами и привести к ошибкам в учёте. Читайте значение, но не правьте его самостоятельно.