Документация | Справочник API

Обзор функционала

Функция согласования договоров позволяет отправлять проект договора найма потенциальным нанимателям для ознакомления и получения их согласия или возражений. Это упрощает процесс преддоговорных переговоров.

Основные возможности

Автоматическая отправка письма с договором на email получателя
Вложение PDF с полным текстом договора
Возможность скрыть реквизиты нанимателя в документе
Отслеживание статуса: отправлено, просмотрено, одобрено, отклонено
Получение комментариев и возражений от потенциальных нанимательов
Автоматическое уведомление наймодателя об ответе

Права доступа

Функция согласования договоров доступна только владельцам недвижимости и их представителям.

Роль	Отправить	Просмотреть список	Удалить
Наймодатель	Да	Да	Да
Представитель наймодателя	Да	Да	Да
Наниматель	Нет	Нет	Нет

Как отправить договор на согласование

1

Откройте страницу объекта

Перейдите на страницу объекта недвижимости, для которого хотите отправить договор.

2

Нажмите кнопку согласования

Нажмите иконку рукопожатия рядом с названием объекта для открытия формы отправки.

3

Заполните данные получателя

Введите имя и email потенциального нанимателя, выберите язык документа.

4

Выберите договор

Выберите существующий договор или создайте новый, настроив блоки условий.

5

Отправьте на согласование

Нажмите кнопку "Отправить". Письмо будет отправлено на указанный email.

Варианты договора

Существующий договор

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

Новый договор

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

Опция "Без реквизитов"

Включите эту опцию, чтобы скрыть персональные данные нанимателя в PDF документе. Это полезно для защиты конфиденциальности на этапе переговоров.

Статусы согласования

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

Черновик

Создано, но ещё не отправлено

Отправлено

Письмо отправлено, ожидается просмотр

Просмотрено

Получатель открыл ссылку

Согласовано

Договор одобрен получателем

Отклонено

Договор отклонён с комментарием

Просрочено

Срок действия ссылки истёк

Отменено

Погашено сменой стороны договора или отозвано владельцем

Как это работает для получателя

Потенциальный наниматель получает письмо со ссылкой на просмотр договора.

1

Открытие ссылки

Получатель переходит по ссылке из письма и видит страницу с договором и кнопкой скачивания PDF.

2

Ознакомление с договором

Получатель скачивает PDF и изучает условия договора найма.

3

Отправка ответа

Получатель нажимает "Одобрить" или "Отклонить" и может добавить комментарий со своими замечаниями.

Уведомление наймодателя

Сразу после ответа получателя, наймодатель получает email-уведомление с результатом согласования, комментарием и рекомендациями по дальнейшим действиям.

Просмотр результатов

Все отправленные согласования и их результаты доступны в списке согласований объекта.

Колонка	Описание
Получатель	Имя и email получателя договора
Договоры	Ссылка на связанный договор
Отправлено	Дата и время отправки письма
Статус	Текущий статус согласования (отправлено, просмотрено, одобрено, отклонено)
Ответ	Комментарий или возражение от получателя

API для интеграций

Для автоматизации работы с согласованиями доступен REST API.

Примечание уровня сервиса

Доступные эндпоинты

GET    /api/v1/properties/{id}/negotiations           # Получить список согласований
POST   /api/v1/properties/{id}/negotiations           # Создать и отправить согласование
GET    /api/v1/properties/{id}/negotiations/{nid}     # Получить детали согласования
DELETE /api/v1/properties/{id}/negotiations/{nid}     # Удалить согласование
POST   /api/v1/properties/{id}/negotiations/{nid}/resend # Переотправить письмо

Пример запроса

Тело POST запроса для создания согласования

{
  "recipient_email": "[email protected]",
  "recipient_name": "John Doe",
  "locale": "uk",
  "hide_requisites": true,
  "expires_in_days": 14,
  "contract_type": "existing",
  "contract_id": 5
}

Полная документация API доступна в Swagger:

Открыть документацию API

Согласование договоров