Документація | Довідник 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

Погодження договорів