← Все интеграции
Битрикс24 CRM
Фильтрация карточек сделок/смарт процессов по ИНН (реквизитам) связанной компании
Реализовано решение проблемы по фильтрации сущностей по реквизитам ИНН связанной компании
ИНН хранится в связанной с компаниями таблице "Реквизиты", при поиске в списке компаний - есть возможность искать их по значению реквизита ИНН. Но при поиске в списке смарт-процессов или сделок - Битрикс24 из коробки фильтровать не умеет. От бизнеса пришла потребность в данном функционале.
Пример кода
Реализация
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;
}
}