Подсказки: банки

Ищет кредитные организации:

по БИК,
SWIFT,
ИНН,
ИНН + КПП,
названию,
адресу до улицы.

Что умеет

✔️ Фильтрует по типу: банки, НКО и филиалы.

✔️ Фильтрует по региону или городу.

✔️ Умеет искать как действующие банки, так и банки на ликвидации.

✔️ Учитывает, где вы находитесь (геолокация до города).

Как подключить

Вставьте код из примера на свой сайт.
Profit!

<input id="bank" name="bank" type="text" />
<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.6.0/jquery.min.js"></script>
<link href="http://cdn.jsdelivr.net/npm/suggestions-jquery@22.6.0/dist/css/suggestions.min.css" rel="stylesheet" />
<script src="http://cdn.jsdelivr.net/npm/suggestions-jquery@22.6.0/dist/js/jquery.suggestions.min.js"></script>

<script>
    $("#bank").suggestions({
        token: "${API_KEY}",
        type: "BANK",
        /* Вызывается, когда пользователь выбирает одну из подсказок */
        onSelect: function(suggestion) {
            console.log(suggestion);
        }
    });
</script>

Параметр token — это API-ключ.

Демонстрация

Выберите вариант из списка, чтобы увидеть полный текст ответа в JSON:

Название, БИК, SWIFT или ИНН банка

Также работает через API

Что в ответе

Аргумент suggestion функции onSelect выглядит так:

Название	Описание
value	Наименование банка
unrestricted_value	= value

data.bic	Банковский идентификационный код (БИК) ЦБ РФ
data.swift	Банковский идентификационный код в системе SWIFT
data.inn	ИНН
data.kpp	КПП
data.registration_number	Регистрационный номер в ЦБ РФ
data.correspondent_account	Корреспондентский счет в ЦБ РФ
data.treasury_accounts	Казначейские счета (для УФК)

data.name	Наименование
└ payment	— платежное наименование
└ full	— не заполняется
└ short	— краткое наименование

data.payment_city	Город для платежного поручения (поля справочника Tnp + Nnp).

data.opf	Тип кредитной организации
└ type	— код типа: BANK — банк BANK_BRANCH — филиал банка NKO — небанковская кредитная организация (НКО) NKO_BRANCH — филиал НКО RKC — расчетно-кассовый центр CBR - управление ЦБ РФ (март 2021) TREASURY - управление Казначейства (март 2021) OTHER — другой
└ full	— не заполняется
└ short	— не заполняется

data.cbr	Управление ЦБ РФ, к которому относится банк
└ name.payment	— наименование управления ЦБ РФ
└ bic	— БИК управления ЦБ РФ
└ address.value	— адрес управления ЦБ РФ

data.address	Адрес регистрации
└ value	— адрес одной строкой стандартизован, поэтому может отличаться от записанного в справочнике БИК.
└ unrestricted_value	— адрес одной строкой (полный, с индексом) стандартизован, поэтому может отличаться от записанного в справочнике БИК.
└ data	— гранулярный адрес
└ data.source	— адрес одной строкой как в справочнике БИК
└ data.qc	— код проверки адреса 0 — адрес распознан уверенно 1 или 3 — требуется ручная проверка

data.state	Состояние
└ actuality_date	— дата актуальности сведений
└ registration_date	— дата регистрации
└ liquidation_date	— дата ликвидации
└ status	— статус организации ACTIVE — действующая LIQUIDATING — ликвидируется LIQUIDATED — ликвидирована

data.okpo	Не заполняется
data.phone	Не заполняется
data.rkc	Не заполняется

Источники данных:

Справочник БИК Банка России
Справочник по кредитным организациям

Примеры настройки

Заполнить реквизиты банка: наименование, БИК, SWIFT, корр. счет, адрес

Подсказывать только головные банки, без филиалов

Отфильтровать банки по городу

Ограничения

На бесплатном тарифе плагин подсказок показывает логотип «Дадаты» в углу выпадающего списка. На платных тарифах и в «коробке» логотипа нет.

Количество запросов в день — в соответствии с тарифным планом.

Длина запроса — не более 300 символов.

Количество условий (параметр locations) — не более 10.

Частые вопросы

Почему не находится банк? Я точно знаю, он должен быть

Скорее всего, он ликвидирован. «Дадата» не подсказывает большинство ликвидированных банков, потому что их нет в справочнике Банка России.

Как часто обновляется справочник банков?

Каждый день. Мы берем его с сайта Банка России.

Подсказки не работают: ошибка 403 Forbidden (Feature SUGGESTIONS disabled for token)

Возможные причины:

В запросе указан неправильный API-ключ. Проверьте в личном кабинете
Исчерпан лимит запросов на день. Проверьте в личном кабинете
Не подтверждён адрес эл. почты. Проверьте в личном кабинете

Что будет, если превысить 10 000 бесплатных запросов в день?

Подсказки перестанут подсказывать. До начала нового дня, затем снова заработают.

10 000 запросов считаются суммарно по всем видам подсказок: адреса, ФИО, организации, банки, емейлы...

Стоимость

Бесплатно до 10 тысяч запросов в день. Больше — в составе годовой подписки.