# crm.invoice.recurring.add

URL: https://chugunov.pro/api-bitrix24/crm/outdated/invoice/crm-invoice-recurring-add/
Проверено на Битрикс24 REST API, обновлено 11.09.2026 (ревизия источника fb39d6c).
Источник: официальная документация Битрикс24 (bitrix-tools/b24-rest-docs, лицензия MIT, © Bitrix). Справочник независимый, официальной документацией не является.

Добавить настройку для регулярного счета
Scope: `crm`
Кто может выполнять метод: любой пользователь

> Устаревший метод. Развитие метода остановлено. Используйте Универсальные методы для счетов.

## Описание

Метод добавляет новую настройку для регулярного счета.

## Параметры

- `fields` `array` — необязательный. Значения полей для создания настройки регулярного счета.
  Обязательное поле - поле `INVOICE_ID` [ID счета, у которой задан параметр `IS_RECURRING=Y`]. 
  Чтобы узнать требуемый формат полей, выполните метод [crm.invoice.recurring.fields](https://chugunov.pro/api-bitrix24/crm/outdated/invoice/crm-invoice-recurring-fields/) и посмотрите формат пришедших значений этих полей

## Примеры запроса

### cURL (Webhook)

```http
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"fields":{"INVOICE_ID":"10","IS_LIMIT":"N","START_DATE":"'$(date -Iseconds --utc --date='TZ="Europe/Moscow" +1 month')'","PARAMS":{"PERIOD":"day","IS_WORKING_ONLY":"N","INTERVAL":30,"DATE_PAY_BEFORE_OFFSET_TYPE":"month","DATE_PAY_BEFORE_OFFSET_VALUE":1}}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.invoice.recurring.add
```

### cURL (OAuth)

```http
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"fields":{"INVOICE_ID":"10","IS_LIMIT":"N","START_DATE":"'$(date -Iseconds --utc --date='TZ="Europe/Moscow" +1 month')'","PARAMS":{"PERIOD":"day","IS_WORKING_ONLY":"N","INTERVAL":30,"DATE_PAY_BEFORE_OFFSET_TYPE":"month","DATE_PAY_BEFORE_OFFSET_VALUE":1}},"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/crm.invoice.recurring.add
```

### JS

```js
try
{
	const current = new Date();
	const nextMonth = new Date();
	nextMonth.setMonth(current.getMonth() + 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.invoice.recurring.add",
		{
			fields:
			{
				"INVOICE_ID": "10",
				"IS_LIMIT": "N",
				"START_DATE": date2str(nextMonth),
				"PARAMS": {
					"PERIOD": "day",
					"IS_WORKING_ONLY": "N",
					"INTERVAL": 30,
					"DATE_PAY_BEFORE_OFFSET_TYPE": "month",
					"DATE_PAY_BEFORE_OFFSET_VALUE": 1,
				}
			}
		}
	);

	const result = response.getData().result;
	if(result.error())
		console.error(result.error());
	else
		console.info("Добавлены настройки регулярного счета. ID записи - " + result);
}
catch(error)
{
	console.error('Error:', error);
}
```

### PHP

```php
try {
    $current = new DateTime();
    $nextMonth = new DateTime();
    $nextMonth->setDate($current->format('Y'), $current->format('m') + 1, $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.invoice.recurring.add',
            [
                'fields' => [
                    'INVOICE_ID'                 => '10',
                    'IS_LIMIT'                   => 'N',
                    'START_DATE'                 => $date2str($nextMonth),
                    'PARAMS' => [
                        'PERIOD'                     => 'day',
                        'IS_WORKING_ONLY'            => 'N',
                        'INTERVAL'                   => 30,
                        'DATE_PAY_BEFORE_OFFSET_TYPE' => 'month',
                        'DATE_PAY_BEFORE_OFFSET_VALUE' => 1,
                    ],
                ],
            ]
        );

    $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 invoice settings: ' . $e->getMessage();
}
```

### BX24.js

```js
var current = new Date();
var nextMonth = new Date();
nextMonth.setMonth(current.getMonth() + 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.invoice.recurring.add",
    {
        fields:
        {
            "INVOICE_ID": "10",
            "IS_LIMIT": "N",
            "START_DATE": date2str(nextMonth),
            "PARAMS": {
                "PERIOD": "day",
                "IS_WORKING_ONLY": "N",
                "INTERVAL": 30,
                "DATE_PAY_BEFORE_OFFSET_TYPE": "month",
                "DATE_PAY_BEFORE_OFFSET_VALUE": 1,
            }
        }
    },
    function(result)
    {
        if(result.error())
            console.error(result.error());
        else
            console.info("Добавлены настройки регулярного счета. ID записи - " + result.data());
    }
);
```

### PHP CRest

```php
require_once('crest.php');

$current = new DateTime();
$nextMonth = (new DateTime())->modify('+1 month');

function date2str($d) {
    return $d->format('Y-m-d\TH:i:s+03:00');
}

$result = CRest::call(
    'crm.invoice.recurring.add',
    [
        'fields' => [
            'INVOICE_ID' => 10,
            'IS_LIMIT' => 'N',
            'START_DATE' => date2str($nextMonth),
            'PARAMS' => [
                'PERIOD' => 'day',
                'IS_WORKING_ONLY' => 'N',
                'INTERVAL' => 30,
                'DATE_PAY_BEFORE_OFFSET_TYPE' => 'month',
                'DATE_PAY_BEFORE_OFFSET_VALUE' => 1,
            ]
        ]
    ]
);

echo '<PRE>';
print_r($result);
echo '</PRE>';
```

Оригинал в официальной документации: https://apidocs.bitrix24.ru/api-reference/crm/outdated/invoice/crm-invoice-recurring-add.html