Как проверить тип документа в 1С: 5 способов для пользователей и разработчиков

Определение типа документа в 1С:Предприятие — одна из самых частых задач как для обычных пользователей, так и для программистов. Без этой информации невозможно правильно заполнить отчеты, настроить обмен данными или написать корректный код для автоматизации. Проблема усложняется тем, что в разных конфигурациях (например, 1С:Бухгалтерия, 1С:УТ, 1С:ЗУП) документы могут иметь одинаковые названия, но разные внутренние идентификаторы, а в некоторых случаях тип документа вообще не отображается в интерфейсе.

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

1. Визуальные способы определения типа документа

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

Самый очевидный способ — посмотреть на заголовок окна документа. Например, при открытии документа "Поступление товаров" в строке заголовка обычно указывается полное имя типа: Документ.ПоступлениеТоваровУслуг. Однако в некоторых конфигурациях (особенно кастомизированных) это имя может быть сокращено или изменено.

📄 Строка заголовка окна — часто содержит полное имя типа документа в формате Документ.ИмяТипа.
🔍 Панель навигации — в некоторых конфигурациях при наведении на документ в списке отображается подсказка с типом.
📋 Журналы документов — в колонке "Вид документа" может быть указано краткое или полное имя типа.
⚙️ Свойства объекта — если кликнуть правой кнопкой на документ в списке и выбрать "Свойства", иногда отображается дополнительная информация.

Если визуальные методы не помогают (например, в сильно измененных конфигурациях), переходите к программным способам, которые дают 100% результат.

2. Определение типа документа через встроенный язык (1С)

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

Если у вас есть ссылка на документ, самый простой способ — использовать метод ТипЗнч():

ТипДокумента = ТипЗнч(СсылкаНаДокумент);
Сообщить("Тип документа: " + ТипДокумента);

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

ТипДокумента = ТипЗнч(СсылкаНаДокумент); ИмяТипа = ТипДокумента.ИмяТипа();
Сообщить("Имя типа: " + ИмяТипа); // Вернет, например, "ПоступлениеТоваровУслуг"

Если вы работаете внутри модуля документа, можно использовать ключевое слово ЭтотОбъект:

Сообщить("Тип текущего документа: " + ТипЗнч(ЭтотОбъект));

Получите ссылку на документ (например, через выборку или параметр функции)

Используйте ТипЗнч() для получения типа

При необходимости извлеките имя типа с помощью .ИмяТипа()

Проверьте результат на корректность (например, что тип не равен Неопределено)

-->

Если вам нужно определить тип документа по его номеру или дате, сначала найдите документ через выборку, а затем примените ТипЗнч():

Запрос = Новый Запрос; Запрос.Текст = "ВЫБРАТЬ | Ссылка КАК Ссылка |ИЗ | Документ.ПоступлениеТоваровУслуг КАК ПоступлениеТоваровУслуг |ГДЕ | ПоступлениеТоваровУслуг.Номер = &Номер | И ПоступлениеТоваровУслуг.Дата = &Дата"; Запрос.УстановитьПараметр("Номер", "000000001"); Запрос.УстановитьПараметр("Дата", '2026-01-15'); РезультатЗапроса = Запрос.Выполнить(); Выборка = РезультатЗапроса.Выбрать(); Если Выборка.Следующий() Тогда ТипДокумента = ТипЗнч(Выборка.Ссылка); Сообщить("Тип найденного документа: " + ТипДокумента);
КонецЕсли;

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

3. Использование метаданных для получения списка всех типов документов

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

Чтобы получить список всех документов в конфигурации, используйте следующий код:

Метаданные = Метаданные(); Для Каждого Документ Из Метаданные.Документы Цикл Сообщить("Тип документа: " + Документ.Имя);
КонецЦикла;

Этот код выведет в окно сообщений имена всех типов документов, например:

Тип документа: ПоступлениеТоваровУслуг Тип документа: РеализацияТоваровУслуг Тип документа: ПлатежноеПоручение
...

Если вам нужно не только имя, но и полную информацию о документе (например, реквизиты, табличные части, формы), используйте свойства объекта метаданных:

Свойство объекта метаданных	Описание	Пример значения
`Имя`	Внутреннее имя типа документа (используется в коде)	`ПоступлениеТоваровУслуг`
`Синоним`	Отображаемое имя документа в интерфейсе	`Поступление (товары, услуги, комиссия)`
`ПолноеИмя()`	Полный путь к типу в дереве метаданных	`Документ.ПоступлениеТоваровУслуг`
`Реквизиты`	Коллекция реквизитов документа	`Дата, Номер, Организация, Контрагент...`
`ТабличныеЧасти`	Коллекция табличных частей документа	`Товары, Услуги, Дополнительно...`

Для Каждого Документ Из Метаданные.Документы Цикл Сообщить("Имя: " + Документ.Имя); Сообщить("Синоним: " + Документ.Синоним); Сообщить("Полное имя: " + Документ.ПолноеИмя()); Сообщить("--- Реквизиты ---"); Для Каждого Реквизит Из Документ.Реквизиты Цикл Сообщить(Реквизит.Имя + " (" + Реквизит.Тип.ИмяТипа() + ")"); КонецЦикла;
КонецЦикла;

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

Свойство объекта метаданных Описание Пример значения

Имя Внутреннее имя типа документа (используется в коде) ПоступлениеТоваровУслуг

Синоним Отображаемое имя документа в интерфейсе Поступление (товары, услуги, комиссия)

ПолноеИмя() Полный путь к типу в дереве метаданных Документ.ПоступлениеТоваровУслуг

Реквизиты Коллекция реквизитов документа Дата, Номер, Организация, Контрагент...

ТабличныеЧасти Коллекция табличных частей документа Товары, Услуги, Дополнительно...

💡
Если вам нужно получить список документов только для конкретного подсистемы (например, только для "Закупки"), используйте фильтрацию по свойству Подсистемы объекта метаданных. Это ускорит обработку и сделает код более читаемым.

4. Определение типа документа по его идентификатору (UID)

В некоторых случаях (например, при обмене данными или работе с 1С:EDT) документы идентифицируются не по имени типа, а по уникальному идентификатору (UID). Это актуально для конфигураций, где имена типов могут меняться при обновлениях, а UID остается стабильным.

Чтобы получить UID типа документа, используйте метод УникальныйИдентификатор():

Метаданные = Метаданные(); ДокументПоступление = Метаданные.Документы.ПоступлениеТоваровУслуг; UID = ДокументПоступление.УникальныйИдентификатор();
Сообщить("UID типа 'ПоступлениеТоваровУслуг': " + UID);

Обратно, если у вас есть UID, можно найти соответствующий тип документа:

UID = "1a2b3c4d-5e6f-7g8h-9i0j-1k2l3m4n5o6p"; // Пример UID Метаданные = Метаданные(); Для Каждого Документ Из Метаданные.Документы Цикл Если Документ.УникальныйИдентификатор() = UID Тогда Сообщить("Найден тип документа: " + Документ.Имя); Прервать; КонецЕсли;
КонецЦикла;

Работа с UID особенно важна при обмене данными между разными базами, где имена типов могут не совпадать, а идентификаторы остаются неизменными.

⚠️ Внимание: UID типа документа может изменяться при полном пересоздании конфигурации или при переносе объектов между разными базами с помощью выгрузки/загрузки. Всегда проверяйте актуальность UID после таких операций.

5. Проверка типа документа в отладчике 1С
Если вы разрабатываете или отлаживаете код, самый быстрый способ определить тип документа — использовать встроенный отладчик 1С:Предприятие. Это позволяет не только увидеть тип, но и изучить структуру документа, его реквизиты и методы.

Чтобы определить тип документа в отладчике:

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

Запустите отладку (F5 или кнопка "Начать отладку").

Когда выполнение остановится на точке останова, наведите курсор на переменную со ссылкой на документ.

В появившейся подсказке будет указан тип документа в формате ДокументСсылка.ИмяТипа.

Также можно использовать окно "Вычислить выражение" (Ctrl+Alt+F8), чтобы вручную выполнить код и получить тип:

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

Как открыть отладчик в 1С 8.3?

1. Запустите 1С:Предприятие в режиме отладки (для этого при старте удерживайте Shift или выберите режим "Отладка" в конфигураторе).

2. В конфигураторе установите точки останова в нужных местах кода.

3. Вернитесь в пользовательский режим и выполните действия, которые приведут к срабатыванию точки останова.

4. При остановке отладчика используйте окно "Локальные переменные" или "Вычислить выражение" для анализа данных.

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

НовыйДокумент = Документы.ПоступлениеТоваровУслуг.СоздатьДокумент(); ТипДокумента = ТипЗнч(НовыйДокумент);
Сообщить("Тип нового документа: " + ТипДокумента);

6. Типичные ошибки при определении типа документа и как их избежать

Даже опытные разработчики иногда сталкиваются с проблемами при определении типа документа в 1С. Рассмотрим самые распространенные ошибки и способы их решения.

Ошибка 1: Пустая ссылка или Неопределено

Если при использовании ТипЗнч() вы получаете ошибку или значение Неопределено, скорее всего, переменная со ссылкой на документ не инициализирована. Всегда проверяйте ссылку перед определением типа:

Если СсылкаНаДокумент = Неопределено Тогда Сообщить("Ошибка: ссылка на документ не задана!"); Иначе ТипДокумента = ТипЗнч(СсылкаНаДокумент);
КонецЕсли;

Ошибка 2: Неправильное имя типа в выборках

При работе с запросами часто ошибаются в имени типа документа. Например, вместо Документ.ПоступлениеТоваровУслуг могут указать просто ПоступлениеТоваровУслуг, что приведет к ошибке. Всегда используйте полное имя типа:

// Неправильно: Запрос.Текст = "ВЫБРАТЬ Ссылка ИЗ ПоступлениеТоваровУслуг"; // Правильно:
Запрос.Текст = "ВЫБРАТЬ Ссылка ИЗ Документ.ПоступлениеТоваровУслуг КАК ПоступлениеТоваровУслуг";

Ошибка 3: Путаница между типом и видом документа

В некоторых конфигурациях (например, 1С:Управление торговлей) документы могут иметь вид (например, "Поступление товаров" и "Поступление услуг" как виды одного типа "ПоступлениеТоваровУслуг"). Не путайте тип документа с его видом! Тип определяется через ТипЗнч(), а вид — через реквизит "ВидДокумента".

Ошибка 4: Неучет версий конфигурации

Имена типов документов могут меняться при обновлении конфигурации. Например, в старых версиях 1С:Бухгалтерии документ назывался ПоступлениеТоваров, а в новых — ПоступлениеТоваровУслуг. Всегда проверяйте актуальность имен типов в текущей версии.

⚠️ Внимание: Если вы пишете код для тиражных конфигураций (например, 1С:Бухгалтерия 3.0 или 1С:УТ 11), учитывайте, что имена типов документов могут отличаться в разных редакциях (базовая, ПРОФ, КОРП). Используйте Метаданные для динамического получения имен.

💡
Всегда проверяйте ссылку на документ на Неопределено перед использованием ТипЗнч(). Это позволит избежать большинства ошибок при определении типа.

7. Практические примеры: как применить знания на практике

Рассмотрим несколько реальных задач, где определение типа документа является ключевым шагом.

Пример 1: Автоматическая обработка документов по типу

Допустим, вам нужно написать обработку, которая будет автоматически отправлять email-уведомления для документов типа "Заказ покупателя", но не для других типов. Вот как это можно реализовать:

Процедура ОбработатьДокумент(СсылкаНаДокумент) ТипДокумента = ТипЗнч(СсылкаНаДокумент); Если ТипДокумента.ИмяТипа() = "ЗаказПокупателя" Тогда ОтправитьEmailУведомление(СсылкаНаДокумент); КонецЕсли;
КонецПроцедуры

Пример 2: Универсальный отчет по документам разных типов

Если вам нужно создать отчет, который будет работать с документами разных типов (например, "Поступление" и "Реализация"), используйте проверку типа для динамического формирования запроса:

ТипыДокументов = Новый Массив; ТипыДокументов.Добавить(Метаданные.Документы.ПоступлениеТоваровУслуг); ТипыДокументов.Добавить(Метаданные.Документы.РеализацияТоваровУслуг); Запрос = Новый Запрос; ТекстЗапроса = "ВЫБРАТЬ |"; Для Каждого ТипДок Из ТипыДокументов Цикл ТекстЗапроса = ТекстЗапроса + " Ссылка КАК Ссылка, |" + " "" + ТипДок.Синоним + "" КАК ТипДокумента |" + "ИЗ |" + " Документ." + ТипДок.Имя + " КАК " + ТипДок.Имя + " |" + "ОБЪЕДИНИТЬ ВСЕ |"; КонецЦикла; Запрос.Текст = ТекстЗапроса;
Результат = Запрос.Выполнить();

Пример 3: Обмен данными с фильтрацией по типу

При настройке обмена данными (например, через Универсальный формат обмена) часто требуется передавать только документы определенных типов. В этом случае определение типа документа позволяет отфильтровать ненужные данные:

Процедура ПодготовитьДанныеДляОбмена() Выборка = Документы.ВыбратьПоДате(НачалоДня(ТекущаяДата()), КонецДня(ТекущаяДата())); Пока Выборка.Следующий() Цикл ТипДокумента = ТипЗнч(Выборка.Ссылка).ИмяТипа(); Если ТипДокумента = "ПоступлениеТоваровУслуг" Или ТипДокумента = "РеализацияТоваровУслуг" Тогда ДобавитьВДанныеДляОбмена(Выборка.Ссылка); КонецЕсли; КонецЦикла;
КонецПроцедуры

Важно: При обмене данными между разными конфигурациями (например, 1С:УТ и 1С:Бухгалтерия) имена типов документов могут не совпадать. В этом случае используйте UID или настройте соответствие типов в правилах обмена.

FAQ: Частые вопросы по определению типа документа в 1С

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

Если у вас есть только номер документа, сначала найдите документ по номеру с помощью выборки, а затем определите его тип. Пример:

Запрос = Новый Запрос; Запрос.Текст = "ВЫБРАТЬ ПЕРВЫЕ 1 | Ссылка КАК Ссылка |ИЗ | Документ.ПоступлениеТоваровУслуг КАК Док |ГДЕ | Док.Номер = &Номер |УПОРЯДОЧИТЬ ПО | Док.Дата УБЫВ"; Запрос.УстановитьПараметр("Номер", "000000001"); Результат = Запрос.Выполнить(); Если НЕ Результат.Пустой() Тогда Выборка = Результат.Выбрать(); Выборка.Следующий(); ТипДокумента = ТипЗнч(Выборка.Ссылка); Сообщить("Тип документа: " + ТипДокумента);
КонецЕсли;

Обратите внимание, что в запросе используется ПЕРВЫЕ 1 и сортировка по дате убыванию, чтобы получить самый свежий документ с данным номером.

Можно ли определить тип документа по его внешнему виду в печатной форме?

Нет, по печатной форме документа определить его тип программно невозможно. Печатные формы — это просто шаблоны вывода данных, и один и тот же тип документа может иметь несколько разных печатных форм (например, "Торг-12" и "Счет-фактура" для документа "Реализация").

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

Как узнать, к какой подсистеме относится документ?

Чтобы определить, к какой подсистеме относится документ, используйте свойство Подсистемы объекта метаданных:

Метаданные = Метаданные(); ДокументМета = Метаданные.Документы.ПоступлениеТоваровУслуг; Для Каждого Подсистема Из ДокументМета.Подсистемы Цикл Сообщить("Подсистема: " + Подсистема.Имя);
КонецЦикла;

Это полезно, если вам нужно, например, отображать документы только из определенной подсистемы (например, "Закупки" или "Продажи").

Почему ТипЗнч() возвращает ДокументСсылка.ИмяТипа, а не просто ИмяТипа?

Функция ТипЗнч() возвращает полный тип значения, который включает в себя категорию типа (в данном случае ДокументСсылка) и имя типа. Это сделано для того, чтобы отличать ссылки на документы от других типов данных (например, от ссылок на справочники или планы видов характеристик).

Если вам нужно только имя типа, используйте метод .ИмяТипа(), как показано в примерах выше.

Как определить тип документа в мобильном приложении 1С?

В мобильном приложении 1С:Предприятие (например, в 1С:Мобильная платформа) способы определения типа документа такие же, как и в десктопной версии. Вы можете использовать:

ТипЗнч() для получения типа по ссылке;

объект Метаданные для получения списка всех типов;

отладчик (если он доступен в вашей версии мобильного приложения).

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

Как узнать тип документа в 1С: подробное руководство с примерами

1. Визуальные способы определения типа документа

2. Определение типа документа через встроенный язык (1С)

3. Использование метаданных для получения списка всех типов документов

4. Определение типа документа по его идентификатору (UID)

5. Проверка типа документа в отладчике 1С

6. Типичные ошибки при определении типа документа и как их избежать

7. Практические примеры: как применить знания на практике

FAQ: Частые вопросы по определению типа документа в 1С

📖 Читайте также