4. Booking

Mishor 4 Documentation‎ > ‎5. API Methods‎ > ‎3. Events‎ > ‎

The booking request is done after the Booking Info request was completed, and you have collected all the customer details required for the booking.

Booking Request

<request version="4.0">

<auth>

<username>example</username>

<password>example</password>

<agent>example</agent>

</auth>

<event-book session="dv.12345" token="dv.111111" dispatchToken="dv.222222" clientRef="123456">

<customer>

<title>M</title>

<firstName>Guest</firstName>

<lastName>Guestington</lastName>

<phone type="home">+61 123456</phone>

<email>guest@example.com</email>

<address>141 Guest Road</address>

<postCode>44445</postCode>

<city>Guestia</city>

<state>VIC</state>

<countryCode>AU</countryCode>

</customer>

<special-request-fields>

<field code="height">1.75 m</field>

</special-request-fields>

<extra-products>

    <product>dv.abc123</product>

</extra-products>

</event-book>

</request>

Parameter	Type	Comments
event-book @session	string	the session id as returned by the search
event-book @clientRef	string	your reference
event-book @dispatchToken	cstring	the dispatch token selected from the booking-info request
customer	node	the lead customer details, pretty self explanatory
special-request-fields	node	the mandatory special request fields from the booking info request
extra-products/product	node	the extra product id from the booking info (optional)

Notes:

the customerCountryCode should be the same country code as was passed to the search
when booking a room with children, the pax node should have an additional age node specifying the child's age. the title can be left empty.

Booking Response

<?xml version="1.0"?>

<response success="1" session="m1.U3xZj6MvUA">

<reservation id="m1.U3xaZMARsA" status="confirmed" clientReference="12345">

<item id="1" status="confirmed" token="dv.123123">

<source provider="innstanttravel-b2b">

<reference>37898862</reference>

<price amount="484.08" currency="USD" />

</source>

<booking billable="1">

<price amount="550.172" currency="AUD" />

</booking>

<event id="2390" date="2014-06-06">

<tickets count="4" />

<name>

<![CDATA[Giverny and Monet's Garden Small Group Day Trip from Paris]]>

</name>

</event>

<venue>

<name>

<![CDATA[Paris]]>

</name>

</venue>

<dispatch type="print">

<description>

<![CDATA[Self-Print Voucher]]>

</description>

<print>

<url>

<![CDATA[http://www.example.com/path-to-ticket-print.pdf]]>

</url>

</print>

</dispatch>

<cancellation>

<frame endTime="2014-06-02 00:00:00" timezone="UTC" type="fully-refundable" />

<frame endTime="2014-06-06 00:00:00" timezone="UTC" type="fully-refundable" />

</cancellation>

</item>

</reservation>

</response>

Parameter	Type	Comments
response @success	boolean	was the request successful - note that this is NOT the booking status response
reservation @id	string	the reservation identifier
reservation @status	string	see "lookups" for possible returned statuses
reservation @clientReference	string	your reference as received during the booking request
item @token	string	the room token that was booked
item @status	string	see "lookups" for possible returned statuses
item @id	int	an incremental counter
source @provider	string	the provider from which this ticket is from
source/reference	string	the provider reference number
source/price @amount	float	the price received from the provider
source/price @currency	currency	3 letter currency code
booking @billable	boolean	is the booking coming from a direct provider
booking/price @amount	float	the price of the ticket
booking/price @currency	currency	3 letter currency code
event @id	string	the id of the booked event
event @date	date	YYYY-MM-DD format of the selected date
event @time	time	HH:mm:ss format of the event, if all day event it is not returned
event/tickets @count	int	the number of tickets booked
event/tickets/name	node	the name of the booked event
venue/name	node	the name of the venue
dispatch @type	string	the type of the dispatch option
dispatch/description	node	the description of the dispatch option
dispatch/print/url	node	in case of "print" method, the url of the actual ticket
cancellation	node	the terms of the cancellation

Notes

1. the source node will appear only if the provider is a direct provider (billable=0)

2. the print node will only be returned in case the booking is made using a self-print dispatch option

Comments

Resources	Search this site