Кейсы Digital for Sales: использование приложений для Битрикс24

Поиск элементов универсального списка по дате создания в Битрикс24

2026-01-03 21:22
При работе с бизнес-процессами и роботами в Битрикс24 пользователи часто сталкиваются с задачей:
найти элементы универсального списка, созданные за определённый период времени,
например:
  • за неделю
  • за месяц
  • между двумя датами
Такие сценарии востребованы при построении отчётов, автоматизации контроля, запуске действий по «свежим» данным.

Стандартный поиск элементов списка: в чём ограничение

Для большинства задач поиска отлично подходит приложение Поиск элементов Списка по любым полям.
Оно позволяет:
  • искать элементы универсальных списков по значениям полей
  • использовать поиск внутри роботов и бизнес-процессов
  • быстро настраивать сценарии без программирования
Однако при работе с датой создания элемента появляется ключевое ограничение.

Почему нельзя задать диапазон дат стандартными средствами

В стандартных роботах и приложениях поиска:
  • доступны только пользовательские поля
  • системное поле даты создания элемента недоступно
  • нельзя задать условие вида
  • «создано с … по …»
  • формулы и переменные возвращают одно значение, а не диапазон
Поэтому поиск элементов универсального списка по диапазону дат стандартными инструментами невозможен.

Решение: REST API Битрикс24 в роботах и БП

Когда требуется более гибкая логика, используется приложение
REST API — методы REST Битрикс24 и JSON в роботах и БП.
Оно позволяет:
  • работать напрямую с REST API Битрикс24
  • передавать любые параметры запроса в формате JSON
  • использовать системные поля, недоступные в стандартных роботах
Именно REST-подход решает задачу поиска по дате создания.

Какой REST-метод используется

Для получения элементов универсального списка применяется метод:
lists.element.get
Этот метод:
  • возвращает элементы списка
  • поддерживает фильтрацию
  • позволяет задавать диапазоны значений через операторы сравнения

Пример REST-запроса для поиска по периоду дат

Условия:
  • ID универсального списка — 245
  • период: с 01.09.2025 по 01.12.2025
Тело REST-запроса:
{
"IBLOCK_TYPE_ID": "lists",
"IBLOCK_ID": 245,
"FILTER": {
">CREATED": "2025-09-01T00:00:00",
"<CREATED": "2025-12-01T00:00:00"
}
}

Важные моменты для корректной работы

  • даты указываются в ISO-формате
  • >CREATED — элементы, созданные позже указанной даты
  • <CREATED — элементы, созданные раньше указанной даты
  • фильтр работает именно по системному полю даты создания

Что указать в JSONPath

Чтобы робот вернул массив элементов, в JSONPath необходимо указать:
$.result
Это стандартное поле ответа REST-методов Битрикс24, в котором содержатся найденные элементы.

Результат использования REST-робота

В результате такой настройки:
  • получаем массив элементов универсального списка за нужный период
  • можем использовать данные в дальнейших шагах бизнес-процесса
  • снимаем ограничения стандартных роботов поиска

Как правильно комбинировать оба подхода

На практике оба приложения используются совместно:
Поиск элементов Списка по любым полям
— оптимален для простых сценариев и пользовательских полей
REST API — методы REST Битрикс24 и JSON в роботах и БП
— незаменим, когда требуется:
  • диапазон дат
  • работа с системными полями
  • сложная фильтрация
Такой подход позволяет строить надёжные и масштабируемые сценарии автоматизации без доработок ядра Битрикс24.

Вывод

Если требуется поиск элементов универсального списка по дате создания или по диапазону дат, стандартные инструменты Битрикс24 не подходят.
Использование REST API через специализированный REST-робот полностью решает эту задачу и значительно расширяет возможности бизнес-процессов.
Этот кейс — наглядный пример того, как REST-инструменты дополняют стандартные приложения и позволяют закрывать реальные задачи автоматизации.