Wie kann ich per Openimmo Feedback Adressen mit dem Adressimporter (z. B. von meiner Homepage) in FLOWFACT importieren?

Avatar
Jan Keller
  • Aktualisiert

Spezifikation Adressimporter - Neue Kontakt-EMail:

Der FlowFact Adressimporter importiert Kontakte aus xml-Dateien, die als E-Mailanhang gesandt werden.
Folgend finden Sie ein Beispiel für die neuen Kontakt E-Mail, die unser Adressimporter einlesen kann. Diese beruht auf dem Openimmo Standard (siehe  www.openimmo.de)

 

Die wichtigsten Eckpunkte:

Der Adressimporter überprüft die ausgewählten Aktivitäten, ob diese einen Anhang mit der Endung ".xml" und im Dateinamen das Wort "kontakt" oder "contact" hat, z.B.: NeuerKontakt.xml (siehe weiter unten). Wird ein derartiger Anhang gefunden, importiert FlowFact diese Datei und ignoriert die Mailnotiz.

Die Kontakt XML-Dateien muss dem Schema "openimmo-feedback_125.xsd" (siehe weiter unten) entsprechen.

 

Wir empfehlen eine Validierung der erstellen Datei "Neuer Kontakt.xml" gegen das XSD Schema z. B. über folgenden Anbieter: http://www.freeformatter.com/xml-validator-xsd.html

 

Erklärungen zu der Datei "NeuerKontakt.xml":

Ihre Portalkennung:
===================
<portal_unique_id>XXX</portal_unique_id>

Unsere beim Objekt Hochladen mitgeteilte Objektnummer:
======================================================
<oobj_id>123456789</oobj_id>

Interessent:
============
<interessent>
  <anrede>Herr</anrede>
  <vorname>Karl</vorname>
  <nachname>Zufrieden</nachname>
  <firma>Zufrieden AG</firma>
  <strasse>Rheinaustraße 13</strasse>
  <plz>50999</plz>
  <ort>Köln</ort>
  <tel>0221/123456</tel>
  <fax>0221/123458</fax>
  <mobil>0171/654321</mobil>
  <email>zuf@karl-zufrieden.de</email>
  <bevorzugt>EMAIL</bevorzugt>
  <wunsch>DETAIL</wunsch>
  <anfrage>Sehr geehrter Anbieter!
  Dieses Objekt interessiert mich sehr.
  Ich möchte bitte so schnell wie möglich besichtigen.
  Karl Zufrieden</anfrage>
  <user_defined_extend>
    <feld>
      <name>WUNSCH</name>
      <wert>BESICHTIGUNG</wert>
     </feld>
  </user_defined_extend>
  <user_defined_extend>
    <feld>
      <name>callbackTime</name>
      <wert>abends</wert>
    </feld>
  </user_defined_extend>
</interessent>

 

Datei "NeuerKontakt.xml":

<?xml version="1.0" encoding="ISO-8859-15"?>
<openimmo_feedback>
  <version>1.2.5</version>
  <sender>
    <name />
    <openimmo_anid />
    <datum>15.11.2007</datum>
    <makler_id>55555</makler_id>
  </sender>
  <objekt>
    <portal_unique_id>XXX</portal_unique_id>
    <portal_obj_id>11223344</portal_obj_id>
    <anbieter_id>55555</anbieter_id>
    <oobj_id>123456789</oobj_id>
    <zusatz_refnr />
    <expose_url>http://www.Portal.de/expose.do?object_id=11223344</expose_url>
    <vermarktungsart>Kauf</vermarktungsart>
    <bezeichnung>Köln, Industriestraße 161</bezeichnung>
    <etage />
    <whg_nr />
    <strasse>Industriestraße 161</strasse>
    <ort>Köln</ort>
    <land>DEU</land>
    <stadtbezirk>Rodenkirchen</stadtbezirk>
    <preis>1234</preis>
    <gebot />
    <wae />
    <anzahl_zimmer>2</anzahl_zimmer>
    <flaeche>75</flaeche>
    <interessent>
      <int_id />
      <anrede>Herr</anrede>
      <vorname>Karl</vorname>
   <nachname>Zufrieden</nachname>
      <firma>Zufrieden AG</firma>
      <strasse>Rheinaustraße 13</strasse>
      <postfach />
      <plz>50999</plz>
      <ort>Köln</ort>
      <tel>0221/123456</tel>
      <fax>0221/123458</fax>
      <mobil>0171/654321</mobil>
      <email>zuf@karl-zufrieden.de</email>
      <bevorzugt>EMAIL</bevorzugt>
      <wunsch>DETAIL</wunsch>
      <anfrage>Sehr geehrter Anbieter! Dieses Objekt interessiert mich sehr. Ich möchte bitte so schnell wie möglich besichtigen. Karl Zufrieden</anfrage>
      <user_defined_extend>
        <feld>
          <name>WUNSCH</name>
          <wert>BESICHTIGUNG</wert>
        </feld>
      </user_defined_extend>
      <user_defined_extend>
        <feld>
          <name>callbackTime</name>
          <wert>abends</wert>
        </feld>
      </user_defined_extend>
    </interessent>
  </objekt>
 </openimmo_feedback>

 

Datei "openimmo-feedback_125.xsd":

<?xml version="1.0" encoding="ISO-8859-1"?>

<!-- 
Feedback Datensatz der vom Portal an den Anbieter (Makler / Software) übertragen wird.
Eine Datei mit einem / mehreren Objekt(en) und jeweils   einem / mehreren Kundenanfrage(n)  
-->

<!--
$$DOKU:
$COPYRIGHT: OpenImmo e.V.
OpenImmo und das OpenImmo Logo sind eingetragen Marken.
Deren Verwendung ist nur Mitgliedern des OpenImmo e.V. oder zertifizierten Firmen erlaubt.

$VERSION: 1.2.5  
$VERSIONDATE: 2011-11-14
$HISTORY:
$CREATED: 2011-10-12, Frank Bitzer (FB)
 
$CHANGE:2006-10-16, FB, Typen
$CHANGE::2006-12-11, FB,  Enumeration Update
$CHANGE::2007-06-13,FB,  regi_id in Sender
$CHANGE::V121:2008-08-07, FB,  Eränzungen in version 1.2.1
$CHANGE::V123:2010-08-13, FB/Oliver Kunz; FIO,  Eränzungen in version 1.2.3, Formatierung/Strukturierung
$CHANGE::V124:2010-08-13, FB/Oliver Kunz; FIO,  Eränzungen in version 1.2.3, Formatierung/Strukturierung
$CHANGE::V123:2012-11-14, einzelen Felder im Objekt
 
$$END
-->


<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"   version="1.0">

 <xsd:element name="openimmo_feedback">
  <xsd:complexType>
   <xsd:sequence>
    <xsd:element ref="version" /> <!--$V124 neu -->

    <xsd:element ref="sender" /> 
    <xsd:element ref="objekt" minOccurs="0" maxOccurs="unbounded"/><!--V121 optional-->
    <xsd:element ref="fehlerliste" minOccurs="0" maxOccurs="unbounded"/> 
    <xsd:element ref="status" minOccurs="0" maxOccurs="unbounded"/><!--V121 neu-->
   </xsd:sequence>
  </xsd:complexType>
 </xsd:element> 

 


 <xsd:element name="version" type="xsd:string">
  <xsd:annotation>
   <xsd:documentation>Entspricht der OpenImmo Version.  Aktuell: "1.2.5" </xsd:documentation>
  </xsd:annotation>
 </xsd:element>

 


 <xsd:element name="sender">
  <xsd:complexType>
   <xsd:sequence>
    <xsd:element name="name" type="xsd:string"/>
    <xsd:element name="openimmo_anid" type="xsd:string" minOccurs="0"/>
    <xsd:element name="datum" type="xsd:string"/>
    <xsd:element name="makler_id" type="xsd:string"/>
    <xsd:element name="regi_id" type="xsd:string" minOccurs="0"/><!--V120: Registrieungs Key aus der Lizenzvereinbarung, falls erfolgt-->
   </xsd:sequence>
  </xsd:complexType>
 </xsd:element>

 <xsd:element name="objekt">
  <xsd:complexType>
   <xsd:sequence> 
    <xsd:element name="portal_unique_id" type="xsd:string" minOccurs="0"/><!--V123 optional-->
    <xsd:element name="portal_obj_id" type="xsd:string" minOccurs="0"/><!--V123 optional-->
    <xsd:element name="anbieter_id" type="xsd:string" minOccurs="0"/><!--V123 optional-->
    <xsd:element name="oobj_id" type="xsd:string" minOccurs="0"/><!--V123 optional-->
    <xsd:element name="zusatz_refnr" type="xsd:string" minOccurs="0"/><!--V123 optional-->
    <xsd:element name="expose_url" type="xsd:string" minOccurs="0"/><!--V123 optional-->
    <xsd:element name="vermarktungsart" type="xsd:string" minOccurs="0" maxOccurs="unbounded"/><!--V123 optional-->
    <xsd:element name="bezeichnung" type="xsd:string" minOccurs="0"/><!--V123 optional-->
    <xsd:element name="etage" type="xsd:string" minOccurs="0"/><!--V123 optional-->
    <xsd:element name="whg_nr" type="xsd:string" minOccurs="0"/><!--V123 optional-->
    <xsd:element name="strasse" type="xsd:string" minOccurs="0"/><!--V123 optional-->
    <xsd:element name="ort" type="xsd:string" minOccurs="0"/><!--V123 optional-->

    <xsd:element name="land" type="xsd:string" minOccurs="0" /><!--V125 optional   ISO Code 3 Stellen verwenden--> 
    <xsd:element name="stadtbezirk" type="xsd:string" minOccurs="0" /><!--V125 optional   --> 

    <xsd:element name="preis" type="xsd:string" minOccurs="0"/><!--V123 optional-->
    <xsd:element name="gebot" type="xsd:string" minOccurs="0"/><!--V123 optional-->
    <xsd:element name="wae" type="xsd:string" minOccurs="0" /><!--V123 optional--> 

    <xsd:element name="anzahl_zimmer" type="xsd:string" minOccurs="0" /><!--V125 optional--> 
    <xsd:element name="flaeche" type="xsd:string" minOccurs="0" /><!--V125 optional   Wohn/Gewerbe/Grundstück Fläche--> 

    <xsd:element ref="interessent" minOccurs="1" maxOccurs="unbounded"/>  
    <xsd:element ref="user_defined_extend" minOccurs="0" maxOccurs="unbounded"/>        
   </xsd:sequence>
  </xsd:complexType>
 </xsd:element>   

 <xsd:element name="interessent">
  <xsd:complexType>
   <xsd:sequence>
    <xsd:element name="int_id" type="xsd:string" minOccurs="0"/><!--V123 optional-->
    <xsd:element name="anrede" type="xsd:string" minOccurs="0"/><!--V123 optional-->
    <xsd:element name="vorname" type="xsd:string" minOccurs="0"/><!--V123 optional-->
    <xsd:element name="nachname" type="xsd:string" minOccurs="0"/><!--V123 optional-->
    <xsd:element name="firma" type="xsd:string" minOccurs="0"/><!--V123 optional-->
    <xsd:element name="strasse" type="xsd:string" minOccurs="0"/><!--V123 optional-->
    <xsd:element name="postfach" type="xsd:string"  minOccurs="0"/><!--V123 optional-->
    <xsd:element name="plz" type="xsd:string" minOccurs="0"/><!--V123 optional-->
    <xsd:element name="ort" type="xsd:string" minOccurs="0"/><!--V123 optional-->
    <xsd:element name="tel" type="xsd:string" minOccurs="0"/><!--V123 optional-->
    <xsd:element name="fax" type="xsd:string" minOccurs="0"/><!--V123 optional-->
    <xsd:element name="mobil" type="xsd:string" minOccurs="0"/><!--V123 optional-->
    <xsd:element name="email" type="xsd:string" minOccurs="0"/><!--V123 optional-->
    
    <xsd:element name="bevorzugt" minOccurs="0" maxOccurs="unbounded"><!--V123 optional-->
     <xsd:annotation>
      <xsd:documentation>Bevorzugte Kontaktart des Kunden. Attribut kann mehrfach vorkommen</xsd:documentation>
     </xsd:annotation>
     <xsd:simpleType>
       <xsd:restriction base="xsd:string">
        <xsd:enumeration value="EMAIL"/>
        <xsd:enumeration value="TEL"/>
        <xsd:enumeration value="MOBIL"/>
        <xsd:enumeration value="FAX"/>
        <xsd:enumeration value="BRIEF"/>
       </xsd:restriction>
     </xsd:simpleType>
    </xsd:element>

    <xsd:element name="wunsch" minOccurs="0" maxOccurs="unbounded"><!--V123 optional-->
     <xsd:annotation>
      <xsd:documentation>Der Info-/Aktivitätenwunsch des Kunden. Attribut kann mehrfach vorkommen</xsd:documentation>
     </xsd:annotation>
     <xsd:simpleType>
        <xsd:restriction base="xsd:string">
         <xsd:enumeration value="BESICHTIGUNG"/>
         <xsd:enumeration value="ANRUF"/>
         <xsd:enumeration value="DETAIL"/>
        </xsd:restriction>
     </xsd:simpleType>
    </xsd:element>
    
    <xsd:element name="anfrage" type="xsd:string" minOccurs="0"/><!--V123 optional-->
    <xsd:element ref="user_defined_extend" minOccurs="0" maxOccurs="unbounded"/>
   </xsd:sequence>
  </xsd:complexType>
 </xsd:element> 
    
 <xsd:element name="fehlerliste">
  <xsd:complexType>
   <xsd:sequence>
    <xsd:element name="fehler" minOccurs="0" maxOccurs="unbounded">
     <xsd:complexType>
      <xsd:sequence>
       <xsd:element name="objekt_id" type="xsd:string" minOccurs="0"/><!--V123 optional-->
       <xsd:element name="fehlernr" type="xsd:int" minOccurs="0"/><!--V123 optional-->
       <xsd:element name="text" type="xsd:string" minOccurs="0"/><!--V123 optional-->
      </xsd:sequence>
     </xsd:complexType>
    </xsd:element>
   </xsd:sequence>
  </xsd:complexType>
 </xsd:element>

 <xsd:element name="status"><!--$V121-->
  <xsd:complexType>
   <xsd:sequence>
    <xsd:element name="statusnr" type="xsd:int" minOccurs="0"/><!--V123 optional-->
    <xsd:element name="text"  type="xsd:string" minOccurs="0"/>
   </xsd:sequence>
  </xsd:complexType>
 </xsd:element>

 <xsd:element name="user_defined_extend">
  <xsd:complexType>
   <xsd:sequence >
      <xsd:element name="feld" minOccurs="0" maxOccurs="unbounded">
      <xsd:complexType>
       <xsd:sequence >
         <xsd:element name="name" type="xsd:string"/>
         <xsd:element name="wert" type="xsd:string"/>
         <xsd:element name="typ" type="xsd:string" minOccurs="0" maxOccurs="unbounded"/>
         <xsd:element name="modus" type="xsd:string" minOccurs="0" maxOccurs="unbounded"/>
       </xsd:sequence>
      </xsd:complexType>
     </xsd:element>
   </xsd:sequence>
  </xsd:complexType>
 </xsd:element>
 
</xsd:schema>

Hinweis: So kopieren Sie den Inhalt der beiden folgenden Textfelder
- Markieren Sie den Inhalt (der jeweiligen Textbox)
- kopieren Sie den Inhalt in die Zwischenablage (Rechtklick innerhalb der Textbox, Funktion "Kopieren").
- Öffnen Sie Ihren Standard-Editor (z.B. Start=>Alle Programme=>Zubehör=>Editor).
- Fügen Sie die Zwischenablage ein (Rechtsklick, Funktion "Einfügen").
- Speichern Sie die Datei und dem jeweils in der Überschrift genannten Dateinamen ab.

 

 

 

Verwandte Beiträge