Эффективная интеграция и кастомизация функционала в Битрикс24 часто требует работы на уровне API. Сегодня мы подробно рассмотрим «Создать новую регулярную сделку crm.deal.recurring.add». Вы узнаете экспертные методики работы с crm.deal.recurring.add и научитесь избегать типичных ошибок начинающих разработчиков.

Создать новую регулярную сделку crm.deal.recurring.add

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

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

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

Метод crm.deal.recurring.add добавляет новую настройку для регулярной сделки.

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

• JS

    try
    {
    	const current = new Date();
    	const nextMonth = new Date();
    	const nextYear = new Date();
    	nextMonth.setMonth(current.getMonth() + 1);
    	nextYear.setFullYear(current.getFullYear() + 1);
    
    	const date2str = function(d)
    	{
    		return d.getFullYear() + '-' + paddatepart(1 + d.getMonth()) + '-' + paddatepart(d.getDate()) + 'T' + paddatepart(d.getHours()) + ':' + paddatepart(d.getMinutes()) + ':' + paddatepart(d.getSeconds()) + '+03:00';
    	};
    
    	const paddatepart = function(part)
    	{
    		return part >= 10 ? part.toString() : '0' + part.toString();
    	};
    
    	const response = await $b24.callMethod(
    		"crm.deal.recurring.add",
    		{
    			fields:
    			{
    				"DEAL_ID": "45",
    				"CATEGORY_ID": "1",
    				"IS_LIMIT": "D",
    				"LIMIT_DATE": date2str(nextYear),
    				"START_DATE": date2str(nextMonth),
    				"PARAMS": {
    					"MODE": "multiple",
    					"MULTIPLE_TYPE": "month",
    					"MULTIPLE_INTERVAL": 1,
    					"OFFSET_BEGINDATE_TYPE": "day",
    					"OFFSET_BEGINDATE_VALUE": 1,
    					"OFFSET_CLOSEDATE_TYPE": "month",
    					"OFFSET_CLOSEDATE_VALUE": 2,
    				}
    			}
    		}
    	);
    
    	const result = response.getData().result;
    	console.info("Добавлены настройки регулярной сделки. ID записи - " + result);
    }
    catch(error)
    {
    	console.error(error);
    }

• PHP

    try {
        $current = new DateTime();
        $nextMonth = new DateTime();
        $nextYear = new DateTime();
        $nextMonth->setDate($current->format('Y'), $current->format('m') + 1, $current->format('d'));
        $nextYear->setDate($current->format('Y') + 1, $current->format('m'), $current->format('d'));
    
        $date2str = function($d) {
            return $d->format('Y-m-d\TH:i:sP');
        };
    
        $paddatepart = function($part) {
            return $part >= 10 ? $part : '0' . $part;
        };
    
        $response = $b24Service
            ->core
            ->call(
                'crm.deal.recurring.add',
                [
                    'fields' => [
                        'DEAL_ID'               => '45',
                        'CATEGORY_ID'           => '1',
                        'IS_LIMIT'              => 'D',
                        'LIMIT_DATE'            => date2str($nextYear),
                        'START_DATE'            => date2str($nextMonth),
                        'PARAMS'                => [
                            'MODE'                    => 'multiple',
                            'MULTIPLE_TYPE'           => 'month',
                            'MULTIPLE_INTERVAL'       => 1,
                            'OFFSET_BEGINDATE_TYPE'   => 'day',
                            'OFFSET_BEGINDATE_VALUE'  => 1,
                            'OFFSET_CLOSEDATE_TYPE'   => 'month',
                            'OFFSET_CLOSEDATE_VALUE'  => 2,
                        ],
                    ],
                ]
            );
    
        $result = $response
            ->getResponseData()
            ->getResult();
    
        if ($result->error()) {
            error_log($result->error());
            echo 'Error: ' . $result->error();
        } else {
            echo 'Success: Добавлены настройки регулярной сделки. ID записи - ' . $result->data();
        }
    
    } catch (Throwable $e) {
        error_log($e->getMessage());
        echo 'Error adding recurring deal settings: ' . $e->getMessage();
    }

• BX24.js

    var current = new Date();
    var nextMonth = new Date();
    var nextYear = new Date();
    nextMonth.setMonth(current.getMonth() + 1);
    nextYear.setYear(current.getFullYear() + 1);
    var date2str = function(d)
    {
        return d.getFullYear() + '-' + paddatepart(1 + d.getMonth()) + '-' + paddatepart(d.getDate()) + 'T' + paddatepart(d.getHours()) + ':' + paddatepart(d.getMinutes()) + ':' + paddatepart(d.getSeconds()) + '+03:00';
    };
    var paddatepart = function(part)
    {
        return part >= 10 ? part.toString() : '0' + part.toString();
    };
    BX24.callMethod(
        "crm.deal.recurring.add",
        {
            fields:
            {
                "DEAL_ID": "45",
                "CATEGORY_ID": "1",
                "IS_LIMIT": "D",
                "LIMIT_DATE": date2str(nextYear),
                "START_DATE": date2str(nextMonth),
                "PARAMS": {
                    "MODE": "multiple",
                    "MULTIPLE_TYPE": "month",
                    "MULTIPLE_INTERVAL": 1,
                    "OFFSET_BEGINDATE_TYPE": "day",
                    "OFFSET_BEGINDATE_VALUE": 1,
                    "OFFSET_CLOSEDATE_TYPE": "month",
                    "OFFSET_CLOSEDATE_VALUE": 2,
                }
            }
        },
        function(result)
        {
            if(result.error())
                console.error(result.error());
            else
                console.info("Добавлены настройки регулярной сделки. ID записи - " + result.data());
        }
    );