Как посчитать сумму в табличной части документа 1С

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

Самый быстрый способ в коде — метод Итог("Колонка"), самый гибкий — обход строк в цикле с условиями, а в типовых конфигурациях сумма документа часто считается не простым сложением, а с учётом НДС, скидок и валюты. Ниже разобраны все рабочие варианты с примерами кода и указанием, когда какой выбирать.

Метод Итог() — самый простой способ

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

СуммаДокумента = Объект.Товары.Итог("Сумма");
СуммаНДС = Объект.Товары.Итог("СуммаНДС");
ИтогоКоличество = Объект.Товары.Итог("Количество");

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

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

Расчёт суммы в цикле с условиями

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

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

Цикл незаменим, когда сумма по строке не хранится в реквизите, а вычисляется из других полей — например, «Количество × Цена» со скидкой. Также в цикле удобно параллельно считать количество позиций, максимальную цену или собирать список номенклатуры.

Для больших табличных частей (тысячи строк) цикл в коде работает медленнее, чем запрос к базе. Если документ уже записан и нужен агрегированный расчёт по многим документам сразу — правильнее использовать запрос с функцией СУММА().

СуммаИтого = Объект.Товары.Итог("Сумма");

Вывод итога по колонке на форме документа

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

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

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

1. 1
   Откройте форму документа в конфигураторе и выделите таблицу с табличной частью
2. 2
   Включите свойство «Подвал» (Footer) у таблицы
3. 3
   Для числовой колонки включите отображение итога в подвале
4. 4
   Если нужен итог с условиями — добавьте реквизит формы и обновляйте его в обработчиках изменения строк
5. 5
   Проверьте: добавьте и удалите строки, итог должен пересчитываться автоматически

Сумма через запрос

Запрос оправдан, когда сумму нужно получить по данным информационной базы: по одному записанному документу без открытия его объекта, по группе документов за период или с группировкой по номенклатуре. Для этого используется агрегатная функция СУММА().

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

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

Для незаписанного документа запрос неприменим к текущим данным — используйте методы объекта. Для массовых расчётов по проведённым документам запрос, наоборот, единственный производительный вариант.

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

В типовых решениях (Бухгалтерия, Управление торговлей, ERP) итоговая сумма документа — это не просто сумма колонки «Сумма». Она может включать или не включать НДС в зависимости от флага «Сумма включает НДС», пересчитываться из валюты в валюту учёта по курсу, уменьшаться на скидки и зависеть от вида операции.

Поэтому при доработках не стоит вставлять собственный расчёт Итог("Сумма") вместо типовых механизмов. В типовых модулях есть процедуры пересчёта табличных частей (например, обработки вида «РассчитатьСуммуТабличнойЧасти» в общих модулях работы с документами), которые учитывают все эти факторы. Правильный подход — вызвать типовую процедуру или посмотреть, как сумма выводится в шапку документа, и повторить эту логику.

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

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

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

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

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

FAQ