> For the complete documentation index, see [llms.txt](https://sravni-labs-ru.gitbook.io/sravni-labs.ru-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sravni-labs-ru.gitbook.io/sravni-labs.ru-docs/ne-aktualno/business-loans/opisanie-skhemy-integracii.md).

# Описание схемы интеграции

Как можно произвести интеграцию между системами

**В данном разделе представлено 3 различных схемы интеграции.**

{% hint style="info" %}

* **Первая схема** отрисована для процесса, когда партнер хочет подключаться исключительно через  наши методы API. На стороне Партнера происходит настройка логики вызовов методов API (Анкетное и Поточное взаимодействие)
* **Вторая схема** отрисована для процесса, когда у Партнера есть шина/брокер, в которую сможет обращаться наш сервис. В этой схеме обмен заявками можно осуществлять асинхронно, этот вариант обсуждается индивидуально
* **Третья схема** отрисована для процесса, когда у Партнера уже есть свой API. На нашей стороне происходит настройка логики вызовов методов по документации Партнера
  {% endhint %}

## **Описание систем на схемах**

{% hint style="info" %}

* `Интернет сайт sravni-ru` - по сути всё взаимодействие пользователя начинается  с этой страницы [ https://www.sravni.ru/biznes-kredity/podbor/](https://www.sravni.ru/biznes-kredity/podbor/)
* `BACK service business loan` - вся логика по заявкам кредитов происходит в этом сервисе (наш сервис)
* `Агентский кабинет` - конкретно в этом процессе, через него работают наши кураторы по кредитам, видят заявки с интернет сайта и могут связаться с пользователем
* `API business loan` - API сервис, который содержит методы позволяющие Партнерам получать нужную для них информацию для создания заявки в своей системе, а также получать ИНН для прескоринга внутри своих систем
* `Шины/Брокеры` - нам не принципиально, мы гибкие и можем подстроится под Партнера. Но предпочтительнее использовать RabbitMQ
* `BACK service Партнера` - по сути обобщённое название сервиса Партнера, который будет обращаться в наш новый API или работать с ивентами
* `Интернет Банк Партнера` - по сути любой ресурс предоставленный Партнером, через который пользователь, при наличии предодобренного предложения, смог бы оформить кредит и подписать документы онлайн
* `Чёрный ящик` - любые системы Партнеров, по сути может быть что угодно
  {% endhint %}

### **1. Схема интеграции через наше API business-loan-api** [**business-loan-api-sravni.pdf**](https://drive.google.com/file/d/1iLq90kPtD4-foBbwJ0wA-xQT_R1BRWSX/view?usp=sharing)<br>

<div align="center" data-full-width="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfOwPIxDD-YIHy-WYWTYboPyZiWYa5xl3cCqlb7Btd9LpDpSe75jWhp_rN7X9S6Gf8CtxlsmISFOGSayK34GVxRiRfaZkimQzEzOaY3ymBH9rHWCgbuvyNOmX6xaLgootcKHLqgA-gs3dX0tlge4mRUF5Y?key=UPB17CnSKL_hTpRpIEikmg" alt=""><figcaption><p>API business-loan-api (лучше открывать в PDF)</p></figcaption></figure></div>

### Описание последовательности интеграции через API&#x20;

1. `Интернет сайт sravni.ru` передаёт ИНН в `API business loan` при заполнении его на фронте
2. `Интернет сайт sravni.ru` передаёт данные и документы по созданной заявке в `BACK service business loan`
3. `BACK service business loan` направляет заявку на куратора в `Агентский кабинет`
4. `BACK service Партнера` на регулярной основе обращается к `API business loan` для того, чтобы получать ИНН необходимые для прескоринга внутри банка Партнера
5. `BACK service Партнера` на регулярной основе обращается к `API business loan` для того, чтобы передавать информацию о прескоренных ИНН с признаком возможности оформления предодобренного предложения (или отсутствием возможности оформления)
6. `BACK service Партнера` на регулярной основе обращается к `API business loan` для того, чтобы получать информацию по полным анкетным данным для создания заявки внутри системы Партнера
7. `BACK service Партнера` на регулярной основе обращается к `API business loan` для того, чтобы отдавать информацию по обновлению статуса по созданным заявкам из предыдущего пункта
8. `Черный ящик` отображает для менеджера банка заявку с источником sravni.ru, менеджер работает с заявкой
9. `Интернет сайт sravni.ru` при наличии в БД Сервиса ИНН с предодобренным предложением от Партнера- выведет специальный баннер, по которому предполагается переходить в Интернет банк Партнера

***

### **2. Схема интеграции через шину/брокера** [**business-loan-api-broker.pdf**](https://drive.google.com/file/d/18gP6OC0MuyzG_NzNeRaYK6sYwhG7jZ4b/view?usp=sharing)

<div data-full-width="true"><figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeS1KHYMluhDTuns3Po4ag3uRZxL7NvsAX3uMWOx4R4fdsxR0QjTj3rRC3-tRLvRVBv2sm2JrDVe0lmKRF5jocTySkQQOyQ0gnl7hXavlQBmf79-w5PYunTt0CsIHSlFZFMTKKPzRiWJ2jmbbJul2MHbSuw?key=UPB17CnSKL_hTpRpIEikmg" alt=""><figcaption><p>Шина/Брокер (лучше открывать в PDF)</p></figcaption></figure></div>

### Описание последовательности интеграции через шину/брокера

1. `Интернет сайт sravni.ru` передаёт ИНН в `API business loan` при заполнении его на фронте
2. `Интернет сайт sravni.ru` передаёт данные и документы по созданной заявке в `BACK service business loan`
3. `BACK service business loan` получает созданную заявку и отправляет ивент об этом в `Шину/Брокер Партнера`
4. `BACK service business loan` направляет заявку на куратора в `Агентский кабинет`
5. `BACK service Партнера` вычитывает сообщение из `Шины/Брокера Партнера`
6. `Черный ящик` отображает для менеджера банка заявку с источником sravni.ru, менеджер работает с заявкой
7. `BACK service Партнера` отслеживает изменения статусов по заявкам и при изменении направляет ивент в `Шину/Брокер sravni.ru`
8. `BACK service business loan` вычитывает сообщение из `Шины/Брокера sravni.ru` и актуализирует статус заявки
9. `BACK service Партнера` на регулярной основе обращается к `API business loan` для того, чтобы получать ИНН необходимые для прескоринга внутри банка Партнера
10. `BACK service Партнера` на регулярной основе обращается к `API business loan` для того, чтобы передавать информацию о прескоренных ИНН с признаком возможности оформления предодобренного предложения (или отсутствием возможности оформления)
11. `Интернет сайт sravni.ru` при наличии в БД Сервиса ИНН с предодобренным предложением от Партнера- выведет специальный баннер, по которому предполагается переходить в Интернет банк Партнера

***

### **3. Схема интеграции через API Партнера** [**business-loan-api-partners.pdf**](https://drive.google.com/file/d/1etEsDDGZZ3l0pYwt4nY7z16vLOm25ckf/view?usp=sharing)<br>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe0gDDHno7f4tv-vY7v9RYRnnK-I0w4n-nP6qHSrydAMllE2SehGN4yWZd76sEjB2gPaabaiFWBV08l62snQDJf9kDAt3YhsPO6dU2qPsIBY4TNeiPrtWXr8oTRc7b-R6p1VEaFconBBLlue3ApS7thVe_E?key=UPB17CnSKL_hTpRpIEikmg" alt=""><figcaption><p>API Партнера (лучше открывать в PDF)</p></figcaption></figure>

### Описание последовательности интеграции через API Партнера

В этом варианте отрисовано взаимодействие, если API предоставляется Партнером. Мы гибко подстраиваемся под каждого Партнера сами.

1. `Интернет сайт sravni.ru` передаёт ИНН в `BACK service business loan` при заполнении его на фронте
2. `BACK service business loan` вызывает метод в `API Партнера` для проведения прескоринга&#x20;
3. `Интернет сайт sravni.ru` передаёт данные и документы по созданной заявке в `BACK service business loan`
4. `BACK service business loan` вызывает метод в `API Партнера` для отправки данных на создание заявки у Партнера
5. `BACK service business loan` направляет заявку на куратора в `Агентский кабинет`
6. `BACK service business loan` вызывает метод в `API Партнера` для получения заявок и их статусов у Партнера
7. `Черный ящик` отображает для менеджера банка заявку с источником sravni.ru, менеджер работает с заявкой
8. `Интернет сайт sravni.ru` при наличии в БД Сервиса ИНН с предодобренным предложением от Партнера - выведет специальный баннер, по которому предполагается переходить в Интернет банк Партнера

<br>
