1С: как запросить остатки через запрос

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

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

Ниже разобраны синтаксис запросов к виртуальным таблицам, передача параметров периода, отборы по складу и номенклатуре, получение остатков с оборотами, а также проверка результата и типичные ошибки, из-за которых запрос возвращает пустоту или неверные суммы.

Какие виртуальные таблицы использовать для остатков

Регистры накопления с видом «Остатки» автоматически предоставляют две ключевые виртуальные таблицы. Таблица Остатки возвращает срез значений ресурсов на конкретный момент времени в разрезе всех измерений регистра. Таблица ОстаткиИОбороты возвращает начальный остаток, приход, расход и конечный остаток за произвольный интервал с заданной периодичностью.

Дополнительно существует таблица Обороты, но для задачи «узнать остаток» она нужна редко — обороты не содержат самого остатка, только движение ресурса за период. Если требуется именно «сколько товара на складе сейчас», выбор всегда падает на Остатки или ОстаткиИОбороты.

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

Запрос остатков на конкретную дату

Базовый пример для типового регистра «ТоварыНаСкладах» выглядит так. Первый параметр виртуальной таблицы — момент времени, на который нужны остатки, второй — условие отбора:

ВЫБРАТЬ
Остатки.Номенклатура КАК Номенклатура,
Остатки.Склад КАК Склад,
Остатки.КоличествоОстаток КАК Количество
ИЗ
РегистрНакопления.ТоварыНаСкладах.Остатки(&Период, ) КАК Остатки

Параметр &Период задаётся до выполнения запроса через Запрос.УстановитьПараметр("Период", Дата). Если параметр не указать, платформа вернёт остатки на текущую дату сеанса, что часто становится источником путаницы при отладке: запрос «вчера работал», а сегодня показывает другие цифры просто потому, что изменилась текущая дата.

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

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

Остатки за период с оборотами

Когда нужно показать динамику — сколько было на начало, сколько пришло и ушло, сколько осталось — используется таблица ОстаткиИОбороты. У неё четыре первых параметра: начало периода, конец периода, периодичность и метод дополнения периодов, затем условие отбора.

ВЫБРАТЬ
Т.Период КАК Период,
Т.Номенклатура КАК Номенклатура,
Т.КоличествоНачальныйОстаток КАК НачальныйОстаток,
Т.КоличествоПриход КАК Приход,
Т.КоличествоРасход КАК Расход,
Т.КоличествоКонечныйОстаток КАК КонечныйОстаток
ИЗ
РегистрНакопления.ТоварыНаСкладах.ОстаткиИОбороты(
&НачалоПериода, &КонецПериода, Месяц, , ) КАК Т

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

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

Отборы: склад, номенклатура, организация

Условие отбора передаётся вторым (в ОстаткиИОбороты — пятым) параметром виртуальной таблицы как текст на языке запросов. Отбор внутри параметров работает быстрее, чем секция ГДЕ над результатом, потому что платформа применяет его на уровне чтения итогов:

РегистрНакопления.ТоварыНаСкладах.Остатки(
&Период,
Склад = &Склад И Номенклатура В (&СписокНоменклатуры))

Отбор по списку значений реализуется через оператор В с параметром-массивом. Для иерархических справочников, например отбора по группе номенклатуры, используется В ИЕРАРХИИ (&Группа). Условия по полям, не являющимся измерениями регистра, в параметрах виртуальной таблицы недопустимы — платформа выдаст ошибку ещё на этапе проверки запроса.

Как получить остатки по регистру бухгалтерии

Для регистра бухгалтерии «Хозрасчетный» принцип тот же, но параметров больше: период, отбор по счетам, список видов субконто, условие по аналитике. Типичный запрос остатков по счёту 41 в разрезе номенклатуры:

ВЫБРАТЬ
Т.Субконто1 КАК Номенклатура,
Т.СуммаОстатокДт КАК СуммаДт,
Т.КоличествоОстатокДт КАК Количество
ИЗ
РегистрБухгалтерии.Хозрасчетный.Остатки(
&Период, Счет = &Счет41, &ВидыСубконто, ) КАК Т

Параметр видов субконто — массив элементов плана видов характеристик «ВидыСубконтоХозрасчетные». Если его не задать, остатки будут свёрнуты без аналитики. Для счетов с дебетово-кредитовым сальдо используйте поля СуммаОстаток (свёрнутое) или СуммаОстатокДт/СуммаОстатокКт (развёрнутое) — выбор зависит от того, как остаток должен выглядеть в отчёте.

Остатки без запроса: типовые отчёты

Если программная выборка не нужна, остатки смотрят штатными отчётами: «Остатки товаров на складах» в УТ и ERP, «Остатки номенклатуры» в УНФ, оборотно-сальдовая ведомость в Бухгалтерии. Эти отчёты построены на тех же виртуальных таблицах, поэтому цифры в них совпадают с результатом корректно написанного запроса — это удобный эталон для проверки своего кода.

Проверка результата и типичные ошибки

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

Отдельная ситуация — отрицательные остатки. Они возникают, когда расход проведён раньше прихода или приход вообще не оформлен. Запрос их честно покажет; чтобы найти такие позиции, добавьте в секцию ГДЕ условие КоличествоОстаток < 0 — это стандартный приём контроля данных.

Ограничения и когда нужна помощь разработчика

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

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

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