Mr-Vers Verwaltung

Rückhabewerte Schnittstellenbeschreibung von Mr-Money.de Vergleichsrechner

Interner Projektname für Rückfragen: Herstellerschnittstelle über a_id (Rückgabewerte)
Ansprechpartner: Herr Natschke 037296-927390 post@mr-money.de
Nachdem Sie die Berechnungsvorgaben aus Ihrem Programm in unsere Rechner übergeben haben, erhalten Sie eine BerechnungsID ($a_id). Über diese ID können Sie die erstellten Angebote oder Anträge zurück erhalten.

Mitgabe einer FremdID:

Sie können eine Variable Namens: $tt_iD (Schreibweise beachten) befüllen und mitgeben. Diesen Inhalt bekommen Sie dann mit den Antragsdaten wieder zurück.

Beispiel:

1. Sie übergeben die Berechnungsvorgaben wie unter https://schnittstellen.versicherungsmaklersoftware.de beschrieben und erhalten eine a_id zurück.
Bsp: https://schnittstellen.versicherungsmaklersoftware.de/varinput.php?id=layout1&pa=herstellerx&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&sp=PHV

Dann berechnen Sie, bzw der Nutzer ein Ergebnis und erstellen über den Link im Berechnungsergebnis ein pdf Angebot.
Nach der Erstellung des pdfs Angebotes rufen Sie aus Ihrem Programm auf:

https://portal.makler-bund.de/?modul=extern&action=hersteller&id=$id&a_id=$a_id&sel=pdf&output=json auf
$id ist dabei die ID des Users, die er bei der Anmeldung von uns bekommt, oder im Testmodus layout1
$a_id aus der o.g. Rückgabe nach dem Berechnungsaufruf, Bsp: 111.222.333.444-80345::herstellerx
Ein kompletter Aufruf könnte so aussehen: https://portal.makler-bund.de/?modul=extern&action=hersteller&id=layout1&a_id=111.222.333.444-80345::herstellerx&sel=pdf&output=json (den Wert der a_id müssen Sie aber unbedingt aus der Rückgabe nutzen)

Als Rückgabe erhalten Sie je Zeile einen Angebotslink nach dem Format: Angebot_[Sparte]=http://www.mr-money.de/....pdf

2. Falls ein Antrag gestellt wurde, können Sie die Antragsdaten und den Original Antrag incl. Beratungsprotokoll zurück erhalten
Das geschieht mit dem Aufruf wie oben nur mit fehlenden Parameter sel=pdf
Als Rückgabe erhalten Sie alle wichtigen Antragsdaten durch Zeilenumbrüche getrennt (z.B. Beitrag_netto=123.44) usw.
Den Antrag können Sie mit dem Link in Zeile 1 abholen.
--- neue Paramater --- ab 21.06.2012
Antrag als Link, aber im PDF-Format:
&antrag=pdfLink

Antrag als PDF oder HTML aber inline:
&antrag=pdfInline bzw. &antrag=htmlInline
Das Inline-PDF ist mit base64 kodiert, HTML ist im Klartext enthalten.

Ausgabe als JSON:
&output=json
Bei Bedarf können wir die Rückgabeschnittstelle beliebig erweitern. Auch ist es möglich die Eingaben des Maklers bei der Berechnungen abzuspeichern und Ihnen zu übertragen. So könnte der Makler später diese Angebote wieder aufrufen bzw. eine neue Berechnung durchführen.

Praktische Hinweise

Bauen Sie zunächst eine funktionierende Schnittstelle IN unsere Rechner. Erst wenn diese funktioniert können Sie die Rückgabe testen. Diese Schnittstelle ist nur ein Vorschlag und kann bei Bedarf angepaßt werden. Wir helfen Ihnen gern bei der Umsetzung.

Beachten Sie bitte, daß diese Schnittstelle nur richtig funktioniert, wenn Sie die $id des Maklers, Ihre HerstellerID und die korrekte BerechnungsID ($a_id) benutzen