HolidayTaxis Supplier Connect API Documentation

Update Individual Booking

Basic Usage

In order to update the details of a booking, the following url must be used via a PUT request (substituting :ref with a known booking reference in the format AAA(AA)-11111111):

HTTP PUT: /bookings/:ref

Request Details

The details to be updated must be included as the RAW PUT DATA in either XML or JSON.

You can update any of the below details of a booking:

Booking Status

Booking statuses can be updated to confirm changes in the Holiday Taxis system. The table below shows which status a booking can be updated to based on it's current status.

Current Status	New Status
PCON	ACON
PAMM	AAMM
PCAN	ACAN

Pick-up Details

For shuttles/shared transfers

You must confirm the pick-up date, time (in local timezone) and meeting point for the shuttle services ideally 48 to 24 hours before departure time. Once submitted, it should not be altered, unless the departure details get amended, in that case the pickup details must be updated accordingly to fit the new values.

The pick-up date and pick-up address fields should be sent inside of a departure block as per the examples at the bottom of this page.

For private transfers

You should review the pick-up date and time sent to ensure all passengers get to their destination in plenty of time. If there are issues with the supplied pick-up date and time you should raise a query by opening a "note" query

Booking Notes

There are nine types of notes that can be added to a booking, as listed below:

Note Type	Description
Regular Note	This is the note you wish to be added to the booking to be read by Holiday Taxis Customer Services.
Flight No Query	If you believe the flight number on the booking is incorrect/incomplete/missing, then set this to 1. When setting this to 1, you do not need to include notecontent.
Wrong Resort	If you believe the booking has been made to the wrong resort then set this to 1. You will need to include notecontent explaining which resort the booking should be corrected to.
Mandatory Child Seat Query	Indicates that child seat(s) is mandatory for the booking and that action may be required by the customer. Accepted values are 1 or 0, ‘notecontent’ is optional. The request is optional to use.
Missing Accommodation Query	Indicates that the booking is missing accommodation name or details. Accepted values are 1 or 0, 'notecontent' is optional. The request is optional to use.
Missing Ship Name Query	Indicates that the booking is missing the cruise ship name or details. Accepted values are 1 or 0, 'notecontent' is optional. The request is optional to use.
Shuttle to Private Address Query	Indicates that the booking needs to be upgraded from a shuttle to a private transfer due to being booked to private address or other non-compliant address. Accepted values are 1 or 0, 'notecontent' is optional. The request is optional to use.
No Show Arrival	Indicates that the passenger did not board the arrival journey transfer. Accepted values is 1. The request may only be used after the pick-up time for the arrival journey has passed. In case it is used prior to this, the response will indicate that the request was not accepted. The request is optional to use.
No Show Departure	Indicates that the passenger did not board the departure journey transfer. Accepted values is 1. The request may only be used after the pick-up time for the departure journey has passed. In case it is used prior to this, the response will indicate that the request was not accepted. The request is optional to use.

Field Name	Required	Values
notecontent	Required	Plain Text
flightnoquery	Optional	1 or 0
wrongresort	Optional	1 or 0
mandatorychildseat	Optional	1 or 0
missingaccommodation	Optional	1 or 0
missingcruiseshipname	Optional	1 or 0
shuttletoprivateaddress	Optional	1 or 0
noshowarrival	Optional	1 or 0
noshowdeparture	Optional	1 or 0

Example

Adding a flight query against a booking and adding a pickup time/accommodation

HTTP PUT: /bookings/HTX-4290672

JSON Request

{
  "request": {
    "status": "AAMM",
    "newpickupaccom": "Hotel Hilton",
    "newpickupaddress1": "Sandreen street",
    "newpickupaddress2": "Brighton",
    "newpickupaddress3": "Sussex",
    "departure": {
      "pickupdate": "2015-05-14T20:00:00"
    },
    "notes": [
      {
        "notecontent": "",
        "flightnoquery": "1",
        "wrongresort": "0",
        "mandatorychildseat": "0",
        "missingaccommodation": "1",
        "missingcruiseshipname": "0",
        "shuttletoprivateaddress": "0",
        "noshowarrival": "0",
        "noshowdeparture": "0"
      }
    ]
  }
}

XML Request

<?xml version="1.0" encoding="UTF-8"?>
<request>
  <status>AAMM</status>
  <newpickupaccom>Hotel Hilton</newpickupaccom>
  <newpickupaddress1>Sandreen street</newpickupaddress1>
  <newpickupaddress2>Brighton</newpickupaddress2>
  <newpickupaddress3>Sussex</newpickupaddress3>
  <departure>
    <pickupdate>2015-05-14T20:00:00</pickupdate>
  </departure>
  <notes>
    <note>
      <notecontent />
      <flightnoquery>1</flightnoquery>
      <wrongresort>0</wrongresort>
      <mandatorychildseat>0</mandatorychildseat>
      <missingaccommodation>0</missingaccommodation>
      <missingcruiseshipname>0</missingcruiseshipname>
      <shuttletoprivateaddress>0</shuttletoprivateaddress>
      <noshowarrival>0</noshowarrival>
      <noshowdeparture>0</noshowdeparture>
    </note>
  </notes>
</request>