Развернуть

Version: 1.0.0

Dicts Overview

Обновлено 12 февраля 2026

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

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

API URLs

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

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

Наименование справочника	Значение параметра `name`
Справочник БИК	BIC
Справочник структур национальных клиринговых кодов	ClearingStructure
Справочник стран	Country
Справочник валют	CurDict
Признак поставки	DelDir
Справочник кодов видов подтверждающих документов	DocCode
Справочник типов ПСФ	GenericLetterType
Справочник кодов ставок ЛИБОР	LiborCode
Справочник типов пластиковых карт ЗП проект	MzpCardType
Код срока привлечения	PaymentPeriodCode
Справочник цифровых значений видов зачислений	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
}

DelDir — признак поставки

Наименование	Описание	Пример
description(String)	Описание условия поставки валюты	Предоставление резидентом коммерческого кредита нерезиденту в виде отсрочки оплаты
code(String)	Код условия поставки валюты	2

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

[
  {
      "description":"Исполнение резидентом обязательств по контракту в счет ранее полученного аванса от нерезидента",
      "code":"1"
  },
  {
      "description":"Предоставление резидентом коммерческого кредита нерезиденту в виде отсрочки оплаты",
      "code":"2"
  },
  {
      "description":"Исполнение нерезидентом обязательств по контракту в счет ранее полученного аванса от резидента",
      "code":"3"
  },
  {
      "description":"Предоставление нерезидентом коммерческого кредита резиденту в виде отсрочки оплаты",
      "code":"4"
  }
]

DocCode — справочник кодов видов подтверждающих документов

Наименование	Описание	Пример
description(String)	Описание вида подтверждающего документа	О вывозе с территории Российской Федерации товаров с оформлением декларации на товары или документов, указанных в подпункте 9.1.1 пункта 9.1 настоящей Инструкции, за исключением документов с кодом 03_3
code(String)	Код вида подтверждающего документа	01_4

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

[
  {
      "description":"О вывозе с территории Российской Федерации товаров с оформлением декларации на товары или документов, указанных в подпункте 9.1.1 пункта 9.1 настоящей Инструкции, за исключением документов с кодом 03_3",
      "code":"01_3"
  },
  {
      "description":"О ввозе на территорию Российской Федерации товаров с оформлением декларации на товары или документов, указанных в подпункте 9.1.1 пункта 9.1 настоящей Инструкции, за исключением документов с кодом 03_4",
      "code":"01_4"
  },
  {
      "description":"Об отгрузке (передаче покупателю, перевозчику) товаров при их вывозе с территории Российской Федерации без оформления декларации на товары или документов, указанных в подпункте 9.1.1 пункта 9.1 настоящей Инструкции, за исключением документов с кодом 03_3",
      "code":"02_3"
  },
  {
      "description":"О получении (передаче продавцом, перевозчиком) товаров при их ввозе на территорию Российской Федерации без оформления декларации на товары или документов, указанных в подпункте 9.1.1 пункта 9.1 настоящей Инструкции, за исключением документов с кодом 03_4",
      "code":"02_4"
  }
]

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":"Прошу ОТОЗВАТЬ ПЛАТЕЖ из КАРТОТЕКИ:____"
}

LiborCode — справочник кодов ставок ЛИБОР

Наименование	Описание	Пример
description(String)	Описание	месячная ставка ЛИБОР
code(String)	Код ставки LIBOR	Л01

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

[
  {
      "description":"месячная ставка ЛИБОР",
      "code":"Л01"
  },
  {
      "description":"3-месячная ставка ЛИБОР",
      "code":"Л03"
  },
  {
      "description":"6-месячная ставка ЛИБОР",
      "code":"Л06"
  },
  {
      "description":"12-месячная ставка ЛИБОР",
      "code":"Л12"
  }
]

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
}

PaymentPeriodCode — код срока привлечения

Наименование	Описание	Пример
description(String)	Срок привлечения (предоставления)	от 31 до 90 дней
code(String)	Код срока	1

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

[
  {
      "description":"до 30 дней",
      "code":"0"
  },
  {
      "description":"от 31 до 90 дней",
      "code":"1"
  },
  {
      "description":"от 91 до 180 дней",
      "code":"2"
  }
]

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

Заметили ошибку?

Выделите текст и нажмите Ctrl + Enter, чтобы сообщить нам о ней

Dicts Overview

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

API URLs﻿

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

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

BIC — справочник БИК﻿

ClearingStructure — справочник структур национальных клиринговых кодов﻿

Country — справочник стран﻿

CurDict — справочник валют﻿

DelDir — признак поставки﻿

DocCode — справочник кодов видов подтверждающих документов﻿

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

LiborCode — справочник кодов ставок ЛИБОР﻿

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

PaymentPeriodCode — код срока привлечения﻿

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

SwiftBic — справочник цифровых значений видов зачислений﻿

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

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

API URLs

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

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

BIC — справочник БИК

ClearingStructure — справочник структур национальных клиринговых кодов

Country — справочник стран

CurDict — справочник валют

DelDir — признак поставки

DocCode — справочник кодов видов подтверждающих документов

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

LiborCode — справочник кодов ставок ЛИБОР

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

PaymentPeriodCode — код срока привлечения

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

SwiftBic — справочник цифровых значений видов зачислений

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