CRM роботы 2.0 + AI (300+ роботов)

Изменить поля товарной позиции

Робот «Изменить поля товарной позиции» записывает рассчитанные значения в поля товарной позиции CRM или свойства связанного товара каталога. Подходит для обработки строк товаров в итераторе.

Для кого и какую задачу решает

Администратору CRM и автору процесса, который записывает рассчитанные значения для каждой товарной строки, например внутри итератора.

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

Параметры и подготовка

В множественном поле формы добавляйте каждое значение отдельным элементом. В текстовое JSON-поле вставляйте целиком только значение из блока именно для этого поля: массив или объект, без внешнего объекта со всеми настройками робота. Обычные текстовые, числовые и списковые поля заполняйте в формате, указанном в таблице.

Поле	Как заполнить
ID товарной позиции (`productRowId`)	Обязательное поле
Поля товарной позиции (`fieldCodes`)	Обязательное поле. можно передать несколько значений
Новые значения полей (`fieldValues`)	Обязательное поле. можно передать несколько значений
Типы полей и свойств (`fieldTypes`)	Обязательное поле. можно передать несколько значений
Области изменения полей и свойств (`fieldScopes`)	Необязательное поле. можно передать несколько значений

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

Как использовать

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

Как заполнить JSON-поля

Поля товарной позиции (`fieldCodes`)

[
  "quantity"
]

Пример одного поля строки. Обычно список формирует форма после выбора «Поле или свойство». До 30 разных полей; пустой [] запрещён.

Это массив: внешние квадратные скобки обязательны. Пустой массив [] отличается от объекта {}; возможность пустого списка определяется правилами этого поля, описанными ниже.

Новые значения полей (`fieldValues`)

[
  "5"
]

Новые значения соответствуют кодам по позиции. Для quantity в примере передаётся 5. Длина должна совпадать с fieldCodes.

Типы полей и свойств (`fieldTypes`)

[
  "double"
]

Типы определяются выбранными полями формы. В примере quantity числовое. При заполненном списке длина совпадает с кодами; не подменяйте тип ради принятия неверного значения.

Области изменения полей и свойств (`fieldScopes`)

[
  "row"
]

row означает поле конкретной строки. Для свойств каталога форма использует product:IDкаталога, например product:15. Пустой список по умолчанию означает row; свойству propertyN обязательно нужен правильный каталог. Ошибка области может затронуть карточку товара во всех сделках.

Учебный пример и ожидаемый результат

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

Пример показывает подготовленные учебные данные. Фактический результат зависит от переданных значений и доступных данных вашего процесса.

Что возвращает и как продолжить процесс

«ID обработанной товарной позиции» (productRowId).
«Коды изменённых полей» (updatedFields), список значений.
«Количество изменённых полей» (updatedCount).

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

Выход «Статус выполнения» проверяйте перед передачей результата дальше. При отрицательном статусе прочитайте «Текст ошибки» и направьте процесс на исправление исходных данных. Успешный статус подтверждает выполнение действия; содержательные признаки результата проверяйте отдельно.

Ограничения и разбор ошибок

Меняет одну товарную позицию по её ID. Доступны поля позиции и одиночные свойства связанного товара или вариации; файловые свойства не выбираются. Свойство каталога меняется для всех сделок с этим товаром. Значения должны соответствовать типам; одинаковое поле нельзя выбрать дважды. Списки кодов, значений, типов и областей согласованы по позициям. После записи возвращаются подтверждённые поля; при частичном сбое нужна сверка перед повтором.

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