Mishor 4 Documentation‎ > ‎5. API Methods‎ > ‎4. Cars‎ > ‎

3. Booking

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><![CDATA[example]]></agent>
    <customfields></customfields>
  </auth>
  <cars-book session="h2.8001232341126" token="h2.914343416" clientRef="12345" pickUpStation="z1" dropOffStation="z2">
    <customer>
      <title>MS</title>
      <firstName>Sophie</firstName>
      <lastName>McBoo</lastName>
      <phone type="home">123456</phone>
      <email>sophiemcboo@example.com</email>
      <address>123 Main st.</address>
      <postCode>88888</postCode>
      <city>Somewhere</city>
      <state>N/A</state>
      <countryCode>UK</countryCode>
      <age>33</age>
    </customer>
    <special-request-fields>
      <field code="0"></field>
    </special-request-fields>
    <optional-components>
      <optional-component token="h1.17345555606" />
    </optional-components>
  </cars-book>
</request>

Parameter Type Comments
cars-book @sessionstringthe session id as returned by the search
cars-book @clientRefstringyour reference
cars-book @pickUpStationstring the token of the pickup station from the info stage 
cars-book @dropOffStationstringthe token of the dropoff station from the info stage 
cars-book @tokenstringthe token selected from the booking-info request
customernode the lead customer details, pretty self explanatory
special-request-fieldsnode the mandatory special request fields from the booking info request
optional-componentsnode the "extra-options" tokens for the booking-info you would like to add to the booking
Notes:
  1. the customerCountryCode should be the same country code as was passed to the search
  2. If you used the age filter during search, the age node value much be identical to the search value
Booking Response
<?xml version="1.0"?>
<response success="1" time="2015-02-16 12:44:14" session="h1.12323434111135">
  <reservation id="tt.20823434371" status="confirmed" clientReference="12334">
    <item id="1" status="confirmed" token="h1.1323434453514">
      <source provider="example-provider">
        <reference>abc-123</reference>
        <price amount="101.24" currency="GBP"></price>
      </source>
      <booking billable="1">
        <price amount="101.24" currency="GBP"></price>
      </booking>
      <stations>
        <station type="pickUp">
          <carCompany companyId="EP"><![CDATA[Europcar]]></carCompany>
          <stationName><![CDATA[Dublin Airport, Ireland]]></stationName>
          <address><![CDATA[MAIN ARRIVALS HALL DUBLIN AIRPORT]]></address>
          <city><![CDATA[Dublin, Ireland]]></city>
          <country><![CDATA[IE]]></country>
          <zipCode><![CDATA[]]></zipCode>
          <state><![CDATA[]]></state>
          <phone><![CDATA[]]></phone>
          <airport><![CDATA[DUBT01]]></airport>
          <coordinates>
            <latitude>0534220</latitude>
            <longitude>-0062254</longitude>
          </coordinates>
          <days>
            <day day="Monday" isClosed="0" is24="1">
              <hours>
                <hour open="00:00:00" close="00:00:00"></hour>
                <hour open="00:00:00" close="00:00:00"></hour>
              </hours>
            </day>
            <day day="Tuesday" isClosed="0" is24="0">
              <hours>
                <hour open="05:00:00" close="23:59:00"></hour>
                <hour open="00:00:00" close="00:00:00"></hour>
              </hours>
            </day>
            ...
          </days>
        </station>
        <station type="dropOff">
          <carCompany companyId="EP"><![CDATA[Europcar]]></carCompany>
          <stationName><![CDATA[Dublin Airport, Ireland]]></stationName>
          <address><![CDATA[MAIN ARRIVALS HALL DUBLIN AIRPORT]]></address>
          <city><![CDATA[Dublin, Ireland]]></city>
          <country><![CDATA[IE]]></country>
          <zipCode><![CDATA[]]></zipCode>
          <state><![CDATA[]]></state>
          <phone><![CDATA[]]></phone>
          <airport><![CDATA[DUBT01]]></airport>
          <coordinates>
            <latitude>0534220</latitude>
            <longitude>-0062254</longitude>
          </coordinates>
          <days>
            <day day="Monday" isClosed="0" is24="1">
              <hours>
                <hour open="00:00:00" close="00:00:00"></hour>
                <hour open="00:00:00" close="00:00:00"></hour>
              </hours>
            </day>
            <day day="Tuesday" isClosed="0" is24="0">
              <hours>
                <hour open="05:00:00" close="23:59:00"></hour>
                <hour open="00:00:00" close="00:00:00"></hour>
              </hours>
            </day>
            ...
        </station>
      </stations>
      <car-details transmission="manual" airConditionIndication="" doors="0" maxPassengers="5" luggageLarge="1" luggageSmall="1">
        <carName><![CDATA[VW Polo 2 Door Economy 2/4 Dr.]]></carName>
        <carCompany><![CDATA[Europcar]]></carCompany>
        <type><![CDATA[]]></type>
        <class><![CDATA[Economy]]></class>
      </car-details>
      <additional-components>
        <component>
          <name><![CDATA[SuperMax Insurance]]></name>
          <desc><![CDATA[]]></desc>
          <price amount="21.4" currency="GBP"></price>
        </component>
      </additional-components>
      <driver-info>
        <title>M</title>
        <firstName><![CDATA[Sophie]]></firstName>
        <lastName><![CDATA[McBoo]]></lastName>
        <age>47</age>
      </driver-info>
      <cancellation>
        <frame endTime="" timezone="UTC" type="non-refundable"></frame>
      </cancellation>
      <rules-restrictions>
        <rule>
          <name><![CDATA[Cover Description]]></name>
          <description><![CDATA[Europcar Ireland Covers -  Collision Damage Waiver, Theft Wavier, Third Party Liability, Eco and Road Tax Fees, Unlimited Mileage ]]></description>
        </rule>
        ...
      </rules-restrictions>
    </item>
  </reservation>
</response>

Parameter Type Comments
response @successbooleanwas the request successful - note that this is NOT the booking status response
reservation @idstringthe reservation identifier
reservation @statusstringsee "lookups" for possible returned statuses
reservation @clientReferencestring your reference as received during the booking request
item @tokenstring the car token that was booked
item @statusstring see "lookups" for possible returned statuses
item @idintan incremental counter 
source @providerstringthe provider from which this car is from
source/referencestring the provider reference number
source/price @amountfloatthe price received from the provider
source/price @currencycurrency3 letter currency code
booking @billablebooleanis the booking coming from a direct provider
booking/price @amountfloatthe price of the ticket 
booking/price @currencycurrency3 letter currency code
stationsnode the station details, see search & info sections for details
car-detailsnodethe details of the car booked, see search response for details
additional-componentsnodethe extra options booked, see info response for details
driver-infonode the details of the driver booked, including name and age

cancellationnode the cancellation terms for this booking
rules-restrictionsnode multiple rules and restrictions attached to this booking
Notes
1. all rules and restrictions MUST be displayed on the voucher you issue to the client without any change
Comments