Как получить движения документа в 1С

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

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

Важно понимать разницу между двумя состояниями движений: теми, что уже записаны в базу, и теми, что сформированы в памяти при проведении, но ещё не сохранены. От этого зависит, какой метод чтения выбрать и почему запрос иногда «не видит» свежие записи.

Что такое движения документа и где они хранятся

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

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

Как посмотреть движения в режиме 1С:Предприятие без программирования

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

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

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

Как получить движения через объект документа в коде

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

ДокументОбъект = СсылкаНаДокумент.ПолучитьОбъект();

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

Для Каждого Запись Из НаборЗаписей Цикл
    Сообщить(Строка(Запись.Номенклатура) + " — " + Запись.Количество);
КонецЦикла;

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

ТаблицаДвижений = ДокументОбъект.Движения.ТоварыНаСкладах.Выгрузить();
// Теперь доступны свёртка, поиск, сортировка:
ТаблицаДвижений.Свернуть("Номенклатура", "Количество");

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

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

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

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

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

Запрос — единственный разумный вариант, когда нужно получить движения сразу пачки документов: замените условие на Регистратор В (&СписокДокументов) или на диапазон по дате с соединением с таблицей документа.

Движения внутри обработчика проведения

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

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

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

Как посмотреть движения в отладчике

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

В окне «Вычислить выражение» (Shift+F9) введите Движения.ТоварыНаСкладах.Выгрузить() — получите таблицу значений, которую можно пролистать и проверить каждое поле каждой строки. Для наборов записей удобно проверять свойство Количество(), чтобы убедиться, что записи вообще добавлены.

1. 1
   Включите отладку в конфигураторе и поставьте точку останова в ОбработкаПроведения
2. 2
   Проведите документ в режиме предприятия
3. 3
   Когда сработает останов, откройте «Вычислить выражение»
4. 4
   Введите Движения.<ИмяРегистра>.Выгрузить() и нажмите «Рассчитать»
5. 5
   Откройте таблицу значений кнопкой просмотра и проверьте строки
6. 6
   Сравните с ожидаемым результатом и найдите расхождение

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

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

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

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

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

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

Для комплексной проверки полезно сравнить результат запроса с данными стандартного отчёта «Движения документа» в режиме предприятия — они должны совпадать построчно.

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