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

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

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

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

1. Получение типа документа через интерфейс 1С (без программирования)

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

Самый простой метод:

1. Откройте список документов (например, Продажи → Реализация товаров и услуг).
2. Щелкните правой кнопкой мыши по колонке "Вид документа" (если ее нет — добавьте через настройки списка).
3. В контекстном меню выберите Группировка → По виду документа.

После этого все документы будут сгруппированы по типам, а в заголовке каждой группы отобразится полное имя вида, например: Документ.РеализацияТоваровУслуг.

Для более детальной информации:

• 🔍 Откройте карточку документа и посмотрите на заголовок окна — там указывается тип (например, "Поступление (акты, накладные)").
• 📋 В журнале документов (Все функции → Журналы документов) тип отображается в отдельной колонке.
• 🖥️ В веб-клиенте 1С тип документа можно увидеть в URL-адресе при открытии формы (параметр ref=Документ.ИмяТипа).

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

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

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

2.1. Метод Метаданные() и ТипЗначения()

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

СсылкаНаДокумент = Документы.ПоступлениеТоваровУслуг.НайтиПоНомеру("000000001");
ТипДокумента = СсылкаНаДокумент.Метаданные().Имя;

Альтернативный вариант через ТипЗначения():

ТипДокумента = ТипЗначения(СсылкаНаДокумент).ИмяТипа;

Оба метода вернут строку вида "Документ.ПоступлениеТоваровУслуг".

2.2. Работа с менеджером документов

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

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

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

2.3. Использование ПолноеИмя() для точной идентификации

Метод ПолноеИмя() возвращает тип документа с учетом пространства имен, что важно для конфигураций с подсистемами:

ПолныйТип = СсылкаНаДокумент.Метаданные().ПолноеИмя();
// Пример результата: "Документ.Финансы.ПлатежноеПоручение"

Убедиться, что ссылка на документ не пустая|Проверить права доступа к метаданным|Учесть версию платформы (в 8.2 и 8.3 синтаксис может отличаться)|Обработать исключение, если документ не найден-->

3. Особенности работы с типами документов в разных конфигурациях

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

3.1. 1С:Бухгалтерия предприятия (БП 3.0)

В БП 3.0 документы часто привязаны к бухгалтерским операциям. Например:

• 📄 Документ.БанковскаяВыписка — для работы с выписками по расчетным счетам.
• 💰 Документ.ПлатежноеПоручение — для платежных документов.
• 📦 Документ.ПоступлениеТоваровУслуг — универсальный документ для учета ТМЦ.

В БП 3.0 имена типов документов могут содержать префиксы подсистем, например: Документ.Банк.ПлатежноеПоручение вместо просто Документ.ПлатежноеПоручение.

3.2. 1С:Управление торговлей (УТ 11)

В УТ 11 акцент сделан на торговых операциях, поэтому здесь появляются специфические типы:

• 🛒 Документ.ЗаказПокупателя — для оформления заказов клиентов.
• 🚛 Документ.РеализацияТоваровУслуг — для отгрузки.
• 🔄 Документ.ВозвратТоваровОтПокупателя — для возвратов.

Важно: В УТ 11.4 и новее некоторые документы были переименованы (например, ОтчетОРозничныхПродажах стал ОтчетОРознице).

3.3. 1С:Зарплата и управление персоналом (ЗУП 3.1)

В ЗУП 3.1 документы связаны с кадровым учетом и расчетом зарплаты:

• 👔 Документ.ПриемНаРаботу — кадровый документ.
• 💸 Документ.НачислениеЗарплаты — для расчетов.
• 📅 Документ.ТабельУчетаРабочегоВремени — для учета времени.

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

4. Работа с типами документов в запросах и отчетах

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

4.1. Фильтрация в запросе по типу

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

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

Обратите внимание на двойные кавычки внутри строки — это обязательный синтаксис для 1С:Предприятие 8.3.

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

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

Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
ТипДокумента = ЭтотОбъект.ВидДокумента.Имя;
КонецПроцедуры

4.3. Ошибки при работе с типами в отчетах

Типичные ошибки и их решения:

• ❌ Ошибка: "Неопределенный тип документа" — проверьте регистр в имени типа (в 1С регистрозависимые сравнения!).
• ❌ Ошибка: "Нет прав на метаданные" — добавьте роль Администрирование или ПолныеПрава.
• ❌ Ошибка: "Не найден документ" — используйте Попытка ... Исключение для обработки.

5. Продвинутые техники: получение типа через рефлексию и OLE

Для сложных задач (например, при интеграции с внешними системами) стандартных методов может быть недостаточно. Рассмотрим альтернативные подходы.

5.1. Использование рефлексии (для опытных разработчиков)

Рефлексия позволяет получать информацию о типах во время выполнения. Пример:

Тип = Тип("Документ.РеализацияТоваровУслуг");
Сообщить(Тип.ПолноеИмя()); // Вернет "Документ.РеализацияТоваровУслуг"

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

5.2. Работа с OLE и COM-объектами

При интеграции с Excel или другими приложениями через OLE тип документа можно передавать как строку:

Excel = Новый COMОбъект("Excel.Application");
Excel.Cells(1,1).Value = "Тип документа: " + СсылкаНаДокумент.Метаданные().Имя;

5.3. Получение типа из внешних источников (JSON, XML)

Если вы работаете с обменами данными, тип документа может храниться в атрибутах:

// Пример разбора JSON
Данные = Новый ЧтениеJSON;
Данные.УстановитьСтроку('{"docType": "Документ.ЗаказПокупателя", "ref": "..."}');
ТипДокумента = Данные.Прочитать().docType;

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

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

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

6.1. Путаница между Имя и ПолноеИмя

Частая ошибка — использование Имя вместо ПолноеИмя в конфигурациях с подсистемами. Например:

// Неверно (может не найти документ в подсистеме)
Если Док.Метаданные().Имя = "ПлатежноеПоручение" Тогда

// Правильно
Если Док.Метаданные().ПолноеИмя() = "Документ.Банк.ПлатежноеПоручение" Тогда

6.2. Ошибки при сравнении строк

Сравнение типов документов чувствительно к регистру и пробелам:

// Ошибка: регистр не совпадает
Если ТипДок = "реализациятоваровуслуг" Тогда

// Правильно
Если Строчные(ТипДок) = Строчные("РеализацияТоваровУслуг") Тогда

6.3. Проблемы с правами доступа

Если при обращении к Метаданные() возникает ошибка прав, проверьте:

• 🔐 Наличие роли Администрирование у пользователя.
• 🛡️ Параметр БезопасныйРежим в настройках ИБ (должен быть отключен для рефлексии).
• 📜 Права на конкретный вид документа (в 1С права могут назначаться отдельно по типам).

7. Практические примеры для разных задач

Рассмотрим реальные сценарии, где требуется определение типа документа.

7.1. Обработка проводок по типу документа

При формировании бухгалтерских проводок часто нужно учитывать тип источника:

Процедура ОбработатьДокумент(Документ)
ТипДок = Документ.Метаданные().Имя;

Если ТипДок = "ПоступлениеТоваровУслуг" Тогда
// Логика для поступления
ИначеЕсли ТипДок = "РеализацияТоваровУслуг" Тогда
// Логика для реализации
КонецЕсли;
КонецПроцедуры

7.2. Автоматическое заполнение реквизитов

При создании нового документа на основе существующего:

НовыйДок = Документы.Создать(СтарыйДок.Метаданные().Имя);
НовыйДок.Контрагент = СтарыйДок.Контрагент;

7.3. Интеграция с внешними системами

При экспорте данных в XML или JSON тип документа часто включают в структуру:

ДанныеДляЭкспорта = Новый Структура();
ДанныеДляЭкспорта.Вставить("ТипДокумента", Док.Метаданные().ПолноеИмя());
ДанныеДляЭкспорта.Вставить("Номер", Док.Номер);

7.4. Построение универсальных отчетов

В универсальных отчетах тип документа используется для фильтрации:

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

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

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

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

Выборка = ЖурналыДокументов.ОбщийЖурнал.Выбрать();
Пока Выборка.Следующий() Цикл
ТипДок = Выборка.ВидДокумента.Имя;
КонецЦикла;

ПолныйПуть = Док.Метаданные().ПолноеИмя();
// Пример результата: "Документ.Логистика.ПеремещениеТоваров"

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

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