← Все интеграции Битрикс24 CRM

Фильтрация карточек сделок/смарт процессов по ИНН (реквизитам) связанной компании

Реализовано решение проблемы по фильтрации сущностей по реквизитам ИНН связанной компании

ИНН хранится в связанной с компаниями таблице "Реквизиты", при поиске в списке компаний - есть возможность искать их по значению реквизита ИНН. Но при поиске в списке смарт-процессов или сделок - Битрикс24 из коробки фильтровать не умеет. От бизнеса пришла потребность в данном функционале.

Пример кода

Реализация

PHP
namespace Master\CrmOverride\Crm\Filter;

use Bitrix\Crm\Filter\EntitySettings;
use Bitrix\Crm\Filter\Field;
use Bitrix\Crm\RequisiteTable;
use Bitrix\Main\Filter\DataProvider;
use CCrmOwnerType;

/**
 * Поле фильтра "Реквизит: ИНН" для сделок и смартов.
 *
 * prepareFields() - показывает поле в UI.
 * applyInnFromRequest() - ИНН → ID компаний → @COMPANY_ID,
 * вызывается из ItemDataProvider / DealDataProvider при сборке фильтра списка.
 */
class CompanyRequisiteDataProvider extends DataProvider
{
	public const FIELD_INN = 'COMPANY_RQ_INN';

	protected EntitySettings $settings;

	public function __construct(EntitySettings $settings)
	{
		$this->settings = $settings;
	}

	public function getSettings(): EntitySettings
	{
		return $this->settings;
	}

	/**
	 * @return Field[]
	 */
	public function prepareFields(): array
	{
		$field = $this->createField(self::FIELD_INN, [
			'type' => 'string',
			'name' => 'Реквизит: ИНН',
		]);

		$field->setSectionId(CCrmOwnerType::CompanyName);
		$field->markAsDefault(false);
		$field->setIconParams([
			'url' => '/bitrix/images/crm/grid_icons/company.svg',
			'title' => 'Компания',
		]);

		return [
			self::FIELD_INN => $field,
		];
	}

	public function prepareFieldData($fieldID): ?array
	{
		return null;
	}

	/**
	 * Читает ИНН из $source и пишет условие по COMPANY_ID в $filter.
	 */
	public static function applyInnFromRequest(array &$filter, array $source): void
	{
		if (!array_key_exists(self::FIELD_INN, $source))
		{
			return;
		}

		$inn = trim((string)$source[self::FIELD_INN]);
		unset($filter[self::FIELD_INN]);

		if ($inn === '')
		{
			return;
		}

		$companyIds = self::findCompanyIdsByInn($inn);

		if ($companyIds === [])
		{
			$filter['=COMPANY_ID'] = 0;

			return;
		}

		$filter['@COMPANY_ID'] = $companyIds;
	}

	/**
	 * @return int[]
	 */
	protected static function findCompanyIdsByInn(string $inn): array
	{
		$rows = RequisiteTable::getList([
			'select' => ['ENTITY_ID'],
			'filter' => [
				'=ENTITY_TYPE_ID' => CCrmOwnerType::Company,
				'%RQ_INN' => $inn,
			],
			'limit' => 500,
		]);

		$ids = [];
		while ($row = $rows->fetch())
		{
			$id = (int)$row['ENTITY_ID'];
			if ($id > 0)
			{
				$ids[$id] = $id;
			}
		}

		return array_values($ids);
	}

	protected function createField($fieldID, array $params = null): Field
	{
		return new Field($this, $fieldID, $params);
	}
}

//

/**
 * Обёртка над штатным DealDataProvider (список и воронка сделок).
 *
 * Важно: crm.deal.list и канбан НЕ вызывают prepareFilterValue.
 * Они прогоняют фильтр через applyActivityFastSearchFilter
 * (внутри applySubQueryBasedFilters) — там и применяем ИНН.
 */
class DealDataProvider extends \Bitrix\Crm\Filter\DealDataProvider
{
	/**
	 * Вызывается и в списке сделок, и в канбане до финальной выборки.
	 * Сюда доходит сырой COMPANY_RQ_INN из UI.
	 */
	public function applyActivityFastSearchFilter(int $entityTypeId, array &$filterFields): void
	{
		parent::applyActivityFastSearchFilter($entityTypeId, $filterFields);
		CompanyRequisiteDataProvider::applyInnFromRequest($filterFields, $filterFields);
	}

	/**
	 * Запасной путь, если где-то используется Filter::getValue.
	 */
	public function prepareFilterValue(array $rawFilterValue): array
	{
		$result = parent::prepareFilterValue($rawFilterValue);
		CompanyRequisiteDataProvider::applyInnFromRequest($result, $result);

		return $result;
	}
}

// 

/**
 * Обёртка над штатным ItemDataProvider (список смарт-процесса).
 * ИНН применяем здесь: список смарта всегда вызывает prepareListFilter у этого провайдера.
 */
class ItemDataProvider extends \Bitrix\Crm\Filter\ItemDataProvider
{
	public function prepareListFilter(array &$filter, array $requestFilter): void
	{
		parent::prepareListFilter($filter, $requestFilter);
		CompanyRequisiteDataProvider::applyInnFromRequest($filter, $requestFilter);
	}

	public function prepareFilterValue(array $rawFilterValue): array
	{
		$result = parent::prepareFilterValue($rawFilterValue);
		CompanyRequisiteDataProvider::applyInnFromRequest($result, $result);

		return $result;
	}
}