Блог Горошко Андрея Bitrix24,PHP Получить список полей шаблона регулярной сделки crm.deal.recurring.fields

Получить список полей шаблона регулярной сделки crm.deal.recurring.fields

Оптимизация производительности и безопасности — залог успешного проекта на 1С-Битрикс. Данный материал посвящен практическому применению «Получить список полей шаблона регулярной сделки crm.deal.recurring.fields». Мы подготовили подробный разбор принципов работы и развернутые примеры интеграции.

Получить список полей шаблона регулярной сделки crm.deal.recurring.fields

Тут может не хватать некоторых данных — дополним в ближайшее время

  • отсутствуют примеры (на других языках)
  • отсутствует ответ в случае успеха
  • отсутствует ответ в случае ошибки
  • не прописаны ссылки на ещё не созданные страницы

> Scope: crm
>
> Кто может выполнять метод: любой пользователь

Метод crm.deal.recurring.fields возвращает список полей настройки шаблона регулярной сделки c описанием.

Практический пример и готовый код на PHP

  • JS
    try
    {
    	const response = await $b24.callMethod(
    		'crm.deal.recurring.fields',
    		{}
    	);
    	
    	const result = response.getData().result;
    	if(result.error())
    	{
    		console.error(result.error());
    	}
    	else
    	{
    		console.dir(result);
    	}
    }
    catch(error)
    {
    	console.error('Error:', error);
    }
  • PHP
    try {
        $response = $b24Service
            ->core
            ->call(
                'crm.deal.recurring.fields',
                []
            );
    
        $result = $response
            ->getResponseData()
            ->getResult();
    
        if ($result->error()) {
            error_log($result->error());
        } else {
            echo 'Success: ' . print_r($result->data(), true);
        }
    
    } catch (Throwable $e) {
        error_log($e->getMessage());
        echo 'Error fetching recurring deal fields: ' . $e->getMessage();
    }
  • BX24.js
    BX24.callMethod(
        "crm.deal.recurring.fields",
        {},
        function(result)
        {
            if(result.error())
                console.error(result.error());
            else
                console.dir(result.data());
        }
    );

Возвращаемые поля

ПолеОписание
ID
integer
Идентификатор записи в таблице настроек регулярной сделки. Только для чтения.
DEAL_ID
integer
ID шаблона сделки. Неизменяемое.
BASED_ID
integer
ID сделки, на основании которой был создан шаблон. Неизменяемое.
ACTIVE
char
Флаг активности. Значения: Y/N.
NEXT_EXECUTION
date
Дата следующего создания новой сделки из шаблона. Рассчитывается системой по указанным параметрам. Если значение пустое, новые сделки не создаются. Только для чтения.
LAST_EXECUTION
date
Дата последнего создания новой сделки из шаблона. Только для чтения.
COUNTER_REPEAT
integer
Количество созданных из шаблона сделок. Только для чтения.
START_DATE
date
Дата начала отсчета при расчете даты следующего создания новой сделки. Если значение пустое, рассчитывается от текущей даты.
CATEGORY_ID
char
Категория, которая будет задана у сделки, созданной из шаблона.
IS_LIMIT
char
Есть ли ограничения по созданию новых сделок. Значения: N — без ограничений, D — установлено ограничение по дате, T — установлено ограничение по количеству новых сделок.
LIMIT_REPEAT
integer
Максимальное число сделок, которое можно создать из этого шаблона. Учитывается, если IS_LIMIT равно T.
LIMIT_DATE
date
Дата, до достижения которой можно создавать сделки из этого шаблона. Учитывается, если IS_LIMIT равно D.
PARAMSНабор параметров для расчета — recurring_params:

— MODE — режим повторения:
— single — единичный (будет создана одна сделка из шаблона, смещение рассчитывается до значения START_DATE);
— multiple — множественный

— MULTIPLE_TYPE — тип повторения в множественном режиме [MODE равен multiple]:
— day — день
— week — неделя
— month — месяц
— year — год

— MULTIPLE_INTERVAL — значение смещения [MODE равен multiple]

— SINGLE_BEFORE_START_DATE_TYPE — тип смещения до даты начала [MODE равен single]:
— day — день
— week — неделя
— month — месяц
— year — год

— SINGLE_BEFORE_START_DATE_VALUE — значение смещения до даты начала, если не установлено — смещения нет [MODE равен single]

— OFFSET_BEGINDATE_TYPE — тип смещения для расчета поля «даты начала сделки», расчет ведется от момента создания новой сделки из шаблона:
— day — день
— week — неделя
— month — месяц
— year — год

— OFFSET_BEGINDATE_VALUE — значение смещения для расчета поля «даты начала сделки», расчет ведется от момента создания новой сделки из шаблона

— OFFSET_CLOSEDATE_TYPE — значение смещения для расчета поля «даты завершения сделки», расчет ведется от момента создания новой сделки из шаблона:
— day — день
— week — неделя
— month — месяц
— year — год

— OFFSET_CLOSEDATE_VALUE — значение смещения для расчета поля «даты завершения сделки», расчет ведется от момента создания новой сделки из шаблона

[](./crm-deal-recurring-add)

💡 Экспертное мнение и рекомендации

Ключевые выводы по теме «Получить список полей шаблона регулярной сделки crm.deal.recurring.fields»:

Использование современных стандартов D7 при работе с crm.deal.recurring.fields позволяет писать чистый, масштабируемый и безопасный код. Не забывайте обрабатывать исключения (try/catch) и проверять права доступа текущего пользователя перед выполнением критических операций.

Похожая задача в бизнесе?

Помогу автоматизировать процессы и внедрить ИИ

Меня зовут Андрей Горошко. Я Full-stack разработчик и эксперт по 1С-Битрикс. Настраиваю CRM Битрикс24, разрабатываю защищенные API и создаю умных ИИ-агентов для автоматизации рутины.

Related Post

Получить список служб доставки sale.delivery.getlistПолучить список служб доставки sale.delivery.getlist

Каждый PHP-разработчик, работающий с экосистемой Bitrix Framework, должен глубоко понимать работу её ключевых компонентов. В этой статье мы проведем подробный аудит темы «Получить список служб доставки sale.delivery.getlist», проанализируем лучшие практики

Как использовать метод SDK crm.deal.details.configuration.reset в Битрикс24Как использовать метод SDK crm.deal.details.configuration.reset в Битрикс24

Оптимизация производительности и безопасности — залог успешного проекта на 1С-Битрикс. Данный материал посвящен практическому применению «Как использовать метод SDK crm.deal.details.configuration.reset в Битрикс24». Мы подготовили подробный разбор принципов работы и развернутые

Внедрение Битрикс24 для строительной компании и застройщикаВнедрение Битрикс24 для строительной компании и застройщика

Профессиональная настройка и внедрение Битрикс24 CRM позволяет систематизировать работу отдела продаж, исключить потерю лидов и автоматизировать ключевые бизнес-процессы компании. Услуга «Внедрение Битрикс24 для строительной компании и застройщика» обеспечивает учет этапов