Parameter für Remote-Integrationen (Deeplinking)

Um Einfluss auf die Ergebnisse innerhalb einer Integration nehmen zu können, haben Sie die Möglichkeit, mit Hilfe von Parametern die Ergebnisse einzuschränken oder den Einstiegspunkt (bspw. in der Buchungsstrecke) selbst festlegen zu können. 

Wie kann man Parameter übergeben?

Je nach Einsatzzweck gibt es zwei Möglichkeiten, die Parameter zu übergeben:

1. Parameter im Script-Aufruf übergeben

Möchten Sie spezielle Integrationen vorfiltern oder vorselektieren, so können Sie das JavaScript-Snippet Ihrer Integration anpassen.

Beispiel:

<div id="vri-container-123"></div>
<script type="text/javascript" charset="UTF-8">
	( function( v, i, o, m, a ){
		if ( !( o in v ) ) {
			v.vioma_vri=o;
			v[o] || ( v[o] = function( ){ ( v[o].q = v[o].q || [] ).push( arguments ); } );
			m = i.createElement( 'script' ), a = i.scripts[0];
			m.src = 'https://cst-client-hotel-blaue-linde.viomassl.com/js/vri/vri.js';
			a.parentNode.insertBefore( m, a );
		}
	} )( window, document, 'vcst' );
	vcst( {load: 'init', url: 'https://cst-client-hotel-blaue-linde.viomassl.com/', set_language: 'de'} );
	vcst( {'id': 123} );
</script>

Um bei obigen Beispiel Parameter mit zu übergeben, können Sie (in Zeile 13) nach der ID, das Object erweitern und weitere Parameter übergeben. Hierbei ist zu beachten, dass die einzelnen Parameter kommasepariert und die Werte im Stil name:wert übergeben werden. Bitte achten Sie auch darauf, ob die Werte als String oder Integer übergeben werden müssen. Arrays werden als String übergeben. 

vcst( {'id': 123,'calendar_date_from':'2015-07-20','calendar_stays':14,'persons_adults':3,'package':12345} );

2. Parameter als GET-Parameter in der URL mit übergeben

Bei der Übergabe der Parameter in der URL, hängt es zusätzlich davon ab, welche Seite Sie aufrufen. Je nach Integration sind es folgende Seiten:

Buchungsstrecke

vsc.php

Pauschalenliste

package-list.php

Zimmerliste

hotel-room-list.php

Programmliste

hotel-program-list.php

Die Parameter können dann im bekannten GET-Parameter-Stil übergeben werden:

http://www.hotel_domain/hotel_seite.html#/vsc.php?calendar_date_from=2015-07-20&calendar_stays=14&persons_adults=3&package=12345

Globale Parameter

Bei allen Integrationen können Sie die gewünschte Sprache mit übergeben. 

set_language

Parameter für die Buchungsstrecke

Für die Buchungsstrecke existieren folgende Parameter, die Sie übergeben können:

Kalender

calendar_date_from

calendar_date_to

calendar_stays

Es macht Sinn, "calendar_dates_to" oder "calendar_stays" zu verwenden. Beide Parameter anzugeben, ist überflüssig.

Personen

persons_adults

persons_children

persons_children_ages

Zimmer

items[]

Programme

items[]

Pauschalen

package

package_variant

Beispiel 1

Deeplink vom 05.01.2016 bis 07.01.2016, 3 Erwachsene und 3 Kinder im Alter 1, 4 und 7 mit automatischer Zimmerverteilung:      

http://www.hotel_domain/hotel_seite.html#/vsc.php?calendar_date_from=2016-01-05&calendar_date_to=2016-01-07&persons_adults=3&persons_children_ages=1,4,7

Analog dazu das Snippet:

<div id="vri-container-123"></div>
<script type="text/javascript" charset="UTF-8">
	( function( v, i, o, m, a ){
		if ( !( o in v ) ) {
			v.vioma_vri=o;
			v[o] || ( v[o] = function( ){ ( v[o].q = v[o].q || [] ).push( arguments ); } );
			m = i.createElement( 'script' ), a = i.scripts[0];
			m.src = 'https://cst-client-hotel-blaue-linde.viomassl.com/js/vri/vri.js';
			a.parentNode.insertBefore ( m, a );
		}
	} )( window, document, 'vcst' );
	vcst( {load: 'init', url: 'https://cst-client-hotel-blaue-linde.viomassl.com/', set_language: 'de'} );
	vcst( {
		'id':123, 
		'calendar_date_from':'2016-01-05', 
		'calendar_date_to':'2016-01-07',
		'persons_adults':3,
		'persons_children_ages':'1,4,7'
	} );
</script>

Beispiel 2

Deeplink bei Anreise am 05.01.2016 mit 2 Übernachtungen, 1 Zimmer mit 1 Erwachsenen im Einzelzimmer mit ID 11111 und Pension ID 2222, 1 Zimmer mit 2 Erwachsene und 2 Kinder im alter 4 und 7, 3x das Programm mit ID 12345:

http://www.hotel_domain/hotel_seite.html#/vsc.php?calendar_date_from=2016-01-05&calendar_stays=2&items[]=hrt:11111:2222:1&items[]=hrt:::2:4,7&items[]=hp:12345:3

Analog dazu das Snippet:

<div id="vri-container-123"></div>
<script type="text/javascript" charset="UTF-8">
	( function( v, i, o, m, a ){
		if ( !( o in v ) ) {
			v.vioma_vri=o;
			v[o] || ( v[o] = function( ){ ( v[o].q = v[o].q || [] ).push( arguments ); } );
			m = i.createElement( 'script' ), a = i.scripts[0];
			m.src = 'https://cst-client-hotel-blaue-linde.viomassl.com/js/vri/vri.js';
			a.parentNode.insertBefore ( m, a );
		}
	} )( window, document, 'vcst' );
	vcst( {load: 'init', url: 'https://cst-client-hotel-blaue-linde.viomassl.com/', set_language: 'de'} );
	vcst( {	
		'id': 123, 
		'calendar_date_from':'2016-01-05', 
		'calendar_stays':2,
		'items[0]':'hrt:11111:2222:1',
		'items[1]':'hrt:::2:4,7',
		'items[2]':'hp:12345:3'
	} );
</script>

Parameter für Listen (Zimmerliste, Pauschalenliste etc.)

Für die Integrationen, die Listen enthalten, gibt es ebenfalls Parameter. Diese sind bereits in den Einstellungen hinterlegt:

Zimmerlistenparameter

Pauschalenlistenparameter

Programmlistenparameter

Parameter der Restplatzbörse

Die Anleitung zur Konfiguration der Restplatzbörse finden Sie hier