Fragen zum Portalexport via ImmoTool

Aus OpenEstate-Wiki

Inhaltsverzeichnis 1 Mit welchen Portalen ist ein Datenaustausch möglich? 2 Ich möchte in einem Portal inserieren, dass sich nicht in diesem Wiki dokumentiert ist. Was kann ich tun? 3 Welche Fragen müssen mit einem Portal geklärt werden, dass ein Datenaustausch stattfinden kann? 4 Es werden keine Immobilien beim Export berücksichtigt, was kann ich tun? 5 Was ist der Unterschied zwischen einem Teil- & Vollabgleich? 6 Sollte ich besser einen Teil- oder Vollabgleich durchführen? 7 Im Immobilienportal werden die Eingaben aus dem ImmoTool unvollständig dargestellt. Was kann ich tun? 8 Wie funktioniert der Export zu einem gemeinsam genutzten Immobilienportal?

Mit welchen Portalen ist ein Datenaustausch möglich?

Grundsätzlich ist ein Datenaustausch mit allen Portalen möglich, die eines der Immobilienformate aus dem ImmoTool unterstützen. Momentan kann das ImmoTool folgende Formate exportieren:

• OpenEstate-XML
• OpenImmo-XML
• ImmoXML
• ImmobilienScout24-CSV
• ImmobilienScout24-XML

Eine Übersicht der Portale, bei denen ein Export nachweislich funktioniert hat, finden Sie in der Exportübersicht.

Ich möchte in einem Portal inserieren, dass sich nicht in diesem Wiki dokumentiert ist. Was kann ich tun?

• Informieren Sie uns kurz via Ticketsystem und wir setzen uns gern mit dem jeweiligen Portal auseinander. Die technischen Details werden wir hier im Wiki zusammenfassend dokumentieren.
• Bitte beachten Sie, dass wir uns nur auf deutsch oder englisch mit den Portalbetreibern verständigen können. Sollten die Betreiber andere Sprachen sprechen, sind wir auf die Zusammenarbeit mit den Anwendern angewiesen.

Welche Fragen müssen mit einem Portal geklärt werden, dass ein Datenaustausch stattfinden kann?

• Wie werden die Immobilien zum Portal übertragen?
  • Möglich ist momentan eine Übertragung via FTP, HTTP-PUT oder HTTP-POST.
• Welche Zugangsdaten werden zum Datentransport benötigt?
  • Der Transport sollte mit einer Anmeldung (Benutzername & Passwort) abgesichert werden.
• In welchem Datenformat sollen die Immobilien übertragen werden?
  • Unterstützt werden die oben genannten XML- & CSV-Formate.
  • Sollte das Portal keines der ImmoTool-Formate unterstützen, muss das gewünschte Format erfragt werden. Damit dieses Format in das ImmoTool integriert werden kann, benötigen wir eine Spezifikation des Formates (z.B. XML-Schema, DTD oder ähnliche Dokumentationen)
• Wie werden die Immobilienfotos zum Portal übertragen?
  • Im Normalfall werden die Bilder gemeinsam mit der XML-/CSV-Datei in einem ZIP-Archiv zum Portal gesendet

Es werden keine Immobilien beim Export berücksichtigt, was kann ich tun?

Damit eine Immobilie exportiert werden kann, muss diese den Status 2. in Vermittlung zugewiesen bekommen. Inserate mit anderem Status (z.B. 1. im Entwurf) werden bei Exporten nicht berücksichtigt. Der Status einer Immobilie kann auf zweierlei Art geändert werden:

1. Markieren Sie die betreffenden Immobilien in der Immobilienübersicht und klicken Sie auf den Button Aktion. Im dargestellten Menü kann der neue Status ausgewählt werden.
2. Öffnen Sie ein Immobilienformular und wählen Sie im Eckdatenformular den entspechenden Status. Klicken Sie abschließend auf den Button Speichern um die Änderung dauerhaft zu speichern.

Was ist der Unterschied zwischen einem Teil- & Vollabgleich?

Dies sind unterschiedliche Verfahrensweisen zum Abgleich des Immobilienbestandes mit einem externen Empfänger (in der Regel ein Immobilienportal).

• Beim Vollabgleich sendet das ImmoTool alle veröffentlichten Inserate (mit Status in Vermittlung) zum Empfänger/Portal.
  • Der Empfänger löscht beim Verarbeiten alle Inserate, die nicht vom ImmoTool übermittelt wurden.
  • Dieses Verfahren hat den Nachteil, dass bei jeder Änderung/Löschung der gesamte Immobilienbestand (inkl. Bilder) übertragen wird. Die Übertragung und Verarbeitung dauert deshalb länger, ist aber unterm Strich zuverlässiger.

• Beim Teilabgleich sendet das ImmoTool die zuletzt geänderten Inserate (in Bezug auf den letzten Teilabgleich).
  • Das ImmoTool protokolliert zwischenzeitige Änderungen / Löschungen im Hintergrund und sendet nur die geänderten Datensätze zum Empfänger.
  • Da grundsätzlich nur Änderungen übertragen werden, sind Übertragungen als Teilabgleich weitaus schneller. (insbesondere bei großen Datenbeständen mit vielen Bildern)

Sollte ich besser einen Teil- oder Vollabgleich durchführen?

Bei kleinen Immobilienbeständen ist ein Vollabgleich am unkompliziertesten und zuverlässigsten.

Jedoch kann bei größeren Immobilienbeständen ein Vollabgleich durchaus eine Stunde oder länger dauern. Dies hängt im wesentlichen von der Upload-Geschwindigkeit des Internetanschlusses ab. Um solche Wartezeiten im Geschäftsalltag zu vermeiden sind Teilabgleiche geschaffen worden.

Achtung: Bei einem Teilabgleich kann es dazu kommen, dass beim Empfänger/Portal die Löschung fehlschlägt. Das ImmoTool erfährt nichts von diesem Fehler und geht davon aus, dass die Löschung korrekt stattgefunden hat. Die nicht gelöschte Immobilie bleibt als 'Datenleiche' beim Empfänger/Portal übrig. Diesem Problem können Sie entgegenwirken, wenn Sie in regelmäßigen Abständen (z.B. wöchentlich) einen Vollabgleich durchführen.

Im Immobilienportal werden die Eingaben aus dem ImmoTool unvollständig dargestellt. Was kann ich tun?

Der Austausch von Immobiliendaten zwischen ImmoTool und einem Portal ist nicht unproblematisch. Datenverluste können an verschiedenen Stellen auftreten:

1. Es ist denkbar, dass eine Eigenschaft vom jeweiligen Immobilienstandard nicht unterstützt wird.
   • In diesem Fall kann man an dem Problem nicht viel ändern. Man kann einzig den Portalbetreiber darum bitten, einen anderen Standard für den Datenaustausch zu implementieren.
2. Es ist ebenfalls nicht unüblich, dass die Portale den jeweiligen Immobilienstandard nicht 100%ig abdecken.
   • Grundsätzlich liegt es im Ermessen des Portalbetreibers, welche Angaben beim Import der ImmoTool-Inserate übernommen werden.
   • In diesem Falle kann man den Portalbetreiber darum bitten, seine Datenbank entsprechend zu erweitern.
3. Es ist ebenso denkbar, dass ein Fehler im ImmoTool vorliegt und eine unvollständige (oder falsche) Exportdatei erzeugt wurde.
   • In diesem Falle werden wir selbstverständlich die nötigen Korrekturen am Programm vornehmen.

Für den Anwender ist es in der Regel nicht ersichtlich, welche der drei Varianten die Ursache des Datenverlustes ist. Schildern Sie uns den Sachverhalt via Ticketsystem und wir überprüfen die Ursache.

Wie funktioniert der Export zu einem gemeinsam genutzten Immobilienportal?

Es ist denkbar, dass mehrere Anwender ein gemeinsames Kontingent in einem Immobilienportal gebucht haben. Es konnte bisher zu Problemen kommen, wenn mehrere Anwender ein gemeinsames Kontingent mit dem ImmoTool beliefern. Mit ImmoTool 0.9.11 wurde das Problem wie folgt gelöst:

• In den Einstellungen der Export-Schnittstelle kann ein ID-Präfix hinterlegt werden. Bei einem Export zum jeweiligen Portal wird vor das eigetragene Präfix vor der Immobilienkennung (Objekt-ID & Objekt-Nr) eingefügt.
• Jeder Anwender im 'Verbund' sollte im ImmoTool ein eigenes Präfix hinterlegen. Aus Sicht des Immobilienportals ist damit eine Eindeutigkeit zwischen den Inseraten hergestellt.
• Achtung: Bevor Sie ein ID-Präfix setzen, stellen Sie sicher, dass vorher alle früheren ImmoTool-Inserate aus dem Portal entfernt werden. Andernfalls können die früheren Inserate nicht automatisch entfernt werden und bleiben als 'Datenleichen' übrig.
• Achtung: Niemand darf im Falle der Nutzung eines gemeinsamen Kontingents einen Vollabgleich senden. Dies würde nämlich bewirken, dass die Inserate der anderen Teilnehmer gelöscht würden.