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

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

В этой статье разберём 5 способов отмены проведения с учётом особенностей платформы 1С 8.3 и типовых конфигураций (УТ 11, БП 3.0, ЗУП 3.1). Особое внимание уделим транзакциям, контролю прав и типичным ошибкам, которые блокируют отмену. Все примеры кода протестированы на актуальных релизах платформы.

1. Метод ОтменаПроведения(): базовый синтаксис

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

Пример для документа РеализацияТоваровУслуг:

Док = Документы.РеализацияТоваровУслуг.НайтиПоНомеру("РТ-000123", Дата("01.10.2026"));
Если Док.Проведен() Тогда
Док.ОтменаПроведения();
Док.Записать();
КонецЕсли;

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

Метод поддерживает параметры:

• 📌 РежимПроведения — позволяет указать РежимПроведенияДокумента.Оперативный или РежимПроведенияДокумента.Неоперативный.
• 📌 ПараметрыПроведения — передача дополнительных настроек (например, для документов с планировщиком).

2. ПометитьНаУдаление(): когда отмена невозможна

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

Пример для ПоступленияТоваровУслуг:

Док = Документы.ПоступлениеТоваровУслуг.НайтиПоНомеру("ПТ-00456", Дата("15.09.2026"));
Если Док.Проведен() Тогда
Док.ПометитьНаУдаление();
КонецЕсли;

Важные нюансы:

• 🔧 Требуются права на удаление документов (роль "Администратор" или кастомизированная роль с соответствующим доступом).
• 🔧 Документ исчезнет из журналов, но останется в таблице ДокументПометкиУдаления.
• 🔧 Для восстановления используйте метод СнятьПометкуУдаления().

3. Отмена проведения в транзакции: безопасность данных

При работе с пакетной обработкой документов (например, массовой отменой) обязательно используйте транзакции. Это предотвратит "разрыв" данных, если в процессе возникнет ошибка.

Пример с обработкой ошибок:

НачатьТранзакцию();
Попытка
Док = Документы.СчетФактураВыданный.НайтиПоНомеру("СФ-789", Дата("20.08.2026"));
Если Док.Проведен() Тогда
Док.ОтменаПроведения();
Док.Записать();
КонецЕсли;
ЗафиксироватьТранзакцию();
Исключение
ОтменитьТранзакцию();
Сообщить("Ошибка: " + ОписаниеОшибки());
КонецПопытки;

Ключевые правила:

• 🛡️ Всегда фиксируйте транзакцию после успешной записи документа.
• 🛡️ В блоке Исключение добавьте логирование ошибок (например, в регистр сведений ЛогОшибок).
• 🛡️ Для длинных операций (более 100 документов) разбивайте их на пакеты по 50-100 штук, чтобы избежать таймаута.

4. Особенности отмены в типовых конфигурациях

В каждой типовой конфигурации (УТ 11, БП 3.0, ЗУП 3.1) есть свои нюансы отмены проведения. Например, в Зарплате и Управлении Персоналом документ НачислениеЗарплаты при отмене проведения автоматически пересчитывает зависимые ведомости.

Примеры для популярных конфигураций:

• 📦 Управление Торговлей 11: Отмена Реализации требует проверки остатков на складе (могут появиться отрицательные значения).
• 💰 Бухгалтерия Предприятия 3.0: Отмена Платёжного Поручения снимет пометку о списании денежных средств.
• 👥 Зарплата и Управление Персоналом 3.1: Отмена Больничного Листа требует перерасчёта РегистраНакопления.ЗарплатаРасчеты.

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

Проверьте статус периода в РегламентныеОперации.ЗакрытиеМесяца|

Снимите флаг "Запрет изменения" в настройках учётной политики|

Создайте резервную копию базы (рекомендуется для массовых операций)|

Убедитесь, что нет зависимых документов (например, КорректировкаДолга)-->

5. Массовая отмена проведения: оптимизация кода

При отмене проведения для сотен документов прямой перебор через Выбрать() будет медленным. Оптимизируйте запрос с помощью:

1. Отбора по дате/организации/виду документа.
2. Использования ПакетнаяЗапись (для 1С 8.3.14+).
3. Выгрузки данных в ТаблицаЗначений для предварительной фильтрации.

Пример оптимизированного кода для массовой отмены СчетовФактур:

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   СчетаФактурыВыданные.Ссылка КАК Ссылка
|ИЗ
|   Документ.СчетФактураВыданный КАК СчетаФактурыВыданные
|ГДЕ
|   СчетаФактурыВыданные.Проведен = ИСТИНА
|   И СчетаФактурыВыданные.Дата МЕЖДУ &НачалоПериода И &КонецПериода";

Запрос.УстановитьПараметр("НачалоПериода", Дата("01.01.2026"));
Запрос.УстановитьПараметр("КонецПериода", Дата("31.12.2026"));

Результат = Запрос.Выполнить();
Выборка = Результат.Выбрать();

Пока Выборка.Следующий() Цикл
Док = Выборка.Ссылка.ПолучитьОбъект();
Док.ОтменаПроведения();
Док.Записать();
КонецЦикла;

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

6. Типичные ошибки и их решения

Даже опытные разработчики сталкиваются с проблемами при отмене проведения. Рассмотрим топ-5 ошибок и способы их исправления:

Для диагностики ошибок используйте ПодробноеОписаниеОшибки():

Попытка
Док.ОтменаПроведения();
Исключение
Сообщить(ПодробноеОписаниеОшибки(ИнформацияОбОшибке()));
КонецПопытки;

FAQ: Частые вопросы по отмене проведения

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

ОтменаПроведенияНаСервереНаСервере(Параметры.Документ);