Makler und Verwaltungen

Dokumentation

Letzte Aktualisierung: 12. November 2026

Alles, was eine Verwaltung oder ein selbstständiger Makler wissen muss, um auf ImmGate zu veröffentlichen: was es kostet, wie wir Ihren Bereich einrichten, wie Sie Ihre Software anbinden und was mit Ihren Anzeigen geschieht. Diese Seite ist öffentlich. Lesen Sie sie, bevor Sie sich anmelden.

Was es kostet, und was darin enthalten ist

49 CHF pro Monat alles inklusive, für alle Ihre Anzeigen. Miete und Verkauf, keine Kosten pro Anzeige, monatlich kündbar.

• Unbegrenzte Anzeigen: Der Preis hängt nicht davon ab, wie viele Objekte Sie veröffentlichen.
• Keine kostenpflichtigen Optionen, keine Stufen, keine käufliche Hervorhebung.
• Die ersten 100 Partner: sechs Monate gratis, danach der Preis für drei Jahre garantiert.
• Ein öffentliches Profil für die Agentur und eines für jeden Makler, im Abonnement enthalten.
• Der automatische Import aus Ihrer Software, ebenfalls enthalten.

Es gibt keinen zweiten Tarif. Wenn Sie einen suchen: Er existiert nicht.

Sichtbarkeit ist nicht käuflich

Das ist die Regel, die alles andere trägt: Die Reihenfolge der Resultate hängt davon ab, was die suchende Person eingibt. Nie davon, was der Anbieter bezahlt. Es gibt keine Abo-Stufen, keine gesponserten Anzeigen, kein Aufsteigen in der Liste gegen Aufpreis.

Das heisst: Sie können bei uns keine Sichtbarkeit kaufen, und niemand kann sie gegen Sie kaufen.

Wer veröffentlichen darf

Immobilienprofis mit Eintrag im Schweizer Handelsregister: Verwaltungen, selbstständige Makler, Bauträger. Wir prüfen den Eintrag, bevor wir ein Konto freischalten.

Privatpersonen veröffentlichen nicht auf ImmGate. Das Suchen und Lesen bleibt für alle gratis, für immer: kein Abo, kein bezahlter Vorsprung, keine Anzeige, die nur Zahlenden vorbehalten ist.

Ihr Bereich, auf einer Seite

Nach der Anmeldung öffnet die Schaltfläche «Mein Bereich» oben rechts Ihre Übersicht. Sie beantwortet vier Fragen, in dieser Reihenfolge.

• Mein Feed: sein Zustand, der letzte erfolgreiche Abruf und die Schaltfläche zum Einrichten und Testen.
• Meine Anzeigen: wie viele online sind, welche offline sind, und der Link zum Korrigieren.
• Mein Team: die Profile Ihrer Makler und die Möglichkeit, Mitarbeitende hinzuzufügen.
• Mein Profil: Ihr öffentliches Profil, Ihre Kantone und Ihre Standardhonorare.

Der Bereich sieht aus wie der Rest der Website, in Ihrer Sprache. Sie haben nie mit einer technischen Administrationsoberfläche zu tun.

Software anbinden: das Format

ImmGate liest den Schweizer Standard SwissRETS, in beiden Ausprägungen. Sie müssen nichts in ein Format von uns exportieren.

• SwissRETS JSON, Version 3.x: die Form, die der Standard weiterentwickelt, und die wir zuerst anfragen.
• SwissRETS XML, Version 2.7: von Qualipool eingefroren, aber immer noch das, was viele Schweizer Programme ausgeben. Wir akzeptieren es genau gleich.

Das XML wird bei uns in die Struktur des JSON übersetzt, danach gehen beide denselben Weg. Mit anderen Worten: Das Format Ihrer Software ändert nichts daran, was aus Ihren Anzeigen bei uns wird.

Wenn Ihre Software nach CASAGATEWAY, Immomig, Casasoft oder zu einem anderen Verteiler exportiert, ist es dieselbe Datei, die wir lesen. Sagen Sie uns, welche Software Sie nutzen, und wir nennen Ihnen die genaue Einstellung.

Software anbinden: Adresse und Schlüssel

Im Reiter «Feed» Ihres Profils genügen drei Felder.

• Das Format: Lassen Sie im Zweifel «Automatisch erkennen». Ein Dokument, das mit «<» beginnt, wird als XML gelesen, eines mit «{» als JSON.
• Die Adresse des Exports: eine https-Adresse oder der Pfad einer auf unserem Server abgelegten Datei. Kein einfaches http: Ein unverschlüsseltes Inventar lässt sich unterwegs mitlesen und verändern, und es enthält die Kontaktdaten Ihrer Verkäufer.
• Der Zugangsschlüssel, falls Ihr Export geschützt ist. Er geht im Header «Authorization» mit, nie in der Adresse: Eine Adresse landet in den Logs der Gegenstelle, ein Header nicht.

Software anbinden: die API, wenn sie selbst sendet

Manche Programme stellen ihr Inventar nicht unter einer Adresse bereit: Sie senden es. Für sie hat ImmGate eine API. Erstellen Sie im Reiter «API» Ihres Bereichs einen Schlüssel (er wird nur einmal angezeigt) und hinterlegen Sie ihn in Ihrer Software.

• POST /api/v1/inventaire: Ihre Software legt ihr vollständiges SwissRETS-Inventar ab, in JSON oder XML. Antwort 202: Es wird innert einer Minute gelesen.
• POST /api/v1/reveil: «Mein Inventar hat sich geändert». Ein Export, den wir bei Ihnen abholen, wird sofort neu gelesen, ohne die halbe Stunde abzuwarten.
• GET /api/v1/etat: der letzte Abruf, wann er stattfand und was angelegt, geändert oder entfernt wurde.
• GET /api/v1/journal/{Nummer}: ein Abruf im Detail, mit dem genauen Fehler jeder Anzeige.

Der Schlüssel geht im Header «Authorization: Bearer …» mit, nie in einer Adresse. Wir speichern nur seinen Fingerabdruck: Ein verlorener Schlüssel wird widerrufen und neu erstellt. Zwei Schlüssel können gleichzeitig aktiv sein, damit Sie ohne Unterbruch wechseln können.

Ein unlesbares Dokument wird sofort abgelehnt (422), mit Begründung. Die Meldungen folgen der Sprache, die Ihre Software verlangt (Accept-Language: fr, de, it oder en). Die Ablage ist immer ein vollständiges Inventar. Es gibt keinen Befehl «lösche Anzeige 12»: Was fehlt, wird mit denselben Sicherungen entfernt wie bei einem Feed.

curl -X POST https://www.immgate.ch/api/v1/inventaire \
  -H "Authorization: Bearer ig_live_…" \
  -H "Content-Type: application/json" \
  -H "Accept-Language: de" \
  --data-binary @inventaire.json

# 202 Accepted
{
  "accepte": true,
  "annonces": 42,
  "projets": 1,
  "ecarts": [],
  "etat": "https://www.immgate.ch/api/v1/etat"
}

Der Verbindungstest, vor jeder Veröffentlichung

Die Schaltfläche «Verbindung testen» holt Ihr Dokument, liest es, prüft es gegen das offizielle Schema des Standards und antwortet in wenigen Sekunden:

• die empfangene Grösse und das erkannte Format
• die Software, die die Datei erzeugt hat, sofern sie sich zu erkennen gibt
• die Anzahl gelesener Anzeigen
• und, falls vorhanden, die Abweichungen vom Standard, Anzeige für Anzeige und Feld für Feld.

Nichts wird geschrieben, keine Anzeige angelegt, keine verändert. Sie korrigieren in Ihrer Software, starten den Test neu, und müssen niemanden anrufen.

Ein erfolgreicher Test bringt Ihren Feed von «Entwurf» auf «Getestet». Aktiviert wird er dadurch nicht: Die Aktivierung bleibt ein Entscheid, kein Nebeneffekt.

Auswählen, was Sie veröffentlichen

Ihre Software exportiert Ihr gesamtes Inventar, aber Sie möchten nicht unbedingt alles auf ImmGate veröffentlichen. Das stellen Sie im Reiter «Feed» ein, ohne etwas in Ihrer Software zu ändern und ohne Ihren Softwareanbieter anzurufen. Standardmässig wird alles übernommen.

• Die Angebote: Mietobjekte, Kaufobjekte oder beides.
• Die Objektarten: Wohnen, Gewerbe, Parkplatz, Grundstück … Entfernen Sie zum Beispiel das Häkchen bei den Parkplätzen, wenn Sie diese nur zusammen mit einer Wohnung vermieten.
• Die Kantone: die ganze Schweiz oder nur jene, die Sie ankreuzen.
• Objekte, die immer übernommen werden, anhand ihrer Referenz, auch wenn Ihre übrigen Einstellungen sie ausschliessen.
• Objekte, die nie übernommen werden, anhand ihrer Referenz.

Der Verbindungstest zeigt Ihnen vor dem Speichern, was Ihre Auswahl bewirkt: wie viele Objekte übernommen werden, welche nicht, und weshalb. Das Protokoll wiederholt es bei jedem Abruf.

Ein Objekt, das Sie ausschliessen, wird nicht angelegt. War es bereits online, wird es beim nächsten Abruf entfernt, ohne Frist, denn es ist Ihre Entscheidung. Es wird nie gelöscht und kommt zurück, sobald Ihre Auswahl es wieder einschliesst.

Die Zustände eines Feeds

Ihr Feed hat einen Zustand, sichtbar in der Übersicht wie im Reiter «Feed».

• Entwurf: die Quelle ist angegeben, nichts wurde bisher geprüft.
• Getestet: die Verbindung antwortet und das Dokument lässt sich lesen. Abweichungen vom Standard verhindern die Aktivierung nicht: Sie werden Ihnen gemeldet.
• Aktiv: die Anzeigen aus dem Feed werden übernommen.
• Pausiert: Ihre Anzeigen bleiben online, werden aber nicht mehr aktualisiert.
• Fehler: drei Abrufe in Folge sind gescheitert. Die genaue Meldung steht in Ihrem Protokoll. Wir versuchen es weiter, in grösseren Abständen, und der Feed wird wieder aktiv, sobald ein Abruf gelingt.

Kein Import löscht irgendetwas. Ein Objekt, das aus Ihrem Export verschwindet, wird depubliziert und aufbewahrt: Kommt es zurück, nimmt es seinen Platz wieder ein.

Die Synchronisation, sobald der Feed aktiv ist

Ein aktiver Feed wird jede halbe Stunde neu gelesen, ohne dass Sie etwas tun müssen. Sie können ihn auch sofort lesen, mit der Schaltfläche «Meinen Feed jetzt lesen» oder über die API. Jeder Abruf folgt denselben sechs Schritten.

• Abholen: Wir holen Ihr Dokument ab, unter Ihrer Adresse oder dort, wo Ihre Software es abgelegt hat. Antwortet es nicht, hören wir hier auf: Nichts ändert sich.
• Lesen: Das Dokument wird mit dem offiziellen SwissRETS-Schema verglichen. Abweichungen werden im Journal für Ihren Softwareanbieter gemeldet, aber alles Verständliche wird übernommen.
• Übersetzen: Jede Anzeige wird zu einer ImmGate-Seite, in den Sprachen, die Sie liefern. Zuerst die Projekte, dann ihre Einheiten.
• Vergleichen: Ein Fingerabdruck jeder Anzeige zeigt, ob sich etwas geändert hat. Eine unveränderte Anzeige wird nicht angefasst, nicht einmal ihr Verlauf.
• Anwenden: Eine neue Anzeige wird angelegt. Eine geänderte wird aktualisiert, und der Verlauf sagt, was sich geändert hat («Nettomiete», «Fotos»). Die Fotos werden zu uns kopiert. Antwortet eines nicht, bleibt die alte Galerie und wir versuchen es erneut. Enthält Ihr Inventar für ein Objekt gar kein Foto mehr, wird dessen Galerie geleert.
• Abgleichen: Eine Anzeige, die in Ihrem Inventar fehlt, wird erst nach zwei Abrufen und vierundzwanzig Stunden entfernt. Sie wird offline genommen, nicht gelöscht: Kommt sie zurück, erhält sie ihren Platz, ihre Adresse und ihren Verlauf wieder.

Drei Sicherungen schützen Ihr Schaufenster vor einem fehlerhaften Export, ohne dass Sie je etwas tun müssen. Die Frist von einem Tag gilt für alles: Ob eine Anzeige fehlt oder alle, nichts wird vor vierundzwanzig Stunden und zwei Abrufen entfernt, und das Protokoll sagt Ihnen schon beim ersten, wann die Entfernung erfolgt. Was irrtümlich entfernt wurde, kommt von selbst zurück, unter derselben Adresse, sobald Ihr Inventar es wieder aufführt. Und ein nicht erreichbarer Feed entfernt nie etwas: Drei Tage Ausfall bei Ihrem Softwareanbieter zählen nicht als drei Tage Abwesenheit. Nach drei Fehlschlägen in Folge wechselt Ihr Feed in Ihrem Bereich auf «Fehler» und beim nächsten erfolgreichen Abruf von selbst wieder auf «aktiv».

Jeder Abruf hinterlässt eine Zeile im Journal des Reiters «Feed», in Ihrer Sprache: was angelegt, geändert oder entfernt wurde, und der genaue Fehler jeder Anzeige, die nicht übernommen werden konnte.

Was der Feed besitzt, behält er. Ein bei uns korrigierter Preis würde beim nächsten Abruf überschrieben: Korrigieren Sie ihn in Ihrer Software. Ihre im Bereich erfassten Honorare werden dagegen nie überschrieben, solange Ihr Feed keine angibt. Dokumente wie Pläne und Grundbuchauszüge behalten ihren Link zu Ihrem Server.

Ein Objekt zurückziehen, und was aus seiner Adresse wird

Ein vermietetes oder verkauftes Objekt lässt sich auf zwei Arten zurückziehen, und der Unterschied zählt.

• Offline nehmen: Es verschwindet von der Website, behält aber seine Adresse und seinen Verlauf. Kommt es zurück auf den Markt, erhält es seinen Platz wieder. Das tut Ihr Feed, wenn ein Objekt aus Ihrem Inventar verschwindet.
• Löschen: Es verschwindet endgültig. Seine Adresse leitet dann in jeder Sprache zu seinem Projekt weiter, falls es eines hat, sonst zur Seite Ihrer Agentur: Ein geteilter oder gemerkter Link führt nie auf eine leere Seite.

Ein Objekt, das Ihr Feed entfernt hat und das nach sechs Monaten nicht zurückgekehrt ist, wird von selbst gelöscht, mit derselben Weiterleitung: Wir bewahren die Daten einer Anzeige, die nicht zurückkommt, nicht grundlos auf. Eine von Hand erfasste oder von Ihnen wieder online gestellte Anzeige wird nie von einer Maschine gelöscht.

Vorsicht bei einer Anzeige aus Ihrem Feed: Löschen Sie sie bei uns, während sie noch in Ihrem Export steht, legt der nächste Abruf sie wieder an. Entfernen Sie sie in Ihrer Software, und den Rest erledigen wir.

Die Honorare: Sie bestimmen, wir weisen aus

Das ist die Besonderheit von ImmGate, und sie verdient eine genaue Formulierung. Wir greifen nie in die Höhe Ihrer Honorare ein: kein empfohlener Tarif, keine Obergrenze, kein Standardwert, nirgends ein angezeigter Durchschnitt. Sie legen Ihre Tarife frei fest.

Was wir verlangen, ist deren Ausweisung. Auf der Anzeige, nicht auf Ihrem öffentlichen Profil: Ein Tarif ohne Zusammenhang wird zum Preisschild, und das sucht niemand, der ein Objekt anschaut.

• Die Felder bestehen auf drei Ebenen: Anzeige, Makler, Agentur. Der erste ausgefüllte Wert gewinnt.
• Sie hinterlegen Ihren Standardtarif im Profil der Agentur. Ein Makler, der anders arbeitet, ersetzt ihn in seinem eigenen, und eine einzelne Anzeige kann ihn nochmals ersetzen.
• Auch der Feed kann sie mitliefern, über die Optionen des Publishers «immgate». Sagen Sie uns Bescheid, wir geben Ihnen die genauen Schlüssel.
• Die Felder sind nicht obligatorisch: Eine Anzeige ohne Honorarangaben erscheint trotzdem, einfach ohne Honorarfeld.

Eine Anzeige von Hand erfassen

Sie haben keine Exportsoftware, oder Sie möchten ein Objekt veröffentlichen, bevor Sie Ihren Feed anbinden? In Ihrem Bereich können Sie eine Anzeige direkt erfassen. Die Felder folgen dem Standard, und das Formular zeigt nur, was zu Ihrer Transaktion passt: keine «Nettomiete» bei einem Verkauf.

Ein Makler korrigiert seine eigenen Anzeigen. Der Administrator der Agentur sieht und korrigiert alle Anzeigen des Hauses.

Projekte: Überbauungen und Neubauten

Eine Überbauung mit zwölf Wohnungen ist nicht zwölf unverbundene Anzeigen. Auf ImmGate hat ein Projekt seine eigene Seite: seine Fotos, seinen Baufortschritt, seine Spannen bei Preis, Zimmern und Flächen, und die Liste seiner noch verfügbaren Einheiten, von der günstigsten zur teuersten.

• Über Ihren Feed: SwissRETS beschreibt die Projekte unter «projects», und jede Einheit gibt mit ihrer «unitReferenceId» an, zu welchem Projekt sie gehört. Wir legen das Projekt an und verknüpfen seine Einheiten, ohne dass Sie etwas tun müssen.
• Von Hand: in Ihrem Bereich «Projekt hinzufügen», dann bei jeder betroffenen Anzeige das Projekt im Feld «Projekt» wählen. Es werden nur die Projekte Ihrer Agentur angeboten.
• Jede Einheit bleibt eine vollwertige Anzeige, mit ihrem Preis und ihren Honoraren. Ihre Seite verweist auf das Projekt und seine weiteren Einheiten.

Ein Projekt folgt denselben Regeln wie eine Anzeige: bei jedem Abruf neu gelesen, entfernt, wenn es aus Ihrem Inventar verschwindet, nie auf einen Schlag gelöscht. Gelöscht, gibt es seine Einheiten frei, die online bleiben.

Ihre Sprachen

Das Portal, die Suche und die Benachrichtigungen gibt es auf Französisch, Deutsch, Italienisch und Englisch. Jede Anzeige erscheint in den Sprachen, die Sie liefern: Wir übersetzen Ihre Texte nicht automatisch.

Eine Anzeige, die Sie nur auf Deutsch liefern, bleibt auf Deutsch, in allen vier Fassungen der Website. Es ist Ihr Text und Ihre Verantwortung, und eine maschinelle Übersetzung einer Objektbeschreibung erkennt man sofort.

Ihre Inserate bei den KI-Assistenten

ImmGate öffnet seinen Katalog für KI-Assistenten, wie Claude, ChatGPT und jeden Agenten, der das MCP-Protokoll spricht, über einen Server: https://www.immgate.ch/mcp. Die Person verbindet dort ihr kostenloses ImmGate-Konto. Wenn sie ihren Assistenten nach «einer 3,5-Zimmer-Wohnung zur Miete bei Zürich, bis 2500 Franken» fragt, kann sie auf Ihre Objekte stossen, mit ihrer Adresse auf ImmGate.

1. Eine Person fragt Ihren Assistenten, wie einen Menschen: 3,5 Zimmer in der Nähe von Lausanne.
2. Er sucht auf ImmGate Dieselbe Suche wie auf der Website, dieselbe Reihenfolge für alle.
3. Er schreibt Ihnen Die Anfrage geht an Ihre Agentur, im Namen der Person, mit dem Hinweis, dass ein Assistent sie gesendet hat.
4. Sie antworten Per E-Mail, wie auf eine Anfrage von der Website. Ihre Adresse wurde nie weitergegeben.

• Dieselbe Suche und dieselbe Reihenfolge wie auf der Website: die neuesten zuerst, nie nach Bezahlung.
• Ihre Honorare so, wie Sie sie veröffentlichen, nie ein vorgeschlagener Satz.
• Keine E-Mail-Adresse wird weitergegeben: Bittet jemand seinen Assistenten, Ihnen zu schreiben, erreicht Sie die Anfrage wie die von der Website, per E-Mail, mit einer Kopie für die Person und dem Hinweis, dass ein Assistent sie gesendet hat.
• Eine Ratenbegrenzung und höchstens hundert Inserate pro Suche: Ein Konkurrent kann Ihr Inventar nicht absaugen.

Sie müssen nichts tun: Ihre auf ImmGate veröffentlichten Inserate sind dabei, in ihren Sprachen.

Die Bewerbungsdossiers, die Sie erhalten

Wer eine Wohnung sucht, kann sein Dossier einmal auf ImmGate anlegen (Identität, Einkommen nach Spanne, Betreibungsregisterauszug, Lohnabrechnungen, Ausweis) und es seiner Anfrage beilegen. Die E-Mail, die Sie erhalten, trägt dann eine Schaltfläche «Bewerbungsdossier öffnen».

• Der Link führt auf eine Seite von ImmGate: Geben Sie eine der Adressen ein, die die Anfrage erhalten haben (die des Maklers, der Agentur oder des Posteingangs Ihrer Software).
• Dorthin geht sofort ein sechsstelliger Code, 15 Minuten gültig.
• Der Code öffnet das Dossier für zwei Stunden in diesem Browser: die Angaben, jede Unterlage zum Herunterladen oder alles in einer ZIP-Datei.
• Der Link bleibt 30 Tage gültig, solange die Bewerberin oder der Bewerber den Zugriff nicht entzieht. Jede Öffnung und jeder Download wird ihr oder ihm angezeigt.

Es sind sensible Daten, die man Ihnen anvertraut. Der Eidgenössische Datenschutzbeauftragte erinnert daran, dass eine Verwaltung eine Kopie des Ausweises oder der Lohnabrechnungen nur von der berücksichtigten Person verlangen darf und die Kopien der anderen vernichten muss: ImmGate erinnert Sie auf der Seite des Dossiers daran.

«Mit ImmGate bewerben»: zwei Zeilen auf Ihrer Website

Zwei Zeilen zum Einfügen, und Ihre Website hat ihre Schaltfläche «Mit ImmGate bewerben». Die Person klickt, stimmt auf ImmGate zu, und ihr vollständiges Dossier, Angaben und Unterlagen, kommt als JSON auf Ihrer Website an, an der Adresse, die Ihr Entwickler angegeben hat (siehe unten).

In Ihrem ImmGate-Bereich, Karte «Mit ImmGate bewerben»: «Aktivieren», dann geben Sie die Adresse Ihres Entwicklers ein. Er erhält seine Seite, mit den zwei Zeilen bereits ausgefüllt.

• Fügen Sie die Skriptzeile einmal in den Kopf Ihrer Seiten ein.
• Fügen Sie die Schaltfläche dort ein, wo sie erscheinen soll, mit Referenz und Titel des Objekts.
• Das ist alles. Die Schaltfläche zeichnet sich selbst, in unseren Farben, in der Sprache Ihrer Seite, und wechselt zu «Dossier gesendet», sobald die Person zugestimmt hat.

Optionale Einstellungen, auf derselben Zeile: data-dossier="achat" für ein Objekt zum Kauf, data-langue="de" für eine feste Sprache, data-taille="grand", data-largeur="plein" für die ganze Breite, data-fenetre="meme", um ImmGate im selben Tab zu öffnen.

Ihr Schlüssel ist nicht geheim: Er öffnet nur die Zustimmungsseite. Das Dossier geht immer an die Empfangsadresse Ihrer Agentur, nie anderswohin. Auf eine andere Website kopiert, würde er die Dossiers Ihnen schicken. Ein neuer Schlüssel entsteht mit einem Klick in Ihrem Bereich.

<!-- 1. Einmal, im Kopf Ihrer Seiten -->
<script src="https://www.immgate.ch/postuler.js" defer></script>

<!-- 2. Dort, wo die Schaltfläche erscheinen soll -->
<div class="immgate-postuler" data-agence="IHR_SCHLUESSEL"
     data-bien-ref="LAC-12" data-bien-titre="3,5 Zimmer, Seestrasse 12"></div>

Bewerbungen als JSON auf Ihrer Website erhalten

Das Dossier kommt nur auf diesem Weg an, ohne E-Mail. Geben Sie in Ihrem Bereich die Adresse Ihres Entwicklers ein: Er erhält einen Link zu einer Seite, auf der alles bereit ist. Die Schaltfläche funktioniert, sobald er die Empfangsadresse angegeben hat.

1. Er fügt die zwei Zeilen der Schaltfläche ein.
2. Er gibt die Adresse Ihrer Website an, die die Bewerbungen empfängt (https).
3. Er sendet sich mit einem Klick ein Beispiel, um zu prüfen.
4. Danach sendet ImmGate bei jeder angenommenen Bewerbung das Dossier an diese Adresse: eine signierte POST-Anfrage mit JSON.

Jede Anfrage trägt den Header X-ImmGate-Signature: «sha256=» gefolgt vom HMAC-SHA256 des Körpers, berechnet mit dem Geheimnis der Entwicklerseite. Prüfen Sie ihn, bevor Sie das JSON lesen, und antworten Sie mit 200.

Das JSON enthält das Objekt (Ihre Referenz und Ihren Titel), die Person, im Klartext die Stufen und Status unter «labels», und jede Unterlage mit ihrer Download-Adresse. Diese Adressen und «file_url» zum erneuten Lesen gelten, solange die Freigabe offen ist: 30 Tage, oder bis die Person den Zugriff entzieht (403 «access_withdrawn»).

Antwortet Ihre Website nicht, oder mit etwas anderem als einem 2xx-Code, versucht ImmGate es nach 5 Minuten, 30 Minuten, 2, 6 und 12 Stunden erneut. Ihr Bereich zeigt den Stand jeder Lieferung und erlaubt, sie erneut zu senden. Die Person sieht unter «Meine Sendungen», dass ihr Dossier an Ihre Website übergeben wurde, und jeden Download.

// Was ImmGate bei jeder angenommenen Bewerbung an Ihre Adresse sendet
POST https://votre-site.ch/immgate/candidature
Content-Type: application/json
X-ImmGate-Event: candidature
X-ImmGate-Signature: sha256=5f2c…

{
  "event": "candidature",
  "agency": { "name": "Régie du Lac SA" },
  "reference": 41,
  "file": "rental",
  "property": { "reference": "LAC-12", "title": "3,5 Zimmer, Seestrasse 12" },
  "complete": true,
  "applicant": {
    "email": "[email protected]",
    "first_name": "Léa", "last_name": "Exemple",
    "profession": "Pflegefachfrau", "annual_income": "80_100"
  },
  "labels": { "annual_income": "80’000 bis 100’000 CHF" },
  "documents": [
    { "category": "payslip", "name": "Lohnabrechnung-Oktober.pdf",
      "url": "https://www.immgate.ch/api/v1/partage/…/pieces/2" }
  ],
  "file_url": "https://www.immgate.ch/api/v1/partage/…",
  "shared_until": "2026-12-13T20:20:54+01:00"
}

// Ihre Adresse, in PHP: Signatur prüfen, dann lesen
$body = file_get_contents('php://input');
$expected = 'sha256=' . hash_hmac('sha256', $body, IMMGATE_SECRET);
if (!hash_equals($expected, $_SERVER['HTTP_X_IMMGATE_SIGNATURE'] ?? '')) {
  http_response_code(401);
  exit;
}
$application = json_decode($body, true);
http_response_code(200);

Weiter gehen: das Dossier in Ihrer Software (API)

Die Schaltfläche und die Lieferung als JSON genügen den meisten Agenturen. Wenn Ihre Software das Dossier selbst anfordern soll, erstellen Sie in Ihrem Bereich eine Kennung und ein Geheimnis, mit der Rückkehradresse Ihrer Website: Das ist OAuth 2.1, mit PKCE.

• Die Schaltfläche führt auf die Autorisierungsseite von ImmGate, mit dem Bereich dossier_location (oder dossier_achat) und einer PKCE-Challenge.
• Die Person meldet sich an und teilt ihr Dossier. Teilen lässt es sich nur, wenn es vollständig ist.
• Ihre Website erhält einen Code an ihre Rücksprungadresse und tauscht ihn mit Ihrem Geheimnis gegen ein Token.
• Mit dem Token liest sie das Dossier als JSON, dann jede Unterlage.
• Die Freigabe gilt 30 Tage. Die Person sieht jeden Zugriff und kann ihn entziehen: Das Token nützt dann nichts mehr.

PKCE-Challenge und Status entstehen bei jedem Klick: ein zufälliger Verifier in der Sitzung, sein SHA-256-Fingerabdruck in base64url als Challenge, und ein zufälliger Status. Speichern Sie mit dem Status die Objektreferenz: Bei der Rückkehr sagt er Ihnen, für welches Objekt sich die Person bewirbt. Eine Rückkehr mit unbekanntem Status wird abgewiesen.

Geben Sie der Schaltfläche Referenz und Titel des Objekts mit (bien_ref, bien_titre): Die Person sieht, wofür sie sich bewirbt, findet es unter «Meine Sendungen», und die Antwort gibt es Ihnen unter «property» zurück. Entfernt Ihre Agentur ihre Schaltfläche oder verlässt sie ImmGate, schliessen sich die Freigaben, und die Schaltfläche führt auf eine Seite «Diese Schaltfläche ist nicht mehr aktiv».

Die Antwort enthält die Person (ihre Felder, und unter «labels» Spannen und Status im Klartext, in der Sprache der Person oder der von ?lang=fr|de|it|en), dann ihre Unterlagen mit ihrer Adresse. Mit beiden Bereichen wählt ?file=rental oder ?file=purchase das Dossier.

Die Ablehnungen: 401 ohne gültiges Token, 403 «access_withdrawn», wenn die Person den Zugriff entzogen hat oder nach 30 Tagen, 403 «insufficient_scope» für ein nicht angefragtes Dossier, 429 über dreihundert Zugriffe pro Stunde. Das Token gilt eine Stunde, das Erneuerungs-Token höchstens 30 Tage. Lehnt die Person ab, erhält Ihre Rücksprungadresse error=access_denied.

Das Dossier wird Ihnen von der Person anvertraut: Sie bearbeiten es in eigener Verantwortung. Der Eidgenössische Datenschutzbeauftragte verlangt, Kopien des Ausweises und der Lohnabrechnungen nur für die berücksichtigte Person aufzubewahren und die der anderen zu vernichten.

# PKCE: PKCE_VERIFIER = 64 Zufallszeichen, in der Sitzung gespeichert;
#       PKCE_CHALLENGE = base64url(sha256(PKCE_VERIFIER)), ohne «=».

# 1. Die Schaltfläche, auf Ihrer Website
<a href="https://www.immgate.ch/oauth/authorize?response_type=code&client_id=IHRE_ID&redirect_uri=https%3A%2F%2Fihre-website.ch%2Fimmgate%2Frueckkehr&scope=dossier_location&state=STATUS&code_challenge=PKCE_CHALLENGE&code_challenge_method=S256&bien_ref=OBJEKT_REF&bien_titre=OBJEKT_TITEL"
   style="display:inline-flex;align-items:center;gap:10px;padding:12px 22px;border-radius:999px;background:#E8192C;color:#fff;font:600 16px system-ui,sans-serif;text-decoration:none">
  <img src="https://www.immgate.ch/themes/custom/immgate/images/logo-mark-white.svg" alt="" width="20" height="20">
  Mit ImmGate bewerben
</a>

# 2. Den Code gegen ein Token tauschen (auf Ihrem Server)
curl -X POST https://www.immgate.ch/oauth/token \
  -d grant_type=authorization_code -d client_id=IHRE_ID -d client_secret=IHR_GEHEIMNIS \
  -d code=CODE -d redirect_uri=https://ihre-website.ch/immgate/rueckkehr -d code_verifier=PKCE_VERIFIER

# 3. Das Dossier, dann jede Unterlage
curl https://www.immgate.ch/api/v1/candidature -H "Authorization: Bearer TOKEN"
curl -O https://www.immgate.ch/api/v1/candidature/pieces/123 -H "Authorization: Bearer TOKEN"

# 4. Die Antwort (Auszug)
{
  "reference": 21,
  "file": "rental",
  "property": { "reference": "LHA-LAC-12", "title": "3,5 pièces, Rue du Lac 12" },
  "complete": true,
  "applicant": {
    "email": "[email protected]",
    "first_name": "Léa", "last_name": "Exemple", "phone": "021 000 00 00",
    "residence_status": "suisse", "annual_income": "80_100",
    "profession": "Infirmière", "employer": "Hôpital Exemple SA",
    "adults": 2, "children": 1, "move_in_date": "2027-04-01",
    "co_first_name": "Marc", "co_last_name": "Exemple"
  },
  "labels": { "residence_status": "Suisse", "annual_income": "80’000 à 100’000 CHF" },
  "language": "fr",
  "documents": [
    { "id": 92, "category": "debt_collection_extract", "name": "Extrait-poursuites.pdf",
      "size_kb": 84, "uploaded": "2026-11-13", "to_renew": false,
      "url": "https://www.immgate.ch/api/v1/candidature/pieces/92" }
  ],
  "shared_until": "2026-12-13T19:17:21+01:00",
  "notice": "Shared by the applicant through ImmGate. …"
}

Ihre Software exportiert nur IDX 3.01 oder per SFTP?

Das ist das alte Schweizer Austauschformat für Anzeigen, das manche Programme noch erzeugen und oft per SFTP ablegen. Wir binden es nicht von vornherein an: SwissRETS kann mehr, und die meisten Programme bieten es bereits an.

Wenn Ihre Software nur das kann, sagen Sie es uns: Wir binden es auf Anfrage an, damit Sie nichts neu erfassen müssen.

Ihre Daten, und unsere

Keine Tracking-Cookies, kein Analyse-Werkzeug auf dieser Website. Die Kontaktdaten von Eigentümern, die in Ihrem Export vorkommen können, werden beim Einlesen verworfen: Sie gelangen nie in unsere Datenbank.

Was wir genau erheben, wozu und wie lange wir es aufbewahren, steht in unserer Datenschutzerklärung.

Eine Frage, die diese Seite nicht klärt

Schreiben Sie uns: Ein Team in der Schweiz antwortet Ihnen so schnell wie möglich. Sagen Sie uns, welche Software Sie verwenden. Das wäre ohnehin unsere erste Frage.

[email protected]