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

Другое · 7 мин

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

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

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

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

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

Получить объект документа перед записью

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

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

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

Записать и провести документ

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

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

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

Проведение с проверкой и отказом

Сценарий: проведение нового документа

При создании документа с нуля заполните все реквизиты и строки табличной части, затем проведите. Если в процедуре ПередПроведением установлен параметр Отказ в Истина, проведение прерывается, документ не сохраняется как проведённый, и управление возвращается к вызывающему коду.

Сценарий: проведение существующего документа по ссылке

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

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

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

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

Свойство Проведен объекта
Норма

Истина после успешного проведения

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

Ложь или документ не сохранён

Движения по регистрам
Норма

Записи созданы в нужных регистрах

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

Регистры пусты или движения не соответствуют документу

Проверить, что документ проведён

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

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

Отменить проведение документа

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

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

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

Ограничения, права и типичные ошибки

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

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

Безопасная работа на рабочей базе

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

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

Итог

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

Проведение делается записью с режимом проведения, результат проверяется через свойство Проведен и движения, а отмену выполняют отдельной записью.

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

Да. Проведение выполняется в коде через менеджер документа или объект по ссылке, открытие формы не требуется. Достаточно получить объект, заполнить реквизиты и вызвать запись с режимом проведения.

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

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

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

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

Какие права нужны для программного проведения?

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

Безопасно ли проводить документы массово на рабочей базе?

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