CRM роботы

Изменить НДС в товаре в сделках

Изменение НДС в товарных позициях сделки

Робот устанавливает ставку НДС и признак «НДС включён в цену» у товаров, уже добавленных в сделку Битрикс24. Он получает товарные строки по ID сделки и обновляет каждую найденную позицию.

Важная особенность: робот обрабатывает все товарные позиции выбранной сделки. В его настройках нет ID отдельного товара или строки. Если в одной сделке должны остаться разные ставки, этот робот для такого сценария не подходит без дополнительной логики.

Параметры робота

Для запуска нужны три обязательных значения:

Параметр	Назначение
`elementId`	ID сделки, товарные позиции которой нужно изменить
`nds`	ставка, записываемая в поле `taxRate` каждой товарной строки
`inPrice`	признак включения НДС в цену, записываемый в `taxIncluded`

Передавайте ставку в формате, который принимает ваш портал Битрикс24. Сам робот не определяет налоговый режим, не выбирает ставку по категории товара и не проверяет её соответствие законодательству. Нужное значение должно быть рассчитано и согласовано до запуска автоматизации.

Как работает обновление

Робот получает ID сделки из параметра elementId.
Запрашивает все товарные позиции этой сделки.
Для каждой строки формирует обновление полей taxRate и taxIncluded.
Отправляет изменения пакетным запросом.
Возвращает статус выполнения.

Робот не добавляет товары и не меняет данные карточек каталога. Обновляются строки товаров внутри конкретной сделки.

Что возвращается

В схеме робота предусмотрено одно выходное поле — status. После выполнения робот устанавливает положительный статус.

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

Где применять

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

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

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

Безопасная настройка

Перед массовым использованием проверьте сценарий на тестовой сделке:

в сделке есть товарные позиции;
передан правильный ID сделки;
значение nds принимается порталом;
inPrice соответствует нужному способу расчёта цены;
итоговые суммы и печатные документы после обновления выглядят ожидаемо.

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

Ограничения

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

Если товаров в сделке нет, изменять будет нечего. Текущая реализация при этом не возвращает отдельное сообщение «товары не найдены», поэтому наличие строк лучше проверять до запуска или повторным запросом после него.

Робот входит в приложение «Роботы для автоматизации бизнеса».