Справочники

Обновлено 2 июля 2026

Компаниям

Холдингам

Платформам

Информация о сервисе

«Справочники» — это сервис, который позволяет вам получать различные справочники, данные из которых можно использовать в запросах API.

Варианты реализации

Ниже будут приведены примеры реализации. Сценарии могут быть для вас отправной точкой и идеей для финального способа реализации функциональности.

Сценарии описали общие, для более легкого восприятия информации описания работы с сервисом.

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

Получение справочника

Шаги

1. Запросить справочник

Участники 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
}

MzpCardType / Справочник типов пластиковых карт ЗП проект

Наименование поля	Описание поля	Пример
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"
}

SalType / Справочник цифровых значений видов зачислений

Наименование поля	Описание поля	Пример
description(String)	Описание	Перевод по договору ГПХ
code(String)	Цифровое значение	49

{
	"description": "юридическое лицо или его филиал",
	"code": "1"
}

SwiftBic / Международный справочник банков

Наименование поля	Описание поля	Пример
zip	Zip код	13022 KUWA
address(String)	Адрес	OPPOSITE PUBLIC LIBRARY
bicInt(String)	Международный БИК	AAACKWKWXXX
filialName(String)	Наименование филиала	Branch lxdMF
bicTypeNat(String)	Тип национального БИК	null
countryNameShort(String)	Краткое наименование страны	СОЕДИНЕННЫЕ ШТАТЫ АМЕРИКИ
modflag(String)	Статус	U
abonent(String)	Тип абонента	null
mnem03(String)	3-символьный код	KWT
nationalId(String)	Национальный клиринговый код	50
bicNat(String)	Национальный БИК	null
countryCode(String)	Цифровой код	414
mnem02(String)	2-символьный код	KW
name(String)	Наименование банка	ALMUZAINI EXCHANGE COMPANY KSC (CLOSED)
location(String)	Почтовый индекс, месторасположение	ALKHOBAR
countryNameInt(String)	Международное наименование	KUWAIT
bicTypeInt(String)	Тип международного БИК	SWIFT
state(String)	Республика/штат	null
place(String)	Населенный пункт	KUWAIT
account(String)	Корсчет	42013457689100142604

{
	"zip": "Zip Lkspx",
	"address": "BankAddress qeTUG",
	"bicInt": "SWIFTEPNPOI",
	"filialName": "Branch JwHtB",
	"bicTypeNat": null,
	"countryNameShort": "СОЕДИНЕННЫЕ ШТАТЫ АМЕРИКИ",
	"modflag": null,
	"abonent": null,
	"mnem03": "USA",
	"nationalId": null,
	"bicNat": null,
	"countryCode": "840",
	"mnem02": "US",
	"name": "Открытое акционерное общество Сбербанк России",
	"location": null,
	"countryNameInt": null,
	"bicTypeInt": "SWIFT",
	"state": null,
	"place": "City VqDOp",
	"account": "86027683840122180969"
}

VOCodes / Справочник Коды видов валютных операций

Наименование поля	Описание поля	Пример
description(String)	Наименование вида валютной операции	Продажа резидентом иностранной валюты за валюту Российской Федерации
code(String)	Код вида валютной операции	01010

{
	"description": "Покупка резидентом иностранной валюты за валюту Российской Федерации",
	"code": "01030"
}

Смотрите также

Справочники

Справочная документация по REST API