Lead- Importschnittstelle
Schnittstellenbeschreibung zur Einlieferung von Interessenten-Datensätzen (IDS) in den FKS-Vertriebsmanager

Inhalt:
1) Allgemeines
2) Auslesen des Textkörpers (Body) der E-Mails
3) Auslesen der mitgelieferten XML-Datei

1.0) Allgemeines
IDS werden über eine E-Mailschnittstelle in den FKS-Vertriebsmanager importiert. Hierzu wird ein zuvor eingerichtetes POP3-Emailkonto abgefragt. Damit die Datensätze identifiziert werden können, ist es notwendig, dass diese zuvor im Format Text/Plain und NICHT im Format HTML an das E-Mailkonto geliefert werden. Datensätze können auf zwei unterschiedliche Arten ausgelesen und in den FKSVertriebsmanager importiert werden:

1.1.) Durch Auslesen einer XML-Datei, die als E-Mailanhang eingeliefert wird (empfohlene Variante)
1.2.) Durch Auslesen des Textkörpers (Body) der E-Mail

Bei beiden Verfahren ist es notwendig, dass in einem Teil der Betreffzeile (Subject) der E-Mail ein eindeutiger, unveränderbarer Text die Herkunft des Datensatzes anzeigt (z.B. 'Lead Meinefirma, Sparte BU' oder 'Lead Meinefirma, Sparte PKV-Voll').

2.0) Auslesen des Textkörpers (Body) der E-Mails

2.1) Anzahl möglicher Einlieferungen mit einem Importvorgang:
Über einen Textkörper kann jeweils nur ein Datensatz importiert werden

2.2) Aufbau des Textköpers:
Damit der Textkörper ausgelesen werden ist es notwendig, dass zuvor der Start und das Ende des Leads definiert wird. Indem so eingegrenzten Textabschnitt werden die einzelnen Variablen zeilenweise untereinander angegeben und augelesen. Dabei werden die Variablen zuvor durch einen Feldbezeichner und ein Trennzeichen definiert.
Wichtig ist, dass immer das gleiche Trennzeichen (z.B. ein Doppelpunkt oder ein anderes Trennzeichen) die Feldbezeichner (nachfolgend fett dargestellt) vom dahinterstehenden Wert trennt (siehe Beispiele) und das für jeden Wert eine eigene Spalte verwendet wird. Die Feldbezeichner können frei definiert werden (z.B. PLZ oder Postleitzahl).

So zum Beispiel:
Nachname: Mustermann
Vorname: Max
und nicht
Name: Mustermann, Max

Start: z.B. 'Sie erhielten nachfolgende Anfrage:'
Ende: z.B. 'Mit freundlichem Gruß’

Folgende Felder stehen zur Verfügung:
Leadkennung: Eindeutige ID des Datensatzes z.B. 15842
Herkunft: Ursprung des Datensatzes z.B. www.financekey.de
Sparte*: Spartenbezeichnung z.B. BU oder BAV
Anrede*: Anrede zum Interessen Herr oder Frau
Titel: akademischer Titel des Interessenten z.B. Prof. oder Dr.
Nachname*: Nachname des Interessenten z.B. Mustermann
Vorname*: Vorname des Interessenten z.B. Max
Geschlecht: Geschlecht des Interessenten männlich oder weiblich
Geburtsdatum*: Geburtsdatum des Interessenten im Format 'dd.mm.jjjj' z.B. 16.05.1977 *
Strasse*: Strassenangabe zur Anschrift des Interessenten z.B. Teststraße 44 a
PLZ*: Fünfstellige Postleitzahl zur Anschrift des Interessenten z.B. 14167*
Ort*: Ortsangabe zur Anschrift des Interessenten z.B. Berlin
Email*: E-Mailanschrift des Interessenten z.B. maxmustermann@test.de
Beruf: Berufsbezeichnung des Interessenten z.B. Speditionskaufmann
Status: Berufsstatus des Interessenten z.B. Angestellter
EK: Jahreseinkommen (brutto) des Interessenten z.B. 58.000 €
Familienstand: Familienstand des Interessenten z.B. ledig
Tel1_Vorwahl: Vorwahl zur Telefonnummer privat z.B. 030
Tel1: Telefonnummer privat (ohne Vorwahl) z.B. 787 14 12
Err1: Erreichbarkeit zu Tel1 (Telefon privat) z.B. abends
Tel2_Vorwahl: Vorwahl zur Telefonnummer beruflich z.B. 02232
Tel2: Tefonnummer beruflich (ohne Vorwahl) z.B. 502415
Err2: Erreichbarkeit zu Tel1 (Telefon privat) z.B. vormittags und nachmittags
Mobil_Vorwahl: Vorwahl zur Mobilrufnummer z.B. 0163
Mobil: Mobilrufnummer (ohne Vorwahl) z.B. 3603036
ErrM: Erreichbarkeit zur Mobilrufnummer z.B. ganztags
Fax_Vorwahl: Vorwahl zur Faxnummer z.B. 02232
Fax: Faxnummer (ohne Vorwahl) z.B. 502514
Bemerkung: Zusatzfeld für Bemerkungen des Interessenten z.B. bitte keine Kontakt nach 21:00 Uhr

Alle weiteren Zeilen werden automatisch ausgelesen und im Feld 'Details' automatisch zusammengefasst.

Zum Beispiel:
Stationär: Mehrbettzimmer
Krankentagegeld: 0
Zahnleistungen: hoch
Selbstbeteiligung pro Jahr: keine (0 €)

* Pflichtangaben

3.0.) Auslesen einer mitgelieferten XML-Datei

3.1) Bennennung der mitgelieferten XML-Datei:
Der Dateiname des XML-Anhanges ist eindeutig (z.B. immer 'lead.xml' oder immer 'kontaktanfrage.fks')

3.2) Anzahl möglicher Einlieferungen mit einem Importvorgang:
Über einen XML-Baum können beliebig viele IDS eingeliefert werden. Nachfolgend wir der Aufbau des XML-Baumes beschrieben:

In einem XML-Baum können mehrer Leads angeliefert werden:
<?xml version=„1.0“ encoding=„ISO-8859-1“?>
<LIEFERUNG>
<LEAD>
DS 01
</LEAD>
<LEAD>
DS 02
</LEAD>
<LEAD>
DS 03
</LEAD>
<LEAD>
DS 04
</LEAD>
</LIEFERUNG>

oder nur ein Lead:

<?xml version=„1.0“ encoding=„ISO-8859-1“?>
<LIEFERUNG>
<LEAD>
DS 01
</LEAD>
</LIEFERUNG>


In der ersten Zeile steht immer:
<?xml version=„1.0“ encoding=„ISO-8859-1“?>
Dann wird der XML-Baum mit dem Tag <LIEFERUNG> geöffnet.
Einzelne Leads werden mit dem Tag <LEAD> geöffnet und anschließend mit dem Tag </LEAD> geschlossen.

Nach dem, je nach Bedarf, ein oder mehrer Datensätze in den Baum geschrieben wurden, wir der XML-Baum mit dem Tag </LIEFERUNG> geschlossen.
Der Aufbau der Datensätze (DS 01, DS 02 etc.) im XML-Format, sieht folgendermaßen aus:

<LEAD>
<LEAD_KENNUNG><![CDATA[15842]]></LEAD_KENNUNG>
<HERKUNFT><![CDATA[www.meienhomepage.de]]></HERKUNFT>
<SPARTE><![CDATA[PKVZ]]></SPARTE>
<ANREDE><![CDATA[Herr]]></ANREDE>
<TITEL><![CDATA[Dr. med.]]></TITEL>
<NACHNAME><![CDATA[Mustermann]]></NACHNAME>
<VORNAME><![CDATA[Max]]></VORNAME>
<GESCHLECHT><![CDATA[männlich]]></GESCHLECHT>
<GEB_DATUM><![CDATA[1971-09-24 00:00:00]]></GEB_DATUM>
<STRASSE><![CDATA[Teststraße 44 a]]></STRASSE>
<PLZ><![CDATA[14167]]></PLZ>
<ORT><![CDATA[Berlin]]></ORT>
<EMAIL><![CDATA[maxmustermann@test.de]]></EMAIL>
<BERUF><![CDATA[Speditionskaufmann]]></BERUF>
<BERUFSSTATUS><![CDATA[Angestellter]]></BERUFSSTATUS>
<FAMILIENSTAND><![CDATA[ledig]]></FAMILIENSTAND>
<EK><![CDATA[58.000 €]]></EK>
<DETAILS><![CDATA[Stationär: Mehrbettzimmer
Zahnleistungen: hoch
Selbstbeteiligung pro Jahr: keine (0 €)
Krankentagegeld 0 ]]></DETAILS>
<TEL1_VORWAHL><![CDATA[02232]]></TEL1_VORWAHL>
<TEL1><![CDATA[502515]]></TEL1>
<ERR1><![CDATA[abends]]></ERR1>
<TEL2_VORWAHL><![CDATA[02232]]></TEL2_VORWAHL>
<TEL2><![CDATA[502514]]></TEL2>
<ERR2><![CDATA[vormittags und nachmittags]]></ERR2>
<MOBIL_VORWAHL><![CDATA[0163]]></MOBIL_VORWAHL>
<MOBIL><![CDATA[3603036]]></MOBIL>
<ERRM><![CDATA[ganztags]]></ERRM>
<BEMERKUNG><![CDATA[bitte keine Kontaktaufnahme nach 21:00 Uhr]]></BEMERKUNG>
</LEAD>

Die Feldbezeichner können frei definiert werden (z.B. PLZ oder Postleitzahl).