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

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

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

Мы рассмотрим:

• 🔍 Встроенные функции платформы для проверки типа
• 💻 Программные методы с примерами кода на встроенном языке
• ⚙️ Как учитывать иерархию документов (родительские и дочерние типы)
• ❌ Типичные ошибки и как их избежать
• 📊 Практические примеры для бухгалтерии, торговли и кадрового учёта

1. Встроенные функции 1С для проверки типа документа

Платформа 1С:Предприятие 8 предоставляет несколько базовых инструментов для определения типа документа без написания кода. Эти методы подходят для пользователей, не владеющих программированием, или для быстрой проверки в режиме 1С:Отладчик.

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

ТипДокумента = ТипЗнч(Документ);
Сообщить(ТипДокумента.ИмяТипа());

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

МетаДанныеДокумента = Документ.Метаданные();
Сообщить(МетаДанныеДокумента.Имя);

• 📌 ТипЗнч() — возвращает тип значения (включая документы, справочники, перечисления)
• 📌 Метаданные() — даёт доступ к метаинформации объекта (имя, синоним, родительский тип)
• 📌 ЭтоТип() — проверяет соответствие объекта заданному типу (полезно для фильтрации)

Обратите внимание: эти функции работают только с существующими объектами. Если вы пытаетесь проверить тип по строковому идентификатору (например, "Документ.РеализацияТоваровУслуг"), они вернут ошибку. Для таких случаев нужны программные методы, о которых пойдёт речь дальше.

2. Программные методы проверки типа документа

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

2.1. Проверка по полному имени типа

Если вам известно полное имя типа документа (например, "Документ.ПоступлениеТоваровУслуг"), вы можете сравнить его с типом текущего документа:

Если ТипЗнч(Документ) = Тип("Документ.ПоступлениеТоваровУслуг") Тогда
Сообщить("Это документ поступления!");
КонецЕсли;

Этот метод надёжен, но требует точного совпадения имён. Если в конфигурации есть наследование (например, документ КорректировкаРеализации наследуется от РеализацияТоваровУслуг), такое сравнение может не сработать. В этом случае поможет функция ЭтоТип():

Если ЭтоТип(Документ, Тип("Документ.РеализацияТоваровУслуг")) Тогда
Сообщить("Это реализация или её наследник!");
КонецЕсли;

2.2. Работа с метаданными через Метаданные.Документы

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

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

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

Если Метаданные.Документы.Найти("ПоступлениеТоваровУслуг") <> Неопределено Тогда
Сообщить("Документ существует!");
Иначе
Сообщить("Документ не найден!");
КонецЕсли;

Использовать ТипЗнч() для получения типа объекта|

Сравнивать с Тип("Документ.Имя") для точного совпадения|

Применять ЭтоТип() для учёта наследования|

Проверять существование документа через Метаданные.Документы.Найти()-->

3. Работа с иерархией документов (наследование типов)

В 1С:Предприятие 8 документы могут наследовать свойства и методы от родительских типов. Например, документ ВозвратТоваровОтПокупателя часто наследуется от РеализацияТоваровУслуг. Это усложняет проверку типа, так как стандартные методы могут не различать родительский и дочерний документы.

Для корректной работы с наследованием используйте комбинацию ЭтоТип() и проверку через Метаданные.Родитель. Пример:

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

Для получения полной цепочки наследования документа можно написать рекурсивную функцию:

Функция ПолучитьЦепочкуНаследования(ТипДокумента)
Цепочка = Новый Массив();
ТекущийТип = ТипДокумента;

Пока ТекущийТип <> Неопределено Цикл
Цепочка.Добавить(ТекущийТип.ИмяТипа());
ТекущийТип = ТекущийТип.Родитель();
КонецЦикла;

Возврат Цепочка;
КонецФункции;

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

4. Практические примеры для разных областей учёта

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

4.1. Бухгалтерский учёт: фильтрация проводок

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

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   ДокументПроводки.Ссылка КАК Документ,
|   ДокументПроводки.ВидДвижения КАК ВидДвижения
|ИЗ
|   РегистрБухгалтерии.Хозрасчетный.Проводки КАК ДокументПроводки
|ГДЕ
|   ЭтоТип(ДокументПроводки.Ссылка, Тип("Документ.РеализацияТоваровУслуг"))";

Результат = Запрос.Выполнить();

В этом примере запрос вернёт только те проводки, которые связаны с документами реализации (включая их наследников).

4.2. Торговля: обработка заказов и отгрузок

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

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

4.3. Кадровый учёт: различия между приказами

В 1С:Зарплата и Управление Персоналом документы типа ПриказОПриемеНаРаботу и ПриказОбУволнении имеют разную структуру. Для их идентификации удобно использовать метаданные:

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

5. Типичные ошибки и как их избежать

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

Ошибка 1: Использование строкового сравнения вместо Тип()

Некорректно:

Если Документ.Метаданные().Имя = "РеализацияТоваровУслуг" Тогда

Правильно:

Если ТипЗнч(Документ) = Тип("Документ.РеализацияТоваровУслуг") Тогда

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

Ошибка 2: Игнорирование наследования

Некорректно:

Если ТипЗнч(Документ) = Тип("Документ.РеализацияТоваровУслуг") Тогда

Правильно (если нужны наследники):

Если ЭтоТип(Документ, Тип("Документ.РеализацияТоваровУслуг")) Тогда

Ошибка 3: Проверка несуществующего документа

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

Если Документ <> Неопределено Тогда
ТипДокумента = ТипЗнч(Документ);
КонецЕсли;

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

6. Автоматизация проверки типов документов

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

6.1. Универсальная функция проверки типа

Пример функции, которая проверяет тип документа с учётом наследования и возвращает результат в удобном формате:

Функция ПроверитьТипДокумента(Документ, ИмяТипа)
Попытка
ТипДляПроверки = Тип("Документ." + ИмяТипа);
Возврат ЭтоТип(Документ, ТипДляПроверки);
Исключение
Возврат Ложь;
КонецПопытки;
КонецФункции;

Использование:

Если ПроверитьТипДокумента(ТекущийДокумент, "РеализацияТоваровУслуг") Тогда
Сообщить("Это реализация или её наследник!");
КонецЕсли;

6.2. Получение всех наследников документа

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

Функция ПолучитьНаследниковДокумента(ИмяРодительскогоТипа)
РодительскийТип = Метаданные.Документы.Найти(ИмяРодительскогоТипа);
Если РодительскийТип = Неопределено Тогда
Возврат Новый Массив();
КонецЕсли;

Наследники = Новый Массив();
Для Каждого Документ Из Метаданные.Документы Цикл
ТекущийТип = Документ;
Пока ТекущийТип <> Неопределено Цикл
Если ТекущийТип.Имя = ИмяРодительскогоТипа Тогда
Наследники.Добавить(Документ.Имя);
Прервать;
КонецЕсли;
ТекущийТип = ТекущийТип.Родитель();
КонецЦикла;
КонецЦикла;

Возврат Наследники;
КонецФункции;

Эта функция вернёт массив имён всех документов, которые прямо или косвенно наследуются от указанного родительского типа.

6.3. Создание обработки для массовой проверки

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

Процедура ЗаполнитьСписокДокументов()
СписокДокументов = Новый СписокЗначений();
Для Каждого Документ Из Метаданные.Документы Цикл
СписокДокументов.Добавить(Документ.Имя, Документ.Синоним);
КонецЦикла;
ЭлементыФормы.СписокТиповДокументов.Список = СписокДокументов;
КонецПроцедуры;

Такая обработка позволит пользователю выбрать тип документа из выпадающего списка и применить к нему нужные действия.

7. Проверка типа документа в отчётах и запросах

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

7.1. Использование ВЫРАЗИТЬ и ТИП в запросах

В языке запросов для проверки типа документа используется оператор ВЫРАЗИТЬ:

ВЫБРАТЬ
Документ.Ссылка КАК Ссылка
ИЗ
Документ.РеализацияТоваровУслуг КАК Документ
ГДЕ
ВЫРАЗИТЬ(Документ.Ссылка КАК Документ.РеализацияТоваровУслуг) <> NULL

Для проверки наследования можно использовать ТИП:

ВЫБРАТЬ
Документ.Ссылка КАК Ссылка
ИЗ
Документ.РеализацияТоваровУслуг КАК Документ
ГДЕ
ТИП(Документ.Ссылка) = ТИП(Документ.РеализацияТоваровУслуг)

7.2. Фильтрация по типу в отчётах

В стандартных отчётах (например, Оборотно-сальдовая ведомость) можно добавить отбор по типу документа через параметры. Для этого:

1. Откройте настройки отчёта.
2. Перейдите на закладку Отбор.
3. Добавьте поле ВидДокумента (или аналогичное, в зависимости от конфигурации).
4. Укажите нужный тип документа из справочника видов.

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

7.3. Пример сложного запроса с проверкой типов

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

ВЫБРАТЬ
Документ.Ссылка КАК Ссылка,
Документ.Дата КАК Дата,
Документ.СуммаДокумента КАК Сумма
ИЗ
Документ.РеализацияТоваровУслуг КАК Документ
ГДЕ
Документ.Дата МЕЖДУ &НачалоМесяца И &КонецМесяца
И НЕ (ВЫРАЗИТЬ(Документ.Ссылка КАК Документ.ВозвратТоваровОтПокупателя) <> NULL)

ОБЪЕДИНИТЬ ВСЕ

ВЫБРАТЬ
Документ.Ссылка КАК Ссылка,
Документ.Дата КАК Дата,
Документ.СуммаДокумента КАК Сумма
ИЗ
Документ.ПоступлениеТоваровУслуг КАК Документ
ГДЕ
Документ.Дата МЕЖДУ &НачалоМесяца И &КонецМесяца
И НЕ (ВЫРАЗИТЬ(Документ.Ссылка КАК Документ.ВозвратТоваровПоставщику) <> NULL)

В этом запросе используется ОБЪЕДИНИТЬ ВСЕ для объединения результатов по реализациям и поступлениям, а также исключаются документы-возвраты.

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

Ссылка = СсылкаНаОбъект("Документ.РеализацияТоваровУслуг.000000001");
ТипДокумента = ТипЗнч(Ссылка);

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

Если Документ <> Неопределено Тогда
Тип = ТипЗнч(Документ);
КонецЕсли;

МетаДанные = Документ.Метаданные();
Если МетаДанные.Предопределённый Тогда
Сообщить("Это предопределённый документ!");
КонецЕсли;

Если Документ.Ссылка.УникальныйИдентификатор() = Новый УникальныйИдентификатор("123e4567-e89b-12d3-a456-426614174000") Тогда
Сообщить("Это нужный предопределённый документ!");
КонецЕсли;

&НаСервере
Функция ПроверитьТипНаСервере(Документ, ИмяТипа)
Возврат ЭтоТип(Документ, Тип("Документ." + ИмяТипа));
КонецФункции;

Результат = ПроверитьТипНаСервереНаСервере(Документ, "РеализацияТоваровУслуг");