Version: 1.0.0

Dicts Overview

Обновлено 19 марта 2026

Методы для работы с банковскими справочниками

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

API URLs

• Тестовый контур: https://iftfintech.testsbi.sberbank.ru:9443
• Промышленный контур: https://fintech.sberbank.ru:9443

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

Наименование справочника	Значение параметра name
Справочник БИК	BIC
Справочник структур национальных клиринговых кодов	ClearingStructure
Справочник стран	Country
Справочник валют	CurDict
Справочник типов ПСФ	GenericLetterType
Справочник типов пластиковых карт ЗП проект	MzpCardType
Справочник цифровых значений видов зачислений	SalType
Международный справочник банков	SwiftBic
Справочник Коды видов валютных операций	VOCodes

Формат справочников

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
}

GenericLetterType — справочник типов ПСФ

Наименование	Описание	Пример
attachmentsEnabled(String)	Признак возможности добавления обычных вложений	0
attachmentsEnabledBF(String)	Признак возможности добавления вложений с помощью сервиса Больших Файлов	1
groupId(String)	Порядковый номер группы письма для сортировки	3
groupName(String)	Наименование группы письма	ОТОЗВАТЬ ПЛАТЕЖ, В Т.Ч. ИЗ КАРТОТЕКИ ИЛИ УТОЧНИТЬ РЕКВИЗИТЫ
letterType(String)	Тип письма	Отзыв платежа из картотеки
sysGroupName(String)	Системное имя группы письма	ReqLetter
systemName(String)	Системное имя типа письма	payment_recall_from_register
template(String)	Шаблон сообщения по умолчанию	Прошу ОТОЗВАТЬ ПЛАТЕЖ из КАРТОТЕКИ:____

Пример записи справочника

{
  "attachmentsEnabled":0,
  "attachmentsEnabledBF":1,
  "groupId":3,
  "groupName":"ОТОЗВАТЬ ПЛАТЕЖ, В Т.Ч. ИЗ КАРТОТЕКИ ИЛИ УТОЧНИТЬ РЕКВИЗИТЫ",
  "letterType":"Отзыв платежа из картотеки",
  "sysGroupName":"ReqLetter",
  "systemName":"payment_recall_from_register",
  "template":"Прошу ОТОЗВАТЬ ПЛАТЕЖ из КАРТОТЕКИ:____"
}

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

Наименование	Описание	Пример
extendedCode(String)	Код карты	111754.Z0.810.00.0.1
peopleGroupCode(String)	Код категории населения	207
bonusProgramCode(String)	Код бонусной программы	00
depositTypeCode1C(String)	Код вида вклада 1C	52
depositSubTypeCode1C(String)	Код подвида вклада 1C	6
typeName(String)	Вид карты	МИР Классическая
uniqueDesign(Boolean)	Индивидуальный дизайн	true

Пример записи справочника

{
  "extendedCode": "111754.Z0.810.00.0.1",
  "peopleGroupCode":"207",
  "bonusProgramCode":"00",
  "depositTypeCode1C":"52",
  "depositSubTypeCode1C":"6",
  "typeName":"МИР Классическая",
  "uniqueDesign": true
}

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"
}