Дополнительные реквизиты в 1С: как получить, добавить и использовать в документах

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

В этой статье мы разберём 5 практических способов работы с дополнительными реквизитами — от ручного добавления через конфигуратор до программного извлечения в отчётах и обменах. Особое внимание уделим типичным ошибкам при работе с реквизитами в документах "Поступление товаров" и "Реализация", которые приводят к потерям данных при обновлениях или переносе базы. Все примеры адаптированы для актуальных версий 1С:Управление торговлей 11, 1С:Бухгалтерия 3.0 и 1С:Зарплата и Управление Персоналом 3.1.

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

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

• 📌 Расширять функционал без доработок — например, добавить поле "Серийный номер оборудования" к документу "Поступление товаров".
• 🔄 Сохранять данные при обновлениях — в отличие от модифицированных реквизитов, дополнительные не сбрасываются при установке новых релизов.
• 📊 Использовать в отчётах — их можно выводить в печатные формы, аналитические таблицы или передавать через обмены данными.
• 🔗 Синхронизировать между базами — например, передавать уникальные идентификаторы контрагентов из 1С:ERP в 1С:Бухгалтерию.

Главное отличие от стандартных реквизитов — они не привязаны жёстко к конфигурации. Это значит, что их можно создавать и удалять прямо в пользовательском режиме (при наличии прав), не заходя в конфигуратор. Однако у такого подхода есть и минусы:

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

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

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

Если у вас есть доступ к конфигуратору, самый надёжный способ добавить дополнительные реквизиты — через подсистему ДополнительныеРеквизитыИСведения. Этот метод подходит для массового создания полей или когда нужно привязать реквизит к нескольким объектам одновременно.

Инструкция:

1. Откройте конфигуратор в режиме 1С:Предприятие (с правами администратора).
2. Перейдите в меню Объекты → Дополнительные реквизиты и сведения.
3. Нажмите Создать и выберите тип объекта (например, Документ.ПоступлениеТоваровУслуг).
4. Заполните свойства:
   • Имя — техническое название (латиницей, например CustomSerialNumber).
   • Синоним — отображаемое имя (например, "Серийный номер").
   • Тип значения — выберите из списка (Строка, Число, СправочникСсылка.Контрагенты и т.д.).
   • Подсказка — необязательное поле для пользователей.

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

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

-->

Способ 2: Создание реквизитов в пользовательском режиме (без конфигуратора)

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

Алгоритм для 1С:Управление торговлей 11:

1. Откройте любой документ, к которому хотите добавить реквизит (например, "Заказ покупателя").
2. В меню документа выберите Ещё → Настроить форму (или Все действия → Изменить форму).
3. В открывшемся окне перейдите на вкладку Дополнительные реквизиты.
4. Нажмите Добавить и заполните:
   • Наименование — отображаемое имя (например, "Дата согласования").
   • Тип — выберите из доступных (обычно Строка, Дата, Число).
   • Общий доступ — включите, если реквизит должен быть виден всем пользователям.

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

Через конфигуратор|В пользовательском режиме|С помощью кода (1С или SQL)|Не добавляю, использую стандартные поля

-->

Способ 3: Программное извлечение реквизитов (для разработчиков)

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

Пример кода для извлечения реквизита CustomSerialNumber из документа "Поступление товаров":

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

// Получаем значение дополнительного реквизита
ЗначениеРеквизита = Док.ДополнительныеРеквизиты.Получить("CustomSerialNumber");

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

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

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

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

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

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

Пока Выборка.Следующий() Цикл
Сообщить(Выборка.Документ + ": " + ?(Выборка.СерийныйНомер = Неопределено, ""Нет данных"", Выборка.СерийныйНомер));
КонецЦикла;

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

Способ 4: Выгрузка реквизитов в отчёты и печатные формы

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

Пример для 1С:Бухгалтерия 3.0:

1. Откройте отчёт (например, "Анализ субконто") в режиме 1С:Предприятие.
2. Нажмите Изменить вариант → Настройки → Дополнительные поля.
3. Добавьте новое поле, выбрав источник данных ДополнительныеРеквизиты и указав имя реквизита.
4. Сохраните настройки и обновите отчёт.

Для печатных форм потребуется редактирование макета. Например, чтобы добавить реквизит CustomNote в печатную форму "Счёт на оплату":

1. Откройте документ "Счёт на оплату" и перейдите в Печать → Настроить форму.
2. В конструкторе макета добавьте новый текстовый блок.
3. В свойствах блока укажите выражение:

   ДокументОбъект.ДополнительныеРеквизиты.Получить("CustomNote")

4. Сохраните макет и проверьте вывод на печать.

Если печатная форма хранится во внешнем файле (.mxl), её нужно редактировать в Конфигураторе или с помощью инструмента 1С:Предприятие — Редактор макетов.

Способ 5: Обмен данными с дополнительными реквизитами

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

Инструкция для Универсального формата обмена (EnterpriseData):

1. Откройте обработку УниверсальныйОбменДаннымиXML.
2. Перейдите на вкладку Правила обмена и выберите нужный узел (например, Документ.ПоступлениеТоваровУслуг).
3. В разделе Дополнительные реквизиты добавьте новые правила:
   • Имя реквизита — техническое имя (например, CustomSerialNumber).
   • Тип данных — должен совпадать с типом в исходной базе.
   • Выгрузка/Загрузка — включите оба флажка.
4. Сохраните правила и выполните тестовый обмен.

Для обменов через REST API или HTTP-сервисы дополнительные реквизиты передаются в составе JSON/XML-структуры объекта. Пример фрагмента JSON для документа с реквизитом:

{
"Document": {
"Ref": "000000001",
"AdditionalFields": {
"CustomSerialNumber": "SN-2026-001",
"DeliveryDate": "2026-05-20"
}
}
}

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

Как передать дополнительные реквизиты в 1С

Бухгалтерию из УТ:

Для передачи реквизитов из 1С:Управление торговлей в 1С:Бухгалтерию через типовой обмен:

1. В правилах обмена (раздел "Документы") найдите документ, для которого нужны реквизиты.

2. В свойствах документа включите флаг "Выгружать дополнительные реквизиты".

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

4. Выполните обмен в тестовом режиме и проверьте заполнение реквизитов в целевой базе.

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

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

• 🔴 Ошибка "Реквизит не найден" — возникает, если имя реквизита указано неверно (регистр имеет значение!) или он не создан для этого типа объекта. Проверьте имя через МенеджерДополнительныхРеквизитов.Метаданные().
• 🔴 Потеря данных при обновлении — если реквизит был создан в пользовательском режиме, а затем конфигурацию обновили, он может "исчезнуть". Всегда фиксируйте реквизиты в конфигураторе для критичных данных.
• 🔴 Некорректный тип данных — например, пытаетесь записать дату в реквизит типа Строка. Используйте ТипЗнч() для проверки:

  Если ТипЗнч(ЗначениеРеквизита) <> Тип("Дата") Тогда
  Сообщить("Ошибка типа!");
  КонецЕсли;

• 🔴 Проблемы с правами — пользователь не видит реквизит, хотя он создан. Проверьте права на объект ДополнительныеРеквизитыИСведения в ролях.

Ещё одна частая проблема — дублирование реквизитов. Например, в базе уже есть реквизит CustomNote, но вы случайно создаёте новый с тем же именем, но другим типом. В этом случае 1С не выдаст ошибку, но данные будут записываться в разные поля. Чтобы избежать этого, всегда проверяйте существование реквизита перед созданием:

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

Практические примеры для разных конфигураций

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

1С:Управление торговлей 11

Задача: Добавить поле "Номер транспортной накладной" к документу "Реализация товаров и услуг" и вывести его в печатную форму ТОРГ-12.

Решение:

1. Создайте дополнительный реквизит TransportBillNumber типа Строка(50) для документа.
2. В печатной форме ТОРГ-12 добавьте строку с выражением:

   ДокументОбъект.ДополнительныеРеквизиты.Получить("TransportBillNumber")

3. Настройте обмен с 1С:Бухгалтерией, чтобы реквизит передавался вместе с документом.

1С:Зарплата и Управление Персоналом 3.1

Задача: Хранить дату последнего медицинского осмотра для сотрудников в справочнике "Физические лица".

Решение:

1. Добавьте реквизит LastMedicalCheckDate типа Дата к справочнику.
2. Создайте обработку, которая будет напоминать о просроченных осмотрах (сравнивая текущую дату с значением реквизита).
3. Настройте отчёт "Анализ кадровых данных", включив в него новый реквизит.

1С:Бухгалтерия 3.0

Задача: Добавить поле "Комментарий менеджера" к счёту на оплату и выгружать его в 1С:ERP.

Решение:

1. Создайте реквизит ManagerComment типа Строка(200).
2. В правилах обмена с ERP добавьте соответствие для этого реквизита.
3. Модифицируйте печатную форму счёта, добавив блок с комментарием.

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

FAQ: Ответы на частые вопросы

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

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