Как определить, что это за документ в 1С

В системе 1С:Предприятие документ — это основной объект учёта: каждая хозяйственная операция (продажа, оплата, приём на работу, перемещение товара) оформляется своим видом документа. Когда вы видите в списке запись «Реализация товаров и услуг 0000-001234» или получаете ссылку из внешней системы, первый практический вопрос — как определить, что это за документ, к какому виду он относится и что означают его реквизиты.

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

Что такое «вид документа» в 1С и где он задаётся

Каждый документ в базе принадлежит определённому виду, который задаётся в конфигураторе в ветке «Документы» дерева метаданных. Вид определяет структуру: какие реквизиты, табличные части и движения по регистрам будут у документа. Например, в типовой конфигурации «Управление торговлей» существуют виды «Заказ клиента», «Реализация товаров и услуг», «Приходный кассовый ордер» и десятки других.

В пользовательском режиме вид документа отображается прямо в заголовке формы: «Реализация товаров и услуг 0000-001234 от 15.03.2026». В журналах документов вид обычно показан в отдельной колонке «Вид документа» или «Тип». Если журнал общий (например, «Документы продажи»), именно эта колонка позволяет отличить заказ от накладной.

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

Самый простой случай — документ открыт перед вами или виден в списке. Здесь достаточно стандартных средств интерфейса, никаких специальных инструментов не требуется.

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

Если документ пришёл к вам как печатная форма или файл, вид определяют по содержимому: накладная по форме ТОРГ-12 соответствует «Реализации товаров и услуг», счёт-фактура — одноимённому документу, приказ о приёме на работу — кадровому документу «Приём на работу». Точное соответствие зависит от конфигурации, поэтому надёжнее найти документ в базе по номеру и дате через полнотекстовый поиск или журнал.

Как определить вид документа по ссылке и GUID

Каждый документ в базе имеет уникальный идентификатор — GUID из 36 символов, например «a1b2c3d4-1234-5678-90ab-cdef12345678». По одному GUID нельзя узнать вид документа: идентификатор уникален в пределах всей базы, но не содержит информации о типе. Поэтому при обмене с внешними системами всегда передают пару «вид документа + GUID».

Получить GUID ссылки можно программно или через специальные обработки (например, универсальные консоли кода, входящие в типовые инструменты разработчика). Зная GUID и вид, можно найти документ в другой базе, участвующей в обмене: метод Документы.РеализацияТоваровУслуг.ПолучитьСсылку(Новый УникальныйИдентификатор(СтрокаGUID)) вернёт ссылку на объект.

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

Разработчику чаще всего нужно определить вид документа по ссылке, полученной из реквизита, запроса или параметра. Для этого используется метод Метаданные() объекта ссылки или функции работы с типами.

// Определяем вид документа по ссылке
ВидДокумента = ДокСсылка.Метаданные().Имя; // например, "РеализацияТоваровУслуг"
Синоним = ДокСсылка.Метаданные().Синоним;    // "Реализация товаров и услуг"

// Проверяем, что значение вообще является документом
Если Документы.ТипВсеСсылки().СодержитТип(ТипЗнч(ДокСсылка)) Тогда
    Сообщить("Это документ вида: " + ДокСсылка.Метаданные().Имя);
КонецЕсли;

// Сравнение с конкретным видом
Если ТипЗнч(ДокСсылка) = Тип("ДокументСсылка.ЗаказКлиента") Тогда
    // обработка заказа
КонецЕсли;

Функция ТипЗнч() возвращает тип значения, а конструкция Тип("ДокументСсылка.ИмяВида") позволяет сравнить его с конкретным видом. Для универсальных проверок удобны коллекции Документы.ТипВсеСсылки() и Метаданные.Документы: перебрав их, можно построить список всех существующих в конфигурации видов.

В запросах вид документа определяют через функцию ВЫРАЗИТЬ(... КАК Документ.ИмяВида) или через таблицу документа: если поле ссылается на несколько видов (составной тип), конкретный вид проверяют условием ГДЕ Ссылка ССЫЛКА Документ.ИмяВида.

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

Номер документа в 1С уникален только в пределах вида документа и периода нумерации (обычно года). Это значит, что номер «0000-001234» может одновременно существовать у реализации, заказа и счёта-фактуры. Поэтому поиск документа только по номеру без указания вида — частая причина ошибок.

Префикс в номере (например, «ЦБ» в «ЦБ00-001234») обычно указывает на организацию или узел обмена, из которого документ пришёл, но не на вид документа. Чтобы найти документ по известным номеру и дате, используйте полнотекстовый поиск по базе или отбор в конкретном журнале документов.

Определение документа в конфигураторе и при отладке

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

При отладке вид документа виден в табло: если вычислить выражение ТипЗнч(Ссылка), отладчик покажет «ДокументСсылка.РеализацияТоваровУслуг». Через функциональную клавишу Shift+F9 (вычислить выражение) удобно проверять типы переменных прямо в процессе пошагового выполнения кода.

Ограничения и риски при работе со ссылками

Операции определения вида документа безопасны — это чтение метаданных, которое не меняет данные. Осторожность нужна при смежных действиях: попытка записать или удалить документ по найденной ссылке, массовый перебор ссылок в цикле (нагрузка на сервер), обращение к реквизитам «битых» ссылок (объект удалён, а ссылка осталась).

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

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