psponline

psp

Bitte warten Sie...

Schnittstellenbeschreibung / Beispiel-Code (PHP)

Einfaches Konsolen-Beispiel: Ticket holen
C:\> curl -H "Content-Type: application/json" -d "{\"mode\":\"getticket\", \"login_array\":{\"mandant\":\"meine_lizenznr\", \"login\":\"mein_loginname\", \"pass\":\"mein_passwort\"}, \"vp_array\":[{\"vp_nr\":0,\"name\":\"M\u00fcller\",\"vorname\":\"Franz\",\"geschlecht\":\"M\",\"geburtsdatum\":\"01.01.1985\"},{\"vp_nr\":1,\"name\":\"M\u00fcller\",\"vorname\":\"Franz\",\"geschlecht\":\"M\",\"geburtsdatum\":\"01.01.1985\",\"versicherungsbeginn\":\"01.01.2021\",\"vollzusatz\":\"V\",\"zielgruppe\":\"N\"}]}" -X POST https://www.psponline.de/webservices/psp_webservice.php oder C:\> curl -H "Content-Type: application/x-www-form-urlencoded" -d "mode=getticket&login_array={\"mandant\":\"meine_lizenznr\", \"login\":\"mein_loginname\", \"pass\":\"mein_passwort\"}&vp_array=[{\"vp_nr\":0,\"name\":\"M\u00fcller\",\"vorname\":\"Franz\",\"geschlecht\":\"M\",\"geburtsdatum\":\"01.01.1985\"},{\"vp_nr\":1,\"name\":\"M\u00fcller\",\"vorname\":\"Franz\",\"geschlecht\":\"M\",\"geburtsdatum\":\"01.01.1985\",\"versicherungsbeginn\":\"01.01.2021\",\"vollzusatz\":\"V\",\"zielgruppe\":\"N\"}]" -X POST https://www.psponline.de/webservices/psp_webservice.php

Ticket holen

// 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',
	);

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

// VP-Daten - VP 1,2,...
	$vp_array[]		= array(
		'vp_nr'			=> 1,
		'name'			=> 'Mustermann',
		'vorname'		=> 'Mini',
		'geschlecht'		=> 'F',				/* M=Mann, F=Frau */
		'geburtsdatum'		=> '25.05.2002',
		'versicherungsbeginn'	=> '01.05.2015',
		'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',
		// Beispiel für Vergleich Zahnzusatztarife (siehe "Erfassungsfelder")
	);

// Request
	$request_array	= array(
		'mode'		=> 'getticket',
		'login_array'	=> json_encode($login_array),
		'vp_array'	=> json_encode($vp_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 jetzt lokal gespeichert werden, um später
	//	- das Angebot über o.g. url erneut aufzurufen oder
	//	- Berechnungsergebnisse abzuholen (über mode='getticketresult', s.u.)
	// ....

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

Berechnungsergebnis / Angebotsdokumente holen

// Request
	$request_array	= array(
			'mode'			=> 'getticketresult',
			'token'			=> '11a9f391654ed3f8e797de6ee5445bcc',
			'angebot_id'		=> '',	// 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)

// Dokumente 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,
		'art'		=> 'rz',
		'name'		=> 'RZ Brille',
		'beitrag'	=> '45.28',
	);
	$risiko_array[]		= array(
		'vorschlag_nr'	=> 2,
		'art'		=> 'la',
		'name'		=> 'LA 2 fehlende Zähne',
		'beitrag'	=> '',
	);
	...

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

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

// Request
	$request_array	= array(
		'mode'			=> 'setticketvalues',
		'token'			=> '11a9f391654ed3f8e797de6ee5445bcc',
		'angebot_id'		=> '',	// 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 ...'