Glossar – Begriffserklärungen

Alle wiederkehrenden Fachbegriffe auf einen Blick

Diese Seite erklärt alle Bezeichnungen und Parameter, die in der Dokumentation immer wieder auftauchen. Wenn Sie einen Begriff in einer anderen Seite nicht verstehen, schauen Sie hier nach.

Begriff / Parameter Kurzform Erklärung
id Partner-ID / Makler-ID Die 8-stellige Kennung, die ein Makler bei der Anmeldung bei Mr-Money erhält (z.B. 00200341). Sie identifiziert den Makler eindeutig im System und muss bei jedem API-Aufruf mitgegeben werden.
Auch im Testbetrieb sollte bereits die echte Partner-ID verwendet werden.
pa Hersteller-ID / Partnerkennung Ihre 2–3-buchstabige Kennung als Software-Hersteller, die Sie einmalig von Mr-Money erhalten (z.B. ABC). Sie identifiziert Ihre Software als Urheber des Aufrufs, damit Mr-Money Anfragen korrekt zuordnen kann.
v_id Vermittlerkennung Ein eindeutiger Bezeichner für den einzelnen Vermittler oder Nutzer, der den Rechner aufruft (z.B. Max_Makler oder ein Benutzerkürzel aus Ihrer Software). Mehrere Vermittler können so ihre Berechnungen und Angebote getrennt verwalten.
Wichtig: Keine Leer- oder Sonderzeichen! Für Endkunden-Portale (kein eingeloggter Makler): Feld leer lassen.
cv Endkunden-Ansicht Wird auf 1 gesetzt, um den Vergleichsrechner in der Endkundenansicht zu laden, obwohl eine v_id übermittelt wird – z. B. weil eine interne Maklerzuordnung zwingend erforderlich ist, die Rechner aber auf einer Endkunden-Website eingebaut werden sollen.
subid Sub-Kennung Optionale zusätzliche Kennung unterhalb der Partner-ID. Nur nach ausdrücklicher Absprache mit Mr-Money verwenden, z.B. wenn der Vergleichsrechner auf unterschiedlichen Websites einebaut wird und Sie die Anfragen entsprechend zuordnen möchten.
Für die meisten Integrationen nicht benötigt.
sp Sparte Kürzel für den Versicherungsbereich (z.B. PHV = Privathaftpflicht, HR = Hausrat). Wird leer gelassen, zeigt der Rechner eine Spartenauswahl an. Die vollständige Liste aller Sparten finden Sie auf der Übersicht.
a_id Berechnungs-ID Wird von varinput.php als Teil der Antwort zurückgegeben. Identifiziert eindeutig eine bestimmte Berechnungssitzung und setzt sich zusammen aus: IP-Adresse + Zufallszahl + :: + Ihrer Hersteller-ID. Beispiel: 89.234.73.234-12345::herstellerx
Diese ID benötigen Sie später, um Angebote oder Antragsdaten für diese Sitzung abzurufen (Seite: Rückgabe-Schnittstelle).
pk Prozesskennung (aus varinput-Antwort) Wird von varinput.php als zweite Zeile der Antwort zurückgegeben. Inhaltlich entspricht pk dem IP_USER-Wert, den varinput.php intern für diese Sitzung erzeugt hat – er heißt in der Rückgabe nur pk.
Beim anschließenden Rechenkern-Aufruf: diesen Wert als IP_USER=[pk-Wert] weitergeben, damit Rechenkern und varinput.php dieselbe Sitzung erkennen.
IP_USER Nutzer-IP + Zufallszahl Pflichtparameter für den direkten Rechenkern-Aufruf. Format: IP-Adresse-des-Endnutzers-[5-stellige-Zufallszahl], Beispiel: 123.45.67.89-98765.
Die Zufallszahl ist notwendig, damit zwei Nutzer mit derselben IP-Adresse (z.B. hinter einem Firmen-Router) als separate Sitzungen erkannt werden.
Wenn zuvor varinput.php aufgerufen wurde: den dort zurückgegebenen pk-Wert als IP_USER übergeben.
Beim direkten Rechenkern-Aufruf ohne varinput: selbst bilden: $_SERVER['REMOTE_ADDR'] . '-' . rand(10000, 99999)
Rechenkern – Der zentrale Berechnungsserver von Mr-Money unter www.mr-money.de/module/kern/. Er empfängt Ihre Anfrage mit Kundendaten und Tarifvorgaben und gibt eine Liste aller passenden Tarife mit Beiträgen, Leistungsvergleich und Antragslinks als XML oder JSON zurück. Details: Rechenkern-Schnittstelle.
token Sicherheits-Token (AngebotCenter) Ein zeitlich begrenzter Authentifizierungsschlüssel für das AngebotCenter im Makler-Portal. Gültig 8 Stunden (verlängerbar mit ttl). Alternative zu pa_pass + ma_pass. Token-Abruf: portal.makler-bund.de/login.php?action=getToken&... Details: Demo – AngebotCenter.
url / url_mvp Rückgabe-URLs von varinput.php url: Link zum Vergleichsrechner der gewählten Sparte (Standardfall).
url_mvp: Link direkt ins AngebotCenter des Makler-Portals – wird nur zurückgegeben, wenn Sie AngebotCenter-Parameter (token, pa_pass o.ä.) übergeben haben.

Die drei beteiligten Systeme

Die Schnittstelle verteilt sich auf drei verschiedene Server – jeder hat eine andere Aufgabe:

System URL Aufgabe
Datenvorgabe schnittstellen.versicherungsmaklersoftware.de/varinput.php Nimmt Kundendaten entgegen, speichert die Sitzung und gibt url, pk und a_id zurück.
Rechenkern www.mr-money.de/module/kern/[sparte].php Berechnet Tarife und liefert Preise, Leistungsvergleich und Antragslinks als XML oder JSON.
Rückgabe / Portal portal.makler-bund.de Stellt fertige Angebots-PDFs und Antragsdaten bereit, nachdem der Nutzer im Rechner eine Berechnung abgeschlossen hat.
✉ Feedback
Fehler oder Unstimmigkeit in dieser Doku entdeckt? Schreiben Sie uns: ts@mr-money.de