Получение информации о клиенте
/v1/client-info
Запрос для получиения расширенной информации об организации пользователя и ее счетах (если пользователь дал согласие на доступ к своим данным см. Сервис авторизации СберБизнес ID.
Должен содержать токен доступа (access_token) пользователя в параметре Authorization заголовка.
Для доступа к этому методу в параметре scope
ссылки авторизации пользователя должен быть указан сервис GET_CLIENT_ACCOUNTS
.
Запрос
Header Parameters
Успех
- application/json
- Схема
- Пример из схемы
Schema
Array [
]
Array [
Array [
]
Array [
]
Array [
]
]
Array [
]
Сокращенное наименование организации
Полное наименование организации
Признак 'резидент / нерезидент'
ОГРН
ИНН / КИО
ОКПО
ОКАТО
Организационно-правовая форма организации клиента
Территориальный банк клиента
Идентификатор организации в ППРБ
Дата регистрации ИНН
Дата регистрации ОГРН
Неклиент
Неподтвержденная организация
Идентификатор организации в ЕКС
Признак наличия у клиента бизнес-карты
Признак наличия у клиента действующей ВКЛ
ВНИМАНИЕ. Фактически возвращаемое значение поля – "string". Для предотвращения возможных ошибок, выполните явную конвертацию значения из "string" в "number".
Сумма действующей ВКЛ.
branch
object
Информация о подразделении
Наименование подразделения
Адрес подразделения
Номер подразделения
orgKindActivityInfo
object
Информация о виде деятельности организации
Код вида деятельности
Наименование вида деятельности
addresses
object[]
Адреса (все заведенные для клиента)
Наименование типа адреса
Цифровой код страны
Индекс
Субъект или регион
Район
Город
Тип населенного пункта
Населенный пункт
Улица
Дом
Строение, корпус
Квартира
Адрес
accounts
object[]
Счета организации клиента, доступные партнеру
Номер счета (20 сиволов)
Наименование счета
Цифровой код валюты счета
БИК банка, где открыт счет
Возможные значения: [assuranceRegistration
, calculated
, transit
, specialTransit
, budget
, loan
, deposit
]
Тип счета
Дата открытия счета
Дата закрытия счета
Возможные значения: [OPEN
, BLOCKED
, RESERVED
, CLOSED
]
Состояние счета
Признак обслуживания в ДБО
Признак бизнес-счета
ВНИМАНИЕ. Фактически возвращаемое значение поля – "string". Для предотвращения возможных ошибок, выполните явную конвертацию значения из "string" в "number".
Минимальный поддерживаемый (неснижаемый) остаток на счете.
Количество расчетных документов, ожидающих разрешения на проведение операции
ВНИМАНИЕ. Фактически возвращаемое значение поля – "string". Для предотвращения возможных ошибок, выполните явную конвертацию значения из "string" в "number".
Сумма расчетных документов, ожидающих разрешения на проведение операции.
Количество расчетных документов, ожидающих акцепта
ВНИМАНИЕ. Фактически возвращаемое значение поля – "string". Для предотвращения возможных ошибок, выполните явную конвертацию значения из "string" в "number".
Сумма расчетных документов, ожидающих акцепта.
Количество расчетных документов, помещенных в картотеку к счету 90902 (картотека 2)
ВНИМАНИЕ. Фактически возвращаемое значение поля – "string". Для предотвращения возможных ошибок, выполните явную конвертацию значения из "string" в "number".
Сумма расчетных документов, помещенных в картотеку к счету 90902 (картотека 2)
Признак полной блокировки счета по дебету
Основание ареста
Дата начала действия ограничения
Дата снятия ограничения
Признак полной блокировки счета по кредиту
Основание ареста
Дата начала действия ограничения
Дата снятия ограничения
blockedSums
object[]
Заблокированные (арестованные) суммы на счете
ВНИМАНИЕ. Фактически возвращаемое значение поля – "string". Для предотвращения возможных ошибок, выполните явную конвертацию значения из "string" в "number".
Заблокированная (арестованная) сумма на счете.
Основание ареста
Наибольшая разрешенная очередность платежей (от 1 до 5). Указывается, если есть блокировка по очередности. Пример: значение 3 означает, что заблокированы очередности 4 - 6
Дата начала действия ограничения
Дата снятия ограничения
blockedQueuesInfo
object[]
Приостановления операций по счету выше очередности (блокировки по очередности)
ВНИМАНИЕ. Фактически возвращаемое значение поля – "string". Для предотвращения возможных ошибок, выполните явную конвертацию значения из "string" в "number".
Заблокированная (арестованная) сумма на счете.
Основание ареста
Наибольшая разрешенная очередность платежей (от 1 до 5). Указывается, если есть блокировка по очередности. Пример: значение 3 означает, что заблокированы очередности 4 - 6
Дата начала действия ограничения
Дата снятия ограничения
blockedSumQueuesInfo
object[]
Приостановления операций по счету выше очередности на сумму
ВНИМАНИЕ. Фактически возвращаемое значение поля – "string". Для предотвращения возможных ошибок, выполните явную конвертацию значения из "string" в "number".
Заблокированная (арестованная) сумма на счете.
Основание ареста
Наибольшая разрешенная очередность платежей (от 1 до 5). Указывается, если есть блокировка по очередности. Пример: значение 3 означает, что заблокированы очередности 4 - 6
Дата начала действия ограничения
Дата снятия ограничения
КПП (все заведенные для организации клиента)
dboContracts
object[]
Договоры обслуживания организации
Номер заключенного договора ДБО
Дата заключения договора ДБО
{
"shortName": "string",
"fullName": "string",
"resident": true,
"ogrn": "string",
"inn": "string",
"okpo": "string",
"okato": "string",
"orgForm": "string",
"territorialBank": "string",
"orgPprbId": 0,
"orgRegDateINN": "string",
"orgRegDateOGRN": "string",
"nonClient": true,
"orgUnconfirmed": true,
"eksEpkId": 1,
"isCorpCardHolder": false,
"hasActiveCreditLine": true,
"creditLineAvailableSum": 0,
"branch": {
"name": "Доп офис 1654",
"address": "г.Москва, Кутузовский проспект, 34",
"code": 138592
},
"orgKindActivityInfo": {
"code": 0,
"name": "string"
},
"addresses": [
{
"type": "string",
"country": "string",
"zip": "string",
"region": "string",
"area": "string",
"city": "string",
"settlementType": "string",
"settlement": "string",
"street": "string",
"house": "string",
"building": "string",
"flat": "string",
"fullAddress": "string"
}
],
"accounts": [
{
"number": "string",
"name": "string",
"currencyCode": "string",
"bic": "string",
"type": "assuranceRegistration",
"openDate": "2025-03-18",
"closeDate": "2025-03-18",
"state": "OPEN",
"dbo": true,
"business": true,
"minBalance": 0,
"cdiPermDocQnt": 0,
"cdiPermDocSum": 0,
"cdiAcptDocQnt": 0,
"cdiAcptDocSum": 0,
"cdiCart2DocQnt": 0,
"cdiCart2DocSum": 0,
"debitBlocked": true,
"debitBlockedCause": "string",
"debitBlockedBeginDate": "2025-03-18T09:47:18.895Z",
"debitBlockedEndDate": "2025-03-18T09:47:18.895Z",
"creditBlocked": true,
"creditBlockedCause": "string",
"creditBlockedBeginDate": "2025-03-18T09:47:18.895Z",
"creditBlockedEndDate": "2025-03-18T09:47:18.895Z",
"blockedSums": [
{
"sum": 0,
"cause": "string",
"blockedQueues": 0,
"beginDate": "2025-03-18T09:47:18.895Z",
"endDate": "2025-03-18T09:47:18.895Z"
}
],
"blockedQueuesInfo": [
{
"sum": 0,
"cause": "string",
"blockedQueues": 0,
"beginDate": "2025-03-18T09:47:18.895Z",
"endDate": "2025-03-18T09:47:18.895Z"
}
],
"blockedSumQueuesInfo": [
{
"sum": 0,
"cause": "string",
"blockedQueues": 0,
"beginDate": "2025-03-18T09:47:18.895Z",
"endDate": "2025-03-18T09:47:18.895Z"
}
]
}
],
"kpps": [
"string"
],
"dboContracts": [
{
"number": "14/2/000001",
"date": "2018-12-31"
}
]
}
Ошибка запроса
- application/json
- Схема
- Пример из схемы
Schema
Array [
]
Тип ошибки
Уникальный идентификатор ошибки (UUID)
Сообщение
checks
object[]
Список проверок, приведших к ошибке
Уровень результата
Сообщение
Названия полей (при наличии связи с моделью)
{
"cause": "string",
"referenceId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"message": "string",
"checks": [
{
"level": "string",
"message": "string",
"fields": [
"string"
]
}
]
}
"Не авторизован"
Cause | Message | Description |
---|---|---|
UNAUTHORIZED | accessToken not found by value =хххххххх-хххх-хххх-хххх-хххххххххххх-х | Указан некорректный или просроченный access_token. Используйте refresh_token для обновления access_token и повторите запрос. |
- application/json
- Схема
- Пример из схемы
Schema
Array [
]
Тип ошибки
Уникальный идентификатор ошибки (UUID)
Сообщение
checks
object[]
Список проверок, приведших к ошибке
Уровень результата
Сообщение
Названия полей (при наличии связи с моделью)
{
"cause": "string",
"referenceId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"message": "string",
"checks": [
{
"level": "string",
"message": "string",
"fields": [
"string"
]
}
]
}
"Операция не может быть выполнена: доступ к ресурсу запрещен"
Cause | Message | Description |
---|---|---|
ACTION_ACCESS_EXCEPTION | Операция не может быть выполнена: доступ к ресурсу запрещен | Используемый в запросе access_token не имеет разрешения на доступ к нужному сервису Sber API. В ссылке авторизации СберБизнес ID, в параметре scope не указана операция. Необходимо добавить одному или несколько операций в scope. Пользователю потребуется пройти авторизацию заново. Вы получите новые токены access_token и refresh_token. Сделайте повторный запрос с новым access_token. |
- application/json
- Схема
- Пример из схемы
Schema
Array [
]
Тип ошибки
Уникальный идентификатор ошибки (UUID)
Сообщение
checks
object[]
Список проверок, приведших к ошибке
Уровень результата
Сообщение
Названия полей (при наличии связи с моделью)
{
"cause": "string",
"referenceId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"message": "string",
"checks": [
{
"level": "string",
"message": "string",
"fields": [
"string"
]
}
]
}
Справочник с указанным идентификатором не найден
- application/json
- Схема
- Пример из схемы
Schema
Array [
]
Тип ошибки
Уникальный идентификатор ошибки (UUID)
Сообщение
checks
object[]
Список проверок, приведших к ошибке
Уровень результата
Сообщение
Названия полей (при наличии связи с моделью)
{
"cause": "string",
"referenceId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"message": "string",
"checks": [
{
"level": "string",
"message": "string",
"fields": [
"string"
]
}
]
}
"Превышен лимит запросов"
Cause | Message | Description |
---|---|---|
TOO_MANY_REQUESTS | Превышен лимит запросов. Повторите операцию позже. | Количество запросов к данному методу за ограниченное время превысило допустимое значение. Пользователю необходимо повторить запрос позднее |
- application/json
- Схема
- Пример из схемы
Schema
Причина или основание сообщения
Уникальный идентификатор (UUID)
Сообщение
{
"cause": "string",
"referenceId": "string",
"message": "string"
}
"Внутренняя ошибка сервера"
Cause | Message | Description |
---|---|---|
UNKNOWN_EXCEPTION | Внутренняя ошибка сервера | Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка. |
- application/json
- Схема
- Пример из схемы
Schema
Array [
]
Тип ошибки
Уникальный идентификатор ошибки (UUID)
Сообщение
checks
object[]
Список проверок, приведших к ошибке
Уровень результата
Сообщение
Названия полей (при наличии связи с моделью)
{
"cause": "string",
"referenceId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"message": "string",
"checks": [
{
"level": "string",
"message": "string",
"fields": [
"string"
]
}
]
}
"Сервис временно недоступен"
Cause | Message | Description |
---|---|---|
UNAVAILABLE_RESOURCE_EXCEPTION | Внутренняя ошибка сервера | Сделайте повторный запрос. Если ошибка повторится, подготовьте логи запроса и направьте в службу Технической поддержки Банка. |
- application/json
- Схема
- Пример из схемы
Schema
Array [
]
Тип ошибки
Уникальный идентификатор ошибки (UUID)
Сообщение
checks
object[]
Список проверок, приведших к ошибке
Уровень результата
Сообщение
Названия полей (при наличии связи с моделью)
{
"cause": "string",
"referenceId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"message": "string",
"checks": [
{
"level": "string",
"message": "string",
"fields": [
"string"
]
}
]
}