Программное изменение движений документа в 1С: методы, примеры и подводные камни

Работа с движениями документов в 1С:Предприятие — одна из самых востребованных задач среди разработчиков и администраторов систем. Чаще всего необходимость программно корректировать движения возникает при доработке типовых конфигураций (УТ 11, БП 3.0, ЗУП 3.1), интеграции с внешними системами или исправлении ошибок, допущенных пользователями. Например, если документ был проведён с неверными данными, а откат проведения невозможен из-за зависимостей.

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

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

1. Основные понятия: что такое движения документа в 1С

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

• 📦 ТоварыНаСкладах (списание со склада)
• 💰 ВзаиморасчётыСКонтрагентами (дебиторская задолженность)
• 📊 НДСРасчёты (налоговые обязательства)

Каждое движение имеет структуру, зависящую от типа регистра:

• 📌 Регистры накопления (остатки): Период, Регистратор, Измерения, Ресурсы, Приход/Расход.
• 📈 Регистры бухгалтерии: СчётДт, СчётКт, Сумма, Валюта.
• 🔄 Регистры расчётов: ПериодРасчёта, ВидРасчёта, СуммаДолга.

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

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

2. Стандартные методы работы с движениями

Платформа 1С:Предприятие предоставляет несколько встроенных методов для управления движениями. Рассмотрим их подробно.

1. Метод Объект.Движения — возвращает коллекцию движений документа по всем регистрам. Пример получения движений для документа ПоступлениеТоваровУслуг:

Движения = ДокументОбъект.Движения.ПоступлениеТовары;
Для Каждого Движение Из Движения Цикл
Сообщить(Движение.Регистратор.Наименование + ": " + Движение.Количество);
КонецЦикла;

2. Метод ЗаписатьДвижения() — перезаписывает движения документа на основе текущих данных. Вызывается после изменения реквизитов документа:

ДокументОбъект.Дату = ТекущаяДата() + 3600; // Сдвигаем дату на 1 час
ДокументОбъект.ЗаписатьДвижения();

3. Метод ОчиститьДвижения() — удаляет все движения документа. Используется перед ручным формированием новых записей:

ДокументОбъект.ОчиститьДвижения();
ДокументОбъект.Записать();

Метод	Назначение	Когда использовать	Ограничения
Движения	Чтение существующих движений	Анализ текущих записей перед изменением	Только для чтения, не изменяет данные
ЗаписатьДвижения()	Пересчёт движений по алгоритму документа	После изменения реквизитов документа	Не работает, если отключено проведение
ОчиститьДвижения()	Удаление всех движений документа	Перед ручным формированием движений	Требует последующего вызова Записать()

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

3. Ручное формирование и изменение движений

Когда стандартные методы не подходят (например, нужно добавить движение в нетиповой регистр или скорректировать только часть записей), приходится работать с движениями вручную. Для этого используется объект ДвижениеДокументаМенеджер.

Пример добавления нового движения в регистр накопления ТоварыНаСкладах:

Движение = ДокументОбъект.Движения.ТоварыНаСкладах.Добавить();
Движение.Период = ДокументОбъект.Дату;
Движение.Номенклатура = Справочники.Номенклатура.НайтиПоНаименованию("Монитор 24\"");
Движение.Склад = Справочники.Склады.Основной;
Движение.Количество = 5;
Движение.Регистратор = ДокументОбъект.Ссылка;

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

Для Каждого Движение Из ДокументОбъект.Движения.ТоварыНаСкладах Цикл
Если Движение.Номенклатура = НужнаяНоменклатура Тогда
Движение.Количество = 10; // Новое значение
КонецЕсли;
КонецЦикла;

Особенности ручного формирования:

• 🔹 Период движения должен совпадать с датой документа.
• 🔹 Регистратор всегда ссылается на текущий документ.
• 🔹 Для регистров бухгалтерии обязательно указывать СчётДт и СчётКт.

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

Указан период движения|Регистратор ссылается на документ|Для бухгалтерских движений заполнены Дт и Кт|Суммы движений сбалансированы (приход = расход)|Проверены права доступа на изменение регистра-->

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

Каждая типовая конфигурация (УТ 11, БП 3.0, ЗУП 3.1) имеет свои нюансы при работе с движениями. Рассмотрим наиболее распространённые случаи.

1. Управление торговлей (УТ 11)

В УТ 11 часто требуется корректировать движения по регистрам:

• 📦 ТоварыНаСкладах — остатки товаров.
• 💵 ВзаиморасчётыСКлиентами — долги покупателей.
• 📄 СебестоимостьТоваров — данные для расчёта себестоимости.

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

Для Каждого Движение Из ДокументОбъект.Движения.СебестоимостьТоваров Цикл
Если Движение.Номенклатура = Товар Тогда
Движение.Стоимость = НоваяСтоимость;
КонецЕсли;
КонецЦикла;

2. Бухгалтерия предприятия (БП 3.0)

В БП 3.0 основной регистр — Хозрасчётный (бухгалтерские проводки). Здесь критично следить за:

• 📌 Корреспонденцией счетов (Дт и Кт).
• 📌 Валютами и курсами (если документ многовалютный).
• 📌 Субконто (аналитика по счетам).

Пример корректировки проводки по счёту 60.01 ("Расчёты с поставщиками"):

Для Каждого Движение Из ДокументОбъект.Движения.Хозрасчётный Цикл
Если Движение.СчётДт = ПланСчетов.НайтиПоКоду("19") Тогда
Движение.Сумма = НоваяСумма;
Движение.СчётКт = ПланСчетов.НайтиПоКоду("60.01");
КонецЕсли;
КонецЦикла;

3. Зарплата и управление персоналом (ЗУП 3.1)

В ЗУП 3.1 движения формируются в регистрах расчётов (НачисленияЗарплаты, УдержанияЗарплаты) и накопления (КадровыеДанныеСотрудников). Особенность — привязка к периоду расчёта и виду начисления.

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

Для Каждого Движение Из ДокументОбъект.Движения.НачисленияЗарплаты Цикл
Если Движение.Сотрудник = ФизЛицо И Движение.ВидНачисления = ВидНачисления Тогда
Движение.Сумма = НоваяСумма;
КонецЕсли;
КонецЦикла;

⚠️ Внимание: В ЗУП 3.1 изменения движений по прошлым периодам могут потребовать перерасчёта НДФЛ и страховых взносов. Используйте обработку ПерерасчётЗарплаты после правок.

Что делать, если движения не сохраняются?

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

1. Права доступа — у пользователя должны быть права на изменение регистра.

2. Транзакции — изменения движений должны выполняться в транзакции.

3. Блокировки — документ не должен быть заблокирован другим пользователем.

4. Обработчики событий — в модуле документа может быть процедура ПередЗаписью, сбрасывающая движения.

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

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

1. Расхождение итогов в регистрах

Симптом: После изменения движений остатки по регистру не сходятся с оборотками.

Причина: Нарушена балансировка движений (например, в регистре накопления сумма прихода не равна сумме расхода).

Решение: Перед сохранением проверяйте баланс с помощью запроса:

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

2. Потеря связи с регистратором

Симптом: Движения существуют, но не привязаны к документу.

Причина: При ручном добавлении движения не заполнено поле Регистратор.

Решение: Всегда присваивайте Движение.Регистратор = ДокументОбъект.Ссылка.

3. Ошибки при изменении бухгалтерских проводок

Симптом: Документ проводится, но в отчётах (например, оборотно-сальдовой ведомости) данные не отображаются.

Причина: Неверная корреспонденция счетов или отсутствует субконто.

Решение: Используйте отладчик для проверки структуры движения:

Отладка.Сообщить(Движение.СчётДт.Наименование + " -> " + Движение.СчётКт.Наименование);

4. Зависание при записи движений

Симптом: Система "подвисает" при вызове ЗаписатьДвижения().

Причина: Слишком большое количество движений или рекурсивный вызов проведения.

Решение: Разбивайте массовые операции на пакеты по 100-200 документов и используйте ПриостановитьПроведение().

Ошибка	Симптом	Причина	Решение
Расхождение итогов	Остатки не сходятся	Несбалансированные движения	Проверять суммы приход/расход
Потеря регистратора	Движения "осиротели"	Не заполнено поле Регистратор	Присваивать ссылку на документ
Неверные проводки	Данные не в отчётах	Ошибка в счетах или субконто	Отлаживать структуру движения
Зависание системы	Долгое выполнение	Слишком много движений	Разбивать на пакеты

6. Продвинутые техники: транзакции, откаты и оптимизация

Для сложных сценариев (например, массового изменения движений в тысячах документов) стандартных методов недостаточно. Рассмотрим продвинутые приёмы.

1. Работа в транзакциях

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

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

2. Массовое изменение движений

Если нужно изменить движения в большом количестве документов, используйте пакетную обработку:

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

3. Откат изменений

Если после изменения движений обнаружились ошибки, можно откатить документ к предыдущему состоянию:

ДокументОбъект.ПрочитатьДвижения(); // Восстанавливаем движения из базы
ДокументОбъект.Записать();

4. Оптимизация производительности

При работе с большими объёмами данных:

• 🚀 Используйте ПриостановитьПроведение() для отключения автоматического пересчёта итогов.
• 📊 Заменяйте циклы по движениям на запросы к регистрам.
• 🔄 Выгружайте движения в ТаблицуЗначений для массовой обработки.

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

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|  Движения.ТоварыНаСкладах.Ссылка КАК Ссылка,
|  Движения.ТоварыНаСкладах.Количество КАК Количество
|ИЗ
|  Документ.Движения.ТоварыНаСкладах КАК Движения
|ГДЕ
|  Движения.Регистратор В (&СписокДокументов)";
Движения = Запрос.Выполнить(СписокДокументов).Выгрузить();

⚠️ Внимание: При массовых изменениях движений в БП 3.0 может потребоваться перепроведение зависимых документов (например, корректировок долга). Используйте обработку ПроверкаСвязанныхДокументов.

7. Примеры кода для реальных задач

Разберём практические примеры программного изменения движений для типовых задач.

Задача 1: Исправить количество товара в реализации

Документ РеализацияТоваровУслуг проведён с ошибкой в количестве. Нужно изменить движение по регистру ТоварыНаСкладах:

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

Задача 2: Добавить недостающую проводку в бухгалтерский документ

В документе ПоступлениеТоваровУслуг отсутствует проводка по счёту 19 (НДС). Добавим её вручную:

ДокОбъект = ДокументОбъект.ПолучитьОбъект();
Движение = ДокОбъект.Движения.Хозрасчётный.Добавить();
Движение.Период = ДокОбъект.Дату;
Движение.СчётДт = ПланСчетов.НайтиПоКоду("19");
Движение.СчётКт = ПланСчетов.НайтиПоКоду("60.01");
Движение.Сумма = 1000; // Сумма НДС
Движение.СубконтоДт1 = Номенклатура;
Движение.СубконтоКт1 = Поставщик;
ДокОбъект.Записать();

Задача 3: Перенос движений между документами

Нужно перенести движения по товару из одного документа реализации в другой (например, при оформлении возврата):

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

Задача 4: Массовая корректировка движений по дате

Изменить период движений для всех документов ОприходованиеТоваров за прошлый месяц:

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

FAQ: Частые вопросы по изменению движений в 1С

Можно ли изменить движения документа, который уже включён в закрытый период?

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

1. Снимите флаг закрытия периода в Регламентные операции.
2. Внесите изменения и перепроведите связанные документы.
3. Закройте период заново.

В БП 3.0 для этого есть обработка ЗакрытиеМесяца с функцией "Разблокировать период".

Почему после изменения движений документ не проводится?

Наиболее частые причины:

• 🔴 Не заполнен обязательный реквизит в движении (например, Субконто для бухгалтерского счёта).
• 🔴 Нарушена корреспонденция счетов (для бухгалтерских регистров).
• 🔴 Документ заблокирован другим пользователем или регламентной операцией.
• 🔴 В модуле документа есть обработчик ПередПроведением, который сбрасывает движения.

Проверьте журнал регистрации (Администрирование → Журнал регистрации) на наличие ошибок.

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

Если документ проведён в прошлом периоде, но изменения необходимы, действуйте так:

1. Создайте корректирующий документ (например, КорректировкаДолга или ОперацияБух).
2. Сформируйте в нём движения, компенсирующие ошибку (сторно + правильная запись).
3. Если нужно изменить оригинальный документ — сделайте его копию с новой датой и перенесите движения.

В УТ 11 для этого есть документ КорректировкаЗапасов.

Можно ли программно изменить движения в облачной версии 1С (1С:Фреш)?

В 1С:Фреш доступ к движениям документа ограничен по сравнению с локальной версией. Вы можете:

• ✅ Использовать стандартные методы (ЗаписатьДвижения(), ОчиститьДвижения()).
• ✅ Работать с движениями через HTTP-Сервисы (если они настроены).
• ❌ Нельзя напрямую модифицировать движения в базовой версии (требуется 1С:Предприятие 8.3 с полными правами).

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

Как отладить код, который изменяет движения?

Для отладки используйте:

• 🐞 Пошаговое выполнение в конфигураторе (клавиша F11).
• 📋 Вывод в сообщения:

  Сообщить(СтрШаблон("Движение: %1, Сумма: %2", Движение.Номенклатура, Движение.Сумма));

• 🔍 Просмотр движений через Все функции → Регистры → Движения документа.
• 📊 Запросы для проверки итогов:

  Запрос = Новый Запрос("ВЫБРАТЬ СУММА(Количество) ИЗ РегистрНакопления.ТоварыНаСкладах");
  Сообщить(Запрос.Выполнить().Выгрузить().Итого);