Есть ли в Bitrix24 REST API оператор OR для фильтров crm.deal.list?

Question

[Андрей Шульц]

Встала задача - необходимо искать сделки с фильтрацией по двум полям. Т.е мне надо найти все результаты, где поле UF_CRM_***1 или UF_CRM_***2 содержит подстроку. Я отправляю следующий массив:

$params = [ 
	'order'	=> [
		'STAGE_ID'	=> 'ASC'
	],
	'filter'	=> [
		[
			'LOGIC' => 'OR',
			'UF_CRM_***1' => trim( $_GET['proposal'] ),
			'UF_CRM_***2' => trim( $_GET['proposal'] )
		]
	],
	'select'	=> [ 'COMPANY_ID', 'STAGE_ID', 'UF_CRM_***'1, 'UF_CRM_***'2, 'DATE_MODIFY' ]
];

но судя по тому, что возвращаются все результаты, фильтр отрабатывает некорректно. Документация достаточно скупа на эту тему, возможно кто то сталкивался уже с таким?

Answer 1

[Роман]

Добрый день!

В rest API такая возможность не реализована, я в подобных случаях использовал пакетный метод batch.

Comments

[Андрей Шульц]

Да, видимо это единственный способ. Документация по batch конечно еще то чудо.

[Роман]

Есть SDK для работы с битриксовым rest api, и там есть метод callBatch, который облегчает задачу.

В таком случае, если взять за основу пример из документации, запрос будет выглядеть следующим образом:

$batchParams = [
    'get_user' => [
        'method' => 'user.get',
        'params' => ['ID' => 1]
    ],
    'get_department' => [
        'method' => 'department.get',
        'params' => [
            "ID" => '$result[get_user][0][ID]'
        ]
    ]
];

CRest::callBatch($batchParams);

Важно отметить, что данный SDK может использоваться как для работы с вебхуками, так и для написания локальных приложения. Нужные параметры задаются в файле settings.php

В случае, если вы используете сторонний http-клиент (guzzle, например), то запрос должен выглядеть так:

use GuzzleHttp\Client;

$Client = new Client(
    'base_uri' => 'https://webhook.url/'
);

$batch = [
    'cmd' => [
        'get_user' => 'user.get?' . http_build_query(['ID' => 1]),
        'get_department' => 'department.get?' . http_build_query(["ID" => '$result[get_user][0][ID]'])
    ]
];

$request = $Client->post('batch', [
    'headers' => [
        'Content-Type' => 'applicaiton/json'
    ],
    'body' => json_encode($batch, JSON_UNESCAPED_UNICODE)
]);

$response = json_decode($request->getBody());

Обратите внимание, при использовании в Batch результатов предыдущего запроса, необходимо ключ параметра писать в двойных скобках, а значение в одинарных. Кавычки в ключах массива в значении не используются:

"ID" => '$result[get_user][0][ID]'

[Андрей Шульц]

Роман Гонюков, в моем случае я потратил кучу времени, чтобы понять, как фильтрация сделок происходит. В мануалах об этом не пишут. Пример ниже как раз для фильтрации.

Answer 2

[Андрей Шульц]

Поскольку документация не особо помогает составить запрос, выложу тут решение.

$params = [
	'cmd' => [
        'kp_num' => 'crm.deal.list?' . http_build_query(
			[
				'filter'	=>  [
					'UF_CRM_***' => '111',
				],
				'select'	=> [
					'ID',
					'COMPANY_ID',
					'STAGE_ID',
					'UF_CRM_***',
					'DATE_MODIFY'
				]
			]
		),
        'ord_num' => 'crm.deal.list?' . http_build_query(
			[
				'filter'	=>  [
					'UF_CRM_***' => '222',
				],
				'select'	=> [
					'ID',
					'COMPANY_ID',
					'STAGE_ID',
					'UF_CRM_***,
					'DATE_MODIFY'
				]
			]
		),
	]
];