Hier gehts zur neuen Dokumentation
Beschreibung für die Schnittstellen der Rechenkerne - Nach oben
Historie der Änderungen im Rechenkern - wichtig für Ihre Entwicklung!! => Historie
Der Rechenkern wird mit einigen Pflichtangaben und einigen
optionale Variablen aufgerufen. Das Ergebnis erhalten Sie als XML oder JSON zurück.
Privathaftpflicht
https://www.mr-money.de/module/kern/phv.php?id=IhreID&subid=IhreID&IP_USER=xxxxx
Beschreibung der Eingabe-Parameter https://schnittstellen.versicherungsmaklersoftware.de/info.php?sp=haftpflicht
Beschreibung der Fragen, Hilfetexte und Variablen im Leistungsvergleich:
https://schnittstellen.versicherungsmaklersoftware.de/leistungsfragen.php?sp=haftpflicht
Tierhalter
https://www.mr-money.de/module/kern/tie.php?id=IhreID&subid=IhreID&IP_USER=xxxxx
Beschreibung der Eingabe-Parameter https://schnittstellen.versicherungsmaklersoftware.de/info.php?sp=tierhalter
Beschreibung der Fragen, Hilfetexte und Variablen im Leistungsvergleich:
https://schnittstellen.versicherungsmaklersoftware.de/leistungsfragen.php?sp=tierhalter
Hausrat
https://www.mr-money.de/module/kern/hr.php?id=IhreID&subid=IhreID&IP_USER=xxxxx
Beschreibung der Eingabe-Parameter https://schnittstellen.versicherungsmaklersoftware.de/info.php?sp=hausrat
Beschreibung der Fragen, Hilfetexte und Variablen im Leistungsvergleich:
https://schnittstellen.versicherungsmaklersoftware.de/leistungsfragen.php?sp=hausrat
Rechtsschutz
https://www.mr-money.de/module/kern/rs.php?id=IhreID&subid=IhreID&IP_USER=xxxxx
Beschreibung der Eingabe-Parameter https://schnittstellen.versicherungsmaklersoftware.de/info.php?sp=rechtsschutz
Beschreibung der Fragen, Hilfetexte und Variablen im Leistungsvergleich:
https://schnittstellen.versicherungsmaklersoftware.de/leistungsfragen.php?sp=rechtsschutz
Unfall
https://www.mr-money.de/module/kern/unf.php?id=IhreID&subid=IhreID&IP_USER=xxxxx
Beschreibung der Eingabe-Parameter https://schnittstellen.versicherungsmaklersoftware.de/info.php?sp=unfall
Beschreibung der Fragen, Hilfetexte und Variablen im Leistungsvergleich:
https://schnittstellen.versicherungsmaklersoftware.de/leistungsfragen.php?sp=unfall
Wohngebäude sowie Feuerrohbau
https://www.mr-money.de/module/kern/wg.php?id=IhreID&subid=IhreID&IP_USER=xxxxx
Beschreibung der Eingabe-Parameter https://schnittstellen.versicherungsmaklersoftware.de/info.php?sp=wohngebaeude
Beschreibung der Fragen, Hilfetexte und Variablen im Leistungsvergleich:
https://schnittstellen.versicherungsmaklersoftware.de/leistungsfragen.php?sp=wohngebaeude
Haus- und Grundbesitzerhaftpflicht
https://www.mr-money.de/module/kern/hug.php?id=IhreID&subid=IhreID&IP_USER=xxxxx
Beschreibung der Eingabe-Parameter https://schnittstellen.versicherungsmaklersoftware.de/info.php?sp=hug
Beschreibung der Fragen, Hilfetexte und Variablen im Leistungsvergleich:
https://schnittstellen.versicherungsmaklersoftware.de/leistungsfragen.php?sp=hug
Gewässerschadenhaftpflicht (Öltank)
https://www.mr-money.de/module/kern/oel.php?id=IhreID&subid=IhreID&IP_USER=xxxxx
Beschreibung der Eingabe-Parameter https://schnittstellen.versicherungsmaklersoftware.de/info.php?sp=oeltank
Beschreibung der Fragen, Hilfetexte und Variablen im Leistungsvergleich:
https://schnittstellen.versicherungsmaklersoftware.de/leistungsfragen.php?sp=oeltank
Photovoltaik
https://www.mr-money.de/module/kern/pho.php?id=IhreID&subid=IhreID&IP_USER=xxxxx
Beschreibung der Eingabe-Parameter https://schnittstellen.versicherungsmaklersoftware.de/info.php?sp=photovoltaik
Beschreibung der Fragen, Hilfetexte und Variablen im Leistungsvergleich:
https://schnittstellen.versicherungsmaklersoftware.de/leistungsfragen.php?sp=photovoltaik
E-Bike/Fahrrad/Pedelec
https://www.mr-money.de/module/kern/fdv.php?id=IhreID&subid=IhreID&IP_USER=xxxxx
Beschreibung der Eingabe-Parameter https://schnittstellen.versicherungsmaklersoftware.de/info.php?sp=fahrrad
Beschreibung der Fragen, Hilfetexte und Variablen im Leistungsvergleich:
https://schnittstellen.versicherungsmaklersoftware.de/leistungsfragen.php?sp=fahrrad
Hunde-KV
https://www.mr-money.de/module/kern/tkv.php?id=IhreID&subid=IhreID&IP_USER=xxxxx
Beschreibung der Eingabe-Parameter https://schnittstellen.versicherungsmaklersoftware.de/info.php?sp=tierkranken
Beschreibung der Fragen, Hilfetexte und Variablen im Leistungsvergleich:
https://schnittstellen.versicherungsmaklersoftware.de/leistungsfragen.php?sp=tierkranken
Pferde-KV
https://www.mr-money.de/module/kern/tkvp.php?id=IhreID&subid=IhreID&IP_USER=xxxxx
Beschreibung der Eingabe-Parameter https://schnittstellen.versicherungsmaklersoftware.de/info.php?sp=pferdekv
Beschreibung der Fragen, Hilfetexte und Variablen im Leistungsvergleich:
https://schnittstellen.versicherungsmaklersoftware.de/leistungsfragen.php?sp=pferdekv
Katzen-KV
https://www.mr-money.de/module/kern/tkvk.php?id=IhreID&subid=IhreID&IP_USER=xxxxx
Beschreibung der Eingabe-Parameter https://schnittstellen.versicherungsmaklersoftware.de/info.php?sp=katzenkv
Beschreibung der Fragen, Hilfetexte und Variablen im Leistungsvergleich:
https://schnittstellen.versicherungsmaklersoftware.de/leistungsfragen.php?sp=katzenkv
Bauherrenhaftpflicht und Bauleistung
https://www.mr-money.de/module/kern/bau.php?id=IhreID&subid=IhreID&IP_USER=xxxxx
Beschreibung der Eingabe-Parameter https://schnittstellen.versicherungsmaklersoftware.de/info.php?sp=neubau
Beschreibung der Fragen, Hilfetexte und Variablen im Leistungsvergleich:
https://schnittstellen.versicherungsmaklersoftware.de/leistungsfragen.php?sp=neubau
Es müssen hier zwingend eine dieser Variablen auf "ja" gesetzt werden, sonst erhalten Sie kein Ergebnis:
Die Übertragung aller Parameter kann wahlweise per GET oder POST erfolgen und muss in ISO-8859-15 Kodierung erfolgen (nicht UTF-8).
Optionale Parameter:
Rückgabe als JSON statt XML:
&out=json
Bsp: https://www.mr-money.de/module/kern/phv.php?id=IhreID&laufzeit=1&delikt=ja&sb=nein&IP_USER=111.111.111.111-12345&out=json
&cv=1: Wenn die Berechnung von einem Endkunden durchgeführt wird und NICHT von einem Vermittler, dann cv=1 mit übertragen. Deaktiviert im Antrag z.B. die Beratungsdokumentation des Vermittlers, usw.
Bsp: https://www.mr-money.de/module/kern/phv.php?id=IhreID&laufzeit=1&delikt=ja&sb=nein&IP_USER=111.111.111.111-12345&cv=1
lvgon=1: der gesamte Leistungsvergleich wird mit zurück geliefert (das können je nach Tarif einige 100kb sein)
Bsp: https://www.mr-money.de/module/kern/phv.php?id=IhreID&laufzeit=1&delikt=ja&sb=nein&IP_USER=111.111.111.111-12345&lvgon=1
lvg_direkt=xxx,xxx,xxx : wenn diese Variable mit einer Tarifnummer (oder mehreren mit Komma getrennt) befüllt wird, wird nur der Leistungsvergleich dieses Tarifes zurück gegeben. (hier darf $lvgon nicht gesetzt sein)
Bsp: https://www.mr-money.de/module/kern/phv.php?id=IhreID&laufzeit=1&delikt=ja&sb=nein&IP_USER=111.111.111.111-12345&lvg_direkt=7
lvgfragenoff=1 : für beide o.g. Parameter gilt: Leistungsvergleiche übermitteln aber ohne die Leistungsfragen und Erklärungen (Beachten Sie aber hier, daß z.B. bei Rechtsschutz je nach Tarifvorgabe, die Antworten im Leistungsvergleich verändert werden. Bsp: Wenn nur Verkehrs RS gewählt wird, wird im Leistungsvergleich keine Info zu Arbeits RS angezeigt.)
pack=1 : der Inhalt wird gepackt übermittelt. (php gzencode) - geht nur bei Paramter $lvgon
antrag_direkt=1 : Es werden nur alle Antragslinks zurück geliefert einfach mit Zeilenumbruch getrennt
Bsp: https://www.mr-money.de/module/kern/phv.php?id=IhreID&laufzeit=1&delikt=ja&sb=nein&IP_USER=111.111.111.111-12345&antrag_direkt=1
$tnr = Damit ist die $tarifnrtemp in der Schnittstellen-Rückgabe gemeint
tnr=xxx und antrag_direkt=1: Es wird nur der Antragslink zu Tarifnummer $tnr zurück geliefert (Einsatz setzt antrag_direkt=1 voraus). Diese Option kann verwendet werden um Eingaben zu speichern und daraus später direkt wieder einen Antrag zu erstellen. Vorteil hier ist, dass Tarifänderungen die zwischendurch eingetreten sind, beachtet werden.
Bsp: https://www.mr-money.de/module/kern/phv.php?id=IhreID&laufzeit=1&delikt=ja&sb=nein&IP_USER=111.111.111.111-12345&antrag_direkt=1&tnr=7 (Antragsaufruf siehe Punkt 2.1.)
antrag_direkt=2 : Es wird auf den fertigen Antrag umgeleitet! Voraussetzung Angabe der $tnr
Bsp: https://www.mr-money.de/module/kern/phv.php?id=IhreID&laufzeit=1&delikt=ja&sb=nein&IP_USER=111.111.111.111-12345&antrag_direkt=2&tnr=7
Gründe für nicht angezeigte Tarife:
fehlende_tarife=1 : Nun werden die jeweiligen Gründe für nicht angezeigte Tarife mit geliefert.
Aufbau der Schnittstellen-Rückgabe mit Ausgabe Leistungsvergleich, sowie Kundendaten- und Berechnungsvorgaben-Übergabe in den Rechner:
Am besten Sie schauen sich parallel zur Beschreibung auf www.mr-money.de den Vergleich an, dann verstehen Sie bessern welche Daten wo übermittelt werden.
1. Teil -> Definition der Leistungsfragen
<Frage> Frage zum Leistungskiterium
<Erklaerung> Hilfstext zur Frage (wird bei uns per Tooltip
Text angezeigt)
<Titel> Inhalt kann "T" sein, das heißt zur
besseren Gliederung haben wir Überschriften eingefügt, die Sie
gesondert darstellen können
2. Teil -> Tarifinformationen
<tarif> hier stehen alle Ergebnisse zum Tarif und den
Leistungsaussagen
<antrag> Dieser Link kann an Ihre installierte
steuerung.php oder an https://www.mr-money.de/module/steuerung.php?
übermittelt werden. Ersetzen Sie vorher aber die ~ Zeichen durch
& Zeichen. ACHTUNG vervollständigen Sie den Antragsstring noch mit: &act=antrag, weil dieser Parameter einen direkten Antrag erstellt.
2.1. Beispiel eines Antragslinkes
https://www.mr-money.de/module/steuerung.php?[Antragslink aus Ihrer XML wo die ~ in & ersetzt wurden]&act=antrag
2.2. Berechnung mit vorheriger Parameter Übergabe in die Eingabemaske und Kunden-Daten Übernahme in den Antrag
Vor dem Aufruf des eigentlichen Rechenkerns können Sie Vorgaben für Eingabefelder und Kundendaten an uns übertragen. Sie erhalten eine Transaktionsnummer zurück, mit der Sie später z.B. auch erstellte Angebote oder Anträge abrufen können.
So übermitteln Sie die Daten an uns: (Beachten Sie besonders die Variablen id, v_id, sp)
Hier erhalten Sie die Transaktionsnummer: https://schnittstellen.versicherungsmaklersoftware.de/
Dann geschieht der eigentliche Rechenkernaufruf wie Sie ihn kennen. Sie hängen an die URL folgenden Parameter zusätzlich an:
a_id (Zeile 3 der Rückgabe z.B. 89.234.73.234-12345::herstellerx
und übermitteln in IP_USER den Inhalt der zurück gegebenen Variable pk
Bsp: https://www.mr-money.de/module/kern/phv.php?id=IhreID&laufzeit=1&delikt=ja&sb=nein&IP_USER=$pk&a_id=$a_id
herstellerx - ist Ihre Software Hersteller ID die Sie von uns erhalten.
id - ist Ihre PartnerID die Sie von uns erhalten und die wir für diesen Webservice freischalten müssen
Einen Antrag rufen Sie dann wie unter 2.2 auf (nicht vergessen die ~ zu ersetzen und den Paramter ran zu hängen)
3. Teil -> Leistungsaussagen
<F..> die Leistungsaussagen zu o.g. Definitionen
Sie können anhand der Leistungstexte eigene Icons anzeogen
lassen:
wenn Aussage "mitversichert" enthält dann ist
Leistungspunkt bestmöglich versichert (bei uns
Grüner Haken)
wenn Aussage "nicht mitversichert" enthält dann ist
Leistungspunkt nicht versichert (bei uns Roter
Strich)
wenn Aussage "nicht versicherbar" enthält
dann ist Leistungspunkt nicht versicherbar (bei
uns Roter Strich)
wenn Aussage "*" als erstes Zeichen enthält
dann ist Leistungspunkt teilweise versichert
(bei halb Grüner Kreis)
4. Teil -> Bedingungen
<F6> Versicherteninformationen
<F7> Versicherungsbedingungen
<F8> Sonstige Informationen
beinhalten eine oder mehrere Dokumete
Aufbau:
<Dok_nr> z.b. 691
<Dokumentenart> z.b. "Allgem. Bedingungen"
(Beschreibung des Dokumentes)
<Dok_Art> meist frei, Zusatzhinweise zum Dokument (z.B.
gilt nur für Elementar)
<Dok_kb> z.b. 67 (Größe in kb)
Die Dok_nr kann auf http://www.online-protokoll.de
einegeben werden um an das pdf zu kommen.
Alternativ kann man es so direkt aufrufen: https://www.mr-money.de/pool/dokmanager/pdfs/347.pdf
(Die Nr. müssen Sie einfach ersetzen)
Logos der Gesellschaften - Nach oben
Aus der Schnittstelle erhalten Sie den Tarifnamen.
Diesen trennen Sie nach dem ersten Bindestrich "-".
Der Teil vor dem Bindestrich bestimmt das Logo.
Bsp. "Allianz-PRO-complete" -> "allianz" für das Logo
Als Bild-Quelle kann dann folgendes verwendet werden:
https://www.mr-money.de/module/vglrechner/layouts/svg_png_logo.php?width=190&gesell=allianz
Zusatz-Webservice - Nach oben
Über unseren Webservice können Sie weitere Infos und Daten abrufen, z.B.:
- Gesellschaftsliste, -infos, -bewertungen
- Adressdaten für HR und WG-Rechner
- Berufe für die Sparte Unfall
- Statistik für Anzahl der Berechnungen und Anträge
- Hunderassen für die Sparten Tierhalter und Haftpflicht
https://api.versicherungsmaklersoftware.de/guide.php?schnittstelle=allgemein
Der Zugriff für die einzelnen Schnittstellen des Webservice wird individuell auf Anfrage erteilt.
WEITERE OPTIONALE BESCHREIBUNGEN:
Individuelle Vermittleranschrift - bei Nutzung der Rechner-Schnittstelle - Nach oben
Wenn Sie für den Antrag die Vermittleranschrift selbst festlegen möchten müssen folgende Parameter zusätzlich übergeben werden:
Pflichtfelder: v_id, name1, email
Zum Löschen des Adressdatensatzes für eine Vermittlernr(v_id) übergeben Sie folgende Parameter:
Individuelle Vermittleranschrift - beim normalen Direktaufruf des Rechners - Nach oben
Wenn Sie für den Antrag die Vermittleranschrift selbst festlegen möchten müssen folgende Parameter zusätzlich übergeben werden:
Ihre PartnerID muss für diese Funktion erst freigeschaltet werden.
Pflichtfelder: v_id, adr[Name1], adr[email]
v_id = Entspricht der allgemeinen Nutzerkennung. Die Identifikation um welchen Vermittler/Nutzer es sich handelt
cv = Übertragen Sie cv=1, wenn der Rechner für Endkunden Verwendung findet
adr[Name1] = Zeile 1 für Name des Vermittlers, z.B. Firma
adr[Name2] = Zeile 2 für Name des Vermittlers, z.B. Vorname Nachname
adr[Strasse] = Straße und Hausnummer
adr[PLZOrt] = PLZ und Ort
adr[Tel] = Telefonnummer
adr[Fax] = Faxnummer
adr[email] = E-Mail-Adresse des Vermittlers
adr[Internet] = Internet-Adresse für Website des Vermittlers
adr[Registernummer] = IHK-Registernummer des Vermittlers
adr[vpnr] = Dient zur Übertragung der Vermittlernummer bei der Gesellschaft; Beispiel vpnr = GesellschaftXYZ:9876543
Bsp.:
https://www.mr-money.de/cookievgl.php?sp=phv&id=00200341&v_id=TSC&adr[Name1]=Max%20Mustermann&adr[Strasse]=Teststr.%201&adr[PLZOrt]=01234%20Musterhausen&adr[email]=test@mustertest.de
Verwendung des MrMoney Fehlermanagers aus externen Systemen mit URL-Aufruf und Standard-Eingabe-Maske - Nach oben
Sie übergeben an die URL:
https://www.mr-money.de/module/fm_init.php
folgende Parameter (Beispiel für PHV):
id=[PARTNERID]
subid=[SUBID]
v_id=[V_ID]
sp=PHV
IP_USER=[DIE_AKTUELLE_IP_USER]
Verwendung des MrMoney Fehlermanagers aus externen Systemen mit eigener Eingabemaske - Nach oben
Sie erstellen ein Eingabeformular für den Fehlermanager welches sich nahtlos in Ihr System integriert. Beim Abschicken werden die eingegebenen Daten intern über Ihr System an den MrMoney Fehlermanager geschickt.
Nachfolgend das JSON-Object für den Fehlermanager. Rot und Fett hervorgehobene Werte sind von Ihnen zu befüllen. Grau hinterlegte Bereiche sind optional. Direkte Quellcode-Funktionen sind Blau hervorgehoben und sind durch die äquivalente der verwendeten Programmiersprache zu ersetzen.
Alle im JSON eingetragenen Texte müssen UTF8 kodiert werden.
{
"auth": {
"Ursprung": "Sach-Rechner",
"KennungA": "PARTNERID",
"KennungB": "V_ID",
"KennungC": "SUBID",
"E-Mail": "EMAIL_DES_MAKLERS",
"Secure": md5 ( sha1 ( 'Sach-Rechner-fm-PARTNERID-fm-V_ID-fm-SUBID' ) )
},
"method": "insertTicket",
"content": {
"Titel": "TITEL_FEHLERMELDUNG",
"Frage": "BESCHREIBUNG_FEHLERMELDUNG",
"Chat": "1",
"Zusatz": [
{
"Name": "Sparte",
"Type": "Info",
"Value": "DIE_SPARTE"
},
{
"Name": "Tarif",
"Type": "Text",
"Value": "TARIF_NAME"
},
{
"Name": "Falscher Beitrag",
"Type": "Text",
"Value": "FALSCHER_BEITRAG"
},
{
"Name": "Richtiger Beitrag",
"Type": "Text",
"Value": "RICHTIGER_BEITRAG"
},
{
"Name": "HTTP_URL_ZU_IHREM_VERGLEICHSRECHNER_ZUM WIEDERAUFRUFEN",
"Type": "relink",
"Value": {
"variable1": "wert1",
"variable2": "wert2",
"...": "..."
}
},
{
"Name": "userAgent",
"Type": "admin",
"Value": "DER_USER_AGENT"
}
]
},
"Files": [base64_encode( gzdeflate("DATEIINHALT"))],
"FileTypes": ["application\/pdf"],
"FileNames": ["DATEINAME.DATEIERWEITERUNG"]
}
Dieses JSON wird per POST an folgende URL gesendet:
http://www.fehlermanager.info/interface.php
Der Fehler ist nun im Mr-Money Fehlermanager eingetragen. Als Rückgabe erhalten Sie "Success", sowie die Meldung und einen Link um das Ticket aufzurufen.
Ermitteln der DokumentenIDs (Vertragsrelevante Dokumente der Tarife) - Nach oben
An den Dokumenten werden täglich(!) Änderungen vorgenommen. Ein Cache auf Ihrem System sollte max. 1 Tag gültig sein um zu verhindern dass der Kunde veraltete/ungültige Dokumente ausgeliefert bekommmt.
Im Normalfall benötigen Sie diesen Abruf nicht, da die Dokumente alle im Antrag abrufbar sind.
---
Abfrage der unterstützten Sparten:
URL: https://www.mr-money.de/module/kern/dokmanager/dok_ids.php?zeige=spartenListe
---
Abfrage aller DokumentenIDs für eine Tarifnummer:
URL: https://www.mr-money.de/module/kern/dokmanager/dok_ids.php?sparte=hr&tarifnr=115
---
Abfrage der DokumentenIDs für eine Tarifnummer die sich seit DatumXY geändert haben oder hinzugefügt wurden:
URL: https://www.mr-money.de/module/kern/dokmanager/dok_ids.php?sparte=hr&tarifnr=123&zeitstempel=2012-10-31
Es werden noch einmal alle DokumenteIDs ausgeliefert und separat noch einmal nur die neuen/geänderten DokumentenIDs
Gelöschte DokumentenIDs werden und können nicht mit ausgeliefert werden!
---
Abfrage der DokumentenIDs für alle Tarifnummern die sich seit DatumXY geändert haben oder hinzugefügt wurden:
Es werden noch einmal alle DokumenteIDs ausgeliefert und separat noch einmal nur die neuen/geänderten DokumentenIDs
Gelöschte DokumentenIDs werden und können nicht mit ausgeliefert werden!
URL: https://www.mr-money.de/module/kern/dokmanager/dok_ids.php?sparte=hr&zeitstempel=2014-01-23
---
Abruf der PDF-Dokumente anhand der DokumentenID:
Als Download:
URL: http://www.online-protokoll.de/view.php?nr=123
Inline (direkte Ausgabe):
URL: http://www.online-protokoll.de/view.php?nr=123&i=1
Mehrere Dokumente als ZIP:
URL: http://www.online-protokoll.de/view.php?tarif=myDoks&nr=2624-123
Ermitteln der Antrag-HASHs für eine durchgeführte Berechnung und Aufruf der Anträge - Nach oben
Abfrage der unterstützten Sparten:
URL: https://www.mr-money.de/module/kern/antrag/erzeugeUrls.php?zeige=spartenListe
---
Abfrage der HASHs. Kann bis zu 8 Stunden nach einer Berechnung durchgeführt werden. Danach werden die Protokoll-Dateien automatisch gelöscht.
URL: https://www.mr-money.de/module/kern/antrag/erzeugeUrls.php?id=IHRE_PARTNER_ID&sparte=phv&ip_user=89.247.129.127-12345
---
Aufruf der Anträge:
Bsp: https://www.mr-money.de/module/antrag.php?load=DER_HASH