Оглавление
1. Порядок обмена интеграционными сообщениями в рамках бизнес-процесса получения, обработки заявки и выдачи Продукта
Для просмотра в увеличенном масштабе нажмите на картинку левой кнопкой мыши.
Комментарии к рис. выше:
1. На стороне HUB должны быть определены ендпоинты, описанные в https://sandbox.goodfin.ru/docs/shb-open-api/v1/index.html:
для получения информации по заявке сервисом:
GET /api/v1/document/getdocumentfile
POST /ad/v1/external/dealapplication/byid (наименование ендпоинта может быть иным, формироваться по правилам HUB. Сотрудники HUB должны передать наименование для регистрации в адаптере Goodfin)
для получения сообщений вида CommonResponse, ChangeDealAppStatEvent от сервисов в точку интеграции HUB:
POST /ad/v1/external/openapi/in (наименование ендпоинта может быть иным, формироваться по правилам HUB. Сотрудники HUB должны передать наименование для регистрации в адаптере Goodfin)
2. HUB должен уметь передавать заявки в установленном формате, концепция которого описана в I. Подготовительные работы по интеграции c применением API (см. раздел "Концепция организации передаваемых данных, используемая в API").
3. Шаг №3 показан укрупненно и состоит из более мелких шагов: автопроверка (после которой заявка может вернуться); запрос на скачивание документов в составе заявки и, если все автоматические проверки пройдены, происходит смена статуса на "Готова к подписанию" или др. (зависит от конкретного банковского сервиса).
4. Если пользователям HUB по аналогии с пользователями Goodfin будет предоставлена возможность отправить запрос на отзыв заявки на любом шаге бизнес-процесса, то сервис может отказать в отзыве заявки или вернуть статус "Отозвана клиентом".
5. В процессе рассмотрения заявки в сервисе возможны различные шаги и статусы. В зависимости от жизненного цикла заявки с сервиса могут приходить статусы типа:
"На рассмотрении";
"Направлен запрос клиенту";
"Формируется предложение";
"Формирование документов предложения";
"Проверка документов";
"Повторная проверка документов";
"Проект на согласовании";
"Запрос от клиента на доработку";
"Предложение принято";
"Предложение оплачено";
"Поиск предложений";
"Предварительное предложение принято"
и др.
6. На рис. желтыми прямоугольниками обозначены задачи, которые выполняет пользователь; зелёными - сервисные задачи, выполняемые системами; оранжевыми - задачи, которые на текущий момент выполняет пользователь с применением сквозной авторизации и переходом в банковский сервис (будут вестить работы, чтобы уйти от сквозной авторизации).
7. Все интеграционные взаимодействия между HUB и банковскими сервисами проходит через адаптер Goodfin, который выполняет необходимые преобразования сообщений под требования определенных банковских сервисов, тем самым обеспечивая для HUB единообразие в формате общения с различными банковскими сервисами.
2. Плюсы и минусы схемы интеграционного взаимодействия для владельцев HUB
Плюсы
- Клиенты/агенты HUB получают доступ ко всем банковским сервисам и их предложениям по продуктам, которые подключены к Goodfin.
- Владельцам HUB достаточно поддерживать только один формат API от Goodfin, прочие издержки по работе на уровне API с банковскими сервисами берет на себя "Адаптер Goodfin" и команда поддержки Goodfin.
- Данные клиентов/агентов остаются у владельца HUB и "не перетекают" в Goodfin.
Минусы
- Владельцам HUB необходимо выполнить доработки пользовательского интерфейса: добавить возможность показывать клиентам предложения от нескольких банков; показывать текущее состояние заявок по нескольким банкам; в случае, если клиент подал несколько заявок в разные банки и в одном из них получил продукт, то автоматически отзывать прочие заявки; добавить возможность отправки заявки с исправленными данными, если по предыдущей получен отказ; выполнять и поддерживать настройки обязательности полей для каждого сервиса; фильтровать предложения от банковских сервисов, чтобы снизить для клиента "стресс" от получения отказов от банков, если заведомо клиент не подходит под требования банка.
- Многие банковские сервисы требуют выполнения операций по подписанию заявки, принятию предложения, докреплению доп. документов и пр. на стороне интерфейса банка. Следовательно, владельцам HUB может потребоваться реализация сервера авторизации на базе Oauth для организации доступа клиентов со сквозной авторизацией к интерфейсу банков.
3. Укрупненная схема компонентов
4. Что нужно сделать владельцам HUB?
Примечание:
1. На текущий момент средствами OPEN API Goodfin отсутствует возможность запросить: "предварительный тариф по выбранному банковскому продукту(ам)", "получить список недостающих данных (данные карточки клиента, документы, финансовые показатели), которые обязательны в составе отправляемой заявки для выбранного банковского продукта(ов)"; "получить актуальный на момент обращения список подключенных банковских сервисов к Goodfin". Данные функции реализованы только для заявок, которые были сформированы из данных, хранящихся в самой системе Goodfin.
2. Банковские сервисы на базе IT-Finance (а также ITCredit) на текущий момент должны будут выполнить настройки по возможности приема заявок от HUB, отличного от Goodfin. Чтобы исключить необходимость регистрации HUB во всех подключенных сервисах командой Goodfin должна быть проведена доработка единого сервера авторизации.
3. Прочие банковские сервисы могут потребовать/ не потребовать другие спец. настройки или доработки. Предсказать сложно, так как процесс подключения новых систем динамичный и может быть растянут во времени по независящим от команды Goodfin причинам.
| Виды работ | Требования к HUB | Перечень доработок на адаптере Goodfin | Перечень доработок в банковских сервисах, которые подключены к Goodfin | Прочие организационные требования к команде Goodfin |
|---|---|---|---|---|
| Доработка тестового окружения в рамках sandbox.goodfin | Проверить возможности sandbox.goodfin адаптера принимать сообщения от HUB, отличного от Goodfin (готовность его работы с несколькими HUB). Для проверки подготовить postman - проект или soapUI - проект, имитирующий отправку заявок от имени HUB. | Подключить в ограниченном режиме тестовую инстанцию без прав доступа со стороны банковских работников и регистрации извне, чтобы проверить в последующем, что: - заявка дошла; | Дописать статью с правилами подключения к тестовой среде или организовать передачу необходимых данных для работы с тестовой средой по закрытому каналу. | |
| Поддержка в HUB формата заявки согласно требованиям OPEN API Goodfin | Согласно описанию концепции передаваемых данных в I. Подготовительные работы по интеграции c применением API реализовать метод(ы) маппинга данных из заявки в формате HUB в формат Goodfin.. | |||
| Реализация возможности поддержки OPEN API Goodfin | На стороне HUB должны быть определены ендпоинты, описанные в https://sandbox.goodfin.ru/docs/shb-open-api/v1/index.html: 1. Для получения информации по заявке сервисом: Примечание: наименование ендпоинта может быть иным, формироваться по правилам HUB. Сотрудники HUB должны передать наименование для регистрации в адаптере Goodfin. 2. Для получения сообщений вида CommonResponse, ChangeDealAppStatEvent от сервисов в точку интеграции HUB: Примечание: наименование ендпоинта может быть иным, формироваться по правилам HUB. Сотрудники HUB должны передать наименование для регистрации в адаптере Goodfin. | |||
| Унификация порядка скачивания документов под требования API Goodfin | Предоставить ендпоинт с правами доступа, по которому сервисы будут обращаться за скачиванием документов в составе заявки в рамках поддержки метода getdocumentfile. | Опубликовать требования к скачиванию документов (ендпоинты скачивания файлов, получения информации о заявке). В составе заявки передавать информацию о path к скачиванию каждого документа. | Использовать пути из заявки для скачивания документов вместо текущего пути скачивания по умолчанию, соответствующего Goodfin. | |
| Возможность клиентов HUB переходить в сервис по ссылкам с авторизацией через HUB, для выполнения операций | Реализовать сервер авторизации на базе Oauth, выполняющий укрупненно следующие операции: - клиент HUB обращается к странице сервиса, которая требует авторизации; | Доработка единого сервера авторизации. | ||
| Интеграционное тестирование в рамках sandbox.goodfin | Подготовить генератор тестовых заявок средствами функциональности HUB для проверки качества проведенных подготовительных работ на HUB. Сообщить данные для адаптера Goodfin. | На адаптере провести работы по подключению.
| ||
| Возможность клиентам HUB переходить по ссылкам в сервисы с авторизацией и без для выполнения различных действий: подписание заявки в сервисе; ответ на доп.запрос(ы) документов или исправление данных заявки; принятие предложения; прикрепление платежного документа; скачивание готовых документов при выпуске банковского продукта. | Поддерживать различные шаблоны формирования внешних ссылок, которые реализованы в банковских сервисах. | На базе сервисов, отличных от IT-Finance могут потребоваться доработки по предоставлению внешней ссылки для подписания, формат которой надо будет передать разработчикам HUB для поддержки. | Организовать передачу актуальных данных по правилам формирования внешних ссылок каждого сервиса. | |
| Добавление возможности клиентам на уровне UI HUB работать с сервисами | Выполнить доработки пользовательского интерфейса: | Организовать передачу актуальных данных: | ||
| Поддержание в актуальном состоянии справочников со списком подключенных сервисов и продуктов | При "ручном" способе поддержки обновлять раздел "Единый указатель по справочникам" раз в месяц. Разовые работы: доопределить все справочные данные, которые Goodfin должен предоставить владельцам HUB для организации процесса интеграции; выложить/актуализировать в разделе "Единый указатель по справочникам". |