Rechenkern-Schnittstelle
Direkte URL-Aufrufe aller verfügbaren Sparten
Bevor Sie mit der Integration beginnen, prüfen Sie die aktuellen Änderungen: Rechenkern-Historie öffnen →
Der Rechenkern wird mit Pflichtangaben und optionalen Variablen aufgerufen. Das Ergebnis erhalten Sie als XML oder JSON zurück.
Pflichtparameter: id (Ihre Partner-ID) • IP_USER (echte IP des Nutzers + 5-stellige Zufallszahl, z.B. 123.456.789.012-98765)
Fehlt
id oder IP_USER, liefert der Rechenkern eine leere Antwort oder eine Fehlermeldung im XML.
Prüfen Sie in Ihrem Code deshalb immer, ob die Antwort gültiges XML/JSON enthält und ob Tarife zurückgeliefert wurden,
bevor Sie auf <tarife> zugreifen.
Option A – mit vorherigem varinput.php-Aufruf (empfohlen, wenn Kundendaten im Antrag vorbefüllt werden sollen):
Den
pk-Wert aus der varinput.php-Antwort als IP_USER übergeben.
varinput.php hat diese Kennung intern bereits erzeugt – so erkennen beide Systeme dieselbe Sitzung und der Antrag wird mit den übergebenen Kundendaten vorbefüllt.Option B – direkter Rechenkern-Aufruf ohne varinput.php (wenn keine Kundendaten-Vorbefüllung benötigt wird):
varinput.php muss nicht zwingend vorher aufgerufen werden – nur wenn Kundendaten später im Antrag vorbefüllt werden sollen.
Ohne varinput.php IP_USER selbst bilden: echte IP-Adresse des Nutzers + Bindestrich + 5-stellige Zufallszahl,
z.B. 123.45.67.89-98765 ($_SERVER['REMOTE_ADDR'] . '-' . rand(10000, 99999)).Warum die Zufallszahl? Damit zwei Nutzer hinter derselben IP-Adresse (z.B. in einem Firmennetzwerk) als separate Sitzungen erkannt werden. Ohne die Zufallszahl würden ihre Berechnungen sich gegenseitig überschreiben.
🔗 Alle Integrationswege (inkl. AngebotsCenter-Variante) im Überblick: Integrationswege (Varianten) →
Alle Sparten im Überblick
Privathaftpflicht (PHV)
Eingabe-Parameter für PHV → Leistungsfragen / Variablen →
Tierhalter (TIE)
Eingabe-Parameter für TIE → Leistungsfragen / Variablen →
Hausrat (HR)
Eingabe-Parameter für HR → Leistungsfragen / Variablen →
Rechtsschutz (RS)
Eingabe-Parameter für RS → Leistungsfragen / Variablen →
Unfall (UNF)
Eingabe-Parameter für UNF → Leistungsfragen / Variablen →
Wohngebäude (WG)
Eingabe-Parameter für WG → Leistungsfragen / Variablen →
Haus- & Grundbesitzerhaftpflicht (HUG)
Eingabe-Parameter für HUG → Leistungsfragen / Variablen →
Gewässerschadenhaftpflicht (Öltank) (OEL)
Eingabe-Parameter für OEL → Leistungsfragen / Variablen →
Photovoltaik (PHO)
Eingabe-Parameter für PHO → Leistungsfragen / Variablen →
E-Bike / Fahrrad / Pedelec (FDV)
Eingabe-Parameter für FDV → Leistungsfragen / Variablen →
Hunde-KV (TKV)
Eingabe-Parameter für TKV → Leistungsfragen / Variablen →
Pferde-KV (TKVP)
Eingabe-Parameter für TKVP → Leistungsfragen / Variablen →
Katzen-KV (TKVK)
Eingabe-Parameter für TKVK → Leistungsfragen / Variablen →
Bauherrenhaftpflicht & Bauleistung (BAU)
Eingabe-Parameter für BAU → Leistungsfragen / Variablen →
ja gesetzt werden:
bhh (Bauherrenhaft), bl (Bauleistung), feuerbl (Feuerrohbau kostenpflichtig),
feuer (Feuerrohbau kostenlos bei gleichzeitiger WG-Versicherung).
Rückgabe-Struktur (XML)
Teil 1 – Leistungsfragen
<Frage>– Frage zum Leistungskriterium<Erklaerung>– Hilfstext (bei uns als Tooltip)<Titel>– Wert"T"= Gliederungsüberschrift
Teil 2 – Tarifinformationen
<tarif>– alle Tarif-Ergebnisse und Leistungsaussagen<antrag>– Antragslink;~durch&ersetzen, dann&act=antraganfügen. (Das~-Zeichen dient als URL-sicheres Trennzeichen innerhalb des XML-Feldes, weil ein&dort den XML-Parser verwirren würde. Vor der Verwendung einfach zurücktauschen.)
antrag: ~ durch & ersetzen und &act=antrag anhängen:
Teil 3 – Leistungsaussagen – Auswertung nach Textinhalt:
| Aussage enthält | Bedeutung | Darstellung (Empfehlung) |
|---|---|---|
mitversichert | Leistung vollständig | ✔ Grüner Haken |
nicht mitversichert | Nicht versichert | ✘ Roter Strich |
nicht versicherbar | Nicht versicherbar | ✘ Roter Strich |
* (erstes Zeichen) | Teilweise versichert | ⚫ Halb-Kreis |
Teil 4 – Bedingungen
<F6>Versicherteninformationen •<F7>Versicherungsbedingungen •<F8>Sonstige Informationen<Dok_nr>z.B. 691 – Abruf: https://www.mr-money.de/pool/dokmanager/pdfs/[Dok_nr].pdf<Dokumentenart>z.B. “Allgem. Bedingungen” – Beschreibung des Dokumentes<Dok_Art>Zusatzhinweise zum Dokument (z.B. “gilt nur für Elementar”), meist leer<Dok_kb>Dateigröße in KB (z.B. 67)
🔗 Erweiterte Dokumenten-Abfragen (DokumentenIDs, geänderte Dokumente, Antrags-HASHs): Dokumente & Antrags-HASHs →
Rückgabe-Variablen (Felderklärung)
Erklärung aller Felder, die der Rechenkern je Tarif in der XML-/JSON-Rückgabe liefert:
| XML-Bezeichnung | Inhalt | Erklärung |
|---|---|---|
info |
leer oder TIP-> |
Falls der Tarif vom Rechenkern einen Tipp erhält, wird das hier mitgeliefert. (Die 3 billigsten Tarife die im Admin als TIP gekennzeichnet sind.) |
ges_original |
Originalname der Gesellschaft | Der User kann den Gesellschaftsnamen im Adminbereich umbenennen. Bei abweichendem Namen wird hier der Originalname mitgeliefert. |
tar_punkte |
Numerischer Wert | Für jeden grünen Vollkreis im Leistungsvergleich 2 Punkte, für einen Halbkreis 1 Punkt. Summe wird hier geliefert. |
zw_aufschlag |
Numerisch in Prozent |
Reihenfolge: Jährlich, Halbj., Viertelj., Monatlich (Bsp: 0,3,5,6). Für eigene JavaScript-Zahlweise-Darstellung.
⚠️ ACHTUNG – Reihenfolge ist UMGEKEHRT zu
zw_erlaubt!Dies ist kein Bug, sondern bewusstes Design – aber eine häufige Fehlerquelle! zw_aufschlag [Index]
zw_erlaubt [Index]
0 → Jährlich
0 → Monatlich
1 → Halbjährlich
1 → Vierteljährlich
2 → Vierteljährlich
2 → Halbjährlich
3 → Monatlich
3 → Jährlich
|
zw_erlaubt |
Numerisch |
Reihenfolge: Monatlich, Viertelj., Halbj., Jährlich (Bsp: 0,0,1,1). Welche Zahlweisen der Tarif anbietet.
⚠️ ACHTUNG – Reihenfolge ist UMGEKEHRT zu
zw_aufschlag!Vergleich siehe Tabelle bei zw_aufschlag oben: Index 0 hier = Monatlich, dort = Jährlich.
|
tarifnr |
Numerisch | In jeder Sparte beginnt die kleinste Tarifnummer bei 100. Nicht mehr benötigte Tarifnummern werden nach einiger Zeit durch neue ersetzt. |
tarifnrtemp |
Numerisch | In einem Vergleich können Tarifnummern mehrfach vorkommen (z.B. mit verschiedenen SB). Diese Nummer für die weitere Verarbeitung (Leistungsvergleich, tnr-Parameter) verwenden. |
tipnummern |
Numerisch, Komma-getrennt | Alle Tarifnummern (nicht tarifnrtemp!), die im Adminbereich mit einem TIP versehen wurden. |
ges |
Gesellschaftsname | Name der Gesellschaft (kann im Adminbereich umbenannt werden). |
tar |
Tarifname | Name des Tarifes (kann im Adminbereich umbenannt werden). |
rab |
Rabattfaktor | 1 = kein Rabatt, 0.9 = 10 % Rabatt. |
tar_original |
Originaler Tarifname | Wenn der Tarifname im Adminbereich verändert wurde, wird der Originalname hier mitgeliefert. |
laufzeit |
Laufzeit des Vertrages | Manche Tarife bieten nur 1 Jahr an, auch wenn eine längere Laufzeit gewünscht ist. Diese Laufzeit wird mitgeliefert. |
beitrag |
EUR mit Komma | Brutto-Jahresbeitrag inkl. Versicherungsteuer. |
PZEIT |
Policierungszeit | Freier Text für die Mitteilung der Policierungszeit. |
BSTAB |
Beitragsstabilität | Wird nicht mehr gepflegt, bitte ignorieren. |
URTEIL |
Gesamturteil | Wird nicht mehr gepflegt, bitte ignorieren. |
ZBEM |
Zusätzliche Bemerkung | Wird nicht mehr gepflegt, bitte ignorieren. |
INFT |
Interne Informationen | Info, die nur der Makler sehen darf (z.B. Provisionsschlüssel). |
INFL |
Interne Info zur Leistung | Info für den Makler (z.B. Tarif der HKD aber über bestimmten Pool abgewickelt). |
EINZ |
Einzugsermächtigung | ja/nein – einige Tarife setzen eine Einzugsermächtigung voraus. |
TIP |
Text zum Tipp | Freier Text den der Makler im Adminbereich für jeden Tarif hinterlegen kann. Als Default der Mr-Money Text. |
Beispiel-Code
<?php
// Pflichtparameter zusammenstellen
$params = http_build_query([
'id' => 'IHRE_PARTNER_ID', // 8-stellige Partner-ID von Mr-Money
'subid' => 'IHRE_SUB_ID', // optional, nach Absprache
'laufzeit'=> '1',
'delikt' => 'ja',
'sb' => 'nein',
'IP_USER' => $_SERVER['REMOTE_ADDR'] . '-' . rand(10000, 99999),
]);
$url = 'https://www.mr-money.de/module/kern/phv.php?' . $params;
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 15,
CURLOPT_SSL_VERIFYPEER => true,
]);
$response = curl_exec($ch);
$curlErr = curl_error($ch);
curl_close($ch);
if ($curlErr) {
die('cURL-Fehler: ' . htmlspecialchars($curlErr));
}
// Als XML parsen
$xml = simplexml_load_string($response);
if ($xml === false) {
die('Ungueltige XML-Antwort');
}
// Tarife ausgeben
foreach ($xml->tarife->tarif as $tarif) {
$gesellschaft = (string) $tarif->ges;
$tarifname = (string) $tarif->tar;
$beitrag = (string) $tarif->beitrag;
$antragslink = str_replace('~', '&', (string) $tarif->antrag) . '&act=antrag';
echo $gesellschaft . ' - ' . $tarifname . ': ' . $beitrag . ' EUR<br>';
}
?>
<?php
// JSON-Ausgabe anfordern mit &out=json
$params = http_build_query([
'id' => 'IHRE_PARTNER_ID',
'IP_USER' => $_SERVER['REMOTE_ADDR'] . '-' . rand(10000, 99999),
'laufzeit'=> '1',
'out' => 'json', // <-- JSON statt XML
]);
$ch = curl_init('https://www.mr-money.de/module/kern/phv.php?' . $params);
curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 15]);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
// $data enthaelt nun die Tarifliste als PHP-Array
?>
<?php
// Antragslink aus XML: ~ durch & ersetzen + act=antrag anhaengen
$rawLink = (string) $tarif->antrag; // aus XML
$antragsUrl = 'https://www.mr-money.de/module/steuerung.php?'
. str_replace('~', '&', $rawLink)
. '&act=antrag';
// Direkter Redirect zum Antrag:
header('Location: ' . $antragsUrl);
exit;
?>
Fehler oder Unstimmigkeit in dieser Doku entdeckt? Schreiben Sie uns: ts@mr-money.de