Praxistipp IS24 REST-API 4.1 - Seite 1 von 3

Die Immobilienscout24 REST-API-SchnittstelleDas Portal Immobilienscout24.de bietet mit der sogenannten REST-API-Schnittstelle eine alternativeÜbertragungsmöglichkeit zum bisherigen Hochladen der Objektdaten per FTP an. Um die Übertragungdieser Daten aus estateOffice und estatePro heraus auch über die neue Schnittstelle zu gewährleisten,haben wir eine entsprechende Anpassung für unsere Software entwickelt. Bevor Sie diese aktiv nutzen, also Ihre Objekte hochladen können, sind zunächst einigeKonfigurationsschritte erforderlich, die sich aber kaum von den gewohnten Einstellungen für dieBörsenkonfiguration unterscheiden.

Wichtig! Führen Sie einen Testlauf durchDie im folgenden beschriebene Schnittstelle wurde von Immobilienscout24 komplett neuentwickelt. Es wurde nicht nur der Übertragungsweg, sondern auch Änderungen anFelddefinitionen und vor allem Pflichtfeldern durchgeführt. Hierzu zählen beispielsweise die

verschiedenen Vertriebsarten (Kauf- oder Mietobjekte) und die verschiedenen Immobilienarten, sowiedie Provisionsfelder in Ihrem Portfolio.

Um weiterhin eine korrekte Anzeige Ihre Immobilien zu gewährleisten müssen an einigen StellenÄnderungen und Ergänzungen durchgeführt werden. Diese sind nachfolgend beschrieben oder inder Schnittstellenbeschreibung von Immobilienscout24 zu finden.

Nach der Übertragung einiger Beispielobjekte und deren Bereitstellung auf Immobilienscout24.desollten Sie die Darstellung in der Börse genauestens auf etwaige Fehler prüfen. Im Anschluss an denerfolgreich verlaufenen Test können Sie dann die Übertragung Ihres gesamten Objektbestandesveranlassen.

So konfigurieren Sie die Immobilienscout24 REST-API-SchnittstelleBevor Sie mit der eigentlichen Konfiguration beginnen können, muss estateOffice / estatePro dienotwendigen Voraussetzungen erfüllen. In diesem Fall bedeutet das die Installation der neuen Version4.1. Außerdem sollten Sie sich auch mit den Neuerungen vertraut machen, die das Update mit sichbringt. Diese können Sie in der zugehörigen Update News (estateOffice / estatePro) nachlesen.

Weiterhin benötigen Sie neben Ihren Zugangsdaten für das Immobilienscout24-Portal auch dienotwendigen Berechtigungen, um Änderungen im System von estateOffice durchführen zu können.Nachdem Sie estateOffice / estatePro 4.1 installiert und gestartet haben, können Sie mit derKonfiguration der neuen Schnittstelle beginnen. Damit Sie dabei auf der sicheren Seite sind, legen Sie,statt die alte Schnittstelle zu bearbeiten, einen neuen Eintrag an:

Praxistipp IS24 REST-API 4.1 - Seite 2 von 3

Schritt 1

Rufen Sie über die Kachel System die Systemeinstellungender Software auf. Hier wechseln Sie über dieNavigationsleiste am linken Rand auf den letzten PunktInternet und aktivieren dort den Eintrag Börsen. Unter derÜberschrift Internetbörsen im Datenbereich sind in derRegel bereits einige Einträge vorhanden, unter anderemauch für den Immobilienscout. Da diese alte Konfigurationaber künftig nicht mehr vom Portal akzeptiert wird, fügenSie einen neuen Eintrag hinzu. Klicken Sie hierzu in derSymbolleiste auf Neue Börse.

Schritt 2

Auf der rechten Seite des Datenbereiches müssen Sie nuneinige Felder befüllen. Tragen Sie zunächst einenaussagekräftigen Namen [1] ein, der sich von derbisherigen Benennung der Immobilienscout24-Börseunterscheidet. Wir haben uns in diesem Beispiel für dieBezeichnung "Immobilienscout24 REST" entschieden.Darüber hinaus befüllen Sie noch das FeldAnbieternummer [2]. Dabei handelt es sich um IhreKundennummer bei Immobilienscout24. Weiterhin müssenSie noch das Feld Anfragen E-Mail [3] mit dem Eintrag "anfrage@immobilienscout24.de" befüllen.Wichtig ist außerdem die Auswahl des richtigen Formats [4]. Wählen Sie zunächst den EintragIS24Immo 1.29. Es handelt sich dabei um das alte Format, welches Sie aus Kompatibilitätsgründen ersteinmal übernehmen müssen. Klicken Sie zum Abschluss in der Symbolleiste auf Speichern.

Schritt 3

Nachdem Sie die neue Börse angelegt haben, importierenSie die Einstellungen, die Sie für den altenImmobilienscout-Eintrag vorgenommen hatten. Hierzuklicken Sie auf die Schaltfläche Kopieren von Börse. Indem sich nun öffnenden Fenster wählen Sie denbisherigen Immobilienscout-Eintrag aus und klicken aufOK. Das Fenster schließt sich nun wieder und Siespeichern wie zuvor die Änderungen über den Button inder Symbolleiste.

Schritt 4

Jetzt folgt der wichtigste Schritt: Die Konvertierung vomalten in das neue Immobilienscout-Format. Sie wählenhierzu unter Format den Eintrag IS24Immo REST 1.0. Nunöffnet sich ein Hinweisfenster, welches Sie wieder mitKlick auf Ja schließen können. Die Konvertierung beginntnun und ist nach einer kurzen Wartezeit abgeschlossen.Speichern Sie Ihre Änderungen.

Praxistipp IS24 REST-API 4.1 - Seite 3 von 3

Schritt 5

Klicken Sie nun im unteren Teil des Datenbereichs auf das+-Symbol vor IS24 REST API. Im Bereich Status sehen Siedie Meldung "Noch nicht autorisiert". Dieser Hinweisbedeutet, dass Sie noch keine Daten anImmobilienscout24.de übertragen können, da Ihre Login-Daten noch nicht hinterlegt sind. Um dies zu ändern,klicken Sie auf die Schaltfläche Autorisieren darunter.

Schritt 6

Ein neues Fenster öffnet sich. Tragen Sie hier IhreZugangsdaten, also Benutzerdaten und Passwort ein, dieSie von Immobilienscout erhalten haben, und verbindenSie sich durch einen Klick auf Anmelden mit Ihren Account.Nach erfolgter Bestätigung schließt sich das Fensterautomatisch. Zum Abschluss speichern Sie IhreÄnderungen wieder über das entsprechende Icon in derSymbolleiste.

Wichtiger Hinweis zu Grundstücken und ProvisionsfeldernDie Einführung der neuen Schnittstelle bringt zahlreiche Änderungen und Anpassungen mitsich. Die folgenden Punkte sollten Sie bei der Übertragung Ihrer Objekte zumImmobilienscout24 besonders beachten:

Überprüfen Sie vor der Übertragung, ob es sich bei Ihren Grundstücken ausschließlich um Wohn-oder auch um Gewerbegrundstücke handelt. Für Gewerbegrundstücke ist eine individuelleAnpassung der Schnittstelle erforderlich. Wenden Sie sich in diesem Fall bitte vor der erstmaligenÜbertragung an unsere Support-Hotline unter +49 911 520 25-30. Wir sind Ihnen gern bei derrichtigen Konfiguration behilflich.

Prüfen Sie vor der Übertragung bitte auch, ob die Provisionsfelder in Ihren Objekten korrektausgefüllt sind. Bislang konnten diese Felder optional mit Inhalten befüllt werden. In der neuenImmobilienscout24-REST-API werden diese jedoch als Pflichtfelder übertragen. Sind sie nichtkorrekt ausgefüllt, kann es zur fehlerhaften Übertragung Ihrer Objekte kommen.

Bei der Konvertierung in das neue Format werden Bildreihenfolgen, die Sie für ein Objektindividuell vorgenommen haben, nicht übernommen.

Die Umstellungen für den neuen Energieausweis werden beim Immobilienscout24 aktuell nochoptimiert. Diese Verbesserungen werden selbstverständlich auch für estateOffice und estateProübernommen. Wir rechnen mit der Veröffentlichung eines entsprechenden Service-Updatesrechtzeitig bis spätestens Anfang Mai 2014.