Dokumentacja | Dokumentacja API

Przegląd funkcji

Oferta handlowa to profesjonalna prezentacja nieruchomości, którą możesz wysłać potencjalnemu najemcy e-mailem. Odbiorca otrzymuje link do strony ze szczegółowymi informacjami o nieruchomości, zdjęciami, charakterystyką i formularzem kontaktowym.

Kluczowe funkcje

Pełna informacja o nieruchomości
Galeria zdjęć
Charakterystyka i parametry nieruchomości
Wykaz mienia wynajmującego
Formularz kontaktowy dla odbiorcy
Śledzenie wyświetleń i odpowiedzi
Obsługa 4 języków (UK, EN, RU, PL)

Uprawnienia dostępu

Tylko właściciele nieruchomości i ich przedstawiciele mogą wysyłać oferty handlowe.

Rola	Wysyłanie	Podgląd listy	Usuwanie
Gospodarz	Tak	Tak	Tak
Agent wynajmujący	Tak	Tak	Tak
Najemca	Nie	Nie	Nie

Jak wysłać ofertę

1

Otwórz nieruchomość

Przejdź do strony nieruchomości, dla której chcesz utworzyć ofertę handlową.

2

Kliknij przycisk wysyłania

Na stronie nieruchomości znajdź przycisk z ikoną koperty (📨) lub wybierz "Oferta handlowa" z menu akcji.

3

Wypełnij formularz

Wprowadź e-mail i imię odbiorcy, wybierz język i walutę wyświetlania. Opcjonalnie dodaj wiadomość przewodnią.

4

Wybierz okres ważności

Określ, ile dni oferta będzie aktywna: 7, 14, 30 lub 60 dni. Po wygaśnięciu link stanie się niedostępny.

5

Wyślij ofertę

Kliknij przycisk "Wyślij". Odbiorca otrzyma e-mail z linkiem do strony oferty.

Pola formularza

Pole	Wymagane	Opis
Email odbiorcy	Tak	Adres e-mail, na który zostanie wysłany list z ofertą
Imię odbiorcy	Tak	Imię odbiorcy do personalizacji wiadomości
Waluta wyświetlania	Nie	Waluta do wyświetlania cen i wartości na stronie oferty
Wiadomość przewodnia	Nie	Osobista wiadomość od Ciebie, która zostanie pokazana w e-mailu i na stronie oferty
Język dokumentu	Tak	Język interfejsu dla e-maila i strony oferty
Link ważny przez (dni)	Tak	Liczba dni, przez które link będzie aktywny (7, 14, 30 lub 60 dni)

Co zawiera oferta

Strona oferty handlowej automatycznie zawiera wszystkie publiczne informacje o nieruchomości:

Informacje o nieruchomości

Nazwa, adres, typ nieruchomości

Zdjęcia

Galeria zdjęć obiektu, do 8 zdjęć

Charakterystyka

Powierzchnia, piętro, liczba pokoi i inne parametry

Infrastruktura

Odległości do metra, sklepów, szkół i innych punktów — w minutach pieszo

Warunki najmu

Kwota i okres najmu podane przy wysyłaniu oferty

Mienie

Meble i wyposażenie wynajmującego

Statusy ofert

System automatycznie śledzi status każdej oferty:

Wysłano

E-mail wysłany, odbiorca jeszcze nie otworzył linku

Wyświetlono

Odbiorca wyświetlił stronę oferty

Odpowiedziano

Odbiorca zostawił odpowiedź przez formularz

Wygasło

Oferta wygasła

Co widzi odbiorca

Odbiorca oferty handlowej przechodzi następujące kroki:

1

Otrzymanie e-maila

Odbiorca otrzymuje profesjonalny e-mail z opisem oferty, Twoją wiadomością przewodnią i przyciskiem do podglądu szczegółów.

2

Podgląd oferty

Klikając link, odbiorca widzi piękną stronę ze wszystkimi informacjami o nieruchomości, galerią zdjęć i charakterystyką.

3

Odpowiedź

Jeśli odbiorca jest zainteresowany, może zostawić wiadomość i telefon kontaktowy przez formularz kontaktowy.

Formularz kontaktowy

Gdy odbiorca zostawi odpowiedź, otrzymujesz powiadomienie e-mail z jego danymi kontaktowymi i wiadomością. Status oferty zmienia się na "Otrzymano odpowiedź".

Poufność

Ważne

Każdy e-mail zawiera klauzulę poufności. Odbiorca jest ostrzegany, że udostępnianie danych o nieruchomości osobom trzecim jest zabronione bez pisemnej zgody.

Podgląd wyników

Lista wszystkich wysłanych ofert jest dostępna w menu nieruchomości. Dla każdej oferty wyświetlane są:

Kolumna	Opis
Odbiorca	Imię i e-mail odbiorcy oferty
Wysłano	Data i godzina wysłania oferty
Status	Aktualny status oferty (wysłano, wyświetlono, odpowiedź, wygasła)
Wyświetlenia	Liczba wyświetleń strony oferty
Odpowiedź	Tekst odpowiedzi i telefon kontaktowy (jeśli odbiorca odpowiedział)

REST API

Oferty handlowe są również dostępne przez REST API do integracji z innymi systemami.

Uwaga dotycząca warstwy usługowej

Endpointy API

GET    /api/v1/properties/{id}/proposals           # Lista ofert
POST   /api/v1/properties/{id}/proposals           # Utwórz i wyślij
GET    /api/v1/properties/{id}/proposals/{pid}     # Szczegóły oferty
DELETE /api/v1/properties/{id}/proposals/{pid}     # Usuń ofertę
POST   /api/v1/properties/{id}/proposals/{pid}/resend # Wyślij ponownie

Przykład zapytania

Przykład treści zapytania (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
}

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

Otwórz dokumentację API

Oferty handlowe