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 5 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Наименование организации одной строкой (как показывается в списке подсказок)
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": "Банк",
                    "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": {
                        "value": "115035, МОСКВА 35, УЛ.БАЛЧУГ,2",
                        "unrestricted_value": "115035, МОСКВА 35, УЛ.БАЛЧУГ,2",
                        "data": null
                    },
                    "phone": null,
                    "state": {
                        "status": "ACTIVE",
                        "actuality_date": 1453939200000,
                        "registration_date": 889488000000,
                        "liquidation_date": null
                    }
                },
                "address": {
                    "value": "г Москва, ул Каланчевская, д 27",
                    "unrestricted_value": "г Москва, ул Каланчевская, д 27",
                    "data": {
					...
                    }
                },
                "phone": null,
                "state": {
                    "status": "ACTIVE",
                    "actuality_date": 1453939200000,
                    "registration_date": 759024000000,
                    "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>
                    <value>115035, МОСКВА 35, УЛ.БАЛЧУГ,2</value>
                    <unrestricted_value>115035, МОСКВА 35, УЛ.БАЛЧУГ,2</unrestricted_value>
                    <data/>
                </address>
                <phone/>
                <state>
                    <status>ACTIVE</status>
                    <actuality_date>1453939200000</actuality_date>
                    <registration_date>889488000000</registration_date>
                    <liquidation_date/>
                </state>
            </rkc>
            <address>
                <value>г Москва, ул Мясницкая, д 35</value>
                <unrestricted_value>г Москва, ул Мясницкая, д 35</unrestricted_value>
                <data>
				...
                </data>
            </address>
            <phone/>
            <state>
                <status>ACTIVE</status>
                <actuality_date>1453939200000</actuality_date>
                <registration_date>759024000000</registration_date>
                <liquidation_date/>
            </state>
        </data>
    </suggestions>
</SuggestResponse>
  • No labels