Please note that this documentation is for the most recent version of this extension. It may not be relevant for older versions. Related documentation can be found in the documentation directory of the extension.
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:
FLOWFACT hAPPy
Note on FlowFACT hAPPy: This software does not support full imports, so follow the steps below
- Set up the interface as usual.
- Assign all the required properties.
- If you start synchronising, all properties should be transferred. The software seems to remember which properties have already been transferred.
- 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 / Uploadsstorage 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_openimmoto see if Importer/www-user has write access.
Testing import files
TYPO3 OpenImmo
TYPO3 OpenImmo is a real estate extension that reads in your objects via an OpenImmo-API and displays them on your website.