Обновление от 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) стало необязательным, партнеры могут полностью исключить его из отправки в запросе (предварительно проверив корректность работы на тестовом стенде)

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

Технические работы на OpenAPI платформе www.uralsib.ru

29.11 с 00:00 будут проводиться большие технические работы, заявки от партнеров приниматься не будут до окончания технических работ.
После завершения технических работ разошлем отдельное оповещение.

Работы закончены. Заявки снова принимаются.

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

Поле Занимаемая должность (payload.incomeInfoJobPosition) стало необязательным, партнеры могут полностью исключить его из отправки в запросе (предварительно проверив корректность работы на тестовом стенде)

Изменения отражены в спецификации: https://api.uralsib.ru/docs/api/specifications/creditCardV5.html

⁃ Добавлены статусы по доставке карт, теперь можно получить более подробную информацию на каком этапе находится доставка.
⁃ Добавлены статусы об активации карты клиентом.
Подробнее в спецификации: https://api.uralsib.ru/docs/api/form/stats.html

Добавлены параметры для сессионных признаков о клиентах в запросе sessions:
1) forwarded_user_agent
2) forwarded_client_ip
3) screen_resolution
Подробная информация: https://api.uralsib.ru/docs/api/form/sessionStore.html