Другое · 7 мин
Как получить движения документа в 1С
Как в 1С получить движения документа: через объект Движения, запросы к регистрам накопления и бухгалтерии, отбор по ссылке, периоду и организации, проверка и ошибки.
Движения документа — это записи, которые 1С создаёт в регистрах при проведении документа. Они отражают изменение остатков, оборотов, начислений, остатков по складам, денежных средств и других показателей в зависимости от конфигурации. Без проведения документа движения обычно отсутствуют, поэтому первая проверка всегда связана со статусом документа.
Получить движения можно двумя основными способами: через объектный интерфейс документа, когда доступен экземпляр документа в коде, или через запросы к виртуальным таблицам регистров, когда нужно сформировать отбор по многим документам или построить отчёт. Выбор зависит от задачи, контекста выполнения и того, нужно ли просто прочитать данные или использовать их в дальнейшей обработке.
Что понимать под движениями документа в 1С
Движения не хранятся внутри самого документа как отдельная таблица, доступная без контекста регистра. Документ при проведении пишет строки в регистры накопления, регистры бухгалтерии, информационные регистры или другие таблицы, описанные в конфигурации. Каждая строка движения содержит период, организацию, сделку, номенклатуру, контрагента, сумму, количество и другие измерения, зависящие от структуры регистра.
Важно различать само движение и остаток. Движение описывает изменение за период, а остаток — результат нарастающего итога на дату. Если нужно узнать, что именно сделал документ, смотрите движения. Если нужно узнать состояние на конец дня, используйте остатки и обороты за период.
Где хранятся движения и как к ним обращаться
В объектной модели движения документа доступны через коллекцию Движения, где каждый элемент соответствует одному регистру. Например, Движения.ОстаткиТоваров содержит строки, которые документ записал в регистр накопления ОстаткиТоваров. Каждая строка можно читать, а в некоторых ситуациях и изменять до записи документа, хотя прямое редактирование движений требует осторожности.
Для массового получения данных используются виртуальные таблицы регистров, такие как ОстаткиИОбороты или движения регистра, в зависимости от конфигурации и платформы. В запросе указывается ссылка на документ, период, организация и другие измерения. Такой подход удобен для отчётов, печатных форм и обработок, где нужно обработать много документов сразу.
Как получить движения через объект документа
Когда у вас есть ссылка на документ, получите объект документа и обратитесь к его движениям после проведения. В управляемом приложении это выглядит примерно как обращение к свойству Движения объекта документа, а затем к конкретному регистру, например Движения.ОстаткиТоваров. Каждая строка содержит поля измерений и ресурсов регистра.
Если документ ещё не проведён, коллекция движений может быть пустой или недоступной, потому что регистры ещё не записаны. После проведения движения становятся доступными для чтения. При отмене проведения движения регистров удаляются или аннулируются в зависимости от реализации конфигурации, и повторное чтение может вернуть пустую выборку.
- 1Убедитесь, что документ проведён
- 2Определите регистры, в которые документ делает движения
- 3Выберите способ: объект документа для текущего экземпляра или запрос к регистру для отчёта
- 4Добавьте отбор по ссылке на документ, периоду и организации
- 5Проверьте, что выборка не пуста и суммы соответствуют проводкам
Как получить движения через запросы к виртуальным таблицам регистров
Запрос к регистру позволяет получить движения сразу по нескольким документам, сгруппировать их по номенклатуре, контрагенту или складу и отфильтровать по дате. В тексте запроса указывается имя виртуальной таблицы регистра, поле Ссылка на документ, период и необходимые измерения. Результат можно выгрузить в таблицу значений, значение таблицы или использовать в отчёте.
При составлении запроса следите за именами регистров и полей, так как они зависят от конфигурации. Не все регистры имеют одинаковую структуру: в некоторых есть только остатки, в других — движения и остатки. Если регистр не ведёт движения по документу, выборка будет пустой даже у проведённого документа.
Отличия управляемых и обычных форм, сервер и клиент
В управляемых формах доступ к данным чаще выполняется на сервере, а клиент получает уже готовый результат. Если вы пытаетесь прочитать движения на клиенте без вызова серверного метода, может возникнуть ограничение доступа или отсутствие данных. Для чтения больших объёмов движений предпочтительнее серверный код или запрос, выполняемый на сервере.
В обычных формах модель может отличаться, и доступ к движениям возможен напрямую через объект документа, но порядок проведения и блокировки остаются важными. Не пытайтесь читать движения в момент проведения документа из других обработок без понимания транзакций, иначе можно получить частичные или неконсистентные данные.
Проверка результата и типичные ошибки
Перед использованием движений проверьте, что документ проведён, период указан правильно, организация соответствует контексту, а регистр действительно ведётся по этому документу. Пустая выборка не всегда означает ошибку: документ мог не делать движения в выбранном регистре. Сравните суммы в выборке с проводками или отчётами по регистру, чтобы убедиться в корректности.
Частая ошибка — попытка изменить движения регистров напрямую в рабочей базе без понимания механизма проведения. Это может привести к несоответствию остатков, ошибкам в отчётах и сложностом восстановлению. Любые корректировки лучше делать через документы корректировки, регламентные операции или средства конфигурации, а не через прямое редактирование таблиц движений.
Как проверить результат
Возвращены строки регистров с суммами и измерениями
Пустая выборка у проведённого документа или ошибка доступа к регистру
Как проверить результат и когда обращаться к специалисту
Нормальным результатом является непустая выборка движений по ссылке на документ с ожидаемыми суммами, количествами и измерениями. Если у проведённого документа выборка пустая, проверьте, ведёт ли выбранный регистр движения по этому виду документов, и не ограничен ли доступ к данным ролями. Ошибка доступа к регистру или неверное имя таблицы требуют проверки конфигурации.
Если движения не совпадают с первичными документами, остатки расходятся или проведение документа завершается ошибкой, остановите самостоятельные изменения и обратитесь к администратору или разработчику 1С. Неправильное вмешательство в регистры может повредить бухгалтерские и складские данные, восстанавливать которые без резервной копии сложно.
Что важно запомнить
Движения берутся из регистров после проведения, через объект или запрос; всегда отбирайте по документу, периоду и организации и проверяйте на копии перед любыми изменениями.
Нужно ли проводить документ перед получением движений?
Да, в большинстве случаев движения регистров создаются только в момент проведения документа. У непроведённого документа выборка движений может быть пустой или недоступной, поэтому сначала проверьте статус документа.
Можно ли получить движения по нескольким документам сразу?
Да, удобнее всего использовать запрос к виртуальной таблице регистра с отбором по списку ссылок на документы, периоду и организации. Объектный способ подходит больше для работы с одним открытым документом.
Что делать, если выборка движений пустая?
Проверьте, что документ проведён, выбран правильный регистр и период, а также что организация и права доступа позволяют читать данные. Пустая выборка может быть нормальной, если документ не делает движения в этом регистре.
Безопасно ли редактировать движения регистров вручную?
Не рекомендуется в рабочей базе без понимания механизма проведения и резервной копии. Прямое изменение движений может нарушить остатки и отчёты. Лучше использовать документы корректировки или обратиться к специалисту по 1С.