Обновление от 17.01.2023

Форма Кредитные карты (v3):
- исправлена работа валидации при использовании флага (/v3/credit_cards/submit?withValidation=true)

—
При обнаружении новых ошибок валидации: @aleksei_savelev
—
Актуальная документация и подключение партнёров к OpenAPI Банка Уралсиб - https://api.uralsib.ru/docs

Обновление от 18.01.2023
Форма кредитные карты(v3)
Больше неактуальна

Форма кредитные карты(v4)
Новая версия формы для кредитной карты. Изменения:
⁃ Изменена валидация для email (personalDataEmail)
⁃ Убрали отправку атрибутов фактического адреса проживания (livingAddress)
⁃ Пол клиента заполняем только из справочников или отправляем пустое значение. В заявке не отображаем. (personalDataGender)
⁃ Заполняем дефолтом кредитный лимит. В заявке не отображаем (productInfoRequestedAmount)
⁃ Чек-бокс соответствия адресов всегда = true. В заявке не отображаем (livingAddressLivingAndRegistrationAreSame)
⁃ Добавилось для новых поля: "Дополнительный номер телефона" (personalDataAdditionalPhone), "Владелец дополнительного номера телефона" (personalDataAdditionalPhoneOwnerType)

Форма дебетовые карты(v5)
1. Изменено количество символов в атрибутах с улицей (deliveryAddressStreet, livingAddressStreet, registrationAddressStreet)
2. Изменена валидация для email (personalDataEmail)
—
При обнаружении новых ошибок валидации: @aleksei_savelev
—
Актуальная документация и подключение партнёров к OpenAPI Банка Уралсиб - https://api.uralsib.ru/docs

Обновление от 09.02.2023
Изменена форма кредитных карт v3 и v4. Спецификация всех полей была сохранена. Изменения коснулись только правил валидации.
Также сделан перевод ошибок валидации на русский язык.
Более детальное описание изменений - в приложенном файле.

Обновление от 21.02.2023

Изменения связаны с приведением поля session_uuid к единому виду, а именно:
- Изменен формат ответа при отправке драфтов и сабмитов заявок - теперь в ответе отсутствует поле sessionUuid
- Изменен формат ответа на запрос GET /partners/sessions - поле uuid переименовано в session_uuid

Обновление от 01.03.2023

Форма Кредитные карты (v3):
- исправлены все известные ошибки в работе валидации при использовании флага (/submit?withValidation=true)

Форма Кредитные карты (v4):
- исправлены все известные ошибки в работе валидации при использовании флага (/submit?withValidation=true)

—
При обнаружении новых ошибок валидации: @aleksei_savelev
—
Актуальная документация и подключение партнёров к OpenAPI Банка Уралсиб - https://api.uralsib.ru/docs

Обновление от 28.03.2023

Сообщаем вам о наших обновлениях:
1. Актуализирована документация по отправке заявок на дебетовую карту: https://api.uralsib.ru/docs/api/specifications/debitCardV5.html. Валидация для дебетовой карты будет реализована на этой неделе.
2.Добавлено описание запроса для получения информации о статусах по заявкам, статусы сделали более подробные: https://api.uralsib.ru/docs/api/form/stats.html
Ограничение: запросить информацию можно только за последние 60 дней
3.Добавлено описание запроса для получения параметров кредита в течение 3 минут: https://api.uralsib.ru/docs/api/form/decision.html
4.Изменена максимальная сумма дохода в заявках на кредитную карту (payload.incomeInfoIncomeAmount) = 99 999 999 999. Просьба применить изменение в текущей используемой версии.
5.Добавлена новая версия для заявки на кредитную карту (v5) с оптимизацией. Обновления в сравнении с v4:
- Добавлена опциональная отправка кодов ГАР адресов
⁃ Исключен для отправки адрес работодателя
⁃ Поля теперь можно заполнять дефолтными значениями или отправлять пустые: payload.personalDataMaritalStatus, payload.incomeInfoJobCountOfEmployees, payload.incomeInfoJobCompanyOwnershipType, payload.incomeInfoJobDuration
⁃ Убрали выбор нескольких вариантов деятельности клиента (payload.incomeInfoOccupationType), теперь можно отправить значение пенсионер (P) или пустое. См. «Чек-бокс "Являетесь ли вы пенсионером?"»
⁃ Занимаемая должность всегда обязательна, если клиент не пенсионер (payload.incomeInfoJobPosition).
⁃ Рабочий телефон стал необязательным, но если указан не должен дублировать ни один номер на форме
⁃ Дополнительный номер телефона (payload.personalDataAdditionalPhone) так же не должен дублировать ни один номер телефона
⁃ Выбор адреса доставки необходимо реализовать с запросом в новый сервис, сделать логику по анализу наличия выбранного КЛАДР в списке: api.uralsib.ru/docs/api/directory/deliveryServices2.html

Напоминаем, что вы можете использовать в PROD уже реализованную вами версию (v3,v4). Переходить на новую версию по кредитной карте рекомендуем для оптимизации передаваемых параметров и для стабильности работы, так как, например, старый справочник с городами доставки может в скором времени перестать использоваться (ориентировочно в сентябре). В новом справочнике гораздо больше населенных пунктов с доставкой.
В ближайшем времени больше не предвидится координальных изменений в формах.

Мы внесли пояснения в документацию по OpenAPI для текущей версии интеграции.

1. В справочник городов доставки второй версии добавлена информация по использованию сервиса и ограничениям, которые необходимо учитывать. Первая версия справочника помечена как Deprecated. Она будет работать, но города доставки в ближайшее время перестанут обновляться. Настоятельно рекомендуем переходить на вторую версию: в ней шире покрытие доставки и представлены корректные КЛАДР-коды по всем городам.

2. Добавлены рекомендация по использованияю метода получения решения по заявкам на кредитные карты.

Исправлена валидация для поля payload.personalDataBirthday (дата рождения) в заявке на Дебетовую карту.

-Максимальная дата рождения должна быть = текущая дата – 18 лет – 1 день, иначе поле не валидируем + ошибка: Минимальный возраст для рассмотрения заявки 18 лет. Если вам ещё не исполнилось 18 лет, для оформления карты необходимо обратиться в офис Банка.

-Минимальная дата рождения должна быть = текущая дата-дата рождения < 81 год, иначе поле не валидируем + ошибка: Максимальный возраст для оформления карты должен быть не более 81 года
• Если дата введена не полностью, поле не валидируем + отобразить ошибку: Укажите дату в формате дд.мм.гггг

Мы отменили обязательность для поля payload.personalDataAdditionalPhoneOwnerType (Владелец дополнительного номера телефона) в заявке на кредитную карту, версия omni_5.0
Версия формы не поменялась.
Вы можете оставить все как есть или убрать отправку параметра payload.personalDataAdditionalPhoneOwnerType в заявках.
В любом случае заявка будет отправляться.

Добавили возможность получать веб-хуки с обновлением статусов по кредитным картам и кредиту наличными

Подробнее в документации - https://api.uralsib.ru

Появилась возможность присылать заявки на открытие РКО через OpenAPI

Подробнее в документации

https://api.uralsib.ru/docs/api/specifications/rkoPartnerV1.html

Добавлены изменения в документацию: https://api.uralsib.ru/docs/api/directory/deliveryServices2.html

1. Добавлено описание фильтрации для Москвы и Санкт-Петербурга (см.п.3.3, "Практика использования").

2. В случае если нет КЛАДР в "dadata: settlement_kladr_id" и
"dadata: address.data.city_kladr_id" необходимо проверять значение в "dadata: address.data.area_kladr_id" (см.пункт 2, "Практика использования").


Описание данных настроек уже было ранее в спецификации: https://api.uralsib.ru/docs/api/specifications/creditCardV5.html. Добавили в раздел со справочниками чтобы не было разночтений.

Просим проверить и применить у себя настройки в случае их отсутствия.

Расширена валидация для полей адреса, теперь допустима отправки латиницы, если в справочнике ГАР / ФИАС она содержится, документация обновлена:

Поля:
Дебетовая карта: https://api.uralsib.ru/docs/api/specifications/debitCardV5.html
• payload.livingAddressStreet (улица проживания)
• payload.livingAddressCity (нас.пункт проживания)
• payload.registrationAddressStreet (улица регистрации)
• payload.registrationAddressCity (нас.пункт регистрации)
• payload.deliveryAddressStreet (улица доставки)
• payload.deliveryAddressCity (нас.пункт доставки)


Кредитная карта: https://api.uralsib.ru/docs/api/specifications/creditCardV5.html
• payload.registrationAddressStreet (улица регистрации)
• payload.registrationAddressCity (нас.пункт регистрации)
• payload.deliveryAddressStreet (улица доставки)
• payload.deliveryAddressCity (нас.пункт доставки)

Для получения списка с городами доставки (v2) необходимо теперь использовать в фильтре код продукта. Планируем в ближайшее время применить фильтры, для определенного кода будут доступны одни города доставки и недоступны другие.

• Для получения списка городов для кредитной карты необходимо использовать запрос с кодом "836_OMNI" в фильтре: GET /directory/delivery-cities-v2?filter[productCode]=836_OMNI
• Для получения списка городов для дебетовой карты необходимо использовать запрос с кодом "009" в фильтре: GET /directory/delivery-cities-v2?filter[productCode]=009

Проверку по конкретному КЛАДР-коду населенного пункта можно выполнить отправив запрос с кодом КЛАДР нас.пункта, который выбрал клиент и код продукта:
Пример: GET /directory/delivery-cities-v2?filter[kladr]=2900000100000&filter[productCode]=009

Подробнее в документации:
https://api.uralsib.ru/docs/api/directory/deliveryServices2.html

Изменены правила валидации на форме Дебетовая карта v5

Поле Кодовое слово (personalDataCodeWord) стало необязательным, партнеры могут полностью исключить его из отправки в запросе (предварительно проверив корректность работы на тестовом стенде)

Изменения в спецификации отразятся в ближайшее время