OpenImmo-Schnittstelle
Büroflächen direkt aus deinem CRM inserieren
Deine Maklersoftware überträgt Büro- und Praxisflächen per OpenImmo zu shareDnC. Wir machen daraus Inserate, halten sie aktuell und melden dir zu jedem Import, was passiert ist.
OpenImmo 1.2.7 · SFTP
Kein Abtippen · Änderungen automatisch
So richtest du die Schnittstelle ein
Einmal einrichten, danach läuft der Import von selbst.
-
1
Schnittstelle freischalten
Die OpenImmo-Schnittstelle ist Teil deines Tarifs. Ist sie freigeschaltet, legt shareDnC deinen SFTP-Zugang an und du bekommst eine Mail.
-
2
Zugangsdaten abholen
Im Konto unter „Schnittstellen“ stehen Server, Port, Benutzername und Ordner. Das Passwort erzeugt der Konto-Inhaber dort selbst; es wird nur einmal angezeigt.
-
3
Im CRM shareDnC als Portal anlegen
Trage die Zugangsdaten in deiner Maklersoftware als neues Exportziel ein: Übertragung per SFTP, Format OpenImmo 1.2.7, Zielordner import/.
-
4
Objekte freigeben
Gib die Büroflächen im CRM für shareDnC frei. Neue Dateien holen wir alle paar Minuten ab und machen daraus Inserate.
Technische Angaben
Für dich oder die IT, die den Export im CRM einrichtet.
- Übertragung
- SFTP (Benutzername und Passwort)
- Format
- OpenImmo 1.2.7, eine XML-Datei oder ein ZIP mit XML und Bildern
- Zielordner
- import/
- Dateigröße
- bis 500 MB je Datei
- Bilder
- JPG, PNG oder WebP, bis 15 MB je Bild, höchstens 20 je Objekt; im ZIP oder als Link
- Zeichensatz
- UTF-8 oder ISO-8859-1
- Übertragungsarten
- Vollübertragung und Teilübertragung (ADD, CHANGE, DELETE)
Server, Port und Benutzername stehen nach der Freischaltung in deinem Konto unter „Schnittstellen“. Alle Felder, Grenzen und das Feedback-Format für CRM-Hersteller: technische Referenz.
Hinweise und Fehlermeldungen
Diese Codes stehen in der Rückmeldung zu jedem Import, mit Ursache und dem, was du tun kannst.
Fehler (14)
Die Datei oder das Objekt wurde nicht übernommen.
Datei ist kein gültiges XML NOT_WELL_FORMED · Nr. 101
Ursache: Die Datei lässt sich nicht lesen, sie ist beschädigt oder unvollständig.
Was du tun kannst: Export im CRM erneut auslösen. Bleibt der Fehler, die Datei an den Support schicken.
Datei aus Sicherheitsgründen abgelehnt XXE_REJECTED · Nr. 102
Ursache: Die XML-Datei enthält Entity-Deklarationen, die wir aus Sicherheitsgründen nicht verarbeiten.
Was du tun kannst: Den OpenImmo-Export ohne DOCTYPE-Entities erzeugen; im Zweifel den CRM-Hersteller fragen.
Angabe <uebertragung> fehlt MISSING_UEBERTRAGUNG · Nr. 103
Ursache: Ohne <uebertragung> ist nicht erkennbar, ob es eine Voll- oder Teilübertragung ist.
Was du tun kannst: Prüfen, ob im CRM das Portal-Format „OpenImmo“ eingestellt ist.
Kein Anbieter in der Datei MISSING_ANBIETER · Nr. 104
Ursache: Die Datei enthält kein <anbieter>-Element und damit keine Objekte.
Was du tun kannst: Export im CRM prüfen und erneut übertragen.
ZIP-Datei beschädigt ZIP_INVALID · Nr. 105
Ursache: Das ZIP-Archiv lässt sich nicht öffnen.
Was du tun kannst: Export im CRM erneut auslösen.
Zu viele Dateien im ZIP ZIP_TOO_MANY_ENTRIES · Nr. 106
Ursache: Das Archiv enthält mehr als 20.000 Dateien.
Was du tun kannst: Die Übertragung auf mehrere kleinere Exporte aufteilen.
ZIP entpackt zu groß ZIP_TOO_LARGE · Nr. 107
Ursache: Entpackt wäre das Archiv größer als 2 GB.
Was du tun kannst: Bilder im CRM verkleinern oder die Übertragung aufteilen.
ZIP aus Sicherheitsgründen abgelehnt ZIP_BOMB · Nr. 108
Ursache: Das Archiv ist ungewöhnlich stark komprimiert oder größer als angegeben.
Was du tun kannst: Export im CRM erneut auslösen; bleibt der Fehler, den Support kontaktieren.
Unzulässiger Dateipfad im ZIP ZIP_SLIP · Nr. 109
Ursache: Das Archiv enthält Pfade, die aus dem Ordner herausführen, oder Verknüpfungen.
Was du tun kannst: Export im CRM erneut auslösen; im Zweifel den CRM-Hersteller fragen.
Archiv im Archiv ZIP_NESTED · Nr. 110
Ursache: Das ZIP enthält ein weiteres Archiv, das wir nicht entpacken.
Was du tun kannst: XML und Bilder direkt in ein ZIP packen.
Keine XML-Datei im ZIP ZIP_NO_XML · Nr. 111
Ursache: Im Archiv ist keine OpenImmo-XML-Datei.
Was du tun kannst: Prüfen, ob der Export vollständig ist.
Mehrere XML-Dateien im ZIP ZIP_MULTIPLE_XML · Nr. 112
Ursache: Pro Archiv wird genau eine OpenImmo-XML-Datei erwartet.
Was du tun kannst: Je Übertragung ein ZIP mit genau einer XML-Datei senden.
Verarbeitung abgebrochen PROCESSING_ABORTED · Nr. 113
Ursache: Die Datei konnte auch nach mehreren Versuchen nicht verarbeitet werden.
Was du tun kannst: Wir sehen uns das an. Die Datei liegt im Ordner error/.
Pflichtangabe fehlt MISSING_REQUIRED · Nr. 302
Ursache: Für ein Inserat fehlen Angaben wie Adresse, Fläche oder Miete.
Was du tun kannst: Die fehlende Angabe im CRM ergänzen; das Objekt kommt mit der nächsten Übertragung.
Hinweise (41)
Übernommen, aber etwas fehlte oder wurde angepasst.
Datei weicht vom OpenImmo-Standard ab SCHEMA_INVALID · Nr. 201
Ursache: Einzelne Angaben entsprechen nicht dem OpenImmo-Schema. Die Datei wurde trotzdem verarbeitet.
Was du tun kannst: Keine Aktion nötig, solange die Inserate korrekt aussehen.
Zeichensatz angepasst ENCODING_CONVERTED · Nr. 202
Ursache: Die Datei hat keine Zeichensatz-Angabe und wurde als ISO-8859-1 gelesen.
Was du tun kannst: Umlaute in den Inseraten prüfen; besser UTF-8 mit XML-Deklaration exportieren.
OpenImmo-Version fehlt VERSION_MISSING · Nr. 203
Ursache: Die Datei nennt keine OpenImmo-Version und wurde als 1.2.7 gelesen.
Was du tun kannst: Keine Aktion nötig.
Ältere OpenImmo-Version VERSION_UNSUPPORTED · Nr. 204
Ursache: Unterstützt werden 1.2.4 bis 1.2.7; die Datei wurde versuchsweise gelesen.
Was du tun kannst: Im CRM einen Export in OpenImmo 1.2.7 einstellen.
Vollübertragung zurückgehalten EMPTY_FULL_TRANSFER · Nr. 205
Ursache: Die Vollübertragung würde mehr als die Hälfte der Inserate offline nehmen und wartet auf Prüfung.
Was du tun kannst: Wenn das beabsichtigt ist, nichts tun; wir geben sie nach Prüfung frei.
Vollübertragung zurückgehalten FULL_TRANSFER_HELD · Nr. 208
Ursache: Die Vollübertragung hätte mehr als die Hälfte Ihrer Inserate offline genommen. Enthaltene Objekte wurden aktualisiert, offline genommen wurde nichts; wir prüfen das.
Was du tun kannst: Prüfen, ob im CRM alle aktiven Objekte für shareDnC freigegeben sind. Wir melden uns.
Objekt ohne openimmo_obid MISSING_OBID · Nr. 301
Ursache: Ohne eindeutige Objekt-ID kann das Objekt nicht zugeordnet werden und wurde übersprungen.
Was du tun kannst: Im CRM prüfen, ob für das Objekt eine OpenImmo-ID vergeben ist.
Keine Gewerbefläche OUT_OF_SCOPE_NUTZUNG · Nr. 303
Ursache: shareDnC listet ausschließlich Büro- und Praxisflächen; Wohnobjekte werden übersprungen.
Was du tun kannst: Keine Aktion nötig.
Kein Mietangebot OUT_OF_SCOPE_KAUF · Nr. 304
Ursache: shareDnC listet nur Flächen zur Miete; Kaufobjekte werden übersprungen.
Was du tun kannst: Keine Aktion nötig.
Keine Büro- oder Praxisfläche OUT_OF_SCOPE_OBJEKTART · Nr. 305
Ursache: Hallen, Läden, Gastronomie und andere Objektarten werden übersprungen.
Was du tun kannst: Keine Aktion nötig.
Bürotyp wird nicht gelistet OUT_OF_SCOPE_BUEROTYP · Nr. 306
Ursache: Dieser Bürotyp (zum Beispiel Ausstellungsfläche) wird nicht übernommen.
Was du tun kannst: Wenn es eine Bürofläche ist, im CRM den Bürotyp anpassen.
Objekt außerhalb von DE, AT, CH OUT_OF_SCOPE_LAND · Nr. 307
Ursache: Übernommen werden nur Objekte in Deutschland, Österreich und der Schweiz.
Was du tun kannst: Keine Aktion nötig.
Provisionspflichtiges Angebot OUT_OF_SCOPE_PROVISION · Nr. 308
Ursache: Provisionspflichtige Angebote können derzeit nicht über die Schnittstelle veröffentlicht werden.
Was du tun kannst: Für eine provisionsfreie Vermarktung im CRM „provisionspflichtig“ auf nein setzen.
Wohnen und Gewerbe angegeben NUTZUNG_MIXED · Nr. 309
Ursache: Das Objekt ist als Wohn- und Gewerbeobjekt markiert und wurde als Gewerbe übernommen.
Was du tun kannst: Keine Aktion nötig.
Bürotyp fehlt BUEROTYP_MISSING · Nr. 310
Ursache: Ohne Angabe wurde das Objekt als Bürofläche übernommen.
Was du tun kannst: Im CRM den Bürotyp ergänzen.
Unbekannter Bürotyp BUEROTYP_UNKNOWN · Nr. 311
Ursache: Der angegebene Bürotyp ist kein OpenImmo-Wert.
Was du tun kannst: Im CRM einen gültigen Bürotyp wählen.
Provisionsangabe fehlt PROVISION_MISSING · Nr. 312
Ursache: Ohne Angabe wurde das Objekt als provisionsfrei übernommen.
Was du tun kannst: Im CRM „provisionspflichtig“ ausdrücklich setzen.
Keine Bilder KEINE_BILDER · Nr. 501
Ursache: Für das Objekt wurden keine Bilder geliefert oder keines ließ sich laden.
Was du tun kannst: Im CRM Bilder hinterlegen und für das Portal freigeben.
Ort nicht zugeordnet CITY_UNKNOWN · Nr. 601
Ursache: Postleitzahl und Ort ließen sich keiner Stadt zuordnen; das Inserat wartet auf Prüfung.
Was du tun kannst: Adresse im CRM prüfen; wir ordnen sie sonst manuell zu.
Postleitzahl und Ort passen nicht zusammen PLZ_ORT_MISMATCH · Nr. 602
Ursache: Postleitzahl und Ortsname zeigen auf verschiedene Städte. Wir haben die Stadt der Postleitzahl übernommen.
Was du tun kannst: Adresse im CRM prüfen.
Tarif erlaubt keine weiteren Inserate REVIEW_TARIFLIMIT · Nr. 708
Ursache: Ihr Tarif ist mit aktiven Inseraten ausgeschöpft. Das Objekt ist angelegt, aber nicht veröffentlicht.
Was du tun kannst: Andere Inserate deaktivieren oder den Tarif erweitern.
Wird vor Veröffentlichung geprüft REVIEW_AUTO_AUS · Nr. 709
Ursache: Für Ihr Konto prüfen wir neue Inserate vor der Veröffentlichung.
Was du tun kannst: Keine Aktion nötig.
Wird geprüft: ist es ein Büro? REVIEW_KEIN_BUERO · Nr. 711
Ursache: Objektart oder Text lassen offen, ob das Objekt als Büro vermietet wird (z. B. Praxis, Atelier, Laden oder Salon). Wir schauen kurz drüber, dann geht das Inserat online.
Was du tun kannst: Keine Aktion nötig. Ist es kein Büro, nehmen Sie das Objekt aus dem Export an shareDnC.
Wird geprüft: Anbieter inseriert an dieser Adresse REVIEW_ADRESSE_BELEGT · Nr. 713
Ursache: An dieser Adresse gibt es schon ein Inserat. Ist es dieselbe Fläche, hat das Inserat des Anbieters Vorrang.
Was du tun kannst: Keine Aktion nötig. Wir prüfen, ob es eine andere Fläche ist, und geben das Objekt dann frei.
Nach Prüfung nicht veröffentlicht PRUEFUNG_ABGELEHNT · Nr. 712
Ursache: Wir haben das Objekt geprüft und veröffentlichen es so nicht. Den Grund finden Sie in dieser Meldung.
Was du tun kannst: Passen Sie das Objekt im CRM an und übertragen Sie es erneut; dann prüfen wir es noch einmal.
Koordinaten passen nicht zur Adresse GEO_IMPLAUSIBLE · Nr. 603
Ursache: Die gelieferten Koordinaten liegen außerhalb von Deutschland, Österreich und der Schweiz oder weit weg von der Postleitzahl. Wir bestimmen die Lage selbst aus der Adresse.
Was du tun kannst: Koordinaten im CRM prüfen oder weglassen.
Energieausweis fehlt ENERGIEAUSWEIS_FEHLT · Nr. 401
Ursache: Das Objekt enthält keine Angaben zum Energieausweis. Es wurde trotzdem übernommen.
Was du tun kannst: Energieausweis im CRM ergänzen; Anzeigen ohne Pflichtangaben nach § 87 GEG können abgemahnt werden.
Objekt schon vorhanden, aktualisiert ADD_EXISTING · Nr. 402
Ursache: Das Objekt kam als neu (ADD), war bei uns aber schon angelegt. Wir haben es aktualisiert.
Was du tun kannst: Keine Aktion nötig.
Referenzobjekt ignoriert AKTION_REFERENZ · Nr. 403
Ursache: Referenzobjekte (aktionart="REFERENZ") übernehmen wir nicht.
Was du tun kannst: Keine Aktion nötig.
Unbekannte Aktion, als Änderung behandelt AKTION_UNKNOWN · Nr. 404
Ursache: Der Wert von aktionart ist im OpenImmo-Standard nicht vorgesehen. Wir haben das Objekt wie eine Änderung übernommen.
Was du tun kannst: Im CRM ADD, CHANGE oder DELETE verwenden.
Mindestmietdauer angepasst MIETDAUER_GERUNDET · Nr. 405
Ursache: Die Mindestmietdauer passt nicht auf unsere Auswahlwerte und wurde auf den nächsten Wert gerundet.
Was du tun kannst: Wert im Inserat prüfen.
Kaution nicht als Betrag lesbar KAUTION_TEXT · Nr. 406
Ursache: Die Kaution kam nur als Text. Wir haben „Kaution erforderlich“ gesetzt, aber keinen Betrag.
Was du tun kannst: Kaution im CRM als Zahl angeben.
E-Mail-Adresse der Kontaktperson ungültig KONTAKT_EMAIL_UNGUELTIG · Nr. 408
Ursache: Die E-Mail-Adresse der Kontaktperson ist keine gültige Adresse. Anfragen zu diesem Inserat gehen deshalb an die E-Mail-Adresse Ihres Kontos.
Was du tun kannst: E-Mail-Adresse der Kontaktperson im CRM korrigieren.
Kontaktdaten im Text wurden entfernt KONTAKTDATEN_ENTFERNT · Nr. 409
Ursache: In Titel, Beschreibung, Lage oder Ausstattung standen Telefonnummern, E-Mail- oder Web-Adressen. Diese gehören in die Kontaktperson und wurden aus dem Text entfernt. Das Inserat ist trotzdem online.
Was du tun kannst: Bitte im CRM in die Kontaktperson eintragen.
Zu viele Bilder BILDER_ZU_VIELE · Nr. 503
Ursache: Pro Inserat zeigen wir höchstens 10 Bilder. Die weiteren wurden nicht übernommen.
Was du tun kannst: Im CRM die wichtigsten 10 Bilder nach vorn sortieren; das Titelbild kommt immer zuerst.
Bild fehlt im ZIP BILD_FEHLT_IM_ZIP · Nr. 504
Ursache: Die XML-Datei nennt ein Bild, das nicht im ZIP-Archiv liegt.
Was du tun kannst: Export im CRM mit Bildern erneut auslösen.
Bild nicht lesbar BILD_UNGUELTIG · Nr. 505
Ursache: Die Datei ist kein gültiges JPG, PNG oder WebP.
Was du tun kannst: Bild im CRM in einem dieser Formate hinterlegen.
Bild zu groß BILD_ZU_GROSS · Nr. 506
Ursache: Ein Bild darf höchstens 15 MB groß sein.
Was du tun kannst: Bild im CRM verkleinert hinterlegen.
Bild nicht abrufbar BILD_DOWNLOAD_FEHLER · Nr. 507
Ursache: Das Bild ließ sich unter der angegebenen Adresse nicht herunterladen. Wir versuchen es beim nächsten Import erneut.
Was du tun kannst: Prüfen, ob die Bild-Adresse öffentlich erreichbar ist.
Bild-Adresse abgelehnt BILD_URL_BLOCKIERT · Nr. 508
Ursache: Die Bild-Adresse zeigt auf ein internes Netz oder ist keine normale Web-Adresse. Solche Adressen rufen wir aus Sicherheitsgründen nicht ab.
Was du tun kannst: Bilder im ZIP mitliefern oder unter einer öffentlichen https-Adresse bereitstellen.
Bild über unverschlüsselte Verbindung BILD_HTTP · Nr. 509
Ursache: Das Bild wurde über http statt https geladen.
Was du tun kannst: Bild-Adressen im CRM auf https umstellen.
Häufige Fragen
Provisionsfreie Büro- und Praxisflächen zur Miete in Deutschland, Österreich und der Schweiz. Wohnungen, Hallen, Kaufobjekte und provisionspflichtige Angebote überspringen wir; in der Rückmeldung steht zu jedem Objekt, warum.
Wir prüfen neue Dateien alle fünf Minuten. Ein vollständiges Objekt mit bekannter Adresse ist danach meist innerhalb weniger Minuten online. Haben wir Zweifel, ob es wirklich ein Büro ist, schaut es sich vorher jemand von shareDnC an.
Änderungen aus dem CRM übernehmen wir beim nächsten Import. Ein gelöschtes Objekt geht offline. Bei einer Vollübertragung gehen Objekte offline, die nicht mehr in der Datei stehen. Würde eine Vollübertragung mehr als die Hälfte deiner Inserate offline nehmen, halten wir sie zurück und melden uns.
Am besten regelmäßig, zum Beispiel täglich, eine Vollübertragung und dazwischen Teilübertragungen für Änderungen. So stimmt der Bestand bei shareDnC immer mit deinem CRM überein.
Nach jedem Import liegt eine Rückmeldung im OpenImmo-Format im Ordner feedback/. Gibt es Hinweise oder neue Inserate, bekommst du eine Mail. Im Konto unter „Schnittstellen“ stehen die letzten Übertragungen mit allen Hinweisen.
An die Kontaktperson, die im CRM beim Objekt hinterlegt ist. Ob du als Konto-Inhaber eine Kopie bekommst, stellst du unter „Schnittstellen“ ein. Auf der Inseratsseite stehen weder E-Mail-Adresse noch Telefonnummer der Kontaktperson; Interessenten schreiben über shareDnC.
Ja. Der nächste Import mit geänderten Daten aus dem CRM überschreibt deine Änderungen aber wieder. Pflege die Objekte deshalb am besten im CRM.
Jede Software, die OpenImmo 1.2.7 per SFTP exportiert. Falls deine Software shareDnC noch nicht als Portal kennt, lege uns als eigenes OpenImmo-Exportziel mit den Zugangsdaten aus deinem Konto an.
Bereit für den ersten Import?
Wir schalten die Schnittstelle für dein Konto frei und helfen dir bei der Einrichtung.