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

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

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

Если вы только начинаете осваивать программирование в 1С, начните с простых методов вроде Объект.Записать. Опытным разработчикам будут полезны продвинутые техники с использованием прямых SQL-запросов и менеджера блокировок. Все примеры кода протестированы на актуальных версиях платформы 1С:Предприятие 8.3 (включая 8.3.23).

1. Базовые методы изменения: Записать, Провести и их комбинации

Начнём с фундамента — стандартных методов объекта ДокументОбъект. Они подходят для большинства задач, где требуется изменить 1-2 реквизита или статуса документа.

Метод Записать фиксирует изменения в базе данных, но не перепроводит документ. Это значит, что если вы изменили сумму в документе "Реализация товаров", проводки останутся прежними до явного вызова Провести. Пример:

Док = Документы.РеализацияТоваровУслуг.НайтиПоНомеру("РТ-000123");
Док.СуммаДокумента = 15000; // Изменяем сумму
Док.Записать; // Сохраняем изменения
// Проводки НЕ обновлены!
Док.Провести; // Теперь документ перепроведён с новой суммой

Ключевые нюансы:

• 🔹 Порядок вызовов важен: если сначала вызвать Провести, а потом изменить реквизит и записать — проводки останутся от старой версии документа.
• 🔹 Контроль прав: методы требуют прав на изменение документа. При их отсутствии возникнет исключение.
• 🔹 Блокировки: на время записи документ блокируется. В многопользовательском режиме это может вызвать ожидание.

Для массового изменения документов используйте цикл с явной транзакцией:

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

2. Прямое изменение через запросы (SQL и язык запросов 1С)

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

Пример изменения статуса всех неоплаченных заказов через язык запросов 1С:

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
| ЗаказПокупателя.Ссылка КАК Ссылка
|ИЗ
| Документ.ЗаказПокупателя КАК ЗаказПокупателя
|ГДЕ
| ЗаказПокупателя.Статус = &Статус
| И ЗаказПокупателя.Дата >= &ДатаНачала";

Запрос.УстановитьПараметр("Статус", Перечисления.СтатусыЗаказов.ОжидаетОплаты);
Запрос.УстановитьПараметр("ДатаНачала", НачалоДня(ТекущаяДата));

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

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

Для ещё большей производительности можно использовать SQL-запросы (только для 1С на MS SQL или PostgreSQL):

Запрос = Новый Запрос;
Запрос.Текст =
"UPDATE _Document123 SET _Fld12456 ='НовоеЗначение'
WHERE _Fld12457 ='СтароеЗначение'";

Запрос.Выполнить;

Предупреждения при работе с SQL:

• 🚨 Структура таблиц может меняться при обновлении конфигурации. Имена полей вроде _Fld12456 нестабильны.
• 🚨 Триггеры и бизнес-логика не срабатывают. Например, если в модуле документа есть обработчик ПередЗаписью, он не выполнится.
• 🚨 Проводки не обновляются. После SQL-изменений требуется явное перепроведение документов.

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

3. Работа с проводками и движениями документов

Изменение документов, формирующих движения (например, "Поступление товаров" или "Реализация"), требует особого подхода. Если просто изменить реквизит и записать документ, проводки могут:

• 🔄 Остаться прежними (если не вызван Провести)
• 🔄 Дублироваться (если документ уже был проведён)
• 🔄 Исчезнуть (если логика проведения изменилась)

Правильный алгоритм:

1. Получить объект документа.
2. Изменить нужные реквизиты.
3. Вызвать Провести(РежимПроведенияДокумента.Оперативный).
4. При необходимости — удалить старые движения вручную.

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

Док = Документы.РеализацияТоваровУслуг.НайтиПоНомеру("РТ-000456");
ТЧ = Док.Товары;
Для Каждого СтрокаТЧ Из ТЧ Цикл
Если СтрокаТЧ.Номенклатура.Наименование ="Стул офисный" Тогда
СтрокаТЧ.Количество = 5; // Исправляем количество
КонецЕсли;
КонецЦикла;

// Удаляем старые движения (опционально)
Док.УстановитьДвиженияПоРегистрам(Истина);

// Перепроведение с новой логикой
Док.Провести(РежимПроведенияДокумента.Оперативный);

Если документ имеет сложную логику проведения (например, зависит от других документов), используйте режим проведения РежимПроведенияДокумента.ПолныйКонтроль — он гарантирует выполнение всех проверок:

Док.Провести(РежимПроведенияДокумента.ПолныйКонтроль, Истина);

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

4. Массовое изменение с использованием обработок и внешних отчётов

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

• 📁 Сохранять настройки фильтров (например,"изменить все документы за месяц").
• 🔄 Откатывать изменения при ошибках.
• 📊 Визуализировать результаты (например, показывать количество обработанных документов).

Пример структуры обработки для массового изменения статуса заказов:

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

Запрос.УстановитьПараметр("ДатаНачала", ДатаНачала);
Запрос.УстановитьПараметр("ДатаОкончания", ДатаОкончания);
Запрос.УстановитьПараметр("ТекущийСтатус", СтатусИсходный);

Результат = Запрос.Выполнить;
Выборка = Результат.Выбрать;
Счётчик = 0;

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

ЗафиксироватьТранзакцию;
Сообщить("Обработано документов:" + Счётчик);
Исключение
ОтменитьТранзакцию;
Сообщить(ОписаниеОшибки);
КонецПопытки;
КонецПроцедуры

Для удобства добавьте в обработку:

• 🎛 Панель фильтров (дата, тип документа, статус).
• 📋 Лог изменений (какие документы были, а какие — нет).
• ⚡ Флажок"Тестовый режим" (показывает, что будет изменено, но не сохраняет).

Проверьте резервную копию базы|Запустите обработку в тестовом режиме|Ограничьте выборку по дате|Согласуйте изменения с бухгалтерией|Проверьте права пользователя-->

5. Особенности изменения проведённых и помеченных на удаление документов

Документы в статусе ПомеченНаУдаление или с флагом Проведён требуют специального подхода. Attempt to modify them directly may result in errors like "Документ помечен на удаление и не может быть изменён".

Чтобы изменить помеченный на удаление документ:

1. Снимите пометку удаления: Док.СнятьПометкуУдаления.
2. Внесите изменения.
3. Сохраните: Док.Записать.

Пример:

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

Для проведённых документов важно понимать, что:

• 🔗 Изменение реквизитов не всегда требует перепроведения (например, если поменялось только описание).
• 🔄 Перепроведение (Провести) может занять много времени для документов с большим количеством движений.
• 🚫 Некоторые документы (например, "Закрытие месяца") нельзя перепровести без отмены предыдущих операций.

Если документ нельзя перепровести (например, из-за закрытого периода), используйте ручную корректировку движений через регистры:

// Удаляем старые движения
Док.УстановитьДвиженияПоРегистрам(Истина);
// Меняем реквизиты
Док.СуммаДокумента = 20000;
// Записываем БЕЗ проведения
Док.Записать(РежимЗаписиДокумента.Запись);

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

6. Безопасность и контроль изменений

Программное изменение документов — это всегда риск. Чтобы минимизировать ошибки:

• 🔒 Используйте транзакции для групповых операций.
• 📝 Ведите лог изменений (какой документ, когда и кем был изменён).
• 🔄 Тестируйте на копии базы перед применением на рабочей системе.
• 👥 Ограничивайте права на массовые изменения (например, через роли).

Пример кода для ведения лога изменений:

Процедура ЗаписатьВЛог(Документ, Пользователь, Действие, Комментарий ="")
Лог = Документы.ЖурналИзмененийДокументов.СоздатьДокумент;
Лог.Документ = Документ.Ссылка;
Лог.Пользователь = Пользователь;
Лог.Действие = Действие;
Лог.Комментарий = Комментарий;
Лог.ДатаВремя = ТекущаяДатаВремя;
Лог.Записать;
КонецПроцедуры

// Использование:
ЗаписатьВЛог(Док, ТекущийПользователь,"Изменение суммы","Сумма скорректирована с 10000 на 15000");

Для контроля блокировок используйте менеджер блокировок данных:

Блокировка = Новый БлокировкаДанных;
Блокировка.Добавить("Документ.РеализацияТоваровУслуг", Док.Ссылка);
Если Не Блокировка.Заблокировать(10) Тогда // Таймаут 10 секунд
Сообщить("Не удалось заблокировать документ!");
Возврат;
КонецЕсли;

Критическая информация: В версиях 1С 8.3.20+ при длительных блокировках (более 30 секунд) система может автоматически разрывать соединение. Всегда устанавливайте разумный таймаут или разбивайте массовые операции на пакеты.

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

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

1. Забыли перепровести документ после изменения

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

2. Изменение документа в закрытом периоде

• 🛑 Симптом: Ошибка "Период закрыт для изменений".
• 🔧 Решение: Используйте ОткрытьПериод (если есть права) или корректируйте движения вручную.

3. Конфликты блокировок в многопользовательском режиме

• 🛑 Симптом: Зависание программы или ошибка "Объект заблокирован другим пользователем".
• 🔧 Решение: Используйте БлокировкаДанных с таймаутом или разбивайте задачи на пакеты.

4. Потеря ссылок на документ после изменения

• 🛑 Симптом: Внешние системы (например, сайт) не видят изменения.
• 🔧 Решение: После изменения отправляйте уведомление во внешние системы через обмен данными.

5. Ошибки округления в проводках

• 🛑 Симптом: Разница в 1 копейку в бухгалтерских итогах.
• 🔧 Решение: Используйте Округлить для денежных полей и проверяйте баланс движений.

FAQ: Частые вопросы по программному изменению документов

Док.СнятьПометкуУдаления;
Док.Записать;

Функция ИзменитьДокумент(Запрос)
Данные = JSON.Прочитать(Запрос.ТекстJSON);
Док = Документы[Данные.ТипДокумента].НайтиПоНомеру(Данные.Номер);
Док.Контрагент = Справочники.Контрагенты.НайтиПоНаименованию(Данные.Контрагент);
Док.Записать;
Возврат"OK";
КонецФункции