К статье
Практический материал

Другое · 8 мин

Программное создание документа в 1С 8

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

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

Важно различать создание нового документа и изменение существующего. Новый документ не существует в базе до вызова записи, поэтому перед сохранением нужно убедиться, что заполнены минимум обязательных реквизитов. Также необходимо учитывать права доступа пользователя, от которого выполняется код, и возможность проведения документа, если конфигурация предполагает движение по регистрам.

Когда программное создание документа оправдано

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

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

Объекты и порядок создания документа

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

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

1c
Док = Документы.ИмяДокумента.СоздатьДокумент();
Док.Дата = ТекущаяДата();
Док.Записать(РежимЗаписиДокумента.Продолжить);

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

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

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

Порядок действий
  1. 1
    Получить объект документа конфигурации
  2. 2
    Создать новый документ
  3. 3
    Заполнить обязательные реквизиты и табличную часть
  4. 4
    Выполнить запись документа
  5. 5
    При необходимости провести документ
  6. 6
    Проверить результат в форме документа или регистрах

Запись, проведение и проверка результата

Запись документа может выполняться с разными режимами: например, только сохранение без проведения или сохранение с проведением. Если документ проводится, система создаёт движения по регистрам накопления, бухгалтерии или налогового учёта, в зависимости от конфигурации. Ошибка при проведении может отменить запись или оставить документ в состоянии, требующем исправления.

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

Права доступа, блокировки и ограничения

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

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

Контрольные точки

Как проверить результат

Открыт созданный документ в интерфейсе
Норма

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

Тревожный признак

Документ не найден или реквизиты пустые

Документ проведён, если требуется
Норма

Движения по регистрам созданы и сверяются с данными

Тревожный признак

Проведение не выполнено или движения отсутствуют

Запись выполнена без ошибок
Норма

Система не выдала сообщения об отказе

Тревожный признак

Появилась ошибка записи или проведения

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

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

Ещё одна проблема — создание документа от имени пользователя без прав на проведение. Код может сохранить черновик, но не провести документ, и пользователь не поймёт, почему движения отсутствуют. Чтобы избежать ошибок, проверяйте права, заполняйте обязательные поля, сверяйте табличную часть и тестируйте создание на копии базы перед запуском в работе.

Типичные ошибки
01
Запись документа без обязательных реквизитов приводит к отказу системы
02
Неверное заполнение табличной части создаёт некорректные движения по регистрам
03
Создание от имени пользователя без прав на проведение оставляет документ непроведённым

Альтернативы и когда не стоит создавать документ программно

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

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

Итог

Что важно запомнить

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

Нужно ли всегда проводить документ после создания?

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

Что делать, если запись документа завершается ошибкой?

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

Можно ли создать документ из внешней обработки?

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

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

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

Когда программное создание документа не подходит?

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