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

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

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

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

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

Для работы потребуется запущенный конфигуратор 1С:Предприятие. Откройте его из списка баз, выбрав нужную базу и нажав кнопку «Конфигуратор». Затем выполните команду «Конфигурация — Открыть конфигурацию»: появится дерево объектов метаданных, в котором и создаётся документ.

Если конфигурация находится на поддержке (типовая), часть объектов будет закрыта для изменения. В свойствах конфигурации через пункт «Поддержка — Настройка поддержки» можно включить возможность изменения. Делайте это осознанно: снятие с полной поддержки усложняет последующие обновления типового релиза.

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

Добавление нового документа в дерево конфигурации

В дереве конфигурации найдите ветку «Документы». Кликните по ней правой кнопкой мыши и выберите «Добавить». Откроется палитра свойств нового объекта — именно через неё задаётся вся структура документа.

На вкладке «Основные» укажите имя документа — внутренний идентификатор на встроенном языке, например ПеремещениеТоваров. Имя пишется латиницей или кириллицей без пробелов и должно отражать назначение документа. Синоним — это название, которое увидит пользователь в интерфейсе, например «Перемещение товаров». Комментарий заполняйте для пояснения назначения объекта другим разработчикам.

Здесь же задаётся длина номера, периодичность нумерации (в пределах года, месяца или непериодическая) и контроль уникальности номеров. Для большинства учётных документов подходит периодичность «В пределах года» с автонумерацией — платформа сама присвоит следующий номер при записи.

1. 1
   Откройте конфигуратор и конфигурацию базы
2. 2
   В ветке «Документы» выберите «Добавить»
3. 3
   Задайте имя и синоним документа
4. 4
   Добавьте реквизиты и табличные части
5. 5
   Настройте форму документа
6. 6
   Укажите движения по регистрам при необходимости
7. 7
   Обновите конфигурацию базы данных (F7)
8. 8
   Проверьте документ в режиме предприятия

Настройка реквизитов и табличных частей

На вкладке «Данные» описывается содержимое документа. Реквизиты шапки — это одиночные поля: контрагент, склад, договор, комментарий. Для каждого реквизита задаётся имя и тип: строка, число, дата, булево или ссылка на справочник, другой документ, перечисление.

Табличные части нужны для списков строк — например, перечня товаров с количеством и ценой. Добавьте табличную часть, задайте ей имя (например, Товары) и внутри неё создайте реквизиты: «Номенклатура» (ссылка на справочник), «Количество» (число), «Цена» (число), «Сумма» (число). Именно так устроены почти все товарные документы в типовых конфигурациях.

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

Создание формы документа

Форма — это то, что видит пользователь. На вкладке «Формы» палитры свойств нажмите кнопку открытия у поля «Основная форма документа» и выберите «Конструктор форм». Конструктор предложит тип формы «Форма документа» и автоматически разместит на ней все реквизиты и табличные части.

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

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

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

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

Документ сам по себе только хранит данные. Чтобы он влиял на учёт — остатки на складах, взаиморасчёты, регистры сведений — нужно настроить проведение. На вкладке «Движения» отметьте галочками регистры, по которым документ должен формировать записи, и нажмите кнопку «Конструктор движений».

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

В свойствах документа на вкладке «Проведение» убедитесь, что разрешено проведение. Дополнительно можно включить оперативное проведение — оно фиксирует документ на текущем времени и используется для документов, отражающих операции «здесь и сейчас», например розничных продаж.

Права, подсистемы и журналы

Чтобы пользователи увидели документ, его нужно включить в подсистемы. На вкладке «Подсистемы» палитры свойств отметьте разделы командного интерфейса, где документ должен отображаться, например «Склад» или «Продажи». Без этого объект существует в конфигурации, но недоступен в интерфейсе.

Проверьте роли: у ролей, под которыми работают пользователи, должны быть права на добавление, изменение, чтение и проведение нового документа. Права настраиваются в ветке «Общие — Роли». Если роль даёт полные права на документы, новый объект может подхватиться автоматически, но надёжнее проверить явно.

Для удобства работы документ добавляют в журнал — общий список документов разных видов. Откройте нужный журнал в ветке «Журналы документов» и в его свойствах отметьте новый вид документа. Графы журнала позволяют вывести в список дополнительные колонки, например контрагента или склад.

Обновление конфигурации и проверка результата

После завершения настройки сохраните конфигурацию и выполните обновление конфигурации базы данных: клавиша F7 или команда «Конфигурация — Обновить конфигурацию базы данных». Платформа покажет окно реструктуризации со списком изменений — подтвердите его кнопкой «Принять».

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

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

Типичные ошибки при создании документа

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

Также часто встречаются: слишком маленькая длина номера, из-за чего нумерация «упирается» в предел; отсутствие проверки заполнения обязательных реквизитов; изменение структуры документа напрямую в рабочей базе без тестирования на копии. Все эти ошибки легко предотвратить, если следовать порядку: копия, доработка, тест, перенос.

Частые вопросы