Получить ID компаний по дате создания
Робот «Получить ID компаний по дате создания» возвращает ID компаний, созданных в выбранном диапазоне даты и времени.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую задачу решает
Руководителю продаж и администратору CRM, который собирает компании, созданные за определённый период, для дальнейшего контроля или обработки.
Выборка по дате изменения и по дате создания решает разные задачи. Этот робот использует именно дату создания компаний и возвращает ID по возрастанию даты. Нужный временной диапазон следует подготовить явно.
Параметры и подготовка
| Поле | Как заполнить |
|---|---|
Дата создания с (dateCreateFrom) |
Необязательное поле |
Дата создания по (dateCreateTo) |
Необязательное поле |
Перед настройкой выберите, откуда процесс получит каждое значение: постоянная настройка, поле карточки или результат предыдущего шага. Подписи в таблице соответствуют полям робота. Коды в скобках помогают различать похожие параметры при передаче данных между шагами.
Как использовать
- Заполните начало и конец периода полями даты-времени. Используйте корректную ISO-запись и при необходимости явный часовой пояс.
- Начальная граница включена через «с», конечная через «по». Укажите конец дня или следующий осмысленный момент согласно вашему правилу.
- Проверьте даты до запуска: пустое или нераспознаваемое значение не ограничивает соответствующую границу. Две пустые границы дают выборку без периода.
- После статуса используйте companyIds и totalCount. firstCompanyId равен первому ID по порядку создания или 0 при пустом результате.
Учебный пример и ожидаемый результат
Для учебной выборки задайте dateCreateFrom=2026-10-01T00:00:00+03:00, dateCreateTo=2026-10-15T23:59:59+03:00. Ожидаются доступные компании с датой создания внутри этих границ. Конкретные ID и количество зависят от учебных данных. Строка «вчера» не распознаётся как ISO-дата и не должна использоваться вместо подготовленного значения.
Пример показывает подготовленные учебные данные. Фактический результат зависит от переданных значений и доступных данных вашего процесса.
Что возвращает и как продолжить процесс
- «Список ID компаний» (
companyIds), список значений. - «Первый ID компании» (
firstCompanyId). - «Количество компаний» (
totalCount).
companyIds содержит ID, а не полные карточки компаний. Для чтения названий и реквизитов добавьте соответствующий шаг. totalCount относится к возвращённой выборке; первый ID помогает только для сценария, которому действительно нужен один первый элемент.
Выход «Статус выполнения» проверяйте перед передачей результата дальше. При отрицательном статусе прочитайте «Текст ошибки» и направьте процесс на исправление исходных данных. Успешный статус подтверждает выполнение действия; содержательные признаки результата проверяйте отдельно.
Ограничения и разбор ошибок
Поля периода необязательны. Корректные ISO-даты нормализуются; пустое либо нераспознаваемое значение игнорируется. Границы включены. Возвращаются ID доступных компаний, первый ID и размер результата; сортировка по дате создания по возрастанию. Данные компаний не изменяются.
Робот не фильтрует по дате изменения и не переносит компании между стадиями. Не оставляйте ошибочную границу в рабочем процессе: она будет пропущена, что может расширить выборку. Проверьте часовой пояс и смысл включённых границ.