Service Webinterface

Internet
K. von Döhlen
06.11.2014
Service Webinterface
Inhaltsverzeichnis
Bookinginterface ....................................................................................................................... 2
Übersicht der Parameter ................................................................................................................... 2
XML-Ausgabe .................................................................................................................................... 5
Formulierte Fehlermeldung .............................................................................................................. 6
Preis und Vakanzanfrage „on the fly“ ..................................................................................... 8
Testschnittstelle ......................................................................................................................... 8
1/8

Internet
K. von Döhlen
06.11.2014
Bookinginterface
Die Buchungsschnittstelle zum Buchungsserver von Wolters Reisen empfängt Anfragen an den Internetserver via CGI (PHP). Alle buchungsrelevanten Daten werden
hierzu an das Script „xml_booking.php“ übergeben und geprüft. Das Ergebnis der Prüfung wird im XML-Format an den Client zurückgegeben. Die einzelnen Schritte
des Buchungsprozesses werden im folgendem erläutert.
Übersicht der Parameter
Folgende Parameter werden an https://www.tui-ferienhaus.de/xml_booking.php? übergeben:
Kursiv:
Nicht kursiv:
optional
notwendig
Parameter VALUES EXAMPLE CONTENT Note
objekt_nr WEJ04035 object id (house)
category_id up to 5 characters AYYYP category-ID
dummya 5-character 12345 Valid agency
dummyc up to 3 characters B, CRO, CZ, D, DK, E, EI, country for vacation
FIN, F, GB …
datum_kz 07.12.2007 Vacation date Um eine reibungslose
Buchungsabwicklung zu
gewährleisten, sollen zwischen dem
Buchungsdatum und dem Tag der
Anreise mindestens 5 Tage liegen.
duration Mögliche Werte 3-21
(Tage)
zub[]
7 Vacation duration Tage
zub[]=ALG01001_B_3&zub[]=
ALG01002_H_1&zub[]=ALG0
1001_Q_1
Code of additional service
insurance “rrv1” – rrv2” – “no” insurance rrv1: Versicherung ohne Selbstbehalt
rrv2: Versicherung mit Selbstbehalt
no: keine Versicherung
pet ‘“yes” – “no” –“2” – “3” Anzahl

Internet
K. von Döhlen
06.11.2014
ist.
travel_conditions “yes” – “no” acception of travel conditions
Customer
pers_kz 4 Number of persons Gesamtanzahl Reisende inkl. der
Anzahl der Kinder.
kind_kz 2 Number of childs (0-14 years) Die Altersbegrenzung für Kinder ist
bis einschließlich dreizehn Jahre. Ab
dem 14. Lebensjahr zählt das Kind als
Erwachsener!
dummys D or NL or GB or F Customer Language Übermittelt die Sprache, in der das
Booklet gedruckt wird.
anrede H, F Customer salutation
titel Dr. Customer title
vorname Hans Customer first name
nachname Mustermann Customer surname
strasse Lange Strasse 56 Customer street
plz 23567 Customer postcode
ort Musterstadt Customer city
land DE Customer country Ländercodes nach ISO 3166
email Hans.mustermann@gmx.de Customer email
tel_office 0049 (0) 421 12345 Customer phone (during the day)
tel_private 04242 – 2 34 56 Customer phone (at end of day)
tel_mobile 0172 – 1 23 45 67 Customer phone (mobile)
mitteilung [...] remarks
Payment
payment
CreditCard
sepadebit
Invoice
AgencyCollection
Type of payment
CreditCard: zusätzlich fällt eine
Gebühr von 1% des Reisepreises an
sepadebit: Zahlart SEPA-Lastschrift
Invoice: Die Zahlart „Rechnung“ hat
nur dann Gültigkeit, wenn das
Reisedatum mindestens 8 Wochen
nach dem Buchungsdatum liegt. Für
die Bearbeitung fällt eine Gebühr in
Höhe von € 10,- an
AgencyCollection: falls keine Zahlart
3/8

Internet
K. von Döhlen
06.11.2014
übermittelt werden soll
Sepadebit
iban
iban-code
bic_swift
bic/swift-code
bank Bankname Optional
kto_fn
Kontoinhaber Vorname
kto_ln
Kontoinhaber Nachname
CreditCard
cc_name
VI
MC
type of creditcard
VI = Visa
MC = Master
cc_nr Original: 4111111111111111 valid Number of creditcard
Maskiert:
411111AVEWWO1111
cc_date
cc_date=2013-08
Expiration date of creditcard
YYYY-MM
cc_fn Hans Owner of Creditcard, Firstname
cc_ln Mustermann Owner of Creditcard, Lastname
Darf nicht in Klartext übermittelt
werden.
Zum Maskieren der Nummer muss
der WebTokenizer verwendet werden(
siehe Doku
WebTokenizer_Schnittstelle_v15.pdf )
4/8

Internet
K. von Döhlen
06.11.2014
Beispiel eines Aufrufs:
http://www.tuiferienhaus.de/xml_booking.php?objekt_nr=UBS99001&category_id=F&dummys=D&dummyc=D&datu
m_kz=08.12.2012&duration=14&pers_kz=2&kind_kz=0&anrede=H&vorname=test&nachname=TEST
XXX&strasse=abc14&plz=28816&ort=Stuhr&land=NL&email=abc@123abc.de&tel_office=0421209&in
surance=no&travel_conditions=yes&dummya=99998&payment=Invoice&mitteilung=testbuchung
mit additional service (ZUB):
http://ferienhaus.t3d.wolters.tng.de/xml_booking.php?objekt_nr=DOS05114&category_id=F&dummya
=99998&dummyc=D&datum_kz=01.12.2012&duration=7&pers_kz=2&kind_kz=1&dummys=NL&anred
e=H&titel=&vorname=kai&nachname=TESTXXX&strasse=Teststr1&plz=12345&ort=Bremen&land=NL
&email=kai.von.doehlen@wolters.tui.de&tel_office=0515-12345&tel_private=0515-
12345&tel_mobile=&mitteilung=&kto=&blz=&bank=&payment=Invoice&cc_name=&cc_nr=&cc_fn=&cc
_ln=&cc_date=&insurance=no&pet=yes&travel_conditions=yes&zub[]=DOS05114_B_2&zub[]=DOS0
5114_T_1
XML-Ausgabe
Buchung erfolgreich - Buchungsstatus OK
99998
D
fh
915090
OK
610
0
OK
Buchung nicht erfolgreich - Buchungsstatus Fail
99998
D
fh
Keine
Fail
0.00
AKONT_NO_FREE_KONTINGENT
Das Kontingent ist ausgebucht oder reicht nicht aus
systemdown
Lautet der Inhalt des Elements „akont_no_free_kontingent“ oder „not_vakant“, ist
das Objekt zu diesem Zeitraum ausgebucht. In jedem anderen Falle für buchungsstatus=FAIL, wird
die Buchung manuell erzeugt und die Service-Abteilung von TUI Wolters setzt sich ggf. mit dem
Kunden in Verbindung.
5/8

Internet
K. von Döhlen
06.11.2014
Anmerkungen zum „systemdown“:
Buchungsserver antwortet nicht. In diesem Falle wird das Service-Center über den Buchungsversuch
informiert, so dass der Buchungswunsch manuell verarbeitet wird.
Der Inhalt „systemdown“ wird in jedem Fall ausgegeben, wenn ein Fehler aufgetreten ist.
Weitere Bedingungen für eine erfolgreiche Buchung:
"OK", wenn Vorgangsnummer angelegt wurde
"Fail", wenn keine Vorgangnummer angelegt werden konnte
"OK", wenn eine Vorgangsnummer angelegt wurde und ein ausreichendes Kontingent
vorhanden ist.
"OnRequest", wenn eine Vorgangsnummer angelegt wurde, aber kein ausreichendes
Kontingent vorhanden ist
"systemdown", wenn der Ocean-Server nicht angesprochen wurde (z.B. wegen eines connecterrors)
oder irgendein Fehler aufgetreten ist
Bitte geben Sie immer nur dann eine positive Meldung an den Kunden (inkl. Vorgangnummer), wenn
und den Inhalt "OK" haben. In allen anderen Fällen geben Sie bitte
keine positive Meldung aus, sondern, dass man sich mit dem Kunden in Verbindung setzen wird.
Ausnahme: enthält "AKONT_NO_FREE_KONTINGENT" oder "not_vakant" (beides
teilqualifiziert) --> dann sollte der Kunde schon erkennen, dass das Objekt ausgebucht ist.
Formulierte Fehlermeldung
Wenn Werte fehlen oder fehlerhaft sind wird eine formulierte Fehlermeldung erzeugt. Es kommt zu
keiner Buchung!
Beispiel:
UBS99001
F
08.12.2012
7
2
0
H
test
TESTXXX
abc14
28816
Stuhr
NL
abc123@abc.de
0421209
Invoicee
yes
no
6/8

Internet
K. von Döhlen
06.11.2014
Please check your payment data
7/8

Internet
K. von Döhlen
06.11.2014
Preis und Vakanzanfrage „on the fly“
Wir bieten Ihnen die Möglichkeit zu genau einem Termin den Preis und die Verfügbarkeit direkt gegen
unsere Datenbank anzufragen. Damit können Sie vor Buchungsabschluß nochmals den aktuellen
Status eines Termins prüfen.
Der Aufruf mit den Parametern erfolgt über ein Script:
http://www.tui-ferienhaus.de/agent_xml_export.php?price&datum_kz=yyyy-mm-dd&duration=&
obj_cat[]=-
Beispiel:
http://www.tui-ferienhaus.de/agent_xml_export.php?price&datum_kz=2014-03-
15&duration=7&obj_cat[]=DOS05041-CYYYO
Ohne categoryID werden die Preise und Vakanzen zu allen Typen des Objektes geliefert.
Beispiel:
http://www.tui-ferienhaus.de/agent_xml_export.php?price&datum_kz=2014-03-
15&duration=7&obj_cat[]=DOS05041
Parameter
price
datum_kz
duration
obj_cat[]
Note
Wird der Parameter nicht übergeben, erfolgt
der XML-Aufruf ohne Preis.
Anreisetag
Anzahl Reisetage
Mögliche Werte sind 3-21 Tage
Übergeben werden hier die zwei Elemente
objektID und categoryID (stammdaten.xml)
Hinweis: Dieses Script sollte ausschließlich für Einzelanfragen verwendet werden und nicht für
Massenanfragen, da es sonst zu erheblichen Performanceproblem kommen kann.
Testschnittstelle
Als Testschnittstelle steht http://ferienhaus.t3d.wolters.tng.de/xml_booking.php zur Verfügung. Alle an
dieses Script gesendeten Parameter werden an das Test Reservierungssystem geleitet.
Möglichkeiten der Nutzung eines Testsystems für die Testphase der Buchungen:
Im Internet kann ein Testsystem genutzt werden, indem der Aufruf nicht an die Domain www.tuiferienhaus.de
sondern an die Domain http://ferienhaus.t3d.wolters.tng.de (dann jedoch nicht SSLverschlüsselt)
erfolgt. Alle versendeten Emails werden dann mit dem Hinweis „Testbuchung“
versehen.
Folgende Emails werden automatisch sowohl aus dem Testsystem als auch aus dem Echt-System
versendet:
Agentur-Email, die den Partner über die Buchung einer Unterkunft von Wolters Reisen
informiert.
Außerdem erhält Wolters Reisen zwei Emails, die über den Vorgang informieren.
TUI Wolters versendet in der Testumgebung KEINE Buchungsmails an den Kunden!
8/8