OpenImmo importer

After you have installed and configured the OpenImmo extension and have set up the scheduler you can start importing your data by using an OpenImmo-API or ImmoScout-API. It is important to know that the OpenImmo importer looks for import data in the uploads/tx_openimmo/connection-x directory (x will be replaced by the uid of the connection; if the folder doesn't exists, execute the scheduler task and it will be created). Make sure you configure your property management software so that its export data is automatically output to this directory.

Notice:

The following property management software has already been used successfully with the TYPO3 OpenImmo extension:

• FlowFact How to set it up:

  • https://flowfact.atlassian.net/wiki/pages/viewpage.action?pageId=5636518
  • https://www.flowfact.de/help_2014/Content/Module&Co/Internetboersen_ImmoXMLAssistent.htm

• FLOWFACT hAPPy

  • https://flowfact.atlassian.net/wiki/pages/viewpage.action?pageId=9732122

  Note on FlowFACT hAPPy: This software does not support full imports, so follow the steps below

  1. Set up the interface as usual.
  2. Assign all the required properties.
  3. If you start synchronising, all properties should be transferred. The software seems to remember which properties have already been transferred.
  4. New properties must always be assigned a transfer destination.

• FlowFact Performer CRM

• immotion (R) from the GAP-Group (no version number XML)

• LAGLER IMMO-Spezial

• Immoblueplus (Aareon)

• onOffice

• Immomio

• EverReal

• fio.de der FIO Systems AG

• TopReal.at (Attention: For this software an additional fetchData Scheduler-Task has to be installed, which loads the import XML from the topreal.at server!)

• Expose 9 (Attention: This software doesn't support synchronization of type VOLL!)

• estateOffice, estatePro & estateSmart

If you run the scheduler the uploads/tx_openimmo/connection-x directory is checked for .zip files. If a .zip file is found it is decompressed and then imported. If more than one file is found they will be imported one after the other. The importer imports files in ascending alphabetical and numerical order. Make sure that your uploaded import files are .zip files!

Warning:

The first import in a new system must always be a complete import (Umfang=VOLL)

If the importer doesn't find any import data it simply does nothing.

Warning:

The filenames of attachments of a property (pictures, PDFs, etc.) shouldn't contain umlauts or any special characters otherwise the documents may not be assigned correctly in the system. Therefore, if a picture is missing in the frontend, please check its filename.

If more than one import file is found in the import directory, because, for example, data has been processed twice during a cronjob interval, the OpenImmo importer imports the files by filename in ascending order. So if a date is included in the filename the older file will automatically be imported first.

Info:

The importer can also be run manually. Simply load an OpenImmo transfer file into the Uploads directory and then run the OpenImmo task in the Scheduler module in the TYPO3 backend. After it has run, you can then evaluate the resulting messages.

Troubleshooting

Exception: You are not allowed to access the given folder

• Please check if the Openimmo Import / Uploads storage directory has the following properties: public, fs-writable, fs-readable, online. You can find this storage directory via the list module on the root page (Page-Uid: 0).
• Check also the directory rights under uploads / tx_openimmo to see if Importer/www-user has write access.

Testing import files

• Generic Openimmo import file
• Generic Openimmo import file S01
• Generic Openimmo import file S02
• Generic Openimmo import file, change property based on S02 import
• Generic Openimmo import file, delete property based on S02 import
• Generic Openimmo import file with documents and groups