Как создать документ через обработку в 1С

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

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

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

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

Любой документ в 1С существует в двух состояниях: объект в памяти и запись в базе данных. Метод СоздатьДокумент() формирует только объект в памяти — в базе ничего не появляется до вызова Записать(). Это важно понимать: если обработка прервётся до записи, никаких «половинчатых» данных в базе не останется.

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

Минимальный код создания документа

Простейший вариант — создание документа с заполнением нескольких реквизитов шапки. Ниже пример для гипотетического документа «РеализацияТоваровУслуг»:

НовыйДок = Документы.РеализацияТоваровУслуг.СоздатьДокумент();
НовыйДок.Дата = ТекущаяДатаСеанса();
НовыйДок.Организация = Организация;
НовыйДок.Контрагент = Контрагент;
НовыйДок.Записать(РежимЗаписиДокумента.Запись);

Несколько принципиальных моментов. Дату документа лучше задавать явно через ТекущаяДатаСеанса() или дату из загружаемых данных — иначе документ получит дату по умолчанию, которая может не совпасть с ожидаемой. Режим записи Запись сохраняет документ без проведения; для проведения используется РежимЗаписиДокумента.Проведение.

Если документ должен проводиться, рекомендуется сначала записать его, затем вызвать ПроверитьЗаполнение() и только потом провести. Так вы получите понятное сообщение об ошибке вместо отказа проведения с типовым текстом.

Заполнение табличных частей

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

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

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

Поиск ссылок для реквизитов

Часто исходные данные содержат не ссылки, а наименования, коды или ИНН. Перед записью их нужно преобразовать в ссылки: Справочники.Контрагенты.НайтиПоРеквизиту("ИНН", ИНН) или НайтиПоНаименованию. Если найдена пустая ссылка — решите заранее: создавать новый элемент справочника, пропускать документ или фиксировать ошибку в протоколе.

Запись, проведение и обработка ошибок

Любая запись документа может завершиться исключением: не заполнен обязательный реквизит, нарушена уникальность номера, отказала проверка в подписке на событие. Поэтому запись всегда помещают в конструкцию Попытка ... Исключение ... КонецПопытки, а текст ошибки выводят через ОписаниеОшибки().

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

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

Проведение и движения по регистрам

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

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

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

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

Если документ найден, у вас два варианта: пропустить его или перезаполнить. Для перезаполнения получите объект через Ссылка.ПолучитьОбъект(), очистите табличные части методом Очистить() и заполните заново. Учтите: перезаполнение проведённого документа потребует повторного проведения и может изменить регистры, по которым уже построены отчёты.

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

После записи не полагайтесь на отсутствие исключений — проверьте фактическое состояние документа. Убедитесь, что НовыйДок.Проведен возвращает Истина (если требовалось проведение), что суммы в документе совпадают с исходными данными и что движения по регистрам сформированы.

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

Типичные ошибки и ограничения

Ещё одно ограничение: обработка, запущенная на клиенте в управляемом приложении, не может напрямую работать с объектами документов — весь код создания и записи должен выполняться в серверной процедуре (директива &НаСервере или серверный общий модуль). Это стандартное требование тонкого и веб-клиента.

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