Dokumentacja | Dokumentacja API

Przegląd funkcjonalności

Funkcja negocjacji umów pozwala wysyłać projekt umowy najmu potencjalnym najemcom do przeglądu i uzyskania ich zgody lub zastrzeżeń. Upraszcza to proces negocjacji przedumownych.

Kluczowe funkcje

Automatyczne wysyłanie emaila z umową do odbiorcy
Załącznik PDF z pełnym tekstem umowy
Możliwość ukrycia danych najemcy w dokumencie
Śledzenie statusu: wysłano, wyświetlono, zaakceptowano, odrzucono
Otrzymywanie komentarzy i zastrzeżeń od potencjalnych najemców
Automatyczne powiadomienie wynajmującego o odpowiedzi

Uprawnienia dostępu

Funkcja negocjacji umów jest dostępna tylko dla właścicieli nieruchomości i ich agentów.

Rola	Wyślij	Zobacz listę	Usuń
Gospodarz	Tak	Tak	Tak
Agent wynajmujący	Tak	Tak	Tak
Najemca	Nie	Nie	Nie

Jak wysłać umowę do zatwierdzenia

1

Otwórz stronę nieruchomości

Przejdź do strony nieruchomości, dla której chcesz wysłać umowę.

2

Kliknij przycisk negocjacji

Kliknij ikonę uścisku dłoni obok nazwy nieruchomości, aby otworzyć formularz wysyłania.

3

Wypełnij dane odbiorcy

Wprowadź imię i email potencjalnego najemcy, wybierz język dokumentu.

4

Wybierz umowę

Wybierz istniejącą umowę lub utwórz nową, konfigurując bloki warunków.

5

Wyślij do zatwierdzenia

Kliknij przycisk "Wyślij". Email zostanie wysłany na podany adres.

Opcje umowy

Istniejąca umowa

Wybierz wcześniej utworzoną umowę z listy. Wszystkie warunki są już skonfigurowane.

Nowa umowa

Utwórz nową umowę, konfigurując bloki warunków bezpośrednio w formularzu negocjacji.

Opcja "Bez danych"

Włącz tę opcję, aby ukryć dane osobowe najemcy w dokumencie PDF. Jest to przydatne do ochrony prywatności podczas negocjacji.

Statusy negocjacji

Każda negocjacja ma status, który odzwierciedla aktualny stan negocjacji.

Szkic

Utworzono, ale jeszcze nie wysłano

Wysłano

Email wysłany, oczekuje na przegląd

Wyświetlono

Odbiorca otworzył link

Zaakceptowano

Umowa zatwierdzona przez odbiorcę

Odrzucono

Umowa odrzucona z komentarzem

Wygasło

Okres ważności linku wygasł

Anulowano

Unieważnione zmianą strony umowy lub wycofane przez właściciela

Jak to działa dla odbiorcy

Potencjalny najemca otrzymuje email z linkiem do przeglądania umowy.

1

Otwarcie linku

Odbiorca przechodzi przez link z emaila i widzi stronę z umową oraz przyciskiem pobierania PDF.

2

Zapoznanie się z umową

Odbiorca pobiera PDF i zapoznaje się z warunkami umowy najmu.

3

Wysłanie odpowiedzi

Odbiorca klika "Zatwierdź" lub "Odrzuć" i może dodać komentarz ze swoimi uwagami.

Powiadomienie wynajmującego

Natychmiast po odpowiedzi odbiorcy wynajmujący otrzymuje powiadomienie emailem z wynikiem negocjacji, komentarzem i zaleceniami dotyczącymi dalszych kroków.

Przeglądanie wyników

Wszystkie wysłane negocjacje i ich wyniki są dostępne na liście negocjacji nieruchomości.

Kolumna	Opis
Odbiorca	Imię i email odbiorcy umowy
Umowy	Link do powiązanej umowy
Wysłano	Data i godzina wysłania emaila
Status	Aktualny status negocjacji (wysłano, wyświetlono, zaakceptowano, odrzucono)
Odpowiedź	Komentarz lub zastrzeżenie od odbiorcy

API do integracji

REST API jest dostępne do automatyzacji pracy z negocjacjami.

Uwaga dotycząca warstwy usługowej

Dostępne endpointy

GET    /api/v1/properties/{id}/negotiations           # Pobierz listę negocjacji
POST   /api/v1/properties/{id}/negotiations           # Utwórz i wyślij negocjację
GET    /api/v1/properties/{id}/negotiations/{nid}     # Pobierz szczegóły negocjacji
DELETE /api/v1/properties/{id}/negotiations/{nid}     # Usuń negocjację
POST   /api/v1/properties/{id}/negotiations/{nid}/resend # Ponownie wyślij email

Przykład żądania

Treść żądania POST do utworzenia negocjacji

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

Pełna dokumentacja API jest dostępna w Swagger:

Otwórz dokumentację API

Negocjacje umów