User Tools

Site Tools


booking:bookingstatus

Checking the status of reservation

The action (function) bookingstatus returns the current status of reservation.

Sample inquiry:

<?xml version='1.0'?>
<mds>
  <auth>
    <login>LOGIN</login>
    <pass>PASSWORD</pass>
  </auth>
  <request>
    <type>bookingstatus</type>
    <conditions>
      <ofr_tourOp>GREC</ofr_tourOp>
      <booking_nr>976272</booking_nr>
      <booking_info>1</booking_info>
    </conditions>
  </request>
</mds>
FieldRequiredDescription
ofr_tourOp yes booking number from Tour-operator
booking_nr yes reservation number
expedient_code no1) agent (clerk) code 4-character
multifunction no2) Content of the multi-function-line
booking_info no If given and equal to “1”, it will download additional information about the book - the equivalent of BI shares on the hood of all parties including download information from the Tour-operator.
NOTE: query response time is significantly longer.
Available from version 2.2

Response example:

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
	<result_message msgType="52" msgCode="205"/>
	<booking_status>XX</booking_status>
	<pricetotal price="0" curr="PLN"/>
	<booking_info_services>
		<service>
			<kindOfService>F</kindOfService>
			<service>WAWZTH ZTHKTW</service>
			<accommodation></accommodation>
			<occupancy></occupancy>
			<numberOfServices>2</numberOfServices>
			<fromDate>280912</fromDate>
			<endDateOrDuration>051012</endDateOrDuration>
			<travellerAllocation></travellerAllocation>
			<servicePrice>0</servicePrice>
		</service>
		<service>
			<kindOfService>H</kindOfService>
			<service>ZTHPLAN</service>
			<accommodation>ST2H</accommodation>
			<occupancy></occupancy>
			<numberOfServices>1</numberOfServices>
			<fromDate>280912</fromDate>
			<endDateOrDuration>051012</endDateOrDuration>
			<travellerAllocation></travellerAllocation>
			<servicePrice>0</servicePrice>
		</service>
	</booking_info_services>
	<booking_info>
		<page num="1">
			<line><![CDATA[ Opcja nr: 976272   do:         19.09.12/9:44 Katalog : L088 / Storno : 18.09.12]]></line>
			<line><![CDATA[ Status: S                                                                      ]]></line>
			<line><![CDATA[ Lp Typ Opis     Od    28.09.12 do   05.10.12                           Cena    ]]></line>
			<line><![CDATA[+--+--+--------+------------------------------------------------------+--------+]]></line>
			<line><![CDATA[  1 F  Tam:     NR:ENT  Wyl:WAW 28.09.12/06:20 PrzyZTH 28.09.12/10:00        XX ]]></line>
			<line><![CDATA[  1 F  Powrot:  NR:ENT  Wyl:ZTH 05.10.12/11:25 PrzyKTW 05.10.12/12:40        XX ]]></line>
			<line><![CDATA[  2 H  Nazwa:   Hotel Planos Beach / Grecja                                     ]]></line>
			<line><![CDATA[  2 H  Pokoj:   Studio 2 os / H sniadania i obiadokolacje                    XX ]]></line>
			<line><![CDATA[  3 S  OPLATALO Oplata lotniskowa ZTH                                        XX ]]></line>
			<line><![CDATA[  4 S  OPLLOKZT Oplata za wylot z lotniska lokalnego - Warszawa              XX ]]></line>
			<line><![CDATA[  5 S  TRZTHLO- Transfer na Zakynthos lotnisko-hotel                         XX ]]></line>
			<line><![CDATA[  6 S  TRZTHHL- Transfer na Zakynthos hotel-lotnisko                         XX ]]></line>
			<line><![CDATA[  7 A  KUBEZP   Ubezpieczenie wliczone w cene                                XX ]]></line>
		</page>
		<page num="2">
			<line><![CDATA[  8 V  UBEZP    Ubezpieczenie KL,NNW i bagazu                                XX ]]></line>
			<line><![CDATA[  9 S  REZYDENT Opieka rezydenta                                             XX ]]></line>
			<line><![CDATA[ 10 1  H        MERLINXTEST MERLINXTEST                                         ]]></line>
			<line><![CDATA[ 11 2  F        MERLINXTEST MERLINXTEST                                         ]]></line>
			<line><![CDATA[ 12    DirkInk  -                                                               ]]></line>
			<line><![CDATA[+--+--+--------+------------------------------------------------------+========+]]></line>
			<line><![CDATA[ Oplata storno : Netto / Prowizja  / Brutto  =       0.00 /     0.00 /     0.00 ]]></line>
			<line><![CDATA[--------------------------------------------------------------------------------]]></line>
			<line><![CDATA[Voucher nie zostal wyslany                                                      ]]></line>
			<line><![CDATA[Zarejestrowane platnosci                                                        ]]></line>
			<line><![CDATA[Poz Data       Typ Kwota PLN  Opis                                              ]]></line>
			<line><![CDATA[+--+----------+---+----------+--------------------------------------------------]]></line>
			<line><![CDATA[--------------------------------------------------------------------------------]]></line>
		</page>
		<page num="3">
			<line><![CDATA[  0         Razem:       0.00 PLN                                               ]]></line>
			<line><![CDATA[--------------------------------------------------------------------------------]]></line>
			<line><![CDATA[W tym         potwierdzonych                  niepotwierdzonych                 ]]></line>
			<line><![CDATA[               0.00 PLN                        0.00 PLN                         ]]></line>
			<line><![CDATA[--------------------------------------------------------------------------------]]></line>
			<line><![CDATA[Dane uczestnikow                                                                ]]></line>
			<line><![CDATA[--------------------------------------------------------------------------------]]></line>
			<line><![CDATA[ 1 MERLINXTEST MERLINXTEST                                                      ]]></line>
			<line><![CDATA[Dodatkowe imie/imiona:                                                          ]]></line>
			<line><![CDATA[Telefon: /123456789                                                             ]]></line>
			<line><![CDATA[Data urodzenia: 18.09.1982                                                      ]]></line>
			<line><![CDATA[Przyporzadkowanie:                                                              ]]></line>
			<line><![CDATA[PESEL:                    Paszport - numer:                                     ]]></line>
		</page>
		<page num="4">
			<line><![CDATA[Paszport - wydany przez:                                                        ]]></line>
			<line><![CDATA[Data wydania:                       Data waznosci:                              ]]></line>
			<line><![CDATA[Obywatelstwo:                                                                   ]]></line>
			<line><![CDATA[Miejsce urodzenia:                                                              ]]></line>
			<line><![CDATA[Adres: MERLINXTEST                                                              ]]></line>
			<line><![CDATA[Miejscowosc: MERLINXTEST            Kod pocztowy: 12-345                        ]]></line>
			<line><![CDATA[--------------------------------------------------------------------------------]]></line>
			<line><![CDATA[ 2 MERLINXTEST MERLINXTEST                                                      ]]></line>
			<line><![CDATA[Dodatkowe imie/imiona:                                                          ]]></line>
			<line><![CDATA[Telefon:                                                                        ]]></line>
			<line><![CDATA[Data urodzenia: 20.01.1982                                                      ]]></line>
			<line><![CDATA[Przyporzadkowanie:                                                              ]]></line>
			<line><![CDATA[PESEL:                    Paszport - numer:                                     ]]></line>
		</page>
		<page num="5">
			<line><![CDATA[Paszport - wydany przez:                                                        ]]></line>
			<line><![CDATA[Data wydania:                       Data waznosci:                              ]]></line>
			<line><![CDATA[Obywatelstwo:                                                                   ]]></line>
			<line><![CDATA[Miejsce urodzenia:                                                              ]]></line>
			<line><![CDATA[Adres:                                                                          ]]></line>
			<line><![CDATA[Miejscowosc:                        Kod pocztowy:                               ]]></line>
			<line><![CDATA[--------------------------------------------------------------------------------]]></line>
			<line><![CDATA[Dane platnika                                                                   ]]></line>
			<line><![CDATA[--------------------------------------------------------------------------------]]></line>
			<line><![CDATA[Nazwisko: MERLINXTEST                                                           ]]></line>
			<line><![CDATA[Imie: MERLINXTEST                                                               ]]></line>
			<line><![CDATA[Adres: MERLINXTEST                                                              ]]></line>
			<line><![CDATA[Miejscowosc: MERLINXTEST            Kod pocztowy: 12-345                        ]]></line>
		</page>
	</booking_info>
	<persons>
		<person id="01" gender="H" name="MERLINXTEST/MERLINXT" date="180982" price="0"/>
		<person id="02" gender="F" name="MERLINXTEST/MERLINXT" date="200182" price="0"/>
	</persons>
	<client>
		<familyName>MERLINXTEST                   </familyName>
		<firstNameOrTitle>MERLINXTEST                   </firstNameOrTitle>
		<street>MERLINXTEST                   </street>
		<postcode>12-345   </postcode>
		<city>MERLINXTEST         </city>
		<email>TEST@MERLINX.PL               </email>
		<telephoneNumber>123456789       </telephoneNumber>
		<itc> </itc>
		<deposit>      </deposit>
	</client>
</response>
FieldAttributeDescription
result_messagemsgCodeCurrent code
List of possible codes on our site: http://www.merlinx.pl/mdsws/msgcode.csv
booking_status-Code for reservation's status
persongenderParticipant gender
personnameSurname and name separted by a “/”
NOTICE: due to technical limitation of the reservation system, this field is limited to 20 characters in length, and therefore for long name/surname of the child may not be transferred entirely.
persondateAge / date of birth of the participant
booking_info_services-services from the reservation
booking_info-information from the Tour-operator for the reservation

Possible codes for reservation status:

CodeDescription
XXCanceled booking
RQReservation “on request”
RRBooking on request CONFIRMED by Tour-operator
OPOption reservation
RFCONFIRMED option reservation
OKFirm booking
??Because of technical reasons, booking status could not be determined
1)
depending on the Tour-operator the agent code may be required
2)
required by the Tour-operators on SART system - ALPE ARIN BEAT BEWR BUKS COLM DAGA EKOR GROM INDX INTE JNNW LIDO LTSL MADA MAES MATI MATW MOJE MRCO OKSE ORIE ORLA OZTA PANO PROF REGE REGO SAGA SAMA SALF SKRP SUMD WYCC WYGO YOUN ZAWA
booking/bookingstatus.txt · Last modified: 2012/09/27 09:27 by zbyszekb