Получение информации о банке по БИК/СВИФТ

Команда fetch/bank позволяет получить дополнительную информацию о банке, имеющуюся в справочнике БИК и Книге государственной регистрации кредитных организаций ЦБ РФ. К такой информации, например, относятся сведения о корреспондентских счетах, СВИФТ, БИК и ОГРН коды, статус банка в рамках платёжной системы ЦБ РФ, а также наличие ограничений, наложенных регулятором.

Запросить эти сведения можно, если банк ранее был найден в режиме подсказок посредством API-команды suggest/bank, либо через наш JavaScript модуль подсказок ahunter_suggest.js. В таких случаях сервис возвращает уникальную сигнатуру банка sign, по которой можно запросить дополнительную информацию о нём с помощью команды fetch/bank.

Также данная команда может использоваться независимо от подсказок, если просто требуется получить сведения о банке по её БИК или СВИФТ коду.

Использование в связке с подсказками по банкам

Использование данной команды совместно с подсказками подразумевает следующий сценарий. Пользователь вводит информацию о банке в некоторой форме в вашем приложении или на сайте. В процессе этого ввода ему предлагаются подсказки, из которых он может выбрать подходящий банк.

Каждая подсказка, возвращаемая сервисом, кроме непосредственно подсказываемого банка снабжается уникальной сигнатурой sign, которая не отображается пользователю, но при этом доступна вашему сайту или приложению. Когда пользователь выбирает подходящую подсказку, приложение или сайт может запоминать соответствующую данной подсказке сигнатуру и использовать её в команде fetch/bank для получения от сервиса полного комплекта сведений о выбранном банке.

Приведённая ниже форма демонстрирует данный сценарий.

Выбранный банк

Нужно выбрать банк в подсказках и нажать Enter, чтобы здесь появились его реквизиты

Для отображения подсказок здесь используется наш JavaScript модуль ahunter_suggest.js. В данном модуле есть встроенная поддержка команды fetch/bank, поэтому здесь достаточно реализовать колбэк on_fetch, который будет принимать результат выполнения данной команды, после того, как пользователь выберет подсказку с подходящим банком. Ниже показан пример такой реализации.

//настраиваем модуль подсказок для работы с нашим сервисом
var options = 
{ 
  //идентификатор поля, куда вводится банк
  id : "js-BankField",
    
  //колбэк при получении полных данных о банке
  on_fetch : function( Suggestion, Bank )
  {
    ...
    //выводим описатель Bank на экран
    alert( JSON.stringify( Bank ) );
    ...
  }
};

//запускаем модуль 
AhunterSuggest.Bank.Solid( options );

Здесь полагается, что на форме есть текстовое поле с идентификатором js-BankField, куда будет вводиться информация о банке. Наш модуль настраивается так, чтобы отслеживать пользовательский ввод в этом поле и отображать подходящие подсказки. Более подробно об использовании подсказок для банков можно посмотреть по следующей ссылке suggest/bank.

Когда пользователь выбирает подходящую подсказку, наш модуль автоматически отсылает Ахантеру запрос fetch/bank, после чего вызывает подготовленный нами колбэк on_fetch. Ему в качестве аргумента передаётся выбранная подсказка Suggestion и полный описатель банка Bank, полученный в качестве результата работы команды fetch/bank. В нашем примере мы берём информацию из этого описателя и просто выводим её на экран. Чтобы не усложнять пример, здесь отображается только небольшая часть сведений о банке.

Пример простого запроса

Приведенный ниже запрос отсылает сервису сигнатуру 044525225, которая соответствует банку ПАО СБЕРБАНК. При этом используется минимальное количество параметров и опций.

https://ahunter.ru/site/fetch/bank?output=json;query=044525225

В данном запросе используются следующие параметры.

  • output=json - сообщает сервису о том, что необходимо вернуть ответ в формате JSON.
  • query=044525225 - сигнатура запрашиваемого банка. Поскольку сигнатура может содержать символы кириллицы, перед отправкой запроса необходимо закодировать её с использованием URL-encoding.

Рассмотрим более подробно все параметры, которые сервис может получать в рамках данной команды.

Параметры команды

Обязательные параметры для выполнения запроса

  • https://ahunter.ru/site/fetch/bank - URL-команды.
  • output=json или output=xml - формат, в котором требуется вернуть результат выполнения команды.
  • query=строка с сигнатурой - строка запроса, содержащая сигнатуру запрашиваемого банка. Вместо сигнатуры в рамках query можно передавать БИК или СВИФТ код запрашиваемого банка.

Опциональные параметры

  • user=API-токен - опциональный API-токен пользователя из личного кабинета. Данный параметр не является обязательным. Его следует использовать в случае, если по запрашиваемому банку нужно получить расширенную информацию, например, стандартизованный почтовый адрес, коды СВИФТ или перечень ограничений, наложенных на счета банка регулятором. Обработка такого запроса будет выполняться платно, поэтому сервис будет списывать со счёта аккаунта стоимость выполнения данной команды согласно цене, указанной в Профиле личного кабинета.

    Если при отправке запроса не указывать данный параметр, то обработка будет выполняться бесплатно, однако по запрошенному банку сервис будет возвращать не все доступные сведения.

    Данный параметр не следует использовать, если вы отсылаете ajax-запросы непосредственно из браузера с веб-страницы, публично доступной любому посетителю вашего веб-сайта. Поскольку в этом случае ваш API-токен может стать известен третьим лицам. Чтобы этого избежать, следует организовать отсылку этих запросов либо с backend-а вашего веб-сайта, либо с закрытой части веб-сайта, доступной, например, только вашим сотрудникам, выполняющим обработку заказов.

  • output=cfulladdr - опция сообщает сервису, чтобы он вернул полный комплект сведений о стандартизованном адресе банка, включая коды этого адреса по справочникам, географические координаты, часовую зону и прочие сведения, которые сервис обычно возвращает при стандартизации почтовых адресов и при получении адреса с помощью команды fetch/address.
  • output=pretty - опция требует, чтобы сервис выполнил "красивое" форматирование возвращаемого JSON или XML текста, расставив в нем переносы строк и отступы. Опция может быть полезна при отладке взаимодействия пользовательского приложения с сервисом.

Пример запроса с дополнительными опциями

Приведенный ниже запрос отсылает сервису сигнатуру 044525225, которая соответствует банку ПАО СБЕРБАНК с дополнительными параметрами.

https://ahunter.ru/site/fetch/bank?user=demotoken;output=json|pretty|cfulladdr;query=044525225

В данном запросе используются следующие параметры.

  • user=demotoken – сообщает сервису API-токен пользователя, поэтому в данном случае полагается, что запрос выполняется платно, так что после его выполнения с баланса будет списана его стоимость.
  • output=json|pretty|cfulladdr - сообщает сервису о том, что необходимо вернуть ответ в формате JSON, отформатировав его "красиво". Также здесь требуется, что сервис вернул блок с полной информацией о стандартизованном адресе.
  • query=044525225 - сигнатура запрашиваемого банка.

Результат запроса в формате JSON

Ниже приведен пример ответа сервиса с результатом обработки сигнатуры 044030653, которая соответствует банку СЕВЕРО-ЗАПАДНЫЙ БАНК ПАО СБЕРБАНК. Результирующий JSON-ответ получен с использованием опции output=json|pretty, позволяющей выполнить "красивое" форматирование JSON-текста.

{
  "bank" : {
    "accounts" : [
      {
        "cbr_bic" : "044030001",
        "control_key" : "36",
        "date_in" : "1997-12-31",
        "date_out" : "",
        "number" : "30101810500000000653",
        "regulation_type" : "CRSA",
        "status" : "ACAC"
      }
    ],
    "address" : {
      "canonic" : "г Санкт-Петербург, ул Красного Текстильщика, д.2",
      "name_precise" : true,
      "nums_precise" : true,
      "sign" : "78s610hдом:2",
      "source" : "г Санкт-Петербург, ул Кр.Текстильщика, 2"
    },
    "codes" : {
      "exchange_type" : "1",
      "participant_status" : "PSAC",
      "participant_type" : "30",
      "registration_num" : "1481\/1309",
      "services" : "3",
      "uid" : 4030653000
    },
    "main" : {
      "bic" : "044030653",
      "date_in" : "1994-01-20",
      "date_out" : "",
      "full_name" : "СЕВЕРО-ЗАПАДНЫЙ БАНК ПАО СБЕРБАНК",
      "is_restricted" : false,
      "lat_name" : "SBERBANK (SEVERO-ZAPADNY HEAD OFFICE)",
      "ogrn" : "1027700132195",
      "parent_bic" : "044525225",
      "restriction_date" : "",
      "short_name" : "СЕВЕРО-ЗАПАДНЫЙ БАНК ПАО СБЕРБАНК"
    },
    "swifts" : [
      {
        "code" : "SABRRU2P",
        "is_default" : true
      }
    ]
  },
  "query" : "044030653",
  "request_process_time" : 15
}

Результатом получения описателя банка является JSON-объект со следующими элементами.

  • bank – объект, содержащий информацию о запрошенном банке. Если в запросе будет указана некорректная сигнатура, либо сигнатура не существующего банка, то в ответе сервиса не будет содержаться данный объект.
  • query – исходный запрос, полученный и обработанный сервисом.
  • request_process_time – время обработки всего запроса в целом в миллисекундах.

Ниже приведено детальное описание этих элементов.

JSON-объект bank: информация о банке

Данный объект содержит всю информацию о запрошенном банке, которой располагает Ахантер. Данный объект содержит следующие дочерние элементы:

  • bank.main - основные сведения о банке, его полное и краткое название, ОГРН, БИК и прочие реквизиты.
  • bank.codes - справочные коды банка в рамках платёжной системы ЦБ РФ. Здесь же указывается регистрационный номер банка в Книге государственной регистрации кредитных организаций, а также код УИС.
  • bank.address - информация о почтовом адресе банка.
  • bank.restrictions - перечень ограничений, наложенных на сам банк регулятором. Данный элемент может быть опущен, если у данного банка нет наложенных ограничений.
  • bank.accounts - перечень корреспондентских счетов банка. Данный элемент может быть опущен, если у запрашиваемого банка нет корреспондентских счетов.
  • bank.swifts - перечень СВИФТ кодов банка. Данный элемент может быть опущен, если у запрашиваемого банка нет СВИФТ кодов.

JSON-объект bank.main: основные сведения и реквизиты банка

Элементы данного объекта позволяют получить основную информацию о банке, такую как реквизиты, название и текущее состояние. Пример JSON-объекта bank.main показан ниже.

{
  "bic" : "044030653",
  "date_in" : "1994-01-20",
  "date_out" : "",
  "full_name" : "СЕВЕРО-ЗАПАДНЫЙ БАНК ПАО СБЕРБАНК",
  "is_restricted" : false,
  "lat_name" : "SBERBANK (SEVERO-ZAPADNY HEAD OFFICE)",
  "ogrn" : "1027700132195",
  "parent_bic" : "044525225",
  "restriction_date" : "",
  "short_name" : "СЕВЕРО-ЗАПАДНЫЙ БАНК ПАО СБЕРБАНК"
}

Объект содержит следующие элементы.

  • full_name - полное название банка.
  • short_name - краткое название банка.
  • lat_name - название банка латинскими буквами.
  • ogrn - основной государственный регистрационный номер банка - ОГРН.
  • bic - БИК код банка.
  • date_in - дата включения банка в состав участников системы переводов ЦБ РФ.
  • date_out - дата исключения банка из состав участников системы переводов ЦБ РФ.
  • is_restricted - булевский флаг, принимает значение true, если на банк наложены ограничения регулятором, либо если он вообще находится в процессе ликвидации.
  • restriction_date - дата наложения ограничений, для случая если is_restricted = true.
  • parent_bic - БИК код головной организации, если текущий банк является отделением или филиалом.

JSON-объект bank.codes: коды банка в рамках системы переводов ЦБ РФ

Данный объект сообщает информацию о кодах и статусе банка в рамках системы переводов ЦБ РФ. Пример JSON-объекта bank.codes показан ниже.

{
  "exchange_type" : "1",
  "participant_status" : "PSAC",
  "participant_type" : "30",
  "registration_num" : "1481\/1309",
  "services" : "3",
  "uid" : 4030653000
}

Объект содержит следующие элементы.

  • registration_num - регистрационный порядковый номер, присвоенный банку при внесении в книгу государственной регистрации.
  • uid - УИС банка.
  • participant_status - статус банка как участника системы переводов ЦБ РФ, присваивается по классификатору ЦБ РФ.
  • participant_type - тип банка как участника системы переводов ЦБ РФ, присваивается по классификатору ЦБ РФ.
  • exchange_type - тип банка как участника обмена в рамках системы обмена электронными банковскими сообщениями с клиентами ЦБ РФ. Отражает информацию о наличии доступа к услугам по переводу денежных средств с использованием распоряжений в электронном виде. Присваивается по классификатору ЦБ РФ.
  • services - доступные сервисы перевода денежных средств. Отражает информацию о доступе к услугам по переводу денежных средств с использованием сервиса срочного перевода, сервиса несрочного перевода и сервиса быстрых платежей. Присваивается по классификатору ЦБ РФ.

JSON-объект bank.address: почтовый адрес банка

Объект содержит адрес банка в том виде, в котором он указан в БИК справочнике, а также адрес в стандартизованном виде, который получен при обработке исходного адреса функцией стандартизации Ахантера. Пример JSON-объекта bank.address показан ниже.

{
  "canonic" : "117312, г Москва, ул Вавилова, дом 19",
  "name_precise" : true,
  "nums_precise" : true,
  "sign" : "77s924hдом:19",
  "source" : "ГОРОД МОСКВА, УЛИЦА ВАВИЛОВА, 19"",
  "address" : { ... стандартизованный адрес ... }
}

Объект включает в себя следующие элементы.

  • source - исходный неструктурированный адрес банка, извлечённый из справочника БИК.
  • canonic - адрес банка, обработанный алгоритмами стандартизации Ахантера.
  • name_precise - если true, то в ходе стандартизации нечисловых адресных полей исходного адреса не было обнаружено ошибок и неточностей.
  • nums_precise - если true, то номер дома, корпуса и строения исходного адреса успешно обработаны и проверены по ФИАС.
  • sign - сигнатура стандартизованного адреса, которую можно передать Ахантеру в команде fetch/address, чтобы получить полные сведения об адресе, такие как, коды по КЛАДР, ФИАС, ОКАТО и ОКТМО, географические координаты и др.
  • address - вложенный объект, содержащий полную информацию о стандартизованном адресе. Структура данного объекта совпадает со структурой адреса, возвращаемой командами fetch/address и cleanse/address, её описание доступно здесь. Данный объект возвращается, если при отправке запроса использовалась опция output=cfulladdr. Аналогичный объект можно получить с помощью отдельного вызова API команды fetch/address, если передать ей в качестве запроса значение сигнатуры данного адреса из поля bank.address.sign. Данный объект не возвращается, если исходный неструктурированный адрес банка source в БИК справочнике представлен в виде, не позволяющем его стандартизовать средствами сервиса.

JSON-массив bank.restrictions: ограничения, наложенные на банк

Данный массив содержит объекты, отражающие информацию о введении Банком России ограничений предоставления услуг по переводу денежных средств участнику платежной системы. Если на банк не наложены ограничения, то массив bank.restrictions не будет включаться в состав объекта bank.

Каждый элемент массива bank.restrictions[i] описывает какой-то один вид наложенного ограничения. В общем случае на банк может быть наложено несколько ограничений. Пример JSON-массива bank.restrictions показан ниже.

[
  {
    "code" : "URRS",
    "date" : "2018-06-18",
  }
]

Массив состоит из однотипных JSON-объектов, включающих в себя следующие элементы.

  • status[i].code - код ограничения по классификатору ЦБ РФ.
  • status[i].date - дата начала действия ограничения в формате XML-Schema date.

JSON-массив bank.accounts: корреспондентские счета банка

Массив содержит информацию о корреспондентских счетах банка и возможных ограничениях, наложенных на отдельные из них регулятором.

Каждый элемент массива bank.accounts[i] содержит сведения по одному счёту. Данный массив может содержать более одного элемента, а также может отсутствовать вовсе. Пример JSON-массива bank.accounts показан ниже.

[
  {
    "cbr_bic" : "049033001",
    "control_key" : "28",
    "date_in" : "1998-01-02",
    "date_out" : "",
    "number" : "30101810900000000746",
    "regulation_type" : "CRSA",
    "restrictions" : 
    [
      {
        "code" : "URRS",
        "date" : "2018-07-02",
        "successor_bic" : ""
      }
    ],
    "status" : "ACAC"
  }
]

Массив состоит из однотипных JSON-объектов, включающих в себя следующие элементы.

  • accounts[i].number - номер счёта.
  • accounts[i].control_key - контрольный ключ записи, включающей БИК код банка и его номер счёта. Рассчитывается в соответствии с алгоритмом, изложенным в Приложении 5 к Положению Банка России "О платежной системе Банка России".
  • accounts[i].cbr_bic - БИК ПБР, обслуживающего данный счёт.
  • accounts[i].regulation_type - тип счёта в соответствии с нормативом, принимает значения по классификатору ЦБ РФ, соответствующие следующим вариантам: корреспондентский счет (субсчет), банковский счет, не являющийся корреспондентским счетом (субсчетом) или единым казначейским счетом, счет Банка России, счет территориального органа Федерального казначейства, единый казначейский счет, счет доверительного управления, клиринговый счет.
  • accounts[i].date_in - дата открытия счёта.
  • accounts[i].date_out - дата исключения информации о счёте из БИК справочника.
  • accounts[i].status - статус счёта по классификатору ЦБ РФ.
  • accounts[i].restrictions - массив ограничений, наложенных на данный счёт Банком России. Не возвращается сервисом, если на счёт не наложены никакие ограничения. Каждый объект данного массива содержит следующие поля:
    • restrictions[j].code - классификационный код ограничения, отражает один из возможных вариантов: закрытие счета, временное сохранение счета с его функционированием в ограниченном режиме, ограничение предоставления сервиса срочного перевода, приостановление предоставления сервиса быстрых платежей, использование реквизитов филиала кредитной организации после его перевода в статус внутреннего структурного подразделения.
    • restrictions[j].date - дата начала действия ограничения.
    • restrictions[j].successor_bic - БИК код преемника.

JSON-массив bank.swifts: сведения о СВИФТ кодах банка

Данный массив содержит СВИФТ коды банка по Международному справочнику SWIFT BIC Directory, если банка включён в систему СВИФТ. Пример JSON-массива bank.swifts показан ниже.

[
  {
    "code" : "SABRRUMMNH1",
    "is_default" : true
  }
]

Массив состоит из однотипных JSON-объектов, включающих в себя следующие элементы.

  • swifts[i].code - СВИФТ код банка по справочнику SWIFT BIC Directory.
  • swifts[i].is_default - если у банка несколько СВИФТ кодов, то данный булевский флаг отмечает значением true тот код, который используется по умолчанию.

Результат запроса в формате XML

Ниже приведен пример ответа сервиса с результатом обработки сигнатуры 045004641, которая соответствует банку СИБИРСКИЙ БАНК ПАО СБЕРБАНК. Результирующий XML-ответ получен с использованием опции output=xml|pretty, позволяющей выполнить "красивое" форматирование XML-текста.

<ProcessFetchResult>
  <Bank>
    <Main>
      <BIC val="045004641"/>
      <OGRN val="1027700132195"/>
      <ParentBIC val="044525225"/>
      <Name full="СИБИРСКИЙ БАНК ПАО СБЕРБАНК" 
            short="СИБИРСКИЙ БАНК ПАО СБЕРБАНК" 
            latin="SBERBANK (SIBIRSKY HEAD OFFICE)"/>
      <State restricted="0" restriction_date=""/>
      <Date in="1995-01-10" out=""/>
    </Main>
    <Codes registration_num="1481/982" 
           uid="5004641000" 
           participant_type="30" 
           participant_status="PSAC" 
           services="3" 
           exchange_type="1"/>
    <Address>
      <Canonic sign="54c1s1214hдом:20" 
               name_precise="1" 
               nums_precise="1" 
               pretty="г Новосибирск, ул Серебренниковская, дом 20"/>
      <Source val="RU, 630007, г Новосибирск, ул Серебренниковская, 20"/>
    </Address>
    <Account number="30101810500000000641" 
             cbr_bic="045004001" 
             regulation_type="CRSA" 
             control_key="19" 
             status="ACAC" 
             date_in="1998-01-05" 
             date_out=""/>
    <Swift code="SABRRUMMNH1" is_default="1"/>
  </Bank>
  <Query val="045004641"/>
</ProcessFetchResult>

Результатом получения описателя банка является XML-документ со следующими дочерними элементами.

  • Bank – элемент, содержащий информацию о запрошенном банке. Если в запросе будет указана некорректная сигнатура, либо сигнатура не существующего банка, то в ответе сервиса данный элемент будет опущен.
  • Query – исходный запрос, полученный и обработанный сервисом.

Ниже приведено детальное описание этих элементов.

XML-элемент Bank: информация о банке

Данный элемент аналогичен JSON-объекту bank, он содержит следующие дочерние элементы:

  • Main - основные сведения о банке, его полное и краткое название, ОГРН, БИК и прочие реквизиты.
  • Codes - справочные коды банка в рамках системы переводов ЦБ РФ. Здесь же указывается регистрационный номер банка в Книге государственной регистрации кредитных организаций, а также код УИС.
  • Address - информация о почтовом адресе банка.
  • Restriction - множественный элемент, соответствующий перечню ограничений, наложенных на сам банк регулятором. Данный элемент может быть опущен, если у данного банка нет наложенных ограничений.
  • Account - множественный элемент, соответствующий перечню корреспондентских счетов банка. Данный элемент может быть опущен, если у запрашиваемого банка нет корреспондентских счетов.
  • Swift - множественный элемент, соответствующий перечню СВИФТ кодов банка. Данный элемент может быть опущен, если у запрашиваемого банка нет СВИФТ кодов.

XML-элемент Main: основные сведения и реквизиты банка

Элемент содержит основную информацию о банке, такую как реквизиты, название и текущее состояние. Пример элемента показан ниже.

<Main>
  <BIC val="045004641"/>
  <OGRN val="1027700132195"/>
  <ParentBIC val="044525225"/>
  <Name full="СИБИРСКИЙ БАНК ПАО СБЕРБАНК" 
        short="СИБИРСКИЙ БАНК ПАО СБЕРБАНК" 
        latin="SBERBANK (SIBIRSKY HEAD OFFICE)"/>
  <State restricted="0" restriction_date=""/>
  <Date in="1995-01-10" out=""/>
</Main>

Элемент содержит следующие дочерние XML-элементы. У основных элементов информация содержится в рамках атрибута val, если не оговорено иное.

  • Name - сведения о названии банка. Представлены в рамках следующих атрибутов:
    • full - полное название банка.
    • short - краткое название банка.
    • latin - название банка латинскими буквами.
  • OGRN - основной государственный регистрационный номер банка - ОГРН.
  • BIC - БИК код банка.
  • Date - сведения о датах включения и исключения банка в состав участников системы переводов ЦБ РФ. Представлены в следующих атрибутах:
    • in - дата включения банка в состав участников системы переводов ЦБ РФ.
    • out - дата исключения банка из состав участников системы переводов ЦБ РФ.
  • State - сведения о наличии ограничений, наложенных регулятором. Представлены в следующих атрибутах:
    • restricted - принимает значение 1, если на банк наложены ограничения регулятором, либо если он вообще находится в процессе ликвидации.
    • restriction_date - дата наложения ограничений, для случая если restricted = 1.
  • ParentBIC - БИК код головной организации, если текущий банк является отделением или филиалом.

XML-элемент Codes: коды банка в рамках системы переводов ЦБ РФ

Данный элемент сообщает информацию о кодах и статусе банка в рамках системы переводов ЦБ РФ. Пример элемента показан ниже.

<Codes registration_num="1481/982" 
       uid="5004641000" 
       participant_type="30" 
       participant_status="PSAC" 
       services="3" 
       exchange_type="1"/>

Элемент содержит следующие атрибуты, с помощью которых передаётся информация.

  • registration_num - регистрационный порядковый номер, присвоенный банку при внесении в книгу государственной регистрации.
  • uid - УИС банка.
  • participant_status - статус банка как участника системы переводов ЦБ РФ, присваивается по классификатору ЦБ РФ.
  • participant_type - тип банка как участника системы переводов ЦБ РФ, присваивается по классификатору ЦБ РФ.
  • exchange_type - тип банка как участника обмена в рамках системы обмена электронными банковскими сообщениями с клиентами ЦБ РФ. Отражает информацию о наличии доступа к услугам по переводу денежных средств с использованием распоряжений в электронном виде. Присваивается по классификатору ЦБ РФ.
  • services - доступные сервисы перевода денежных средств. Отражает информацию о доступе к услугам по переводу денежных средств с использованием сервиса срочного перевода, сервиса несрочного перевода и сервиса быстрых платежей. Присваивается по классификатору ЦБ РФ.

XML-элемент Address: почтовый адрес банка

Элемент содержит адрес банка в том виде, в котором он указан в БИК справочнике, а также адрес в стандартизованном виде, который получен при обработке исходного адреса функцией стандартизации Ахантера. Пример элемента показан ниже.

<Address>
  <Canonic sign="54c1s1214hдом:20" 
           name_precise="1" 
           nums_precise="1" 
           pretty="г Новосибирск, ул Серебренниковская, дом 20"/>
  <Source val="RU, 630007, г Новосибирск, ул Серебренниковская, 20"/>
</Address>

Объект включает в себя следующие дочерние элементы.

  • Source - исходный неструктурированный адрес банка, извлечённый из справочника БИК. Эта информация передаётся с помощью атрибута val данного элемента.
  • Canonic - адрес банка, обработанный алгоритмами стандартизации Ахантера и сопутствующие такой обработке служебные сведения. Эта информация передаётся с помощью следующих атрибутов данного элемента:
    • name_precise - если 1, то в ходе стандартизации нечисловых адресных полей исходного адреса не было обнаружено ошибок и неточностей.
    • nums_precise - если 1, то номер дома, корпуса и строения исходного адреса успешно обработаны и проверены по ФИАС.
    • sign - сигнатура стандартизованного адреса, которую можно передать Ахантеру в команде fetch/address, чтобы получить полные сведения об адресе, такие как, коды по КЛАДР, ФИАС, ОКАТО и ОКТМО, географические координаты и др.
  • Address - необязательный элемент, содержащий полную информацию о стандартизованном адресе. Структура данного элемента совпадает со структурой адреса, возвращаемой командами fetch/address и cleanse/address, её описание доступно здесь. Поведение, назначение и содержание этого элемента аналогично JSON-объекту bank.address.address.

XML-элемент Restriction: ограничение, наложенное на банк

Это множественный элемент, каждый экземпляр которого, отражает информацию о введении Банком России ограничения предоставления услуг по переводу денежных средств в рамках платежной системы.

Каждый экземпляр элемента Restriction описывает какое-то одно ограничение. В общем случае на банк может быть наложено несколько ограничений. В случае отсутствия ограничений, наложенных на банк, элементы данного типа не возвращаются в ответе сервиса. Пример элемента показан ниже.

<Restriction code="URRS" 
             date="2018-06-18"/>

Информация об ограничении передаётся с помощью следующих атрибутов данного элемента.

  • code - код ограничения по классификатору ЦБ РФ. Может отражать один из следующих вариантов: ограничение предоставления сервиса срочного перевода, отзыв (аннулирование) лицензии, мораторий на удовлетворение требований кредиторов, приостановление предоставления сервиса быстрых платежей косвенному участнику, приостановление доступа к услугам по переводу денежных средств в качестве косвенного участника, закрытие полевого учреждения Банка России.
  • date - дата начала действия ограничения в формате XML-Schema date.

XML-элемент Account: корреспондентский счет банка

Это множественный элемент, каждый экземпляр которого представляет информацию об одном корреспондентском счёте банка и возможных ограничениях, наложенных на него регулятором. У банка может быть несколько таких счетов, в этом случае XML-ответ сервиса будет содержать несколько элементов данного типа.

Пример элемента показан ниже.

<Account number="30101810900000000746" 
         cbr_bic="049033001" 
         regulation_type="CRSA" 
         control_key="28" 
         status="ACAC" 
         date_in="1998-01-02" 
         date_out="">
  <Restriction code="URRS" 
               date="2018-07-02" 
               successor_bic=""/>
</Account>

Информация о счёте передаётся в рамках данного элемента с помощью следующих атрибутов.

  • number - номер счёта.
  • control_key - контрольный ключ записи, включающей БИК код банка и его номер счёта. Рассчитывается в соответствии с алгоритмом, изложенным в Приложении 5 к Положению Банка России "О платежной системе Банка России".
  • cbr_bic - БИК ПБР, обслуживающего данный счёт.
  • regulation_type - тип счёта в соответствии с нормативом, принимает значения по классификатору ЦБ РФ, соответствующие следующим вариантам: корреспондентский счет (субсчет), банковский счет, не являющийся корреспондентским счетом (субсчетом) или единым казначейским счетом, счет Банка России, счет территориального органа Федерального казначейства, единый казначейский счет, счет доверительного управления, клиринговый счет.
  • date_in - дата открытия счёта.
  • date_out - дата исключения информации о счёте из БИК справочника.
  • status - статус счёта по классификатору ЦБ РФ.

Ограничения, наложенные на данный счёт регулятором передаются в рамках дочернего множественного элемента Restriction с помощью следующих атрибутов:

  • code - классификационный код ограничения, отражает один из возможных вариантов: закрытие счета, временное сохранение счета с его функционированием в ограниченном режиме, ограничение предоставления сервиса срочного перевода, приостановление предоставления сервиса быстрых платежей, использование реквизитов филиала кредитной организации после его перевода в статус внутреннего структурного подразделения.
  • date - дата начала действия ограничения.
  • successor_bic - БИК код преемника.

XML-элемент Swift: сведения о СВИФТ коде банка

Это множественный элемент, каждый экземпляр которого представляет информацию об одном СВИФТ коде банка по Международному справочнику SWIFT BIC Directory, если банка включён в систему СВИФТ. Если банк не включён в данную систему, то элементы данного типа не возвращаются сервисом. Пример элемента показан ниже.

<Swift code="SABRRUMMNH1" is_default="1"/>

Элемент включает в себя следующие атрибуты.

  • code - СВИФТ код банка по справочнику SWIFT BIC Directory.
  • is_default - если у банка несколько СВИФТ кодов, то данный булевский флаг отмечает значением true тот код, который используется по умолчанию.
версия сервиса:
обработано за 1 (мс)