Товары в задачах - связь с CRM

Приложение добавляет в карточку задачи Битрикс24 список товаров, по каждому из которых нужно выполнить определённое действие — проверить, пересчитать, сфотографировать и т.д. Товары можно добавить вручную из каталога Битрикс24 или одной кнопкой загрузить из связанной сделки, лида или элемента смарт-процесса CRM. Работа с товарами происходит прямо внутри задачи, без отдельной учётной системы.

Главная идея: Задача → товары → действия по каждому → выполнение → завершение задачи.

1. Откройте задачу — в карточке любой задачи, к которой у вас есть доступ, появляется вкладка «Товары».
   
2. Добавьте товары — через поиск по каталогу Битрикс24 — или одной кнопкой из связанной сделки, лида или смарт-процесса, если задача создана из CRM.
   
3. Укажите, что сделать, и срок — для каждого товара вводится короткое действие и, при необходимости, дата выполнения.
   
4. Исполнитель отмечает выполнение — по мере работы с товарами исполнитель или соисполнитель ставит галочку «Сделано» напротив каждой позиции.
   
5. Исполнитель завершает задачу — когда все товары отмечены выполненными, исполнитель или соисполнитель нажимает кнопку «Завершить задачу». По настройкам портала это может также добавить результат в задачу и перевести связанный лид, сделку или смарт-процесс на следующий этап воронки.
   

• Добавление товаров из каталога — поиск по названию среди товаров вашего портала Битрикс24, без ручного ввода ID.
  
• Поле «Что сделать» — свободный текст действия по товару, редактируется прямо в строке списка.
  
• Необязательный срок — дата выбирается в выпадающем календаре прямо в строке, с отметками «Сегодня» и «Просрочено».
  
• Количество — необязательное поле для ввода количества по товару, редактируется прямо в строке.
  
• Исполнитель — кто фактически поставил «Сделано» — фиксируется автоматически и показывается в строке.
  
• Чекбокс «Сделано» — быстрая отметка выполнения с сохранением, кто и когда это сделал.
  
• Прогресс по задаче — счётчик «N из M выполнено» и индикатор прогресса в верхней части списка.
  
• Завершение задачи одной кнопкой — доступно исполнителю и соисполнителю, когда все товары отмечены выполненными.
  
• Удаление позиций — товар можно быстро убрать из задачи иконкой корзины в строке.
  
• Совместная работа — со списком одновременно может работать несколько участников задачи — изменения не перезаписывают друг друга.
  
• Загрузка из CRM — товары подтягиваются из связанной сделки, лида или элемента смарт-процесса — заменяя список или добавляясь к нему, по настройке.
  
• Смена этапа CRM — при завершении задачи связанный лид, сделка или смарт-процесс может автоматически переходить на следующий этап воронки.
  
• Результат задачи — при завершении задачи в неё можно автоматически добавлять результат о выполненных действиях с товарами.
  
• Экспорт в CSV и фильтр — выгрузка списка товаров в файл и переключатель «Не завершённые / Все» для отображения на экране.
  
• Гибкие настройки — какие поля показывать, как ведёт себя поиск и загрузка из CRM, что происходит при завершении — настройки общие для всех пользователей портала.
  

Любой участник с доступом к задаче:

• просматривать список товаров;
  
• добавлять и удалять товары, загружать из связанной сделки, лида или смарт-процесса;
  
• менять «Что сделать», срок и количество;
  
• ставить и снимать «Сделано».
  

Только исполнитель или соисполнитель:

• завершать задачу через приложение.
  

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

• Внутри любой задачи Битрикс24, к которой у вас есть доступ, — вкладка «Товары».
  
• Настройки приложения (общий раздел, не привязан к конкретной задаче) — открываются из меню приложений Битрикс24.
  

Список товаров задачи

В верхней части вкладки — название и статус задачи, прогресс выполнения («N из M выполнено» + полоса прогресса), кнопки CSV / фильтр / «Обновить» / «+ Добавить товар».

Каждая строка товара содержит:

• Название товара — из каталога Битрикс24, фиксируется на момент добавления.
  
• Что сделать — свободный текст действия. Клик по тексту превращает его в поле ввода, сохранение по Enter или потере фокуса.
  
• Количество (если включено в настройках) — редактируется прямо в строке, число ввода зависит от настройки «Дробное количество» (целое или с двумя знаками после запятой).
  
• Срок (если включено в настройках) — необязательная дата. Можно ввести вручную (ДД.ММ.ГГГГ) или выбрать в выпадающем календаре (иконка "календарь" рядом с полем). Отображается как «Сегодня» или «Просрочено · дата», если срок наступил или прошёл, — подсветка снимается после выполнения.
  
• Исполнитель (если включено в настройках) — выводится отдельной второй строкой под основной, только когда товар отмечен выполненным. Заполняется автоматически: это тот, кто поставил чекбокс «Сделано».
  
• Чекбокс «Сделано» — крупный, слева. Ставить и снимать может любой участник задачи с доступом к ней.
  
• Корзина — компактная иконка справа (появляется при наведении на строку), центрирована по вертикали. Удаляет товар из задачи после подтверждения. Сам товар в каталоге Битрикс24 не затрагивается.
  

Порядок строк после установки чекбокса не меняется — выполненная позиция остаётся на своём месте, просто становится немного тусклее.

Кнопка «+ Добавить товар» открывает окно подбора:

• поиск по названию товара в каталоге Битрикс24 (минимум 3 символа);
  
• в зависимости от настройки «Динамический поиск товаров» — поиск запускается либо автоматически через паузу после ввода, либо только по кнопке «Найти» / клавише Enter;
  
• в результатах — название, цена и единица измерения товара;
  
• клик по строке результата или по «+ Добавить» добавляет товар в список задачи с количеством 1, курсор сразу переходит в поле «Что сделать».
  

Загрузка товаров из сделки, лида или смарт-процесса

Если задача создана из сделки, лида или элемента смарт-процесса CRM, под кнопками появляется строка вида:

Вы можете загрузить товары из сделки «Название сделки» [Открыть сделку] [Загрузить]

• Открыть сделку / Открыть лид / Открыть смарт-процесс — открывает связанный элемент CRM в Битрикс24.
  
• Загрузить — подтягивает товарные позиции из этого элемента CRM в список задачи. Поведение зависит от настройки «Удалять товары в списке перед загрузкой»: если включена — текущий список заменяется (с подтверждением), если выключена — товары из CRM просто добавляются к уже имеющимся.
  

• «Не завершенные» / «Все» — кнопка-переключатель: скрывает выполненные позиции, показывая только оставшиеся; повторное нажатие («Все») возвращает полный список. На прогресс и завершение задачи фильтр не влияет — только на то, что видно на экране.
  
• CSV — выгружает текущий (с учётом фильтра) список товаров в файл на компьютер: название, что сделать, количество и срок (если включены в настройках), отметка «Сделано», исполнитель.
  

Когда все товары в списке отмечены выполненными, под списком появляется кнопка «Завершить задачу» — доступна только исполнителю и соисполнителю задачи. По нажатию задача переводится в статус «Завершена», окно закрывается автоматически.

Дополнительно, в зависимости от настроек:

• если включено «Добавлять результат при закрытии задачи» — в задачу добавляется результат «Все действия с товарами выполнены»;
  
• если включено «Менять этап в CRM» и задача связана со сделкой/лидом/смарт-процессом — этот элемент CRM переводится на следующий этап воронки.
  

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

Если завершить не удалось (ошибка сети или прав), отметки о выполнении не откатываются — показывается уведомление с кнопкой «Повторить завершение».

Если задача уже завершена, список товаров переходит в режим только для чтения: чекбоксы, поля и кнопка добавления недоступны, под списком — пояснение, что для редактирования нужно вернуть задачу в работу в обычном интерфейсе Битрикс24, а затем снова открыть вкладку «Товары».