Информация о сервисе
«Справочники» — это сервис, который позволяет вам получать различные справочники, данные из которых можно использовать в запросах API.
Варианты реализации
Ниже будут приведены примеры реализации. Сценарии могут быть для вас отправной точкой и идеей для финального способа реализации функциональности.
Сценарии описали общие, для более легкого восприятия информации описания работы с сервисом.
Можно использовать разные триггеры запуска того или иного сценария - действия пользователя, регламентный запуск по времени, наступление определенных событий и другие варианты.

Шаги
- Запросить справочник
Участники usecase
- Платформа - любой web-ресурс (интернет-магазин, облачный сервис, мобильное приложение и т.д.) либо ваша внутренняя система (ERP, учетная система и др.), которую используют Пользователи
- Sber API - в контексте usecase представляет из себя запросы и ресурсы Sber API, к которым обращается Платформа
Предварительные условия
- Запускается внутри одного из сценариев
- У Платформы есть токены доступа Пользователя, полученные с помощью СберБизнес ID
Результат применения
- Платформа получила справочник

Используемые запросы
| № | Метод | Точка вызова | Описание | Операция в scope | Шаг в схеме |
|---|---|---|---|---|---|
| 1 | /fintech/api/v1/dicts | Получение справочника | DICT | 1. Запросить справочник | |
| 2 | /ic/sso/api/v2/oauth/token | Обновление токена доступа | openid | 1. Запросить справочник |
Перечень справочников
Идентификатор справочника (name) / название справочника на русском языке
| Наименование поля | Описание поля | Пример |
|---|---|---|
| zipcode(String) | Индекс | 109240 |
| datech(Date) | Дата контроля | 1970-01-01 |
| address(String) | Адрес | ул Высоцкого, 4 |
| city(String) | Город | Г. Москва |
| corrAccount(String) | Корр. счет | 30101810600000000754 |
| tnp(String) | Тип населенного пункта | Г |
| name(String) | Наименование банка | КУ АО \"ЗЕРНОБАНК\"- ГК \"АСВ\" |
| type(String) | Флаг «Участие в электронных расчетах» 0 | |
| bic(String) | БИК банка | 040173754 |
| cityOrig(String) | Населенный пункт | Москва |
| status(String) | Статус | ЛИКВ |
{
"zipcode": "350000",
"datech": null,
"address": "ул Фестивальная, 1",
"city": "Г. Краснодар",
"corrAccount": "30101810203490000724",
"tnp": "Г",
"name": "ФИЛИАЛ ООО КБ \"СОЮЗНЫЙ\" В Г. КРАСНОДАРЕ",
"type": "4",
"bic": "040349724",
"cityOrig": "Краснодар",
"status": null
}
| Наименование поля | Описание поля | Пример |
|---|---|---|
| countryCode(String) | Код страны | CH |
| countryIso(String) | ISO код страны | CH |
| countryNameRus(String) | Наименование страны на русском языке | null |
| format(String) | Формат национального клирингового кода | 6!n |
| fullName(String) | Наименование национального клирингового кода | Swiss Clearing Code (SIC code) |
| name(String) | Сокращенное наименование национального клирингового кода | Swiss Clearing Code (SIC code) |
| note(String ) | Обозначение национального клирингового кода | SW |
{
"note": "RU",
"countryIso": "RU",
"countryCode": "RU",
"format": "9!n",
"name": "Банковский идентификационный код (БИК)",
"fullName": "Банковский идентификационный код (БИК)",
"countryNameRus": null
}
| Наименование поля | Описание поля | Пример |
|---|---|---|
| mnem03(String) | 3-символьный код | DZA |
| code(String) | Цифровой код | 012 |
| nameInt(String) | Международное наименование | ALGERIA |
| mnem02(String) | 2-символьный код | DZ |
| name(String) | Наименование | Алжирская Народная Демократическая Республика |
| nameShort(String) | Краткое наименование страны | АЛЖИР |
{
"mnem03": "EGY",
"code": "818",
"nameInt": "EGYPT",
"mnem02": "EG",
"name": "Арабская Республика Египет",
"nameShort": "ЕГИПЕТ"
}
| Наименование поля | Описание поля | Пример |
|---|---|---|
| name(String) | Наименование валюты | АВСТРАЛИЙСКИЙ ДОЛЛАР |
| code(String) | Код валюты (цифровой) | 036 |
| isoCode(String) | ISO код валюты | AUD |
| fractDigits(Integer) | Количество знаков дробных единиц в 1 целой единице | 2 |
{
"name": "КАНАДСКИЙ ДОЛЛАР",
"code": "124",
"isoCode": "CAD",
"fractDigits": 2
}
| Наименование поля | Описание поля | Пример |
|---|---|---|
| code(Integer) | Код | 2 |
| name(String) | Наименование | Оплата товаров, работ, услуг по ценам (тарифам), подлежащим государственному регулированию |
{
"name": "Перечисления прибыли в размере, согласованном сторонами при заключении контракта и предусмотренном его условиями, после исполнения контракта и представления в уполномоченный банк акта приема-передачи товара (акта выполненных работ, оказанных услуг)",
"code": 4
}
| Наименование поля | Описание поля | Пример |
|---|---|---|
| compability(String) | Не допускается совместное использование с кодами | CHQB,HOLD |
| code(String) | Код | SDVA |
| desc(String) | Описание | Средства должны быть зачислены бенефициару той же датой валютирования |
{
"compability": "CHQB,HOLD",
"code": "INTC",
"desc": "Платеж является внутрикорпоративным, то есть перевод средств между двумя компаниями, принадлежащими к одной группе (например, между филиалом и головной организацией)"
}
| Наименование поля | Описание поля | Пример |
|---|---|---|
| format(String) | Формат | [135!с]0!с |
| description(String) | Описание | Указываются реквизиты счета-фактуры: дата, референс и детали через слэши ‘/’ |
| codeWord(String) | Кодовое слово | /INV/ |
| jurPersonUsage(String) | Признак использования юр. лицами в ПП | Y |
{
"format": "[20!с]0!с",
"description": "Указывается уникальный референс, идентифицирующий соответствующее международное платежное поручение (International Payment Instruction - IPI) (до 20 символов)",
"codeWord": "/IPI/",
"jurPersonUsage": "Y"
}
| Наименование поля | Описание поля | Пример |
|---|---|---|
| format(String) | Формат | 6..10n |
| description(String) | Описание | Международный Блиц-перевод, осуществляемый только через счета Лоро ЦА |
| codeWord(String) | Кодовое слово | /IET/ |
| currCode(String) | Валюта | 111 |
| jurPersonUsage(String) | Признак использования юр. лицами в ПП | N |
{
"format": "30x\n[//33x]",
"description": "Банк, который дал инструкции по данной операции",
"codeWord": "/INS/",
"currCode": null,
"jurPersonUsage": "N"
}
| Наименование поля | Описание поля | Пример |
|---|---|---|
| format(String) | Формат | null |
| description(String) | Описание | Указывается код отчетности Национального банка Украины (НБУ) – используется только при переводе средств в UAH |
| codeWord(String) | Кодовое слово | /1PB/ |
| currCode(String) | Валюта | UAH |
{
"format": null,
"description": "Указывается местоположение клиента-бенефициара",
"codeWord": "/BENEFRES/",
"currCode": null
}
| Наименование поля | Описание поля | Пример |
|---|---|---|
| bonusProgramCode(String) | Код бонусной программы | AE |
| depositTypeCode1C(String) | Код вида вклада 1C | 50 |
| typeName(String) | Вид карты | Visa Classic \"Аэрофлот\" |
| uniqueDesign(Boolean) | Индивидуальный дизайн | false |
| depositSubTypeCode1C(String) | Код подвида вклада 1C | 2 |
| peopleGroupName(String) | Название категории населения | Зарплатная |
| typeCode(String) | Код вида карты | 12 |
| peopleGroupCode(String) | Код категории населения | 207 |
{
"bonusProgramCode": "PG",
"depositTypeCode1C": "50",
"typeName": "Visa Classic \"Подари жизнь\"",
"uniqueDesign": false,
"depositSubTypeCode1C": "2",
"peopleGroupName": "Зарплатная",
"typeCode": "18",
"peopleGroupCode": "207"
}