ImmobilienScout24.de-REST-Schnittstelle

Mit dem Upgrade Performer CRM 2014 R2 wird die Übertragung zu ImmobilienScout24 via REST-API-Schnittstelle unterstützt.

Der ImmobilienScout24 stellt seine Schnittstelle zur Übertragung von Immobiliendaten um. In diesem Rahmen wird vom ImmobilienScout24 die neue IS24-REST-API eingeführt. Diese wird zukünftig der einzige Weg sein, um Immobiliendaten aus Performer CRM zu ImmobilienScout24.de zu übertragen.

Zudem ermöglicht die neue IS24-REST-API die Übertragung aller relevanten Angaben zum Energieausweis. Somit ist ein zusätzliches Hinzufügen in den „Sonstigen Angaben“ nicht mehr notwendig und kann im AddIn „ENEV 2014“ deaktiviert werden.

Nachfolgend werden detaillierte Informationen gegeben zu:

 

Abkündigung IS24-FTP-Übertragungen

Vom ImmobilienScout24.de werden alle Übertragungswege, welche nicht über die neue IS24-REST-API gehen zum 31.12.2014 abgeschaltet. Bei Performer CRM Kunden betrifft dies die beiden Möglichkeiten der „OpenImmo (CSV)“ und der „ImmobilienScout24 XML“ Übertragung.

 

Wie erkennen Sie welche Schnittstelle Sie zurzeit nutzen?

Die einfachste Möglichkeit um Ihre aktuellen Schnittstellen zu überprüfen stellt das AddIn „IS24 Börsentest“ da. Laden Sie sich dieses per Live Update im AddIn-Konfigurator in Ihr System und starten Sie Performer CRM danach neu. Nun finden Sie in Ihrer Ribbon-Leiste auf dem Reiter „Hilfe“ die Funktion „Informationen zur IS24-Rest-API“. Betätigen Sie diese Funktion, öffnet sich ein Fenster mit den entsprechenden Informationen.

 

Übertragung per OpenImmo (CSV) Schnittstelle

Performer CRM Kunden welche noch mit OpenImmo an ImmobilienScout24.de übertragen müssen am schnellsten eine Änderung vornehmen. Dieser Weg wird nur noch bis zum 31.12.2014 unterstützt. Ab diesem Termin ist keine Übertragung auf diesem Weg mehr möglich!

Um hier abzuhelfen ist ein Update auf Performer CRM 2014 R2 notwendig und eine Neueinrichtung der neuen IS24-REST-API Schnittstelle im System.

 

Übertragung per ImmobilienScout24-XML Schnittstelle

Die Übertragung mittels der IS24-XML Schnittstelle wird von ImmobilienScout24.de zum 31.12.2014 abgeschaltet. Dies bedeutet für Sie, dass Sie ab diesem Tag keine Immobilien mehr auf diesem Wege an den ImmobilienScout24 übermitteln können.

Um hier abzuhelfen ist ein Update auf Performer CRM 2014 R2 notwendig und eine Neueinrichtung der neuen IS24-REST-API Schnittstelle im System..

 

Umstellung auf die IS24-REST-Übertragung

Damit bei der Umstellung alles reibungslos verläuft, finden Sie hier eine Anleitung zur Umstellung der Übertragung.

 

Prüfen ob das Feld Ansprechpartner ein Feld vom Typ Adresslink ist

Prüfen Sie nach dem Update (oder lassen Sie dies Ihren Installationspartner prüfen) ob das Feld „Ansprechpartner“ im Objekt vom Typ „Adresslinkfeld“ ist. Dies kann ein FLOWFACT-Administrator im Bereich Administration unter dem Punkt „Feldarten“ einsehen. Normalerweise sollte das Feld bereits auf diesen Typ eingestellt sein, bei einigen älteren Performer CRM Systemen kann es allerdings vorkommen, dass das Feld mit dem Typ „Text“ eingerichtet ist. Sollte dies bei Ihnen der Fall sein, sollte dies umgestellt werden. Am besten besprechen Sie dies ebenfalls mit Ihrem Installationspartner.

Wenn das Feld auf den Typ "Adresslink" umgestellt ist, sollten Sie bitte zudem diejenigen Vorlagen prüfen, in welchen auf den Inhalt des Feldes "Ansprechpartner" per Platzhalter zugegriffen wird, da nun mehr Informationen in dem Feld eingepflegt sind.

 

Einstellen der CustomMappings bei angepassten Feldern

Wenn Sie ein absolutes Standard-System besitzen oder Sie weder angepasste Felder, Eingabehilfen noch eine eigene Zuordnungsdatei besitzen, können Sie diesen Punkt überspringen.

Sollten Sie allerdings eine angepasste Zuordnungsdatei für die Börsenübertragung aufgrund eigener Felder oder Feldwerte besitzen, müssen Sie nach dem Update die sogenannte CustomMapping Tabelle bearbeiten. In dieser Tabelle können Sie Ihre eigenen Felder Feldern im ImmobilienScout24.de (bzw. der FLOWFACT API) zuweisen, damit diese bei einer Übertragung auch korrekt dargestellt werden. Die Zuordnung der Custommappings können Sie über das AddIn "CustomMappingConfigurator" vornehmen.

Eine detailierte Dokumentation zur Anwendung ist im AddIn selbst enthalten.

Sollte Ihnen bereits frühzeitig bekannt sein, dass Sie eine stark angepasste Zuordnungsdatei für die Internetübertragung besitzen, empfiehlt sich hier vor dem Update ein Gespräch mit Ihrem Installationspartner oder Ihrem Betreuer bei der FLOWFACT AG.

 

Einrichtung der neuen IS24-REST-API Schnittstelle

Der vorletzte Schritt ist die Neueinrichtung der neuen IS24-REST-API Schnittstelle in Ihrem Performer CRM. Dies können Sie wie gewohnt in der Administration unter dem Punkt „Grundeinstellungen“ -> „Stand. Schnittstellen“ vornehmen. Wählen Sie dort die Schaltfläche „Schnittstelle neu anlegen / bearbeiten“ und wählen im sich öffnenden Assistenten die Option „neue Schnittstelle anlegen – ImmobilienScout24 (REST-API)“ aus.

 

Im nächsten Schritt geben Sie der Internetbörse einen Namen und betätigen den Knopf „Eingeben“ um Ihre Zugangsdaten für die neue Schnittstelle zu hinterlegen. WICHTIG: Hier sind diejenigen Zugangsdaten relevant mit denen Sie sich über die Weboberfläche von ImmobilienScout24.de in Ihren Account einloggen und nicht mehr die bisherigen FTP-Zugangsdaten.

 

Deaktivieren aller Objekte über die alte Schnittstelle

Vor dem Update auf die neue Version deaktivieren Sie alle Ihre übertragenen Immobilien im ImmobilienScout24.de. Entfernen Sie dazu einfach bei allen Objekten die Häkchen zur Übertragung an den ImmobilienScout24.de im Reiter „eMakeln“. Um dies schneller zu erreichen kann dies auch ein Nutzer mit der notwendigen Berechtigung über das Tool „Global ändern“ vornehmen. Dann sollten Sie zunächst die Einstellungen der bisherigen ImmobilienScout24.de-Schnittstelle auf die neu eingerichtete Schnittstelle übertragen und danach die Zuordnung zur bisherigen ImmobilienScout24.de-Schnittstelle entfernen.

Wenn Sie alle Objekte dementsprechend bearbeitet haben starten Sie zunächst eine Übertragung ausschließlichfür die "alte" ImmobilienScout24.de-Schnittstelle. Wenn diese erfolgreich abgeschlossen und damit alle Immobilien von ImmobilienScout24.de entfernt wurden, starten Sie danach die Übertragung explizit für die neu eingerichtete ImmobilienScout24.de-Schnittstelle, um die Immobilien erneut zu veröffentlichen. Von einer gleichzeitigen Übertragung an beide Schnittstellen wird abgeraten, da in diesem Fall Fehldarstellungen nicht ausgeschlossen werden können.

Hinweis:
Bitte beachten Sie, dass Sie die Immobilien natürlich nur über die alte Schnittstelle deaktivieren können, wenn diese von ImmobilienScout24.de noch zur Verfügung gestellt wird. Sollten Sie nach der Abschaltung erst das Update durchführen, müssen Sie alle Immobilien manuell über Ihr ImmobilienScout24.de-Konto auf der Webseite durchführen.

 

Übertragung mit der neuen Schnittstelle

Die Übertragung wird auf dem bisher gewohnten Weg gestartet. Der stärkste Unterschied ist die Übertragung, welche nun asynchron stattfindet. Dies bedeutet, Sie erhalten direkt nach dem Start der Übertragung die Rückmeldung, dass diese durchgeführt wurde. Nun wird die Übertragung im Hintergrund durchgeführt und sobald diese abgeschlossen wird erhalten Sie eine Nachricht in Ihrer Wiedervorlage. Bitte beachten Sie, dass es gerade bei großen Übertragungen länger dauern kann, bis diese abgeschlossen sind. Daher wird das Erscheinen der Aktivität in Ihrer Wiedervorlage einige Zeit in Anspruch nehmen.

 

Wichtige Anmerkungen für Nutzer der Mandanten.ini

Für Kunden welche aktuell die Mandanten.ini von Performer CRM nutzen, um mit verschiedenen Konten oder Firmendaten an den ImmobilienScout24.de zu übertragen gibt es einige Änderungen.

Für Kunden die keine derartige Übertragung durchführen oder denen der Begriff Mandanten.ini unbekannt ist, ist dieser Abschnitt irrelevant.

 

Unterstützung der Mandanten.ini

Mit der IS24-REST-API werden die Funktionen der Übertragung durch die Mandanten.ini durch ImmobilienScout24.de nicht mehr unterstützt. Eine bereits eingerichtete Mandanten.ini für eine bestehende ImmobilienScout24.de-Schnittstelle wird bei der Umstellung nicht weiter berücksichtigt. Durch einige Verfahrensänderungen in der Übertragung durch die neue Schnittstelle sind nun aber einige Funktionen der Mandanten.ini obsolet geworden.

 

Übertragung von Filialdaten

Durch eine Änderung in der Übertragungslogik von der alten FTP-Schnittstelle zur neuen IS24-REST-API wurden hier die Möglichkeiten erweitert. Dies bedeutet, dass zukünftig viele Adressinformationen nicht aus den Firmendaten sondern direkt vom am Objekt eingestellten Ansprechpartner gezogen werden.

Folgende Werte werden zukünftig über den verknüpften Ansprechpartner übertragen:

Dies versetzt Sie in die Lage, Daten von Filialen gemeinsam über ein Konto und eine Schnittstelle zu versenden, dabei aber immer die entsprechenden Daten der Filiale mitzugeben. Nur bei der Firma ist dies momentan nicht möglich, daher setzt diese Übertragung voraus, dass alle Niederlassungen oder Filialen unter der gleichen Firmierung arbeiten.

 

Übertragung mit unterschiedlichen Firmierungen

ImmobilienScout24.de hat leider mit der neuen IS24-REST-API die Möglichkeit deaktiviert den Firmennamen bei jeder Übertragung separat mit zu übertragen. Daher werden zukünftig mehrere Konten und eingerichteten Schnittstellen in Performer CRM benötigt, sollen auch zukünftig Objekte aus demselben System mit unterschiedlichen Firmierungen an den ImmobilienScout24.de gesendet werden. Hinter dem zu übertragenden Objekt wählen Sie dann die Schnittstelle aus mit der das Objekt in das korrekte ImmobilienScout24.de Konto übertragen wird.


 

Informationen für Entwickler zu Events

Die FLOWFACT AG stellt für Entwickler bei der Internetübertragung einige Events zur Verfügung. Durch die Änderung der Schnittstellentechnologie bei ImmobilienScout24.de kommt es hier auch zu Änderungen.

 

Sind Sie betroffen?

Die Events werden von Skripten genutzt, welche ein Programmierer erstellt und im FLOWFACT-Verzeichnis in den Ordner „system\Services\Openimmo“. Dort werden diese als *.vbs Dateien abgelegt und beim Start von FLOWFACT eingelesen. Einige der hier liegenden Skripte sind Standarddateien, welche von der FLOWFACT AG ausgeliefert werden:

Sollten in diesem Ordner über die angegebenen Dateien hinaus weitere existieren, sollten Sie sich mit Ihrem FLOWFACT-Betreuer in Verbindung setzen.

 

OpenImmo Events

Es existiert eine ganze Reihe von Events bei OpenImmo-Übertragungen, welche mit der alten Schnittstelle zum Teil heute noch gemeinsam mit einer ImmobilienScout24.de-Übertragung genutzt werden können. Da die IS24-REST-API Übertragung keine OpenImmo-Übertragung mehr ist, werden diese Events logischerweise nicht mehr unterstützt.

 

Börsenübertragungsevents

Neben den OpenImmo-Übertragungsevents existieren noch die beiden Events Callback_BeforeTransfer und Callback_AfterTransfer. Beide Events werden auch mit der neuen IS24-REST-API unterstützt. Allerdings kommt das Callback_AfterTransfer aufgrund der asynchronen Übertragung direkt nach dem Callback_BeforeTransfer. Dadurch gibt es momentan kein qualifiziertes Feedback mehr wann eine Übertragung beendet ist.