В результате работы сформирован справочник организаций Республики Беларусь с полной нормализованной карточкой контрагента. В выгрузке — ключевые идентификаторы (УНП и наименование с УНП в поле value), даты (регистрации, исключения из ЕГР, последних изменений), статусы и типы организаций.
Для каждой компании приведены полные и краткие наименования, а также торговые названия — на русском и белорусском языках. Для ИП дополнительно выгружаются ФИО на двух языках, для юрлиц — адрес местонахождения одной строкой и основной вид деятельности (код ОКЭД + наименование на русском).
На практике справочник применяют так:
Проверка благонадёжности контрагентов. По статусу (ACTIVE, LIQUIDATED, BANKRUPT и др.) и датам (registration_date, removal_date) быстро отсеивают недействующие, ликвидируемые и банкротящиеся компании.
Сегментация под задачи закупок и продаж. Фильтруют по типу (ИП или юрлицо), по виду деятельности (ОКЭД) и по актуальности данных (actuality_date). Например, можно собрать список только действующих юрлиц по конкретному ОКЭД.
Двуязычная работа и документооборот. Наличие наименований и ФИО на русском и белорусском упрощает подготовку писем, договоров и отчётности, а также коммуникацию с партнёрами в Беларуси.
Импорт в CRM и внутренние реестры. Структура полей позволяет сразу загружать данные в CRM (Битрикс24, amoCRM и др.), формировать реестры поставщиков и вести мониторинг изменений.
Мониторинг динамики. Сравнение выгрузок по дате actuality_date и статусам помогает отслеживать появление новых компаний, ликвидацию, банкротство и реорганизации.
Для решения задачи я реализовал сбор и структурирование данных по организациям Республики Беларусь по ключевым словам с выгрузкой в удобном формате.
Сначала зафиксировал требования к полноте данных: обязательно должны быть УНП, статус, тип (ИП/юрлицо), даты (регистрации, исключения, последних изменений), наименования на русском и белорусском, а для юрлиц — адрес и ОКЭД, для ИП — ФИО. На Python настроил запросы к источнику данных, добавил обработку пагинации и повторных попыток при временных сбоях.
На этапе извлечения сопоставил поля API с требуемой структурой: value (наименование + УНП), data.unp, data.registration_date, data.removal_date, data.actuality_date. Статусы (ACTIVE, LIQUIDATING, LIQUIDATED, BANKRUPT, SUSPENDED, REORGANIZING) привёл к единому набору, чтобы клиент мог сразу фильтровать по статусу. Типы организаций (INDIVIDUAL, LEGAL) сохранил без преобразований — это важно для сегментации (например, отдельно работать с ИП и юрлицами).
Двуязычные поля (data.full_name_ru/by, short_name, trade_name, fio) обрабатывал так, чтобы при наличии данных на обоих языках они попадали в соответствующие колонки, а при отсутствии — явно фиксировалось пустое значение. Для юрлиц отдельно выгружал data.address одной строкой, для всех — data.oked и data.oked_name.
Далее выполнил нормализацию и контроль качества: проверил, что УНП заполнен во всех записях, статусы соответствуют допустимому списку, даты приведены к единому формату. Записи без УНП или с критическими пропусками вынес в отдельный лист «Исключения».
Финальный шаг — экспорт в Excel с тремя листами: «Основная база» (только ACTIVE), «Все статусы» (полная выборка) и «Исключения» (неполные карточки). Названия колонок соответствуют полям справочника, чтобы данные можно было сразу загружать в CRM или использовать для отчётов. Дополнительно подготовил инструкцию по интерпретации статусов и работе с двуязычными полями.
Результат. Готовый справочник организаций Беларуси, который можно сразу применять в работе. В Excel‑файле каждая организация представлена полной карточкой: УНП и статус (сразу видно, действующая ли компания), даты регистрации и последних изменений, тип (ИП или юрлицо). Для юрлиц есть адрес и вид деятельности (ОКЭД), для ИП — ФИО. Все наименования и ФИО приведены на русском и белорусском языках — это удобно для документов и коммуникации.
Как применяют на практике:
Экономия времени и снижение рисков. Не нужно вручную проверять контрагентов: по статусу и датам сразу видно, стоит ли с компанией работать. Это особенно важно для закупок и заключения договоров.
Быстрый подбор партнёров. Можно за несколько минут собрать список подходящих компаний под конкретную задачу: например, только действующие юрлица по нужному ОКЭД или ИП в определённой сфере.
Удобство для документооборота и рассылок. Двуязычные поля позволяют сразу использовать данные для писем, коммерческих предложений и отчётов без дополнительного перевода и ручного ввода.
Прозрачность истории изменений. Даты регистрации, исключения из реестра и последних обновлений помогают понять, насколько «свежая» компания и как часто у неё меняются данные.
Готовность к автоматизации. Файл можно сразу загрузить в CRM или Excel, настроить фильтры и начать работу без доработки. При необходимости базу можно регулярно обновлять и отслеживать динамику рынка.