Информация о сервисе
«Справочники» — это сервис, который позволяет вам получать различные справочники, данные из которых можно использовать в запросах 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) / название справочника на русском языке
BIC / Справочник БИК
- Структура
- Пример
Наименование поля | Описание поля | Пример |
---|---|---|
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
}
ClearingStructure / Справочник структур национальных клиринговых кодов
- Структура
- Пример
Наименование поля | Описание поля | Пример |
---|---|---|
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
}
Country / Справочник стран
- Структура
- Пример
Наименование поля | Описание поля | Пример |
---|---|---|
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": "ЕГИПЕТ"
}
CurDict / Справочник валют
- Структура
- Пример
Наименование поля | Описание поля | Пример |
---|---|---|
name(String) | Наименование валюты | АВСТРАЛИЙСКИЙ ДОЛЛАР |
code(String) | Код валюты (цифровой) | 036 |
isoCode(String) | ISO код валюты | AUD |
fractDigits(Integer) | Количество знаков дробных единиц в 1 целой единице | 2 |
{
"name": "КАНАДСКИЙ ДОЛЛАР",
"code": "124",
"isoCode": "CAD",
"fractDigits": 2
}
DirType / Справочник типов списания
- Структура
- Пример
Наименование поля | Описание поля | Пример |
---|---|---|
code(Integer) | Код | 2 |
name(String) | Наименование | Оплата товаров, работ, услуг по ценам (тарифам), подлежащим государственному регулированию |
{
"name": "Перечисления прибыли в размере, согласованном сторонами при заключении контракта и предусмотренном его условиями, после исполнения контракта и представления в уполномоченный банк акта приема-передачи товара (акта выполненных работ, оказанных услуг)",
"code": 4
}
Instruction23 / Справочник кодов инструкций поля 23Е
- Структура
- Пример
Наименование поля | Описание поля | Пример |
---|---|---|
compability(String) | Не допускается совместное использование с кодами | CHQB,HOLD |
code(String) | Код | SDVA |
desc(String) | Описание | Средства должны быть зачислены бенефициару той же датой валютирования |
{
"compability": "CHQB,HOLD",
"code": "INTC",
"desc": "Платеж является внутрикорпоративным, то есть перевод средств между двумя компаниями, принадлежащими к одной группе (например, между филиалом и головной организацией)"
}
KeyWord70 / Справочник Кодовые слова поля 70
- Структура
- Пример
Наименование поля | Описание поля | Пример |
---|---|---|
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"
}
KeyWord72 / Справочник Кодовые слова поля 72
- Структура
- Пример
Наименование поля | Описание поля | Пример |
---|---|---|
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"
}
KeyWord77B / Справочник Кодовые слова поля 77B
- Структура
- Пример
Наименование поля | Описание поля | Пример |
---|---|---|
format(String) | Формат | null |
description(String) | Описание | Указывается код отчетности Национального банка Украины (НБУ) – используется только при переводе средств в UAH |
codeWord(String) | Кодовое слово | /1PB/ |
currCode(String) | Валюта | UAH |
{
"format": null,
"description": "Указывается местоположение клиента-бенефициара",
"codeWord": "/BENEFRES/",
"currCode": null
}