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

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

Коммерческое предложение — это профессиональная презентация объекта недвижимости, которую вы можете отправить потенциальному нанимателю по электронной почте. Получатель получает ссылку на страницу с подробной информацией об объекте, фотографиями, характеристиками и формой обратной связи.

Ключевые возможности

Полная информация об объекте недвижимости
Фотогалерея
Характеристики и параметры объекта
Перечень имущества наймодателя
Форма обратной связи для получателя
Отслеживание просмотров и ответов
Поддержка 4 языков (UK, EN, RU, PL)

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

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

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

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

1

Откройте объект

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

2

Нажмите кнопку отправки

На странице объекта найдите кнопку с иконкой конверта (📨) или выберите пункт "Коммерческое предложение" в меню действий.

3

Заполните форму

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

4

Выберите срок действия

Укажите, сколько дней предложение будет активным: 7, 14, 30 или 60 дней. После истечения срока ссылка станет недоступной.

5

Отправьте предложение

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

Поля формы

Поле	Обязательное	Описание
Email получателя	Да	Email адрес, на который будет отправлено письмо с предложением
Имя получателя	Да	Имя получателя для персонализации письма
Валюта отображения	Нет	Валюта для отображения цен и стоимостей на странице предложения
Сопроводительное сообщение	Нет	Персональное сообщение от вас, которое будет показано в письме и на странице предложения
Язык документа	Да	Язык интерфейса для письма и страницы предложения
Ссылка действительна (дней)	Да	Количество дней, в течение которых ссылка будет активной (7, 14, 30 или 60 дней)

Что включено в предложение

Страница коммерческого предложения автоматически включает всю публичную информацию об объекте:

Информация об объекте

Название, адрес, тип объекта

Фото

Фотогалерея объекта, до 8 фото

Характеристики

Площадь, этаж, количество комнат и другие параметры

Инфраструктура

Расстояния до метро, магазинов, школ и других точек — в минутах пешком

Условия аренды

Сумма и период аренды, указанные вами при отправке предложения

Имущество

Мебель и оборудование наймодателя

Статусы предложений

Система автоматически отслеживает состояние каждого предложения:

Отправлено

Письмо отправлено, получатель ещё не открыл ссылку

Просмотрено

Получатель просмотрел страницу предложения

Получен ответ

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

Срок истек

Срок действия предложения истёк

Что видит получатель

Получатель коммерческого предложения проходит следующие шаги:

1

Получение письма

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

2

Просмотр предложения

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

3

Ответ

Если получатель заинтересован, он может оставить сообщение и контактный телефон через форму обратной связи.

Форма обратной связи

Когда получатель оставляет ответ, вы получаете email-уведомление с его контактами и сообщением. Статус предложения меняется на "Получен ответ".

Конфиденциальность

Важно

Каждое письмо содержит предупреждение о конфиденциальности информации. Получатель предупреждается, что передача данных об объекте третьим лицам запрещена без письменного согласия.

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

Список всех отправленных предложений доступен в меню объекта. Для каждого предложения отображается:

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

REST API

Коммерческие предложения также доступны через REST API для интеграции с другими системами.

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

Эндпоинты API

GET    /api/v1/properties/{id}/proposals           # Список предложений
POST   /api/v1/properties/{id}/proposals           # Создать и отправить
GET    /api/v1/properties/{id}/proposals/{pid}     # Детали предложения
DELETE /api/v1/properties/{id}/proposals/{pid}     # Удалить предложение
POST   /api/v1/properties/{id}/proposals/{pid}/resend # Повторно отправить

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

Пример тела запроса (POST)

{
  "recipient_email": "[email protected]",
  "recipient_name": "John Doe",
  "locale": "uk",
  "currency_id": 1,
  "cover_message": "Personal message for the recipient",
  "expires_in_days": 14
}

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

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

Коммерческие предложения