← На главную

При разработке отчетов или внешних обработок в 1С:Управление торговлей 11.5 часто возникает задача вывести текущий статус оплаты документа Реализация товаров и услуг. Пользователи привыкли видеть в интерфейсе документа информационную строку «Оплачено: XX RUB 100%». Однако попытка получить эти данные простым запросом к Регистрам накопления часто заводит разработчиков в тупик. Давайте разберем, почему это происходит и как правильно подойти к решению данной задачи.

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

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

1. Режим ведения взаиморасчетов: В системе может быть настроен учет «по договорам» или «по заказам/накладным». Если расчеты ведутся по договорам, то оплата может поступать в счет всего договора, а не конкретного документа, что делает привязку «платеж-реализация» неявной.
2. Сложная логика закрытия долга: Механизм взаиморасчетов учитывает возвраты товаров, зачеты авансов, корректировки долга и курсовые разницы.
3. Разделение видов взаиморасчетов: В актуальных версиях УТ 11 используется механизм «Расчеты с клиентами», который предполагает наличие нескольких видов регистров (например, РасчетыСКлиентами и РасчетыСКлиентамиПоДокументам), данные в которых могут отличаться в зависимости от настроек системы.

Как реализовать корректное получение статуса оплаты

Вместо того чтобы писать сложный запрос, который будет ломаться при каждой смене методики учета на проекте, рекомендуем воспользоваться типовым подходом, заложенным разработчиками 1С. Рассмотрим, как это реализовано в системе.

Типовые механизмы конфигурации инкапсулированы в общие модули. Чтобы получить статус оплаты для Реализация товаров и услуг, обратимся к функциям подсистемы «Взаиморасчеты». При анализе кода формы документа вы обнаружите, что для отображения процента оплаты вызываются методы, которые анализируют остатки по регистрам взаиморасчетов в разрезе документа-регистратора.

Рекомендуемый алгоритм действий

Для решения вашей задачи выполните следующие шаги:

1. Анализ метаданных: Изучите, какие регистры накопления используются в вашей базе. Это могут быть РасчетыСКлиентами или РасчетыСКлиентамиПоДокументам.
2. Использование типовых функций: Найдите в конфигурации общие модули, в названии которых присутствуют слова Взаиморасчеты или РасчетыСКлиентамиСервер. Именно там находятся функции, возвращающие структуру данных о состоянии расчетов.
3. Пример реализации через обращение к модулям:

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

   Скопировать код

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

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

Разработчики 1С уже учли все возможные «подводные камни» в расчетах: операции сторнирования, валютные разницы, особенности отражения оплат по эквайрингу и многое другое. Если вы напишете собственный запрос к Регистру накопления, вы почти гарантированно упустите какой-либо из этих аспектов, что приведет к неверным данным в ваших отчетах.

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