Dokumentation | API-Referenz

Funktionsüberblick

Ein Geschäftsangebot ist eine professionelle Präsentation eines Immobilienobjekts, die Sie per E-Mail an einen potenziellen Mieter senden können. Der Empfänger erhält einen Link zu einer Seite mit detaillierten Objektinformationen, Fotos, Charakteristiken und einem Feedbackformular.

Hauptfunktionen

Vollständige Immobilieninformationen
Fotogalerie
Objektcharakteristiken und -parameter
Inventarliste des Vermieters
Feedbackformular für Empfänger
Verfolgung von Ansichten und Antworten
Unterstützung für 4 Sprachen (UK, EN, RU, PL)

Zugriffsrechte

Nur Objekteigentümer und ihre Vertreter können Geschäftsangebote senden.

Rolle	Senden	Liste anzeigen	Löschen
Vermieter	Ja	Ja	Ja
Vermietervertreter	Ja	Ja	Ja
Mieter	Nein	Nein	Nein

Wie man ein Angebot sendet

1

Objekt öffnen

Gehen Sie zur Seite des Immobilienobjekts, für das Sie ein Geschäftsangebot erstellen möchten.

2

Senden-Schaltfläche klicken

Suchen Sie auf der Objektseite die Schaltfläche mit Briefumschlag-Symbol (📨) oder wählen Sie "Geschäftsangebot" im Aktionsmenü.

3

Formular ausfüllen

Geben Sie E-Mail und Name des Empfängers ein, wählen Sie Sprache und Währung. Optional fügen Sie eine Begleitnachricht hinzu.

4

Gültigkeitsdauer wählen

Geben Sie an, wie viele Tage das Angebot aktiv sein wird: 7, 14, 30 oder 60 Tage. Nach Ablauf wird der Link unzugänglich.

5

Angebot senden

Klicken Sie auf "Senden". Der Empfänger erhält eine E-Mail mit Link zur Angebotsseite.

Formularfelder

Feld	Erforderlich	Beschreibung
E-Mail	Ja	E-Mail-Adresse, an die das Angebot gesendet wird
Name	Ja	Empfängername zur Personalisierung der E-Mail
Anzeigewährung	Nein	Währung zur Anzeige von Preisen und Werten auf der Angebotsseite
Begleitnachricht	Nein	Persönliche Nachricht von Ihnen, die in der E-Mail und auf der Angebotsseite angezeigt wird
Sprache	Ja	Schnittstellensprache für E-Mail und Angebotsseite
Gültig für (Tage)	Ja	Anzahl der Tage, für die der Link aktiv sein wird (7, 14, 30 oder 60 Tage)

Was ist im Angebot enthalten

Die Geschäftsangebotsseite enthält automatisch alle öffentlichen Informationen zum Objekt:

Objektinformationen

Name, Adresse, Objekttyp

Fotos

Fotogalerie der Immobilie, bis zu 8 Fotos

Charakteristiken

Fläche, Etage, Zimmeranzahl und andere Parameter

Infrastruktur

Entfernungen zu U-Bahn, Geschäften, Schulen und anderen Punkten — in Gehminuten

Mietbedingungen

Mietpreis und Zeitraum, die Sie beim Versand des Angebots angegeben haben

Inventar

Möbel und Ausstattung des Vermieters

Angebotsstatus

Das System verfolgt automatisch den Status jedes Angebots:

Gesendet

E-Mail gesendet, Empfänger hat Link noch nicht geöffnet

Angesehen

Empfänger hat Angebotsseite angesehen

Beantwortet

Empfänger hat über Formular geantwortet

Abgelaufen

Angebotsgültigkeit abgelaufen

Was der Empfänger sieht

Der Empfänger des Geschäftsangebots durchläuft folgende Schritte:

1

E-Mail erhalten

Der Empfänger erhält eine professionelle E-Mail mit Angebotsbeschreibung, Ihrer Begleitnachricht und einer Schaltfläche zur Detailansicht.

2

Angebot ansehen

Nach dem Klicken auf den Link sieht der Empfänger eine ansprechende Seite mit allen Objektinformationen, Fotogalerie und Charakteristiken.

3

Antwort

Bei Interesse kann der Empfänger eine Nachricht und Kontakttelefon über das Feedbackformular hinterlassen.

Feedbackformular

Wenn der Empfänger eine Antwort hinterlässt, erhalten Sie eine E-Mail-Benachrichtigung mit seinen Kontakten und der Nachricht. Der Angebotsstatus ändert sich zu "Antwort erhalten".

Vertraulichkeit

Wichtig

Jede E-Mail enthält einen Hinweis zur Vertraulichkeit der Informationen. Der Empfänger wird darauf hingewiesen, dass die Weitergabe von Objektdaten an Dritte ohne schriftliche Zustimmung verboten ist.

Ergebnisse anzeigen

Die Liste aller gesendeten Angebote ist im Objektmenü verfügbar. Für jedes Angebot wird angezeigt:

Spalte	Beschreibung
Empfänger	Name und E-Mail des Angebotsempfängers
Gesendet am	Datum und Uhrzeit des Angebotsversands
Status	Aktueller Angebotsstatus (gesendet, angesehen, beantwortet, abgelaufen)
Aufrufe	Anzahl der Seitenaufrufe
Antwort	Antworttext und Kontakttelefon (wenn Empfänger geantwortet hat)

REST API

Geschäftsangebote sind auch über REST API für Integration mit anderen Systemen verfügbar.

Service-Layer-Hinweis

API-Endpunkte

GET    /api/v1/properties/{id}/proposals           # Angebotsliste
POST   /api/v1/properties/{id}/proposals           # Erstellen und senden
GET    /api/v1/properties/{id}/proposals/{pid}     # Angebotsdetails
DELETE /api/v1/properties/{id}/proposals/{pid}     # Angebot löschen
POST   /api/v1/properties/{id}/proposals/{pid}/resend # Erneut senden

Request-Beispiel

Beispiel Request-Body (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
}

Vollständige API-Dokumentation ist in Swagger UI verfügbar

API-Dokumentation öffnen

Geschäftsangebote