Allgemein

Das folgende Dokument beschreibt alle relevanten Aspekte zur Einrichtung des Importers von Immomio. Der Importer ermöglicht den Export von Objekten zu Immomio über klassischen ERP Software, ohne manuelle Aufwände. Diese Objekte können nach dem erfolgreichen Import in Immomio bearbeitet und auf Wunsch auf die jeweiligen Portale verteilt werden.




Führen Sie die folgenden Schritte durch um den Objektimport zu nutzen

  1.  Buchen Sie das "Bestandsimport" Modul in der "Produktbuchung" Sektion
  2. Fügen Sie die FTP-Zugangsdaten zu Ihrem ERP-System hinzu (Admins können diese im Bereich "Verwaltung->FTP Import" abrufen)
  3. Stoßen Sie den Objektexport aus Ihrem ERP-System an. Sobald dieser abgeschlossen ist finden Sie die neu importierten Objekte in der Spalte “Importiert”




Unterstützte Standards

Aktuell unterstützt der Importer zwei Standards:

  • OpenImmo (Version 1.2.7b) (im Anhang an den Artikel finden Sie ein XSD mit den Feldbeschreibungen)
  • ReLion

Für beide Standards gilt, dass die jeweiligen Inhalte in einem ZIP File übertragen werden müssen. Um alle Inhalte aus der ERP Software auch in Immomio vorzufinden, müssen die ZIP Files folgende Inhalte haben:

  • Objekte
  • Bilder im Format .jpg (der Wohnungen, Häuser etc.)
  • Dokumente im Format .pdf (Energieausweise, Pläne etc.)


Hinweis: Wenn die relativen Pfade in der ReLion CSV bzw. OpenImmo XML Datei nicht korrekt sind, so ist es nicht möglich im automatischen Prozess die Bilder, respektive die Dokumente zu finden.

Die Dokumente selbst müssen für eine korrekte Verarbeitung von Umlauten und Sonderzeichen im Format UTF-8 konfiguriert sein. Bei anderen Encodings gibt Immomio keine Garantie für eine korrekte Verarbeitung der Inhalte.


Beispiel für OpenImmo:

<anhang location="INTERN" gruppe="BILD">
    <anhangtitel>Bild 2</anhangtitel>
    <format>jpg</format>
    <daten>
        <pfad>BILD.JPG</pfad>
    </daten>
</anhang>


Hinweis zu den Bildern:

  • Der Immomio Importer unterstützt aktuell zwei Bildformate: PNG und JPG (andere Formate wie RAW oder GIF werden nicht unterstützt)
  • Die Bilder in den Anhängen müssen nur in einer Größe vorhanden sein. Der Immomio Importer konvertiert die Bilder jeweils in die für die unterschiedlichen Endgeräte notwendigen Formate und Größen.



Konfiguration des ERP Systems

Der Immomio Importer unterstützt zwei Verfahren zur Übertragung von Inhalten:

  • FTP
  • SFTP


Hinweis: Seitens Immomio ist der präferierte Übertragungsweg SFTP.


FTP

Für FTP stellt der Immomio Importer die folgenden Ports zur Verfügung:

  • 2121
  • 48152 - 48200


Hinweis: Immomio stellt nicht den Standard Port 21 für FTP zur Verfügung, aufgrund der häufigen Abfrage- und Login-Versuche von Bots auf Port 21.


Um Dateien hochzuladen, ist es notwendig im FTP Client den sog. Passive Mode zu aktivieren. Der Passive Mode ist deshalb sinnvoll, weil er verhindert, dass eingehender Traffic auf Port 2121 von außen zugelassen werden muss. 


Hinweis: Die genannten Ports müssen in der Firewall NUR für ausgehenden Traffic aktiviert sein.


SFTP

Für SFTP stellt der Immomio Importer den folgenden Port zur Verfügung:

  • 2222


Hinweis: Immomio stellt nicht den Standard Port 22 für SFTP zur Verfügung, aufgrund der häufigen Abfrage- und Login-Versuche von Bots auf Port 22.

Wichtig: Sollten Sie die Verbindung mit einem Client (z.B. Filezilla oder WinSCP) testen und die Verbindung schlägt fehl, überprüfen Sie ob der Serverschlüssel aktuell ist und aktualisieren Sie diesen. 




Nutzung der Zugangsdaten in Flowfact


  • Bezeichnung: Immomio
  • Hostadresse: siehe FTP Bereich in Immomio
  • Kundennummer = Benutzername(ohne -openimmo)
  • Login = Benutzername
  • Passwort = Passwort



Wichtig: Datei muss als ZIP-Datei geschickt werden + nur als Teilabgleich !



Bereits getestete Vermarktungssoftwares: 

  • Flowfact Performer
  • Flowfact Happy
  • onOffice
  • estateOffice
  • Wodis Sigma



Fehlerbehebungen:

Beim Herstellen der Verbindung erhalten ich ein Timeout.

Überprüfen Sie die Porteinstellungen und geben Sie die unterstützen Ports entsprechend frei. 


Wie kann ich testen ob ich die richtigen Ports freigegeben habe?

Für Linux: Bitte öffnen Sie eine Kommandozeile und geben Sie die folgenden Kommandos ein. 

telnet ftp.immomio.com 2222
telnet ftp.immomio.com 2121

Sollte die Verbindung erfolgreich gewesen sein, sollten sie den folgenden Ouput in der Kommandozeile sehen:

Trying 185.80.184.158...
Connected to ftp.immomio.com.
Escape character is '^]'.
SSH-2.0-SSHD-CORE-1.6.0


Für Windows: Bitte öffnen Sie eine Kommandozeile und geben Sie die folgenden Kommandos ein. 

telnet ftp.immomio.com 2222
telnet ftp.immomio.com 2121

Sollte die Verbindung erfolgreich gewesen sein, sollten sie den folgenden Ouput in der Kommandozeile sehen:

Trying 185.80.184.158...
Connected to ftp.immomio.com.
Escape character is '^]'.
SSH-2.0-SSHD-CORE-1.6.0


Wenn ich Objekte übertrage, erscheinen diese nicht in Immomio. Es wird kein Import in Immomio gestartet.

Stellen Sie sicher, dass die Dateinamen von Anhängen und Bildern oder die XML Dateien keine Leerzeichen beinhalten und die genutzten Zeichen der Codierung UTF-8 entsprechen. 


Bei der Nutzung von Estate Office: Stellen Sie sicher, dass keine Doppelangaben in den Feldern stehen (z.B. Baujahr 1900-1991).


Bei der Nutzung von Flowfact: FTP Port ist standardmässig 21 und kann nicht verändert werden.


Es fehlen bei einzelnen Objekten Bilder.

Bitte überprüfen Sie hierfür Ihren Export. Der Immomio Importer ist in der Lage alle Dateien aus den Archiven auszulesen und in Immomio zu importieren. Voraussetzung hierfür ist, dass die Bilder in den Archiven vorhanden sind und an der richtigen Stelle im richtigen Format vorliegen. 


Meine Bilder werden übertragen, erscheinen aber als leere Platzhalter.

Dies kann vorkommen, wenn die Bilder nicht im richtigen Format übertragen wurden und der Immomio Importer nicht in der Lage war, die Bilder zu skalieren. Bitte überprüfen Sie, ob Sie die Bilddateien öffnen können und ob sie den Anforderungen für Bilder seitens Immomio entsprechen. 


Einige Felder in Immomio werden trotz Import nicht befüllt.

Um sicher zu stellen, dass alle Open Immo Felder korrekt übertragen werden, prüfen Sie das XML auf Leerzeichen in allen Feldern, welche nicht für Text gedacht sind. 

Im Anhang finden Sie den aktuellen OpenImmo Standard als XML Beispiel


Nach dem Import werden bestehende Objekte nicht aktualisiert.

Überprüfen Sie, ob Sie dem Objekt aus der Schnittstelle heraus eine neue externe ID vergeben haben. Ein Abgleich der Objektdaten orientiert sich immer an dieser ID. 


Der Import überschreibt all meine Änderungen in Immomio.

Deaktivieren Sie falls möglich den Vollabgleich bei Ihrer Schnittstelle oder nutzen Sie den Schreibschutz in den Einstellungen der Objekte.


Einige Änderungen werden bei aktivierten Objekten nicht übernommen.

Beim Objekt könnte der Schreibschutz aktiv sein. Um Änderungen am Objekt zuzulassen, muss dieser deaktiviert sein. 







Im Anhang finden Sie den aktuellen OpenImmo Standard als XML sowie eine beispielhafte Zip Datei.