HolidayTaxis Supplier Connect API Documentation
Update Multiple Bookings
Basic Usage
In order to update the details of multiple bookings, the following url must be used via a POST request:
HTTP POST: /bookings
Request Details
The details to be updated must be included as the RAW POST 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. |
| 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 |
Example - Status Only
Updating status of three bookings
HTTP POST: /bookings
JSON Request
{
"bookings": [
{
"ref": "TEST-12341234",
"status": "ACON"
},
{
"ref": "TEST-12340011",
"status": "AAMM"
},
{
"ref": "TEST-12349999",
"status": "ACAN"
}
]
}
XML Request
<?xml version="1.0" encoding="UTF-8"?>
<request>
<bookings>
<booking>
<ref>TEST-12341234</ref>
<status>ACON</status>
</booking>
<ref>TEST-12340011</ref>
<status>AAMM</status>
</booking>
<ref>TEST-12349999</ref>
<status>ACAN</status>
</booking>
</bookings>
</request>
Example - Pickup and Notes
Adding a flight query, wrong resort query, note and adding a pickup time/accommodation against two bookings
HTTP POST: /bookings
JSON Request
{
"bookings": [
{
"ref": "TEST-12341234",
"status": "ACON",
"newpickupaccom": "United Kingdom",
"newpickupaddress1": "Suite B 2nd Floor Moore House",
"newpickupaddress2": "13 Black Lion Street",
"newpickupaddress3": "Brighton",
"departure": {
"pickupdate": "2023-06-08T11:45:00"
},
"notes": {
"note": {
"notecontent": "Confirm booking. Update pickup time, address and raise wrong resort and flight no query",
"flightnoquery": 1,
"wrongresort": 1
}
}
},
{
"ref": "TEST-12001200",
"status": "ACON",
"newpickupaccom": "United Kingdom",
"newpickupaddress1": "Suite B 2nd Floor Moore House",
"newpickupaddress2": "13 Black Lion Street",
"newpickupaddress3": "Brighton",
"departure": {
"pickupdate": "2023-07-09T21:10:00"
},
"notes": {
"note": {
"notecontent": "Confirm booking. Update pickup time, address and raise wrong resort and flight no query",
"flightnoquery": 1,
"wrongresort": 1
}
}
}
]
}
XML Request
<?xml version="1.0" encoding="UTF-8"?>
<request>
<bookings>
<booking>
<ref>TEST-12341234</ref>
<status>ACON</status>
<newpickupaccom>United Kingdom</newpickupaccom>
<newpickupaddress1>Suite B 2nd Floor Moore House</newpickupaddress1>
<newpickupaddress2>13 Black Lion Street</newpickupaddress2>
<newpickupaddress3>Brighton</newpickupaddress3>
<departure>
<pickupdate>2023-06-08T11:45:00</pickupdate>
</departure>
<notes>
<note>
<notecontent>Confirm booking. Update pickup time, address and raise wrong resort and flight no query</notecontent>
<flightnoquery>1</flightnoquery>
<wrongresort>1</wrongresort>
</note>
</notes>
</booking>
<booking>
<ref>TEST-12001200</ref>
<status>ACON</status>
<newpickupaccom>United Kingdom</newpickupaccom>
<newpickupaddress1>Suite B 2nd Floor Moore House</newpickupaddress1>
<newpickupaddress2>13 Black Lion Street</newpickupaddress2>
<newpickupaddress3>Brighton</newpickupaddress3>
<departure>
<pickupdate>2023-07-09T21:10:00</pickupdate>
</departure>
<notes>
<note>
<notecontent>Confirm booking. Update pickup time, address and raise wrong resort and flight no query</notecontent>
<flightnoquery>1</flightnoquery>
<wrongresort>1</wrongresort>
</note>
</notes>
</booking>
</bookings>
</request>