varinput.php - Referenz – Mr-Money Schnittstellen

varinput.php ist der gemeinsame Einstiegspunkt für alle drei Varianten. Sie schreibt die übermittelten Kundendaten serverseitig in eine Sitzungsdatei und gibt je nach Parametern eine fertige Weiterleitungs-URL oder Sitzungs-IDs zurück.

https://schnittstellen.versicherungsmaklersoftware.de/varinput.php

Aufruf per GET oder POST • Zeichenkodierung: ISO-8859-1 • Übersicht aller drei Varianten: Integrationswege →

⚠ Fehlerfall
Fehlt ein Pflichtparameter (id oder pa) oder ist die Partner-ID unbekannt, gibt varinput.php eine Fehlermeldung als Plain-Text zurück (kein url-Feld). Bei json=true enthält das JSON-Objekt "Status": "Error" und ein "Message"-Feld. Prüfen Sie in Ihrem Code deshalb immer, ob die erwarteten Felder (url, pk, a_id) in der Antwort enthalten sind.

1. Pflichtparameter

Parameter	Name	Beschreibung
`id`	Partner-ID / Makler-ID	8-stellige ID des Maklers bei Mr-Money, z.B. `00200341`. Testmodus: `layout1`
`pa`	Hersteller-ID	Ihre 2–3-buchstabige Kennung als Software-Hersteller (von Mr-Money vergeben). Testmodus: `herstellerx` – liefert dann eine erklärende HTML-Demo-Seite statt den Plain-Text-Response.

2. Allgemeine optionale Parameter

Diese Parameter sind varianten-unabhängig und können bei jeder der drei Varianten gesetzt werden.

Parameter	Beschreibung
`sp`	Sparte (z.B. `PHV`, `HR`, `KFZ`). Wird `sp` weggelassen, landet der Nutzer auf der Spartenauswahl statt direkt im Vergleichsrechner.
`v_id`	Vermittlerkennung – Bezeichner für den einzelnen Nutzer/Vermittler in Ihrem System. Keine Sonderzeichen. Für Endkunden-Portale leer lassen.
`subid`	Eigene Unterkanal-Kennung. Hinweis: Bei Variante 3 setzt das System intern automatisch `subid=portal` – dieser Wert muss nicht manuell gesetzt werden.
`t_id`	Tracking-ID (wird an die Rechner-URL angehängt).
`tt_iD`	Weiterer Tracking-Parameter (wird an die Rechner-URL angehängt). Hinweis: Dieser Wert wird über die Rückgabe-Schnittstelle mit den Antragsdaten wieder zurückgeliefert – kann also als Fremd-ID für die Zuordnung in Ihrem System genutzt werden (Schreibweise beachten: `tt_iD`).
`ur_iD`	Url-Referrer-ID (wird an die Rechner-URL angehängt).
`ma_iD`	Mitarbeiter-ID (wird an die Rechner-URL angehängt).
`einzeltarif`	Schränkt die Rechneranzeige auf einen einzelnen Tarif ein (wird an die Rechner-URL angehängt).
`wgart`	Warengruppen-Art – wird bei der Sparte `WG` benötigt. Wert `feu` schaltet intern auf Feuerversicherung um.
`logoutUrl`	URL, auf die das AngebotsCenter nach dem Logout weiterleitet (nur relevant bei Variante 3).
`redirect=1`	Statt des Text-Response leitet `varinput.php` den Browser direkt auf die erzeugte URL weiter. Bei Variante 3 mit gültigem Token auf `url_mvp`, sonst auf `url`.
`json=true`	Liefert alle Response-Felder als JSON-Objekt statt als Plain-Text (Zeile für Zeile).
`id_extern`	Ihre eigene interne Kunden- oder Vorgangsnummer. Wird im MVP zur Kundenzuordnung/-aktualisierung genutzt und später über die Rückgabe-Schnittstelle wieder zurückgeliefert.
`pk_k`	MVP-interne Kundenkennung. Wenn gesetzt, wird der bestehende MVP-Kundendatensatz direkt referenziert (anstatt über `id_extern` gesucht).
`adr[Name1]` `adr[Strasse]` `adr[PLZOrt]` `adr[email]` etc.	Vermittleranschrift als Array – wird als Textdatei serverseitig gespeichert und bei späteren Antragsaufrufen für die Vermittleranschrift verwendet. Details: Vermittleranschrift →

3. Allgemeine Antragsvariablen

Diese Variablen können bei jedem varinput.php-Aufruf mitgegeben werden.

Bezeichnung	Variable	Mögliche Werte / Hinweis
Kundendaten (`*_k`) – werden zur Vorbefüllung von Antragsformularen genutzt
Anrede	`Anrede_k`	`Herr`, `Frau`, `Firma`
Nachname	`Name_k`	Nachname des Kunden
Vorname	`Vorname_k`	Vorname des Kunden
Firma	`Firma_k`	Firmenname (bei `Anrede_k=Firma`)
Straße	`Strasse_k`	Straße inkl. Hausnummer
PLZ	`PLZ_k`	Postleitzahl
Ort	`Ort_k`	Wohnort
Telefon (privat)	`Tel_privat_k`	Telefonnummer (privat)
Fax	`Fax_k`	Faxnummer
E-Mail	`email_k`	E-Mail-Adresse des Kunden
Geburtsdatum	`Geb_dat_k`	Format `JJJJ-MM-TT` (z.B. `1985-06-15`). Wird intern in `TT.MM.JJJJ` umgewandelt.
Beruf	`Beruf_k`	Beruf des Kunden
Familienstand	`Famstand_k`	`ledig`, `verheiratet`, `zusammenlebend`, `geschieden`, `getrenntlebend`, `verwitwet`
Staatsangehörigkeit	`Staatsang_k`	Liste anzeigen →
IBAN	`IBAN_k`	DE: 22 Zeichen, AT: 20, CH: 21. Wird auf korrekte Länge validiert.
BIC	`BIC_k`	BIC/SWIFT-Code
Bank	`Bank_k`	Name der Bank
BLZ	`BLZ_k`	Bankleitzahl (Legacy)
Kontonummer	`Konto_k`	Kontonummer (Legacy)
Kontoinhaber	`Kontoinhaber_k`	Name des Kontoinhabers, falls abweichend vom Kunden
Kundendaten – Lebenspartner
Anrede Lebenspartner	`Anrede_Lebenspartner_k`	`Herr`, `Frau`
Vorname Lebenspartner	`Vorname_Lebenspartner_k`	Vorname des Lebenspartners
Nachname Lebenspartner	`Nachname_Lebenspartner_k`	Nachname des Lebenspartners
Geburtsdatum Lebenspartner	`Geburtsdatum_Lebenspartner_k`	Format `JJJJ-MM-TT`
Antragsdaten Vorversicherung
Kündigung durch	`Wer_hat_Vorvertrag_gekuendigt`	`kein Vorvertrag`, `Versicherungsnehmer`, `Versicherung`
Antrag abgelehnt	`Antrag_abgelehnt`	`nein`, `ja`
Vorversicherer	`Vorversicherung`	Name des Vorversicherers
Vorversicherungsnummer	`Vorversicherungnummer`	Versicherungsscheinnummer beim Vorversicherer
Beginn Vorversicherung	`Beginn_Vorversicherung`	Format `TT.MM.JJJJ`
Ablauf Vorversicherung	`Ablauf_Vorversicherung`	Format `TT.MM.JJJJ`
Allgemeine Vertragsvariablen
Zahlungsweise	`Zahlungsweise`	`jaehrlich`, `halbjaehrlich`, `vierteljaehrlich`, `monatlich`
Zahlungsart	`Zahlungsart`	`Bankeinzug`, `Rechnung`

PHP – Kundendaten mit allgemeinen Variablen übergeben

<?php
// Alle Felder ISO-8859-1 kodiert uebergeben
$params = http_build_query([
    'id'           => 'IHRE_PARTNER_ID',
    'pa'           => 'IHRE_HERSTELLER_ID',
    'sp'           => 'PHV',
    // Allgemeine Antragsvariablen:
    'Anrede_k'     => 'Herr',
    'Name_k'       => 'Muster',
    'Vorname_k'    => 'Hans',
    'Geb_dat_k'    => '1985-03-15',
    'Famstand_k'   => 'verheiratet',
    'Zahlungsweise'=> 'jaehrlich',
    'Zahlungsart'  => 'Bankeinzug',
    'Staatsang_k'  => 'Deutschland',
]);

$ch = curl_init('https://schnittstellen.versicherungsmaklersoftware.de/varinput.php');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => $params,
]);
$response = curl_exec($ch);
curl_close($ch);
// Rueckgabe: url=... / pk=... / a_id=...
?>

4. Vertragsdaten (`*_v`)

Alle Felder mit dem Suffix _v werden als Vertragsdaten in die Sitzungsdatei geschrieben. Welche Felder hier sinnvoll sind, hängt von der jeweiligen Sparte ab – spartenspezifische Variablen finden Sie unter Variablen je Sparte →

5. Variante-3-Parameter (AngebotsCenter)

Diese Parameter aktivieren zusätzlich das Feld url_mvp im Response. Ohne sie ist url_mvp leer. Details: Variante 3 →

Parameter	Beschreibung
`token`	Option A (empfohlen): Vorab über das MVP-Login-System geholtes Token. Wird direkt übergeben.
`pa_pass`	Option B: Passwort-basierter Tokenabruf. `varinput.php` holt das Token intern selbst, wenn `v_id`, `pa_pass` und `ma_pass` gesetzt sind. Ist nur `pa_pass` gesetzt, wird es als `ma_pass` verwendet.
`ma_pass`

6. Response-Felder

Standard-Response: Plain Text, ein Feld pro Zeile (key=value). Mit json=true als JSON-Objekt.

Feld	JSON-Key	Beschreibung
`url`	`URL`	Fertige Vergleichsrechner-URL für den Nutzer (Variante 1 & 2). Direkt für Redirect verwendbar.
`pk`	`pk`	Sitzungs-ID (IP + Zufallszahl, z.B. `1.2.3.4-12345`). Als `IP_USER` beim Rechenkernaufruf übergeben (Variante 2).
`a_id`	`a_id`	Berechnungs-ID (`pk::pa`, z.B. `1.2.3.4-12345::herstellerx`). Beim Rechenkern und bei der Rückgabe-Schnittstelle benötigt.
`url_mvp`	`URL_MVP`	Direkt-Login-URL ins AngebotsCenter (Variante 3). Nur gefüllt, wenn `token` oder `pa_pass` / `ma_pass` übergeben wurde.

Plain-Text-Response (Standard)

url=https://www.mr-money.de/cookievgl.php?id=IhreID&sp=phv&a_id=1.2.3.4-12345::IHR_PA&...
pk=1.2.3.4-12345
a_id=1.2.3.4-12345::IHR_PA

JSON-Response (json=true)

{
  "Status":  "Success",
  "URL":     "https://www.mr-money.de/cookievgl.php?id=IhreID&sp=phv&a_id=1.2.3.4-12345::IHR_PA&...",
  "URL_MVP": "",
  "pk":      "1.2.3.4-12345",
  "a_id":    "1.2.3.4-12345::IHR_PA"
}

Beispiel-Code

PHP – Minimaler Aufruf (Variante 1)

<?php
$params = http_build_query([
    'id'        => 'IHRE_PARTNER_ID',
    'pa'        => 'IHR_PA',
    'sp'        => 'PHV',
    'json'      => 'true',
    'Name_k'    => 'Mustermann',
    'Vorname_k' => 'Max',
    'Geb_dat_k' => '1985-06-15',
]);

$ch = curl_init('https://schnittstellen.versicherungsmaklersoftware.de/varinput.php?' . $params);
curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

// $response['URL']  -- Rechner-URL fuer den Nutzer
// $response['pk']   -- Sitzungs-ID fuer Rechenkern (Variante 2)
// $response['a_id'] -- Berechnungs-ID fuer Rechenkern und Rueckgabe
?>

varinput.php – Referenz