Page tree
Skip to end of metadata
Go to start of metadata

Запрос

Для пользователей подсказок DaData.ru:

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Token ${API_KEY}" \
  -d '{ "query": "альфа" }' \
  https://suggestions.dadata.ru/suggestions/api/4_1/rs/suggest/bank

Для пользователей standalone-подсказок:

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{ "query": "альфа" }' \
  http://ВАШ_СЕРВЕР:ПОРТ/suggestions/api/4_1/rs/suggest/bank

Заголовки

ЗаголовокОписание
Content-Type

Тип данных в запросе: application/json или application/xml

Accept
Тип данных в ответе: application/json или application/xml
Authorization

API-ключ в формате: Token ВАШ_КЛЮЧ

Только для пользователей подсказок DaData.ru

Параметры

ПараметрОбязательный?Описание
queryдаЗапрос, для которого нужно получить подсказки
count
нет
Количество возвращаемых подсказок (по умолчанию — 10, максимум — 20).
status
нетОграничение по статусу организации
type
нетОграничение по типу организации

Ответ

Возвращается список объектов банка:

 Показать

ПолеОписание
valueНаименование организации одной строкой (как показывается в списке подсказок)
unrestricted_valueНаименование компании одной строкой (полное)
data.opf.typeТип (латинское сокращение)
data.opf.fullПолное наименование типа банковской организации
data.opf.shortСокращенное наименование типа банковской организации
data.name.paymentПлатежное наименование
data.name.fullПолное наименование
data.name.shortКраткое наименование
data.bicБИК
data.swiftSWIFT
data.innИНН (начиная с версии 20.3)
data.kppКПП (начиная с версии 20.3)
data.okpoОКПО
data.correspondent_accountКорреспондентский счет
data.registration_numberРегистрационный номер
data.payment_cityМесто нахождения банка для платежных поручений (начиная с версии 19.7)
data.rkcСсылка на РКЦ. Структура идентична структуре объекта банка
data.address.valueАдрес банка одной строкой, после успешной стандартизации может отличаться от записанного в БИК
data.address.unrestricted_value= data.address.value
data.address.data

Объект адреса (Гранулярный адрес)

└ source

— исходный адрес одной строкой как в БИК

└ qc

— код качества адреса (начиная с версии 19.1)

  • 0 – Адрес распознан уверенно
  • 1 – Остались «лишние» части. 
  • 3 – Есть альтернативные варианты.
data.phoneТелефон
data.state.statusСтатус (активен, в стадии ликцидации, ликвидирован)
data.state.actuality_dateДата актуальности сведений о компании
data.state.registration_dateДата регистрации
data.state.liquidation_dateДата ликвидации

Формат даты

Даты регистрации и ликвидации — количество миллисекунд от 01.01.1970. Хранится в UTC.

Для JavaScript преобразуется в дату так:

var ticks = 989784000000,
    date = new Date(ticks);

Для PHP:

$ticks = 989784000000;
$sec = $ticks / 1000;
echo date("d.m.Y", $sec);

Для Java:

long ticks = 989784000000;
Calendar cal = Calendar.getInstance();
cal.setTimeInMillis(ticks);

Для C#:

long ticks = 989784000000;
DateTime date = new DateTime(long.Parse(ticks));

Примеры

Запрос:

{
  "query": "альфа" 
}

Ответ:

 Показать
{
    "suggestions": [
        {
            "value": "АЛЬФА-БАНК",
            "unrestricted_value": "АЛЬФА-БАНК",
            "data": {
                "opf": {
                    "type": "BANK",
                    "full": null,
                    "short": null
                },
                "name": {
                    "payment": "АО \"АЛЬФА-БАНК\"",
                    "full": null,
                    "short": "АЛЬФА-БАНК"
                },
                "bic": "044525593",
                "swift": "ALFARUMMXXX",
                "inn": "7728168971",
                "kpp": "770801001",
                "okpo": null,
                "correspondent_account": "30101810200000000593",
                "registration_number": "1326",
                "payment_city": "г. Москва",
                "state": {
                    "status": "ACTIVE",
                    "actuality_date": 1583280000000,
                    "registration_date": 662860800000,
                    "liquidation_date": null
                },
                "rkc": null,
                "address": {
                    "value": "г Москва, ул Каланчевская, д 27",
                    "unrestricted_value": "107078, г Москва, Красносельский р-н, ул Каланчевская, д 27",
                    "data": {
					...                    }

                },
                "phones": null
            }
        }
	]
}

Запрос:

<req>
  <query>втб</query>
</req>

Ответ:

 Показать
<SuggestResponse>
    <suggestions>
        <value>ВТБ</value>
        <unrestricted_value>ВТБ</unrestricted_value>
        <data>
            <opf>
                <type>BANK</type>
                <full/>
                <short/>
            </opf>
            <name>
                <payment>БАНК ВТБ (ПАО)</payment>
                <full/>
                <short>ВТБ</short>
            </name>
            <bic>044525187</bic>
            <swift>VTBRRUMMXXX</swift>
            <inn>7710353606</inn>
            <kpp>770801001</kpp>
            <okpo/>
            <correspondent_account>30101810700000000187</correspondent_account>
            <registration_number>1000</registration_number>
            <payment_city>г. Москва</payment_city>
            <state>
                <status>ACTIVE</status>
                <actuality_date>1583280000000</actuality_date>
                <registration_date>656121600000</registration_date>
                <liquidation_date/>
            </state>
            <rkc/>
            <address>
                <value>г Москва, Пресненская наб, д 12</value>
                <unrestricted_value>123112, г Москва, Пресненский р-н, Пресненская наб, д 12</unrestricted_value>
                <data>
                    ...
                </data>
            </address>
            <phones/>
        </data>
    </suggestions>
</SuggestResponse>
  • No labels