Registry Search - Поиск по государственным реестрам

Описание

Процессор Registry Search выполняет поиск информации о компаниях и индивидуальных предпринимателях в государственных реестрах (ЕГРЮЛ/ЕГРИП) по ИНН или ОГРН.

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

Поддерживает как прямой ввод поискового запроса через параметр searchQuery, так и получение данных из цепочки входных процессоров с автоматической подстановкой переменных.

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

• Обогащение базы компаний — массовое получение реквизитов и данных из ЕГРЮЛ по списку ИНН/ОГРН.
• Верификация контрагентов — проверка актуальности данных о компании: статус, адрес, руководитель.
• Финансовый анализ — получение данных о выручке и прибыли для оценки финансового состояния контрагентов.
• Построение цепочек владения — извлечение информации о собственниках компании (физические и юридические лица, доли).
• Сегментация по ОКВЭД — получение основного и дополнительных видов деятельности для классификации компаний.

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

Параметр	Тип	Обязательный	По умолчанию	Описание
searchQuery	string	Нет	—	Поисковый запрос (ИНН или ОГРН). Поддерживает переменные вида {{processorName.field}}. Если не указан, извлекается из payload входного пакета.
maxPackets	number	Нет	50	Максимальное количество входных пакетов, обрабатываемых за один запуск процессора.
includeFinances	boolean	Нет	false	Включать ли финансовую информацию (выручка, прибыль). Для ИП финансовые данные недоступны. Каждый успешный запрос финансов списывает дополнительные токены.
debugMode	boolean	Нет	false	Режим отладки с подробным логированием конфигурации, входных процессоров и промежуточных данных.

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

Процессор получает данные от родительских процессоров через систему DataPackets. Из входных пакетов извлекается поисковый запрос (ИНН или ОГРН) в следующем порядке приоритета:

1. Параметр searchQuery из конфигурации (с подстановкой переменных из chainData).
2. Поле searchQuery из payload входного пакета.
3. Поле query из payload входного пакета.
4. Поле name или title из payload входного пакета.

Если входных процессоров нет, но указан searchQuery, создается виртуальный пакет для обработки. Если нет ни входных данных, ни searchQuery, процессор завершается без ошибки.

Типичные источники входных данных:

• Процессор inn-search — передает найденные ИНН.
• Любой процессор, формирующий список ИНН/ОГРН в выходных пакетах.

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

Каждый успешный результат поиска создает один выходной DataPacket со следующей структурой:

Поле	Тип	Описание
inn	string	ИНН организации или ИП (обязательное поле)
type	string	Тип сущности: company или individual (обязательное поле)
ogrn	string	ОГРН (для юрлиц) или ОГРНИП (для ИП)
kpp	string	КПП (только для юридических лиц)
opf	string	Организационно-правовая форма
registrationDate	string	Дата регистрации
status	string	Текущий статус организации (действующая, ликвидирована и т.д.)
shortName	string	Краткое наименование организации
fullName	string	Полное наименование организации
address	string	Юридический адрес одной строкой
zipCode	string	Почтовый индекс
regionCode	string	Код региона (из адреса или первые 2 цифры ИНН)
mainOkvedCode	string	Код основного ОКВЭД
mainOkvedName	string	Наименование основного ОКВЭД
okveds	string	Дополнительные ОКВЭД через точку с запятой
managerFio	string	ФИО руководителя (для ИП — ФИО предпринимателя)
managerInnfl	string	ИНН физического лица руководителя
managerPosition	string	Должность руководителя
managersOthers	string	JSON-массив остальных руководителей (fio, innfl, position)
managementCompany	string	JSON-объект управляющей компании (name, inn, ogrn, date)
owners	string	JSON-массив собственников (type, name, inn, share)
charterCapital	number	Размер уставного капитала (только для юрлиц)
workersCount	number	Количество работников (за последний доступный год)
lastYearFinResults	number	Год последней финансовой отчетности (при includeFinances: true)
income	number	Выручка в рублях за последний год (при includeFinances: true)
profit	number	Валовая прибыль в рублях за последний год (при includeFinances: true)

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

• searchType: "registry"
• includeFinances: значение из конфигурации
• processedAt: ISO-дата обработки
• processorVersion: "2.0"

Стоимость

Процессор использует систему cost tracking с двумя типами операций:

Операция	Код	Описание
Базовый поиск	basic-search	Списывается за каждый успешный поиск по ИНН/ОГРН
Финансовые данные	finance-search	Списывается дополнительно за каждый успешный запрос финансовой информации (только при includeFinances: true)

Стоимость в токенах определяется таблицей bg_prices. При ошибках API (recoverable) токены не списываются — создается error-пакет.

Примеры

Базовый поиск по ИНН из цепочки

Процессор подключен после inn-search. Поисковый запрос берется автоматически из выходных данных предыдущего процессора:

searchQuery: {{inn-search.inn}}
maxPackets: 100
includeFinances: false

Поиск с финансовой информацией

searchQuery: {{inn-search.inn}}
maxPackets: 50
includeFinances: true
debugMode: false

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

searchQuery: 7707083893
maxPackets: 1
includeFinances: true

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

Процессор	Связь	Описание
inn-search	Входной	Передает найденные ИНН для поиска в реестрах
company-info-v2	Последующий	Расширенная информация о компании с поиском контактов, парсингом сайта и анализом через GPT
contact-search	Последующий	Поиск контактной информации (телефоны, email, сайты) по данным из реестра
gpt-filter	Последующий	Анализ и фильтрация полученных данных через GPT (например, классификация по ОКВЭД)