Schnittstelle für Profis

OpenImmo-Anbindung

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.

So starten Sie

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.

Variante A: HTTPS-Upload (empfohlen)

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": [] }

Variante B: FTP

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/.

Was verarbeitet wird

OpenImmo-FeldVerwendung bei neocasa.ch
nutzungsart / vermarktungsartMieten, 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_externEindeutige 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.

Konditionen

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.

Bereit für die Anbindung?

Die Einrichtung läuft im Portal – Sie brauchen dafür niemanden anzuschreiben.

Verbindung einrichten