Mr-Vers Verwaltung

Schnittstellenbeschreibung zu Mr-Money.de Vergleichsrechner am Bsp: PHV

Hier gehts zur neuen Dokumentation

https://rechner-doku.versicherungsmaklersoftware.de

1. Praktische Funktionsweise

Sie übergeben uns als POST oder GET an https://schnittstellen.versicherungsmaklersoftware.de/varinput.php die Variablen, die Sie übermitteln wollen.
Dieses Formular simuliert die Übergabe einiger Variablen als POST-Request.
SteuervariablenWenn es nicht möglich ist, den POST oder GET Aufruf von Ihrer Porgrammiersprache auszuführen,
können Sie uns auch einen anderen Vorschlag unterbreiten.

Eine genaue Definition der Variablen und Inhalte finden Sie hier
(Wir empfehlen diese Detaildaten aber nicht mit zu übergeben,
da diese sich im Laufe der Zeit immer wieder verändern werden.)

PHV Variablen - Beschreibung
TIE Variablen - Beschreibung
RS Variablen - Beschreibung
UNF Variablen - Beschreibung
HR Variablen - Beschreibung
WG Variablen - Beschreibung
BAU Variablen - Beschreibung
HUG Variablen - Beschreibung
OEL Variablen - Beschreibung
PHO Variablen - Beschreibung
FDV Variablen - Beschreibung
TKV Variablen - Beschreibung
TKVP Variablen - Beschreibung
TKVK Variablen - Beschreibung

id (MaklerID)Das ist die 8stellige ID, welche die Makler bei der Anmeldung bei uns erhalten, z.B. 00200341.
pa (Partnerkennung)
Diese Nummer erhalten Sie von Mr-Money, sie besteht meist aus 2-3 Buchstaben (z.b. ABC). Der Wert "herstellerx" schaltet in den Demomodus.
subid (Nur nach Absprache)
v_id (Vermittlerkennung)
Verschiedene Nutzer des Rechner bzw Ihres Portals können ihre Angebote für Kunden getrennt abspeichern. Nehmen Sie dazu am besten die Benutzerkennung des angemeldeten Users in Iherm System. Sollte nur ein Nutzer die Rechner aufrufen, übergeben Sie z.B. v_id=Vor_Nachname. (WICHTIG: Keine Leer- oder Sonderzeichen!) Für Endkunden Portal muss dieses Feld FREI bleiben!
sp (Sparte, falls leer dann wird die Spartenübersicht angezeigt)
Für Angebots-Center im Makler-Verwaltungs-Portal (MVP)
token (optional, siehe 3.)
pa_pass (optional, Makler-Passwort, siehe 3.)
ma_pass (optional, Mitarbeiter-Passwort, siehe 3.)
pk_k (optional, ID vom Kundendatensatz im Mr-Money MVP, siehe 3.)
id_extern (pk_k muss leer sein, token muss gesetzt sein, nur nach Aufforderung verwenden)
Kundendaten
Anrede_k
Name_k
Vorname_k
Firma_k
Strasse_k
PLZ_k
Ort_k
Tel_privat_k
Fax_k
email_k
Beruf_k
Geb_dat_k
Staatsang_k
Famstand_k
IBAN_k
Bank_k
Kontoinhaber_k
Antragsdaten Vorversicherung
Wer_hat_Vorvertrag_gekuendigt
Antrag_abgelehnt
Vorversicherung
Vorversicherungnummer
Beginn_Vorversicherung
Ablauf_Vorversicherung
Weitere Vertragsdaten für PHV
Anrede_Lebenspartner_k
Vorname_Lebenspartner_k
Nachname_Lebenspartner_k
Geburtsdatum_Lebenspartner_k
Vertrags Detaildaten (je nach Sparte unterschiedlich - optional)
vs_v (Verssumme)
alter
delikt (Deliktunfähige Kinder)
Weitere Variablen (frei lassen)
Diese Übergabe muß vor dem eigentlichen Rechneraufruf geschehen, denn Sie erhalten eine ID zurück, mit der Sie sich später bei der Antragsstellung die Antragsdaten von unserer Datenbank holen können.
Der Absendenbutton soll die Datenübertragung im Hintergrund an uns simulieren:


Falls die Übertragung per GET stattfinden soll sieht das so aus:
(ACHTUNG im GET Link ist keine $sp enthalten damit auf die Spartenübersicht gesprungen wird, daher können keine Detaildaten der Sparte übergeben werden. Fügen Sie. wenn benötigt, z.B. sp=PHV&vs_v=5000000 hinzu)
https://schnittstellen.versicherungsmaklersoftware.de/varinput.php?id=layout1&pa=herstellerx&v_id=Max_Makler&Anrede_k=Herr&Name_k=Muster&Vorname_k=Hans&Firma_k=&Strasse_k=Schiller%203&PLZ_k=09366&Ort_k=Stollberg&Tel_privat_k=037296-927390&Fax_k=037296-927399&email_k=post@mr-money.de&Beruf_k=Maler&Geb_dat_k=01.01.1970&Staatsang_k=Deutschland&Famstand_k=verheiratet&Bank_k=Postbank&BLZ_k=12345678&Konto_k=987654321&Kontoinhaber_k=Petra%20Muster


Wenn Sie die URL um die Variable Sparte ($sp=PHV) ergänzen, erhalten Sie einen Link, der direkt in den PHV Rechner führt. Diese Variante empfehlen wir, wenn Sie in den jeweiligen Rechner nicht nur Kunden, sondern auch Vertragsdaten importieren wollen. (z.B. Versicherungssumme, qm Wohnfläche, ... weitere Tarifmerkmale laut o.g. Variablen - Beschreibung)

Wichtig ist das die Variableninhalte dann rawurlencode sind Info rawurlencode

2. Alternativ nur die Übergabe Ihre Daten an unseren Rechner ohne Rückgabemöglichkeit:
Wird der Aufruf mit dem Parameter redirect=1 erweitert, wird sofort der Vergleichsrechner aufgerufen. Wird der Paramter Sparte weggelassen, erscheint die Gesamtübersicht der Rechner.
Bsp:
https://schnittstellen.versicherungsmaklersoftware.de/varinput.php?id=layout1&pa=herstellerx&v_id=Max_Makler&Anrede_k=Herr&Name_k=Muster&Vorname_k=Hans&Firma_k=&Strasse_k=Schiller%203&PLZ_k=09366&Ort_k=Stollberg&Tel_privat_k=037296-927390&Fax_k=037296-927399&email_k=post@mr-money.de&Beruf_k=Maler&Geb_dat_k=01.01.1970&Staatsang_k=Deutschland&Famstand_k=verheiratet&Bank_k=Postbank&BLZ_k=12345678&Konto_k=987654321&Kontoinhaber_k=Petra%20Muster&redirect=1 optional: &sp=PHV

3. Nutzung vom Angebots-Center über externe Verwaltungssoftware

a)

Legen Sie die Nutzer als "Mitarbeiter" im Makler-Bund-Portal an:
https://portal.makler-bund.de/?modul=admin&action=mitarbeiter
Das dort hinterlegte Kürzel der Mitarbeiter (Kuerzel_ma) muss im Parameter v_id übertragen werden.

Das Anlegen der Nutzer kann auch über die Schnittstelle des MVP erfolgen:
portal.makler-bund.de/schnittstellen.php?task=instructions&interface=mitarbeiter

Die bisherige Konfiguration der Untervermittler/Mitarbeiter über den Adminbereich des SACH-Rechners entfällt:
https://login.versicherungsmaklersoftware.de/partner_untervermittler.php

b)

Zur Authentifizierung im AngebotsCenter können Sie die Zugangsdaten des Vermittlers und Mitarbeiters (pa_pass und ma_pass) oder einen Security-Token übertragen.

Wenn Sie den Token nutzen möchten, können Sie diesen über folgende URL abrufen:
https://portal.makler-bund.de/login.php?action=getToken&Makler=[ID-Makler]&Pass=[PW-Makler]&Mitarb=[ID-Mitarbeiter]&MitPass=[PW-Mitarbeiter]
"[ID-Makler]" entspricht "id (MaklerID)"
"[ID-Mitarbeiter]" entspricht "v_id (= Mitarbeiter-Kürzel, Kuerzel_ma)"

Der Token ist 8 Stunden gültig. Die Haltbarkeit verlängert sich bei der Nutzung automatisch.

Falls Sie Tokens mit mehr als 8 Stunden Gültigkeit erzeugen möchten, können Sie den Parameter "ttl" anfügen und die Haltbarkeit in Sekunden übertragen. Z.B. ttl=2592000 für 30 Tage.

c)

Im Response der /varinput.php erhalten Sie nun zusätzlich den Pfad zum Angebots-Center (url_mvp=) der statt (url=) aufgerufen werden muss um direkt ins AngebotsCenter zu gelangen. Der Rechner der jeweiligen Sparte wird dabei direkt geöffnet.

d)

Kundenzuordnung:

Um beim Sprung ins Angebots-Center optional einen Kunden zu referenzieren, kann mit dem Parameter pk_k eine ID des Kundendatensatzes aus dem MVP übermittelt werden. Alternativ kann auf Nachfrage auch eine gleichbleibende eindeutige Kunden-ID aus Ihrem System übertragen werden.