The create booking reference call is an optional call after the prebook and before the book call. This call will create a booking record with the customer details before the booking is made. This means that any information given in the subsequent book request gets added to an existing booking reference with existing customer data. If there is any problem with the book process, there will then still be a record of the booking attempt with the booking reference returned in this call and the with customer details.
The request includes the lead customer contact details, such as address, phone number and email address. The response returns the booking reference created.
The structure of the XML will be:
The structure of the XML will be:
<CreateBookingReferenceRequest>
<LoginDetails>
<Login>TestLogin</Login>
<Password>TestPassword</Password>
</LoginDetails>
<CustomerDetails>
<CustomerTitle>Mr</CustomerTitle>
<CustomerFirstName>George</CustomerFirstName>
<CustomerLastName>Cambridge</CustomerLastName>
<DateOfBirth>1993-07-22</DateOfBirth>
<CustomerAddress1>Nottingham Cottage</CustomerAddress1>
<CustomerAddress2>Kensington Palace</CustomerAddress2>
<CustomerTownCity>London</CustomerTownCity>
<CustomerCounty></CustomerCounty>
<CustomerPostcode>W8 8PX</CustomerPostcode>
<CustomerBookingCountryID>1</CustomerBookingCountryID>
<CustomerPhone>02031666000</CustomerPhone>
<CustomerFax></CustomerFax>
<CustomerEmail>george@prince.com</CustomerEmail>
<CustomerPassportNumber>T45SDUR8326</CustomerPassportNumber>
</CustomerDetails>
<DepartureDate>2013-09-14</DepartureDate>
<Duration>7</Duration>
<OneWay>0</OneWay>
<ThirdPartyID>7</ThirdPartyID>
</CreateBookingReferenceRequest>
The response returns the new booking reference.
<CreateBookingReferenceResponse>
<ReturnStatus>
<Success>true</Success>
<Exceptions/>
</ReturnStatus>
<BookingReference>1000692</BookingReference>
</CreateBookingReferenceResponse>