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

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Next »

Запрос

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

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

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

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Token ${API_KEY}" \
  -d '{ "query": "альфа" }' \
  http://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

Unable to render {include} The included page could not be found.

Параметры

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

Ответ

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

 Показать

ПолеОписание
valueКраткое наименование банка (data.name.short). Если краткое наименование не указано — платежное наименование (data.name.payment).
unrestricted_value= value
data.bicБИК
data.swiftSWIFT
data.innИНН (начиная с версии 20.3)
data.kppКПП (начиная с версии 20.3)
data.correspondent_accountКорреспондентский счет
data.registration_numberРегистрационный номер

data.name

└ payment

└ full

└ short

Наименование:

— платежное

— не заполняется

— краткое

data.payment_cityГород для платежного поручения (поля справочника Tnp + Nnp) (начиная с версии 19.7)
data.opfТип кредитной организации
└ type

Код типа

  • BANK — банк
  • BANK_BRANCH — филиал банка
  • NKO — небанковская кредитная организация (НКО)
  • NKO_BRANCH — филиал НКО
  • RKC — расчетно-кассовый центр
  • OTHER — другой
└ fullне заполняется
└ shortне заполняется
data.addressАдрес регистрации
└ value— адрес банка одной строкой (краткий)
Стандартизован, поэтому может отличаться от записанного в справочнике БИК.
└ unrestricted_value— адрес банка одной строкой (полный)
└ data

гранулярный адрес

└ data.source

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

└ data.qc

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

  • 0 — адрес распознан уверенно

  • 1 или 3 — требуется ручная проверка

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

— статус

  • ACTIVE — действующая
  • LIQUIDATING — ликвидируется
  • LIQUIDATED — ликвидирована
data.okpoне заполняется
data.phoneне заполняется
data.rkcне заполняется

Формат даты

Даты регистрации и ликвидации — количество миллисекунд от 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": "Банк",
                    "short": "Б"
                },
                "name": {
                    "payment": "АО \"АЛЬФА-БАНК\"",
                    "full": "АКЦИОНЕРНОЕ ОБЩЕСТВО \"АЛЬФА-БАНК\"",
                    "short": "АЛЬФА-БАНК"
                },
                "bic": "044525593",
                "swift": "ALFARUMMXXX",
                "okpo": "09610444",
                "correspondent_account": "30101810200000000593",
                "registration_number": "1326",
                "rkc": {
                    "opf": {
                        "type": "RKC",
                        "full": "Подразделение расчетн. сети Банка России",
                        "short": "ПРС"
                    },
                    "name": {
                        "payment": "ОПЕРУ МОСКВА",
                        "full": null,
                        "short": null
                    },
                    "bic": "044525000",
                    "swift": null,
                    "okpo": "09201220",
                    "correspondent_account": null,
                    "registration_number": null,
                    "rkc": null,
                    "address": null,
                    "phone": null,
                    "state": {
                        "status": "ACTIVE",
                        "registration_date": 889473600000,
                        "liquidation_date": null
                    }
                },
                "address": null,
                "phone": null,
                "state": {
                    "status": "ACTIVE",
                    "registration_date": 759009600000,
                    "liquidation_date": null
                }
            }
        }
	]
}

Запрос:

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

Ответ:

 Показать
<SuggestResponse>
    <suggestions>
        <value>ВТБ 24 (ПАО)</value>
        <unrestricted_value>ВТБ 24 (ПАО)</unrestricted_value>
        <data>
            <opf>
                <type>BANK</type>
                <full>Банк</full>
                <short>Б</short>
            </opf>
            <name>
                <payment>ВТБ 24 (ПАО)</payment>
                <full>БАНК ВТБ 24 (ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО)</full>
                <short>ВТБ 24 (ПАО)</short>
            </name>
            <bic>044525716</bic>
            <swift>CBGURUMMXXX</swift>
            <okpo>20606880</okpo>
            <correspondent_account>30101810100000000716</correspondent_account>
            <registration_number>1623</registration_number>
            <rkc>
                <opf>
                    <type>RKC</type>
                    <full>Подразделение расчетн. сети Банка России</full>
                    <short>ПРС</short>
                </opf>
                <name>
                    <payment>ОПЕРУ МОСКВА</payment>
                    <full/>
                    <short/>
                </name>
                <bic>044525000</bic>
                <swift/>
                <okpo>09201220</okpo>
                <correspondent_account/>
                <registration_number/>
                <rkc/>
                <address/>
                <phone/>
                <state>
                    <status>ACTIVE</status>
                    <registration_date>889473600000</registration_date>
                    <liquidation_date/>
                </state>
            </rkc>
            <address/>
            <phone/>
            <state>
                <status>ACTIVE</status>
                <registration_date>759009600000</registration_date>
                <liquidation_date/>
            </state>
        </data>
    </suggestions>
</SuggestResponse>
  • No labels