← OpenImmo-Schnittstelle

Technische Referenz

Für die IT von Maklern und für CRM-Hersteller: wie ein Export an shareDnC aussehen muss und was wir daraus machen. Die Werte auf dieser Seite kommen direkt aus der Konfiguration des Imports.

Format und Übertragung

Versionen: OpenImmo 1.2.4, 1.2.5, 1.2.6, 1.2.7; andere Versionen lesen wir versuchsweise und melden einen Hinweis
Dateien: Eine XML-Datei oder ein ZIP mit genau einer XML-Datei und den Bildern
Zeichensatz: UTF-8 oder ISO-8859-1 laut XML-Deklaration
Übertragung: SFTP in den Ordner import/; Dateien werden alle 5 Minuten abgeholt, sobald sie mindestens 60 Sekunden unverändert liegen
umfang="VOLL": Der komplette Bestand. Aktive Objekte, die nicht in der Datei stehen, gehen offline. Würde das mehr als 50 % der aktiven Objekte treffen (ab 10 Objekten), halten wir die Übertragung zurück und prüfen sie.
umfang="TEIL": Nur die enthaltenen Objekte; der übrige Bestand bleibt unverändert
aktionart: ADD und CHANGE legen an oder aktualisieren, DELETE nimmt offline; REFERENZ wird ignoriert; ohne Angabe gilt CHANGE
art="OFFLINE": Testübertragung: wird geprüft und beantwortet, aber nichts übernommen
Schlüssel: openimmo_obid. Ändert sie sich, ist es für uns ein neues Objekt.

Welche Objekte wir übernehmen

Alles andere überspringen wir; in der Rückmeldung steht zu jedem Objekt, warum.

nutzungsart: GEWERBE
vermarktungsart: MIETE_PACHT
objektart: buero_praxen
buero_typ: BUEROFLAECHE, BUEROHAUS, BUEROZENTRUM, LOFT_ATELIER, PRAXIS, PRAXISFLAECHE, PRAXISHAUS, COWORKING, SHARED_OFFICE
Land (iso_land): DEU, AUT, CHE
Provision: nur provisionsfrei (provisionspflichtig = false)

Verarbeitete Felder

Pfade unterhalb von <immobilie>. Pflichtfelder sind markiert; fehlt eines, übernehmen wir das Objekt nicht und melden es. Andere Felder lesen wir nicht.

Steuerung

verwaltung_techn/openimmo_obid	PflichtSchlüssel des Objekts; bleibt über alle Übertragungen gleich
verwaltung_techn/objektnr_extern	Ihre Objektnummer, in Rückmeldung und Mail
verwaltung_techn/aktion@aktionart	ADD, CHANGE oder DELETE; ohne Angabe CHANGE

Objektart

objektkategorie/nutzungsart@GEWERBE	PflichtNur Gewerbe
objektkategorie/vermarktungsart@MIETE_PACHT	PflichtNur Miete
objektkategorie/objektart/buero_praxen@buero_typ	Art der Fläche, wird zum Namen der Einheit (z. B. Bürofläche, Praxis)

Lage

geo/plz	PflichtPostleitzahl
geo/ort	PflichtOrt; wird einer Stadt bei shareDnC zugeordnet
geo/strasse	Straße
geo/hausnummer	Hausnummer
geo/etage	Etage
geo/regionaler_zusatz	Stadtteil, hilft bei der Zuordnung
geo/geokoordinaten@breitengrad	Breitengrad; sonst ermitteln wir die Position aus der Adresse
geo/geokoordinaten@laengengrad	Längengrad
geo/land@iso_land	Land: DEU, AUT oder CHE
verwaltung_objekt/objektadresse_freigeben	false: Adresse wird im Inserat nicht gezeigt

Fläche

flaechen/bueroflaeche	PflichtFläche in m² (Pflicht: eines der Flächenfelder); daraus schätzen wir die Arbeitsplätze
flaechen/nutzflaeche	Fläche in m², wenn kein vorheriges Flächenfeld geliefert wird
flaechen/gesamtflaeche	Fläche in m², wenn kein vorheriges Flächenfeld geliefert wird
flaechen/anzahl_zimmer	Anzahl Räume

Preis

preise/kaltmiete	PflichtKaltmiete pro Monat (Pflicht: ein Preisfeld)
preise/nettokaltmiete	Kaltmiete, wenn keine <kaltmiete> geliefert wird
preise/mietpreis_pro_qm	Preis pro m², mal Fläche gerechnet, wenn keine Kaltmiete geliefert wird
preise/nebenkosten	Nebenkosten, zur Kaltmiete addiert
preise/warmmiete	Gesamtmiete, wenn keine Kaltmiete geliefert wird
preise/pauschalmiete	Gesamtmiete, wenn weder Kalt- noch Warmmiete geliefert wird
preise/zzg_mehrwertsteuer	false: Preis inklusive Mehrwertsteuer
preise/kaution	Kaution als Betrag
preise/kaution_text	Kaution als Text: Inserat zeigt „Kaution erforderlich“
preise/provisionspflichtig	true: Objekt wird übersprungen (nur provisionsfreie Objekte); fehlt die Angabe, gibt es einen Hinweis

Texte

freitexte/objekttitel	PflichtTitel des Inserats (sonst der erste Satz der Beschreibung)
freitexte/objektbeschreibung	Beschreibung
freitexte/sonstige_angaben	An die Beschreibung angehängt
freitexte/lage	Lagebeschreibung
freitexte/ausstatt_beschr	Ausstattungsbeschreibung

Verfügbarkeit

verwaltung_objekt/abdatum	Verfügbar ab (Datum)
verwaltung_objekt/verfuegbar_ab	Verfügbar ab, wenn kein <abdatum> geliefert wird; Text wie „sofort“ heißt sofort
verwaltung_objekt/min_mietdauer	Mindestmietdauer; Einheit im Attribut min_dauer, gerundet auf unsere Auswahl

Ausstattung

ausstattung/kueche	Ausstattung „Küche“
ausstattung/stellplatzart	Ausstattung „Parkplatz“
ausstattung/moebliert	Ausstattung „Möbliert“ (bei VOLL oder TEIL)
ausstattung/barrierefrei	Ausstattung „Barrierefrei“
ausstattung/dv_verkabelung	Ausstattung „Internet“
ausstattung/teekueche	Ausstattung „Kaffee/Tee“
ausstattung/serviceleistungen	Ausstattung „Reinigung“ (Attribut REINIGUNG)

Energieausweis

zustand_angaben/energiepass/epart	BEDARF oder VERBRAUCH
zustand_angaben/energiepass/endenergiebedarf	Energiekennwert (Bedarfsausweis)
zustand_angaben/energiepass/energieverbrauchkennwert	Energiekennwert (Verbrauchsausweis)
zustand_angaben/energiepass/waermewert	Wärmewert
zustand_angaben/energiepass/stromwert	Stromwert
zustand_angaben/energiepass/primaerenergietraeger	Energieträger
zustand_angaben/energiepass/baujahr	Baujahr laut Ausweis
zustand_angaben/baujahr	Baujahr, wenn der Ausweis keins nennt
zustand_angaben/energiepass/gueltig_bis	Gültig bis

Kontakt

kontaktperson/anrede	Anrede der Kontaktperson
kontaktperson/vorname	Vorname
kontaktperson/name	Nachname
kontaktperson/email_direkt	Anfragen gehen an diese Adresse
kontaktperson/email_zentrale	Anfragen, wenn keine direkte Adresse geliefert wird
kontaktperson/tel_durchw	Telefon (nicht öffentlich)
kontaktperson/tel_zentrale	Telefon, wenn keine Durchwahl geliefert wird
kontaktperson/tel_handy	Mobil (nicht öffentlich)
kontaktperson/firma	Firma der Kontaktperson

Bilder

anhaenge/anhang

Bilder; TITELBILD zuerst, GRUNDRISS zuletzt; Dokumente, Filme und Links ignorieren wir

Grenzen

Größere oder andere Dateien lehnen wir ab und legen sie in error/.

Datei: bis 500 MB je hochgeladener Datei
XML: bis 50 MB entpackt
ZIP: höchstens 20.000 Einträge und 2.048 MB entpackt; keine ZIP-Dateien im ZIP
Dateitypen im ZIP: xml, jpg, jpeg, png, webp; andere Dateien ignorieren wir und melden es
Bilder: JPG, PNG oder WebP bis 15 MB, höchstens 20 je Objekt; im ZIP oder als http(s)-Link

Verzeichnisse und Aufbewahrung

Jeder Zugang sieht nur seine eigenen Ordner. Schreiben darf das CRM nur in import/.

import/: Hier legt das CRM die Dateien ab. Nach der Verarbeitung ist der Ordner wieder leer.
archive/: Verarbeitete Dateien, nach Jahr und Monat · wird nach 30 Tagen gelöscht
error/: Abgelehnte Dateien, zum Beispiel kaputtes XML oder ZIP · wird nach 90 Tagen gelöscht
feedback/: Rückmeldung je Import als <Import-Nr>_feedback.xml · wird nach 30 Tagen gelöscht

Feedback-Format

Nach jedem Import schreiben wir eine Rückmeldung im Format openimmo_feedback 1.2.5 nach feedback/.

sender/makler_id: anbieternr aus deiner Datei, sonst deine Kundennummer bei shareDnC
fehlerliste/fehler: Ein Eintrag je Hinweis oder Fehler: objekt_id (objektnr_extern, sonst openimmo_obid), fehlernr (stabiler Code) und text mit Code und Lösung
status: statusnr und eine Zusammenfassung der Übertragung; zusätzlich ein status je veröffentlichtem Inserat mit Link

statusnr

0: Übernommen; Hinweise stehen gegebenenfalls in der fehlerliste. Auch je veröffentlichtem Inserat, mit Link
1: Teilweise übernommen: einzelne Objekte hatten Fehler
2: Nichts übernommen: Datei abgelehnt oder kein Objekt fehlerfrei
3: Vollübertragung zurückgehalten, shareDnC prüft

Alle fehlernr mit Ursache und Lösung: Hinweise und Fehlermeldungen. Die Nummern ändern sich nicht.