Интеграция с сервисом ипотеки Сделка.РФ

Интеграция позволяет создать Ипотечную заявку в Сделка.рф из MACRO, продолжить работу с ней в кабинете Сделка.рф и автоматически получать в MACRO статусы рассмотрения и условия одобрения от банков.

#Как устроен обмен

Обмен данными идет в двух направлениях:

MACRO → Сделка.рф: сведения об ипотечной заявке, заемщиках, сделке, объекте и настроенных банках.
Сделка.рф → MACRO: статусы заявок в банки и, при одобрении, сумма кредита, срок и процентная ставка.

Документы и дополнительные сведения, для которых в MACRO нет полей, заполняются в кабинете Сделка.рф. Изменения, внесенные в Сделка.рф, не переносятся в карточки заемщиков, сделки или объекта в MACRO.

#Какие данные передаются

Направление	Сущность	Данные
MACRO → Сделка.рф	Заемщики	ФИО, дата и место рождения, пол, телефон, email, ИНН, СНИЛС, документ, адреса и семейное положение.
MACRO → Сделка.рф	Анкеты заемщиков	Сведения о браке и супруге, доходе, работодателе, трудоустройстве и образовании.
MACRO → Сделка.рф	Сделка и объект	Связь с заявкой на покупку; при наличии объекта — его название, регион, категория и готовность дома.
MACRO → Сделка.рф	Условия кредита	Стоимость объекта, первоначальный взнос, срок и базовый ипотечный продукт.
MACRO → Сделка.рф	Банки	Коды банков из сопоставления и email, указанные в соответствующих контактах банков MACRO.
Сделка.рф → MACRO	Заявки в банки	Банк, текущий статус и дата изменения статуса. Если локальной заявки в этот банк нет, MACRO создаст ее автоматически.
Сделка.рф → MACRO	Одобрение	Одобренная сумма, срок в месяцах и процентная ставка.

#Перед началом работы

Для подключения обратитесь к администратору MACRO или ответственному за интеграции в вашей компании. Необходимо выполнить следующие настройки.

Подключить платную опцию Сделка.рф. Ипотечный сервис активируется отдельно от электронной регистрации.
Настроить интеграцию с электронной регистрацией Сделка.рф. Для ипотеки используются те же учетные данные: второй комплект Client_id и Client_secret заводить не нужно.
Открыть Настройки компании → Интеграции → Сделка.рф и убедиться, что подключение активно.
Скопировать Webhook URL и передать его технической поддержке Сделка.рф. Без подключения webhook статусы и условия одобрения не будут поступать в MACRO автоматически.
Создать в MACRO контакты банков с ролью Банк ипотечный, если их еще нет.
В блоке Ипотека. Сопоставление ипотечных банков сопоставить каждый нужный банк Сделка.рф с контактом банка в MACRO и сохранить настройки.
Если заявка отправляется по существующей сделке и объекту, для компании-застройщика также должен быть указано сопоставление юридического лица Сделка.рф. При отсутствии сопоставления MACRO покажет ошибку во время отправки.

#Подготовка ипотечной заявки

Откройте раздел Ипотечные заявки и создайте новую заявку либо откройте существующую.
Выберите связанную заявку на покупку. Без нее кнопка отправки в Сделка.рф недоступна:
Проверьте основного заемщика и всех созаемщиков. В карточках должны быть актуальные персональные, паспортные и контактные данные, адреса, семейное положение, сведения о работе, доходе и образовании.
Если созаемщик является супругом или супругой, заполните признаки супруга, гражданства, учета дохода и брачного договора:

Состав банков, в которые будет направлена заявка, определяется сохраненным сопоставлением банков в настройках интеграции. До отправки убедитесь, что в сопоставлении оставлены только нужные банки и у контактов банков указаны актуальные адреса электронной почты.

#Отправка заявки

В карточке ипотечной заявки откройте блок Банки.
Нажмите Отправить заявку в Сделка.рф:
Дождитесь завершения отправки и не нажимайте кнопку повторно в другой вкладке.

MACRO автоматически:

найдет существующие карточки заемщиков в Сделка.рф либо создаст новые;
создаст или переиспользует сделку, связанную с заявкой на покупку;
проверит обязательные данные заемщиков;
создаст анкеты основного заемщика и созаемщиков;
создаст одну ипотечную заявку для всех заемщиков и передаст в нее список банков.

Если заявка на покупку уже находится в статусе Сделка в работе или Сделка проведена, используется связанная сделка Сделка.рф. Для более раннего статуса MACRO создает техническую сделку с минимальным набором данных.

После успешной отправки кнопка исчезнет, а вместо нее появится ссылка Перейти к заявке в Сделка.рф:

#Что делать при ошибке

Если Сделка.рф отклонит данные, под кнопкой появится красный блок с перечнем ошибок.

Прочитайте сообщения: для ошибки заемщика MACRO указывает его имя.
Исправьте данные в карточке ипотечной заявки или контакта.
Снова нажмите Отправить заявку в Сделка.рф.

Повторный запуск продолжает незавершенную отправку и по возможности использует уже созданные внешние сущности. Карточка заемщика, ранее связанная со Сделка.рф, перед проверкой обновляется данными из MACRO.

Если ошибка возникла после создания анкеты заемщика или другого внешнего объекта, часть данных уже может находиться в Сделка.рф. Не создавайте новую ипотечную заявку в MACRO только ради повтора. Сначала исправьте данные и повторите отправку из той же карточки. Если ошибка остается, передайте текст ошибки в поддержку.

#Работа после отправки

Перейдите по ссылке Перейти к заявке в Сделка.рф. В кабинете Сделка.рф:

дополните заявку данными, которых нет в MACRO;
приложите документы;
проверьте состав банков;
отправьте заявку непосредственно в банки;
выполните доработку, если банк вернул заявку.

Сама передача из MACRO создает заявку в Сделка.рф, но не заменяет ее отправку в банки из кабинета Сделка.рф.

#Что возвращается в MACRO

После отправки заявки в банки Сделка.рф передает уведомления в MACRO. В блоке Банки создается заявка в соответствующий банк либо обновляется уже существующая.

Событие в Сделка.рф	Статус в MACRO
Заявка отправлена в банк	Отправлено в банк
Заявка возвращена на доработку	Возврат на доработку
Заявка повторно отправлена после доработки	Отправлено в банк
Банк отказал	Отказ банка
Банк одобрил кредит	Кредит одобрен

При одобрении MACRO дополнительно записывает в заявку банка:

одобренную сумму кредита;
срок в месяцах;
процентную ставку.

#Можно ли изменять данные после обмена

Действие	Можно ли	Что произойдет
Исправить данные до успешной отправки	Да	При следующей попытке MACRO использует актуальные локальные данные; уже связанная карточка заемщика в Сделка.рф обновляется.
Повторить незавершенную отправку после ошибки	Да	MACRO продолжит процесс и переиспользует уже созданные связи, где это возможно.
Изменить ипотечную заявку, заемщиков, сделку или объект в MACRO после успешной отправки	Да, локально в MacroCRM	Изменения сохранятся только в MACRO, автоматически НЕ обновят уже созданную заявку в Сделка.рф.
Повторно отправить успешно созданную заявку из MACRO	Нет	После успеха кнопка заменяется ссылкой на внешнюю заявку. Дальнейшие изменения вносятся в кабинете Сделка.рф.
Изменить данные в Сделка.рф	Да	В MACRO автоматически вернутся только поддерживаемые статусы и условия одобрения; данные заемщиков, сделки, объекта и документы обратно не синхронизируются.
Изменить локальную заявку в банк	Да	Изменение останется в MACRO. Следующий webhook Сделка.рф может обновить статус и параметры одобрения этой заявки.
Изменить сопоставление банков после отправки	Да, для следующих заявок	Уже связанная заявка банка не переносится на другой контакт. Новое сопоставление применяется к последующим обменам.

#История изменений

В карточке ипотечной заявки откройте пункт Лог в левом меню. В нем фиксируются:

успешная отправка и список банков;
неудачная попытка отправки;
создание заявки в банк по уведомлению Сделка.рф;
изменение статуса заявки в банк;
получение суммы, срока и ставки при одобрении.

Автоматические события отображаются от имени «Система».

#Уведомления сотрудникам

Чтобы менеджер не пропускал изменения статусов, настройте триггер.

Откройте Компании → Настраиваемые события.
Выберите сущность Ипотечные заявки.
Выберите событие Получено уведомление от Сделка.рф.
При необходимости добавьте условие Тип уведомления Сделка.рф и выберите нужные типы уведомлений.
Добавьте действие «Оповестить сотрудников» или «Создать задачу».
В качестве получателя или исполнителя выберите менеджера ипотечной заявки либо конкретных сотрудников компании.

В сообщениях можно использовать данные основного заемщика и ссылку на ипотечную заявку.

#Если статусы не приходят

Проверьте по порядку:

Заявка успешно создана и открывается по ссылке из MACRO.
В кабинете Сделка.рф она действительно отправлена в банк.
Webhook URL передан и подключен поддержкой Сделка.рф.
Банк сопоставлен с действующим контактом с ролью Банк ипотечный.
Событие и результат его обработки появились в логе ипотечной заявки.

Если проблема сохраняется, передайте в поддержку номер ипотечной заявки MACRO, название банка, время события и снимок экрана с ошибкой или логом.