INN Search - Поиск ИНН организации

Описание

Процессор INN Search выполняет поиск ИНН (идентификационного номера налогоплательщика) организации по набору косвенных реквизитов: названию компании, адресу, веб-сайту или дополнительной информации. Использует INN Lookup Service для интеллектуального сопоставления данных.

Процессор не может быть первым в pipeline — он обязательно требует входных данных от родительских процессоров. Все параметры конфигурации поддерживают подстановку переменных из цепочки данных (chainData), что позволяет передавать значения из предыдущих процессоров.

Результат поиска включает найденный ИНН, наименование компании, уровень уверенности (confidence) от 0 до 100% и список альтернативных ИНН-кандидатов, если однозначное определение невозможно.

Сценарии использования

• Идентификация компаний по названию — поиск ИНН, когда известно только название организации.
• Привязка веб-сайтов к юрлицам — определение ИНН компании по доменному имени её сайта.
• Обогащение CRM-данных — массовый поиск ИНН для записей в CRM, где есть только название и/или адрес.
• Предварительная идентификация перед поиском в реестрах — первый шаг в pipeline для последующего обогащения через registry-search.

Конфигурация

Параметр	Тип	Обязательный	По умолчанию	Описание
companyName	string	Нет	—	Название компании. Поддерживает переменные: {{processorName.field}}.
address	string	Нет	—	Адрес компании. Поддерживает переменные.
website	string	Нет	—	Веб-сайт компании (URL или домен). Поддерживает переменные.
anotherInfo	string	Нет	—	Дополнительная информация для уточнения поиска. Поддерживает переменные.
maxPackets	number	Нет	50	Максимальное количество входных пакетов для обработки за один запуск.

Хотя бы один из параметров (companyName, address, website, anotherInfo) должен содержать непустое значение после подстановки переменных. Если все параметры пустые, создается пакет с пустым результатом без списания токенов.

Входные данные

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

Из входных пакетов через систему chainData извлекаются значения для подстановки в параметры конфигурации. Например, если предыдущий процессор (yandex-search) выдает пакеты с полями title и domain, их можно использовать:

companyName: {{yandex-search.title}}
website: {{yandex-search.domain}}

Выходные данные

Каждый обработанный входной пакет создает один выходной DataPacket:

Поле	Тип	Описание
inn	string	Найденный ИНН (10 или 12 цифр). Пустая строка, если ИНН не найден.
name	string	Наименование компании, соответствующее найденному ИНН.
confidence	number	Уровень уверенности в результате от 0 до 100. Значение 100 означает однозначное определение, ниже 50 — наличие конкурирующих кандидатов.
inn_variants	string[]	Массив альтернативных ИНН-кандидатов (близких по рейтингу к основному результату). Пустой массив при однозначном определении.

Метаданные пакета:

• searchType: "inn_search"
• processedAt: ISO-дата обработки
• processorVersion: "1.0.0"

Интерпретация уровня уверенности

Confidence	Значение
100	Найден единственный ИНН-кандидат, однозначное определение
50	Есть один близкий конкурент
40	Есть два близких конкурента
30	Есть три близких конкурента
10	Минимальное значение при наличии множества конкурентов
0	ИНН не найден

Стоимость

Операция	Код	Описание
Поиск ИНН	inn	Списывается только при успешном нахождении ИНН (непустое значение в поле inn). Если ИНН не найден, токены не списываются.

Примеры

Поиск ИНН по названию компании из предыдущего процессора

companyName: {{yandex-search.title}}
website: {{yandex-search.domain}}
maxPackets: 50

Поиск ИНН с указанием всех параметров

companyName: {{data-source.companyName}}
address: {{data-source.address}}
website: {{data-source.website}}
anotherInfo: {{data-source.description}}
maxPackets: 100

Поиск ИНН только по сайту

companyName:
address:
website: {{site-crawl.domain}}
anotherInfo:
maxPackets: 30

Связанные процессоры

Процессор	Связь	Описание
yandex-search	Входной	Передает найденные сайты и названия компаний из поисковой выдачи
site-crawl	Входной	Передает данные с веб-страниц, включая домен и содержимое
registry-search	Последующий	Получает найденный ИНН и выполняет поиск полных данных в ЕГРЮЛ/ЕГРИП
company-info-v2	Последующий	Получает ИНН для расширенного поиска информации о компании с контактами