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

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

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

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

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

• 📌 Какую хозяйственную операцию будет регистрировать документ? (Приход товара, оплата от клиента, перемещение между складами и т.д.)
• 📝 Какие реквизиты должны быть в документе? (Дата, контрагент, сумма, список товаров и пр.)
• 🔄 Будут ли движения по регистрам? (Если да — какие регистры задействованы: накопления, бухгалтерии, сведений?)
• 🖨️ Нужна ли печатная форма? (Счет, накладная, акт и другие бланки)

Если документ планируется использовать в типовой конфигурации (например, 1С:ERP или 1С:КА 2.4), проверьте, нет ли аналогичного объекта среди стандартных. Иногда проще доработать существующий документ, чем создавать новый с нуля. Для этого откройте дерево метаданных (Ctrl+Shift+M) и найдите раздел Документы.

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

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

Шаг 1: Добавление документа в дерево метаданных

Чтобы создать новый документ, откройте Конфигуратор 1С в режиме редактирования. Для этого:

1. Запустите 1С:Предприятие в режиме Конфигуратор (выберите базу и удерживайте Shift при запуске).
2. В главном меню выберите Конфигурация → Открыть конфигурацию (Ctrl+Shift+O).
3. В дереве метаданных найдите ветку Документы и кликните по ней правой кнопкой мыши.
4. Выберите Добавить → Документ.

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

• 🔹 Имя — уникальный идентификатор документа на латинице (например, SalesOrder для заказа клиента).
• 🔹 Синоним — название, которое будет отображаться пользователям (например, «Заказ клиента»).
• 🔹 Комментарий — краткое описание назначения документа (необязательно, но полезно для других разработчиков).
• 🔹 Префикс номеров — префикс для автонумерации документов (например, «ЗК-» для заказов).

Обратите внимание на флажок Включать в командный интерфейс. Если его не установить, документ не будет доступен в списке объектов для пользователей в режиме 1С:Предприятие. Также на этом этапе можно настроить подсистемы, к которым будет относиться документ (например, «Продажи» или «Склад»).

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

Шаг 2: Настройка реквизитов документа

Реквизиты — это поля, которые будут заполняться в документе. Например, для документа «Поступление товара» реквизиты включают поставщика, склад, дату и список товаров. Чтобы добавить реквизиты:

1. В окне свойств документа перейдите на вкладку Реквизиты.
2. Нажмите Добавить и заполните свойства реквизита:
   • 🔹 Имя — идентификатор (например, Supplier).
   • 🔹 Синоним — отображаемое название (например, «Поставщик»).
   • 🔹 Тип — выберите из списка (строка, число, справочник, дата и т.д.).
   • 🔹 Длина — для строковых полей (например, 100 символов для названия).

Пример настройки реквизита для поля «Сумма документа»:

Имя: TotalAmount
Синоним: Сумма документа
Тип: Число
Длина: 15, 2 (для хранения копеек)

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

Шаг 3: Настройка движений документа по регистрам

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

1. В окне свойств документа перейдите на вкладку Движения.
2. Нажмите Добавить и выберите тип регистра:
   • 📊 Регистр накопления — для учета остатков (товары, денежные средства).
   • 💰 Регистр бухгалтерии — для бухгалтерских проводок.
   • 📋 Регистр сведений — для хранения справочной информации (курсы валют, цены).

Для регистра накопления ТоварыНаСкладах в документе «Поступление товара» движение настраивается как приход. В модуле документа потребуется написать код, который заполнит таблицу движений. Пример кода для движения по регистру:

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

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

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

Шаг 4: Создание печатной формы документа

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

1. В окне свойств документа перейдите на вкладку Печатные формы.
2. Нажмите Добавить и укажите:
   • 📄 Имя — идентификатор формы (например, InvoiceForm).
   • 📑 Синоним — название для пользователей (например, «Счет-фактура»).
   • 🖥️ Тип — выберите Табличный документ или Текстовый документ.

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

• 📍 Добавить логотип компании.
• 📌 Настроить вывод реквизитов (ИНН, КПП, адрес).
• 📊 Добавить таблицу с товарами и итоговыми суммами.
• 🖋️ Подписи и печать (если документ требует визирования).

Пример кода для вывода печатной формы:

Процедура Печать(Кнопка)
ПечатнаяФорма = Документы.ЗаказКлиента.ПечатнаяФормаСчетФактура;
ПечатнаяФорма.Заполнить(ЭтотОбъект);
ПечатнаяФорма.Показать;
КонецПроцедуры

Шаг 5: Настройка модуля документа

Модуль документа содержит программный код, который управляет логикой работы объекта. Здесь прописываются:

• 🔧 Обработчики событий (при создании, записи, проведении).
• 📝 Проверки заполнения (например, обязательность реквизитов).
• 🔄 Автоматические расчеты (суммы, скидки, налоги).
• 🛠️ Дополнительные функции (экспорт, интеграция с внешними системами).

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

1. В окне свойств документа перейдите на вкладку Модуль.
2. Нажмите кнопку Открыть модуль (или F12).

Пример кода для проверки заполнения обязательных реквизитов:

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

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

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

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

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

Шаг 6: Тестирование и отладка документа

После настройки документа необходимо протестировать его работу в режиме 1С:Предприятие. Для этого:

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

Проверьте:

• 🔍 Заполнение реквизитов — все ли поля доступны и корректно сохраняются.
• 📊 Движения по регистрам — изменились ли остатки после проведения.
• 🖨️ Печатная форма — открывается ли бланк и корректно ли заполнен.
• ⚡ Производительность — нет ли задержек при открытии или сохранении.

Если возникли ошибки, вернитесь в Конфигуратор и используйте отладчик (F9 для установки точек останова). Например, если документ не проводится, проверьте:

• Корректность кода в обработчике ОбработкаПроведения.
• Права доступа пользователя к регистрам.
• Наличие обязательных реквизитов.

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

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

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

Еще одна частая проблема — конфликты нумерации, когда префиксы документов пересекаются. Например, если у вас есть документы «Заказ клиента» с префиксом «ЗК-» и «Заказ поставщику» с тем же префиксом, при одновременном создании может возникнуть ошибка дублирования номеров. Решение:

• Используйте уникальные префиксы для каждого типа документа.
• Настройте серии номеров в параметрах нумерации.

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

Функция ПолучитьJSON
Данные = Новый Структура;
Данные.Вставить("Дата", Формат(Дата,"ДФ=dd.MM.yyyy"));
Данные.Вставить("Контрагент", Контрагент.Наименование);
Возврат JSON.Записать(Данные);
КонецФункции