Schnittstelle für Profis
neocasa.ch empfängt Objekte im OpenImmo-Standard 1.2.7 – dem Format, das onOffice, FlowFact, CASAsoft, Immotop und die meisten anderen Makler-Systeme exportieren. Einmal eingerichtet, fliessen Ihre Inserate vollautomatisch ein: neue Objekte, Aktualisierungen, Bilder und Löschungen.
Richten Sie die Verbindung im Portal unter neocasa.ch Connect selbst ein: Software auswählen, Anleitung folgen, Zugangsdaten eintragen. Kein Telefonat, keine Wartezeit auf eine Freischaltung. Diese Seite hier beschreibt dasselbe Verfahren für alle, die es direkt in ihrer Software umsetzen wollen.
Ihre Software sendet die OpenImmo-XML samt Bildern per POST an:
POST https://neocasa.ch/api/openimmo/import.php
Header: X-Api-Key: IHR-SCHLUESSEL
Formularfelder (multipart/form-data), wahlweise:
package = ZIP mit OpenImmo-XML + Bildern (ein Feld, wie die meisten Systeme exportieren)
oder
xml = OpenImmo-XML-Datei
images = ZIP mit den Anhang-Bildern (optional)Beispiel mit curl:
curl -X POST https://neocasa.ch/api/openimmo/import.php \
-H "X-Api-Key: IHR-SCHLUESSEL" \
-F "package=@export.zip"Antwort (JSON):
{ "ok": true, "imported": 3, "updated": 1, "deleted": 0, "errors": [], "warnings": [] }Exportiert Ihre Software nur per FTP, erhalten Sie einen eigenen FTP-Zugang. ZIP-Pakete (XML + Bilder) werden automatisch alle 10 Minuten verarbeitet; verarbeitete Pakete wandern in _done/, fehlerhafte in _error/.
| OpenImmo-Feld | Verwendung bei neocasa.ch |
|---|---|
| nutzungsart / vermarktungsart | Mieten, Kaufen oder Gewerbe |
| objektart (wohnung, haus, buero_praxen …) | Objektkategorie |
| preise (kaufpreis, warmmiete, kaltmiete, nettokaltmiete …) | Preis |
| flaechen (wohnflaeche, nutzflaeche, anzahl_zimmer) | Fläche & Zimmer |
| geo (strasse, plz, ort, geokoordinaten) | Adresse & Karten-Pin (fehlende Koordinaten werden automatisch ermittelt) |
| freitexte (objekttitel, objektbeschreibung, lage, ausstatt_beschr) | Titel & Beschreibung |
| ausstattung (balkon, lift, stellplatz, küche …) | Ausstattungs-Merkmale |
| anhaenge / anhang (Bilder im ZIP) | Bildergalerie – Bilder werden bei neocasa.ch gehostet |
| verwaltung_techn / objektnr_extern | Eindeutige Referenz: gleiche Nummer = Aktualisierung statt Duplikat |
| aktion aktionart="DELETE" | Inserat wird offline genommen |
Eingehende Lieferungen werden gegen das offizielle OpenImmo-1.2.7d-Schema geprüft. Abweichungen führen nicht zur Ablehnung, sondern werden in der Antwort alswarnings gemeldet.
Die Schnittstelle ist Teil jedes Anbieter-Kontos – während der Einführungsphase also kostenlos, siehe Preise. Ihre per OpenImmo gelieferten Objekte erscheinen als vollwertige Inserate: mit Bildern, Kontaktformular, Umgebungsanalyse und IhremAnbieter-Profil.
Die Einrichtung läuft im Portal – Sie brauchen dafür niemanden anzuschreiben.
Verbindung einrichten