Получить информацию о товарной позиции

Урок 133 из 248
Автор: Марина Павлова
Сложность урока:
1 уровень - интуитивно все понятно из интерфейса, но почитать стоит.
1 из 5
Просмотров: 13865
Дата изменения: 16.02.2024
Недоступно в лицензиях:
Текущую редакцию Вашего 1С-Битрикс можно просмотреть на странице Обновление платформы (Marketplace > Обновление платформы).
Все лицензии БУС

Действие позволяет получить данные о товарной позиции для передачи в другие действия.

Примечание: Действие доступно в шаблонах бизнес-процессов Сделок, Коммерческих предложений, Счетов и Смарт-процессов.

  Описание действия

  Описание параметров


  • ID товарной позиции – укажите идентификатор ID товарной позиции, по которой нужно получить информацию.

  Пример настройки:

Поля выбранной товарной позиции с указанным ID станут доступны в секции Дополнительные результаты формы Вставка значения:

  • ID товарной позиции;
  • ID владельца;
  • Тип владельца;
  • ID товара;
  • Название товара;
  • Цена;
  • Цена без налога со скидкой;
  • Цена без учета скидок и налогов;
  • Цена без учета скидок, но с учетом налогов;
  • Количество;
  • Цена за весь товар;
  • Сумма (текст);
  • Тип скидки;
  • Величина скидки;
  • Сумма скидки;
  • Налог;
  • Налог включен в цену;
  • Код единицы измерения;
  • Единица измерения;
  • Сортировка;
  • XML ID;
  • Тип товара.

  Пример работы с действием

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

Подробнее...
, секция Поля документа, поле Товарные позиции . Это поле содержит в себе идентификаторы всех товарных позиций в документе.

Чаще всего в документе (сделке, счете) привязано несколько товаров. Действие Информация о товарной позиции предоставляет информацию только по одному товару, поэтому при попытке использования поля Товарные позиции в этом действии, вы получите данные только об одном товаре (первом в списке).

Как же получить данные по всем товарам? Поле "Товарные позиции" - множественное, а значит с ним получится работать с помощью Итератора Конструкция выполняет перебор значений во множественных переменных. С помощью этой конструкции возможно создать цикл действий, каждая итерация которого выполнится с очередным значением множественной переменной (константы, параметра, поля документа).

Подробнее...
.

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

Действия, которые использованы в практическом примере: Изменение документа Действие изменяет указанные поля документа.
Подробнее...
, Итератор, Информация о товарной позиции, Задача Действие позволяет создать задачу.
Подробнее...
. Также в Сделках создано пользовательское Пользовательские поля - это поля, которые создают пользователи CRM, то есть сотрудники. Такие поля доступны во всех элементах и по своим возможностям полностью повторяют системные - отображаются в карточке, по ним можно фильтровать элементы, с ними взаимодействуют роботы.

Подробнее на helpdesk.bitrix24.ru.
множественное поле типа Строка с названием Информация о товарах, в которое мы будем записывать полученную о товарах информацию.

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

Опишем как отработает такой бизнес-процесс:

  • Сначала мы очищаем поле сделки Информация о товарах действием Изменение документа , на случай, если в поле уже было что-то записано ранее;
  • Далее задействуем Итератор . В теле итератора происходит чтение данных Для этого в параметр ID товарной позиции подставляем значение
    итератора из дополнительных результатов:
    о каждом товаре сделки по его ID и затем, запись нужных нам данных в поле сделки Информация о товарах Важно указать Да для параметра Добавить множественные поля вместо перезаписи. В этом случае
    информация о каждом товаре запишется новым значением множественного поля.

    .
  • После того, как все циклы Итератора отработают, процесс перейдет к действию Задача. В описании задачи добавляем всю новую информацию из поля Информация о товарах.
    Примечание: Дополнительно в описании выведем поле документа Товарные позиции (текст). Это поле отобразит информацию о всех товарах в документе со стоимостью в виде таблицы.

Результатом запуска БП в сделке с двумя товарами будет новая задача с информацией о товарах в описании:

Нажмите на рисунок, чтобы увеличить

, где
  1. Информация о товарах, которую мы записали в поле сделки Информация о товарах;
  2. Информация из поля документа Товарные позиции (текст).


Нам жаль это слышать… Но мы постараемся быть лучше!

Мы благодарны Вам за помощь в улучшении документации.

Спасибо, мы рады что смогли помочь Вам. Ниже Вы можете оставить свой отзыв или пожелание :)
Мы стараемся сделать документацию понятнее и доступнее,
и Ваше мнение важно для нас
Курсы разработаны в компании «1С-Битрикс»