psponline

Schnittstellenbeschreibung / Beispiel-Code (PHP)

Einfache Konsolen-Beispiele:

SingleSignOn (json)

SingleSignOn + Daten vorbelegen (json)

Als Response erhälst du jeweils das token und den Link zum anschließenden Sprung in psponline, welcher 60 Sekunden gültig ist.
Für mehr Details wende dich an unseren Support.

SingleSignOn

// Logindaten - Zugangsdaten des Users (falls eine Autorisierung bereits über das MVP erfolgt ist, kann auch ein zentrales Hauptlizenz-Masterpasswort benutzt werden, welche Sie auf Anfrage erhalten)
$login_array	= array(
	'mandant'	=> 'meine_lizenznr',
	'login'		=> 'mein_loginname',
	'pass'		=> 'mein_passwort',
);

// Request
$request_array	= array(
	'mode'			=> 'getticket',
	'login_array'	=> json_encode($login_array),
);

// Webservice via curl
$curl = curl_init('https://www.psponline.de/webservices/psp_webservice.php');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, $request_array);
$response_json	= curl_exec($curl);
curl_close($curl);

// Response
$response_array	= json_decode($response_json, true);

$status	= $response_array['status'];	// 'ok' oder 'error ...'
$token	= $response_array['token'];	// z.B. '11a9f391654ed3f8e797de6ee5445bcc'
$url	= $response_array['url'];		// z.B. 'https://www.psponline.de/erfassung_angebot.php?token=11a9f391654ed3f8e797de6ee5445bcc'

// token kann lokal gespeichert werden, um später
//	- Berechnungsergebnisse abzuholen oder
//	- Werte zu übertragen oder
//	- das Angebot erneut aufzurufen

// psponline innerhalb 60 Sekunden aufrufen:
header("Location: " . $url);

SingleSignOn + Daten vorbelegen

// Kunden-Daten - VP 0 (siehe "Erfassungsfelder")
// optional, wenn nicht bestückt, werden die Daten der 1.VP als Kundendaten übernommen
$vp_array[]		= array(
	'vp_nr'				=> '0',
	'name'				=> 'Müller',
	'vorname'			=> 'Franz',
	'geschlecht'		=> 'M',					/* M=Mann, F=Frau */
	'geburtsdatum'	=> '01.06.1995',
);

// VP-Daten - VP 1,2,... (siehe "Erfassungsfelder")
// Beispiel für Vergleich Zahnzusatztarife
$vp_array[]		= array(
	'vp_nr'				=> '1',
	'name'				=> 'Müller',
	'vorname'			=> 'Franz',
	'geschlecht'		=> 'M',				/* M=Mann, F=Frau */
	'geburtsdatum'		=> '01.06.1995',
	'versicherungsbeginn'	=> '01.06.2025',
	'vollzusatz'			=> 'Z',				/* V=Vollversicherungstarife, Z=Zusatzversicherungstarife */
	'zielgruppe'		=> 'N',				/* N=Normalversichert, M=Mediziner, B=Beamter, A=Beamtenanwärter, U=Ausbildung */
	'berufsstatus'		=> 'A',				/* A=Angestellt, S=Selbständig, F=Freiberuflich, O=nicht berufstätig */
	'knz_zahn'			=> '1',
	'proz_zahnbehandlung'	=> '0',
	'proz_zahnersatz'	=> '50',
	'proz_kfo'			=> '0',
    'gesundheitsfragen' => '{"bmi_cm":"182", "bmi_kg":"80"}',
);

// Request
$request_array	= array(
	'mode'			=> 'getticket',
	'login_array'	=> json_encode($login_array),
	'vp_array'		=> json_encode($vp_array),
);

// Response
$response_array	= json_decode($response_json, true);

// token kann lokal gespeichert werden, um später
//	- Berechnungsergebnisse abzuholen oder
//	- Werte zu übertragen oder
//	- das Angebot erneut aufzurufen

// psponline innerhalb 60 Sekunden aufrufen:
header("Location: " . $url);

Angebotsdaten abrufen

// Request
$request_array	= array(
		'mode'			=> 'getticketresult',
		'token'			=> '11a9f391654ed3f8e797de6ee5445bcc',		// token des Angebotes, max. 24 Std. nach letzter Angebotsspeicherung gültig
		'angebot_nr'	=> '1',		// optional, '' =  das letzte zum Ticket gespeicherte Angebot
		'dokumentart_id_list'	=> '',	// optional, '' oder '1,2,3,4,5,6,7' liefert alle Dokumentarten, z.B. '2' liefert alle Anträge
);

// Response
$response_array	= json_decode($response_json, true);

$status		= $response_array['status'];		// 'ok' oder 'error ...'
$dokument_array	= $response_array['dokument_array'];	// Array mit Dokumentdaten
							// 'datei'			=> xml, json oder base64-codiertes pdf,
							// 'bezeichnung'	=> Dokumentname,
							// 'typ'				=> 'xml', 'json' oder 'pdf',
							// 'dokumentart_id'	=> 0: Angebotsdaten (xml, json), 1: Angebot, 2: Antrag, 3: Produktinformationsblatt, 4: Tarifunterlagen, 5: Empfangsbestätigung, 6: E-Mail, 7: Weitere Unterlagen (pdf)
							// 'dokumentart'	=> s.o.
							// 'knz_signiert'	=> S: fertig unterschrieben
							// 'dokument_id'	=> eindeutige Dokument-ID
							// 'timestamp'		=> Erzeugungs-Timestamp (JJJJ-MM-TT hh:mm:ss)

// Angebotsdaten (xml, json) können nun gespeichert und weiterverarbeitet werden, z.B. für eine Risikovoranfrage
// Dokumente (pdf) können nun gespeichert oder als Links zur Verfügung gestellt werden

Werte übertragen

// Werte in ein bestehendes Angebot übertragen, z.B. Risikozuschlag oder Leistungsausschluss zu einem Angebot / VP / Vorschlag 
$risiko_array[]		= array(
	'vorschlag_nr'	=> '1',         // Nr des Tarifangebots (beginnend bei 1, siehe Spalten im Leistungsvergleich)
	'art'			=> 'rz',
	'name'			=> 'RZ Brille',
	'beitrag'		=> '45.28',
	'tarif_id'		=> '16362',		// optional RZ auf bestimmten Tarif, ansonsten gilt RZ insgesamt
);
$risiko_array[]		= array(
	'vorschlag_nr'	=> '2',
	'art'			=> 'la',
	'name'			=> 'LA 2 fehlende Zähne',
);
...

// optional Kunden-Daten (VP 0) ändern 
$vp_array[]		= array(
	'vp_nr'			=> '0',
	'telefon'		=> '0888-12345678',
	'beruf'			=> 'Postbote',
);

// VP-Daten (VP 1,2,...) ändern
$vp_array[]		= array(
	'vp_nr'			=> '1',
	'risiko_array'	=> $risiko_array,
);

// Request
$request_array	= array(
	'mode'			=> 'setticketvalues',
	'token'			=> '11a9f391654ed3f8e797de6ee5445bcc',		// token des Angebotes, max. 24 Std. nach letzter Angebotsspeicherung gültig
	'angebot_nr'	=> '1',		// optional, '' = das letzte zum Ticket gespeicherte Angebot
	'vp_array'		=> json_encode($vp_array),
);

// Response
$response_array	= json_decode($response_json, true);

$status	= $response_array['status'];	// 'ok' oder 'error ...'

Angebot erneut öffnen

// Request
$request_array	= array(
	'mode'			=> 'getticket',
	'login_array'	=> json_encode($login_array),
	'token'			=> '11a9f391654ed3f8e797de6ee5445bcc',		// token des zu öffnenden Angebotes
	'angebot_nr'	=> '1',		// optional, '' =  das letzte zum Ticket gespeicherte Angebot
);

// Response
$response_array	= json_decode($response_json, true);

$status	= $response_array['status'];	// 'ok' oder 'error ...'
$token	= $response_array['token'];	// z.B. '5cff74fbf54b58f9fe422395f0ab5a7f'		// neues token, nur für SSO, keine Speicherung notwendig
$url	= $response_array['url'];		// z.B. 'https://www.psponline.de/erfassung_angebot.php?token=5cff74fbf54b58f9fe422395f0ab5a7f'

// psponline innerhalb 60 Sekunden aufrufen:
header("Location: " . $url);