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

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

Эта статья поможет разобраться в нюансах создания документа в 1С 8.3 — от базовой настройки в конфигураторе до написания кода в модуле объекта. Мы рассмотрим не только техническую сторону (реквизиты, табличные части, формы), но и типовые ошибки, которые приводят к сбоям при проведении. Особое внимание уделим структуре хранения данных и взаимодействию с другими объектами конфигурации.

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

1. Зачем нужны документы в 1С и как они работают

Документ в 1С:Предприятие — это не просто электронный аналог бумажного бланка. Это объект конфигурации, который выполняет три ключевые функции:

• 📝 Регистрация событий: фиксирует факт хозяйственной операции (поступление товара, оплата от клиента, начисление зарплаты).
• 🔄 Изменение состояния системы: при проведении документ формирует движения по регистрам (накопления, бухгалтерии, расчетов).
• 📊 Источник данных для отчетов: служит основой для анализа деятельности (оборотно-сальдовая ведомость, остатки товаров).

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

• 📅 Дата (обязательный реквизит, определяет период актуальности)
• 🔢 Номер (уникальный идентификатор в рамках периода)
• 🔄 Статус проведения (Проведен/НеПроведен)

Пример: документ ПоступлениеТоваровУслуг не только записывает, что товар поступил на склад, но и:

• Увеличивает остатки в регистре ТоварыНаСкладах
• Формирует запись в регистре ПартииТоваров (для учета по партиям)
• Создает проводки в бухгалтерском учете (если включена функциональность)

⚠️ Внимание: Если документ не проведен, он не влияет на регистры и отчеты. Это частая ошибка при тестировании — разработчики проверяют логику по непроведенным документам и получают некорректные результаты.

2. Создание нового документа в конфигураторе: пошаговая инструкция

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

1. Откройте дерево объектов: в левой панели найдите ветку Объекты → Документы.
2. Создайте новый документ: кликните правой кнопкой по папке Документы и выберите Добавить.
3. Задайте основные свойства:
   • 📌 Имя: латинские символы, без пробелов (например, ЗаказПокупателя)
   • 📝 Синоним: отображаемое имя (например, Заказ покупателя)
   • 🔢 Префикс номера: для уникальности (например, ЗК-)
   • 📅 Периодичность: В пределах года или В пределах месяца

Настройте нумерацию: автоматическая или ручная (в разделе Нумерация).

Сохраните: нажмите ОК — документ появится в дереве объектов.

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

• 📄 Формы (по умолчанию создается форма списка и форма документа)
• 📋 Модули (модуль объекта, модуль менеджера, модуль формы)
• 🔧 Реквизиты и табличные части (пока пустые)

Имя документа соответствует стандартам именования (латиница, без пробелов)|

Задан уникальный префикс номера (например, "ПТ-" для поступлений)|

Выбрана правильная периодичность нумерации (год/месяц)|

Проверена необходимость автоматической нумерации|

Созданы формы для ввода и просмотра документа-->

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

• 📦 ТоварыНаСкладах (уменьшение остатков)
• 💰 ВзаиморасчетыСКонтрагентами (увеличение задолженности)

3. Структура документа: реквизиты, табличные части и связи

Структура документа определяет, какие данные он будет хранить. Она состоит из трех основных компонентов:

3.1. Реквизиты шапки

Это поля, которые относятся ко всему документу в целом. Типичные примеры:

• 🏢 Контрагент (ссылка на справочник Контрагенты)
• 📦 Склад (ссылка на справочник Склады)
• 💰 СуммаДокумента (число, 10 знаков после запятой)
• 📝 Комментарий (строка неограниченной длины)

Чтобы добавить реквизит:

1. Откройте ветку документа в конфигураторе.
2. Перейдите на вкладку Реквизиты.
3. Нажмите Добавить и заполните свойства:
   • 🔤 Имя (например, Контрагент)
   • 📌 Тип (например, СправочникСсылка.Контрагенты)
   • 🔢 Длина (для строковых полей)

3.2. Табличные части

Используются для хранения списков данных (например, строки товара в заказе). Чтобы добавить табличную часть:

1. Перейдите на вкладку Табличные части.
2. Нажмите Добавить и укажите имя (например, Товары).
3. Внутри табличной части добавьте колонки (аналогично реквизитам):
   • 📦 Номенклатура (тип СправочникСсылка.Номенклатура)
   • 🔢 Количество (тип Число)
   • 💰 Цена (тип Число, точность 2 знака)
   • 💵 Сумма (тип Число, вычисляемое поле)

Для вычисляемых полей (например, Сумма = Количество × Цена) используйте событие ПриИзменении в модуле формы.

3.3. Связи с другими объектами

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

Тип связи	Пример	Назначение
Справочник	Контрагент → Справочник.Контрагенты	Указание партнера по сделке
Документ	Основание → Документ.ЗаказПокупателя	Связь с первичным документом (например, реализация по заказу)
План видов характеристик	СтавкаНДС → ПланВидовХарактеристик.СтавкиНДС	Выбор ставки налога из предопределенного списка
Перечисление	ВидОплаты → Перечисление.ВидыОплат	Фиксированный набор значений (наличные, безнал и т.д.)

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

Как проверить корректность связей между объектами?

В конфигураторе откройте меню Сервис → Проверка конфигурации и выберите опцию Проверка ссылочной целостности. Система покажет все "битые" ссылки — например, если документ ссылается на несуществующий справочник или удаленный реквизит. Также полезно использовать отчет Анализ использования объектов (меню Отчеты → Стандартные отчеты), чтобы найти неиспользуемые связи.

4. Модуль документа: где и как писать код

Логика работы документа описывается в модулях. В 1С 8.3 для документа доступны три типа модулей:

• 📜 Модуль объекта (Объект.ДокументИмя) — основная бизнес-логика (проведение, отмена проведения, обработчики событий).
• 📋 Модуль менеджера (Менеджер.ДокументИмя) — методы для работы со списком документов.
• 🖥️ Модуль формы (Форма.ДокументИмя.ФормаДокумента) — логика интерфейса (валидация, динамическое изменение полей).

Наиболее важные процедуры размещаются в модуле объекта:

4.1. Процедура ОбработкаПроведения

Вызывается при проведении документа. Здесь формируются движения по регистрам. Пример для документа ПоступлениеТоваров:

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

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

4.2. Процедура ОбработкаОтменыПроведения

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

Процедура ОбработкаОтменыПроведения(Отказ)
Движения.ТоварыНаСкладах.Очистить();
Движения.ПартииТоваров.Очистить();
КонецПроцедуры

4.3. Процедуры-обработчики событий

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

• ПередЗаписью — проверка корректности данных перед сохранением.
• ПриСозданииНаСервере — автоматическое заполнение реквизитов при создании.
• ОбработкаЗаполнения — заполнение табличной части по шаблону.

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

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

⚠️ Внимание: Избегайте тяжелых вычислений в обработчиках ПередЗаписью или ПриИзменении — это замедляет работу интерфейса. Для сложных проверок используйте фоновые задания или переносите логику в ОбработкаПроведения.

В модуле объекта (ОбработкаПроведения)|

В модуле формы (обработчики событий)|

В общих модулях|

Использую внешние обработки|

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

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

5.1. Ошибки при проведении

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

• 🔍 Права доступа: у пользователя должны быть права на запись в регистры, по которым формируются движения.
• 📝 Заполненность обязательных реквизитов: например, не указан склад или номенклатура.
• 🔢 Корректность типов данных: попытка записать строку в числовое поле.
• 🔄 Уникальность записей в регистрах: дублирование ключей (например, две записи с одинаковым товаром и складом на одну дату).

Пример ошибки при дублировании записей в регистре ТоварыНаСкладах:

Ошибка при записи объекта:
{ДвижениеРегистраНакопления.ТоварыНаСкладах.Запись:
Период = {01.01.2026},
Регистратор = {Документ.ПоступлениеТоваров.Поступление1},
Номенклатура = {Справочник.Номенклатура.Товар1},
Склад = {Справочник.Склады.Основной}}
Уникальность записей регистра нарушена.

5.2. Проблемы с нумерацией

Если документы нумеруются некорректно:

• 🔢 Проверьте настройки периодичности (в пределах года/месяца).
• 🔄 Убедитесь, что не включена ручная нумерация, если она не нужна.
• 📅 Если нумерация сбилась, используйте обработку ПеренумероватьДокументы().

5.3. Некорректные движения по регистрам

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

• 🔍 Проверьте, добавлены ли регистры в состав движений документа (вкладка Движения в конфигураторе).
• 📝 Убедитесь, что в процедуре ОбработкаПроведения корректно заполнены измерения и ресурсы движений.
• 🔄 Используйте отладчик (F5 в конфигураторе), чтобы проверить, выполняется ли процедура проведения.

Пример типичной ошибки — неверное заполнение измерения Склад:

Движение.Склад = Неопределено; // Ошибка: не указан склад
// Правильно:
Движение.Склад = Объект.Склад;

5.4. Проблемы с формами

Если форма документа не открывается или работает некорректно:

• 🖥️ Проверьте права на форму (в ролях пользователя).
• 🔧 Убедитесь, что все реквизиты формы связаны с данными (свойство ПутьКДанным).
• 📝 Если форма "подвисает", ищите зацикленные обработчики (например, бесконечный вызов ПриИзменении).

6. Пример: создание документа "Заказ покупателя" с нуля

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

6.1. Настройка структуры

1. Создайте документ с именем ЗаказПокупателя и синонимом Заказ покупателя.
2. Добавьте реквизиты шапки:
   • Контрагент (тип СправочникСсылка.Контрагенты)
   • ДатаПоставки (тип Дата)
   • Статус (тип Перечисление.СтатусыЗаказов)
3. Добавьте табличную часть Товары с колонками:
   • Номенклатура (тип СправочникСсылка.Номенклатура)
   • Количество (тип Число)
   • Цена (тип Число)
   • Сумма (тип Число, вычисляемое поле)

Создайте регистр накопления ЗаказыПокупателей с измерениями:

• Контрагент
• Номенклатура

и ресурсом Количество.

• Добавьте регистр в движения документа (вкладка Движения).

6.2. Код модуля объекта

Добавьте в модуль объекта процедуру проведения:

Процедура ОбработкаПроведения(Отказ, РежимПроведения)
// Очищаем движения (на случай повторного проведения)
Движения.ЗаказыПокупателей.Очистить();

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

6.3. Код модуля формы

Добавьте обработчик для автоматического расчета суммы:

Процедура ТоварыКоличествоПриИзменении(Элемент)
ТекущаяСтрока = Элементы.Товары.ТекущаяСтрока;
ТекущаяСтрока.Сумма = ТекущаяСтрока.Количество * ТекущаяСтрока.Цена;
КонецПроцедуры

Процедура ТоварыЦенаПриИзменении(Элемент)
ТекущаяСтрока = Элементы.Товары.ТекущаяСтрока;
ТекущаяСтрока.Сумма = ТекущаяСтрока.Количество * ТекущаяСтрока.Цена;
КонецПроцедуры

6.4. Проверка работоспособности

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

1. Откройте 1С:Предприятие в режиме отладки (F5 в конфигураторе).
2. Создайте новый документ Заказ покупателя.
3. Заполните реквизиты и добавьте несколько строк в табличную часть.
4. Проведите документ и проверьте движения в регистре ЗаказыПокупателей (через Все функции → Регистры накопления).

💡

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

7. Оптимизация работы с документами: советы опытных разработчиков

Создание документа — только первый шаг. Чтобы система работала быстро и стабильно, следуйте этим рекомендациям:

7.1. Работа с большими табличными частями

Если в документе сотни строк (например, в ИнвентаризацияТоваров):

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

7.2. Контроль уникальности

Чтобы избежать дублирования документов:

• 🔍 Добавьте проверку уникальности в ПередЗаписью:

  Если НЕ ПустаяСсылка(НайтиДокументПоНомеру(Номер, Дата)) Тогда
  Отказ = Истина;
  Сообщить("Документ с таким номером уже существует!");
  КонецЕсли;

• 📌 Используйте префиксы в номерах (например, ЗК-0001, РТ-0001).

7.3. Версионирование документов

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

• 📝 Создайте реквизит Версия (тип Число).
• 🔄 При каждом изменении увеличивайте номер версии и сохраняйте историю в отдельном регистре.
• 📅 Используйте отчет ИсторияИзменений для просмотра предыдущих версий.

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

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

• 🔗 Используйте универсальный формат обмена (например, JSON или XML).
• 🔑 Добавьте реквизит ВнешнийИдентификатор для сопоставления с записями в другой системе.
• 📡 Для массового импорта используйте обработки загрузки с проверкой данных.

⚠️ Внимание: При обмене данными всегда проверяйте соответствие типов данных. Например, в 1С дата хранится как Дата, а в JSON она может прийти строкой ("2026-01-01"). Используйте функции преобразования, например: Дата(СтрокаДаты).

8. Часто задаваемые вопросы (FAQ)

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

Используйте механизм заполнения по шаблону:

1. В модуле формы документа добавьте команду ЗаполнитьПоШаблону.
2. В обработчике команды напишите код копирования данных:

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

Для удобства можно