HolidayTaxis

Setting Up the Integration

To enable HolidayTaxis integration:

1. Go to Settings > Integration > HolidayTaxis.

2. Tick the checkbox labeled Activate this service to enable the connection.

3. Choose the Environment (Sandbox or Production).

   • Sandbox is for testing (not live bookings).

   • Production is for real-world bookings.

4. API credentials: Sandbox and Production API keys are provided directly by HolidayTaxis. If you do not have your API credentials, please contact your HolidayTaxis account manager or HolidayTaxis support team.

5. Enter your API key in the Sandbox API key or Production field.

6. Click Save to apply changes.

Sandbox displays a yellow warning label in the review interface to indicate it’s not a live environment.

HolidayTaxis Settings Explained

Booking Section

• When the booking status is cancelled, change the payment status to cancelled:

  • Ensures that if a booking is cancelled, the associated payment record reflects that status automatically.

• When the booking status is cancelled, set driver commission to zero:

  • Automatically clears any assigned driver commission to prevent incorrect payouts.

• Mark payments as paid:

  • All imported HolidayTaxis bookings will be marked as "Paid" regardless of internal workflows.

  • Useful because customers pay HolidayTaxis directly, not your drivers.

• Add the "HTX-" prefix before booking reference numbers received from HolidayTaxis:

  • Adds a visual identifier in booking listings to differentiate external HolidayTaxis bookings from local ones.

Driver Section

• Send driver assignments:

  • Allows you to notify HolidayTaxis which driver is assigned to the booking.

  • Driver details such as name, contact method, and vehicle info are transmitted.

• Send driver position updates:

  • Sends real-time GPS coordinates to HolidayTaxis (every ~15 seconds).

  • Requires the assigned driver to use the EasyTaxiOffice driver mobile app.

• Preferred contact method:

  • The main communication method HolidayTaxis should use (e.g., Phone call).

• Allow contact via:

  • Selects all acceptable methods for contacting the driver (e.g., SMS, WhatsApp).

Booking Sync Options

HolidayTaxis data syncs using three main methods:

Automatic Sync

• Runs in the background every 15 minutes.

• Fetches any newly created or updated bookings from HolidayTaxis.

Global Sync

• Manual sync initiated by the admin.

• Located in Bookings > All > Sync Source > HolidayTaxis.

• Best used when first enabling the integration or after a network issue.

• Mode, Period, Status, Profile, Refresh: These filters control what bookings get synced.

Single Sync

• Refreshes data for a single booking.

• Useful for specific updates or troubleshooting.

• Accessible from the Review window of a booking via External Status.

Accessing and Using the Review Screen

The HolidayTaxis Review Screen provides a detailed interface to manage bookings:

• Open by clicking the External Status tag of a HolidayTaxis booking from the main list.

• Includes: driver assignment, status controls, pending updates, notes, and more.

You can identify HolidayTaxis bookings in the booking list by the HTX- prefix in their Ref ID and the unique external status badge.

Clicking the status tag opens the Review panel where all relevant integration options and updates can be handled.

Driver Assignment and Tracking

Assigning Drivers

• Use the internal booking screen to assign a driver.

• Click Send driver to push this information to HolidayTaxis.

• Required fields:

  • Driver Name

  • Contact method

  • Vehicle identifier (e.g., registration number)

Deallocating Drivers

• Click Remove driver to inform HolidayTaxis that the assignment is void.

• If a new driver is assigned later, you can re-use Send driver to update.

Pending Updates

HolidayTaxis may modify a booking (flight change, time update, location shift).

• These updates appear as Pending update(s).

• View the suggested new value and previous value.

• You can:

  • Apply selected: Accept changes and update the ETO system. This action only updates your local data and does not send any updates to HolidayTaxis.

  • Reject selected: Ignore the suggested changes and keep your original details.

Pending updates remain visible until resolved.

Send Note and Notes Panel

Sending a Note

• Use the Send Note box to communicate with HolidayTaxis directly from the review screen.

• Add helpful flags such as:

  • Flight number missing/incorrect

  • Wrong resort selected

  • Missing accommodation

  • No-show events

Notes Panel

• Logs all past communication including your notes and HolidayTaxis system messages.

• Each entry includes a timestamp and sender identity.

• Use this to trace past updates, requests, or issues.

Status Management and Open Queries

• Bookings flagged with an amber icon have open queries.

• These might require missing data.

• Use Send Note with the correct flag to clear the query.

• The current status of the booking includes one of the following:

  • Pending Booking Voucher

  • Booking Voucher Approved

  • Pending Amendment

  • Amendment Approved

  • Pending Cancellation

  • Cancellation Approved

Statuses You Can Change as a Client

The following statuses can be updated by the ETO admin from the Review screen:

• Pending Booking Voucher → Booking Voucher Approved

• Pending Amendment → Amendment Approved

• Pending Cancellation → Cancellation Approved

These updates are made via status buttons and notify HolidayTaxis of your confirmation decision.

• Once a booking is confirmed, you can proceed with driver assignment and note submission.

Gold-Tier Integration & Data Requirements

EasyTaxiOffice provides full integration with the HolidayTaxis Driver Events API at the Gold tier. This ensures that HolidayTaxis receives all required driver, vehicle, status, and geo-location data necessary for the highest level of functionality.

Please note: HolidayTaxis will only receive the information that is enabled in your integration settings and completed in your driver and vehicle profiles.

1. Ensure Required Integration Settings Are Enabled

In the HolidayTaxis integration settings, verify that the following options within the Driver section are enabled:

• Send driver assignments

• Send driver position updates

• Preferred contact method

Under Allow contact via, ensure the appropriate communication methods are selected (e.g., phone, SMS, WhatsApp).

These settings determine what type of driver and communication data is transmitted to HolidayTaxis.

2. Ensure All Required Driver & Vehicle Details Are Completed

To meet Gold-tier requirements, each assigned driver must have all of the following information filled in:

Driver details:

• Phone number

• Preferred communication method (e.g., SMS, WhatsApp)

• Driver name

Vehicle details:

• Vehicle brand

• Vehicle model

• Vehicle color

HolidayTaxis will only receive the fields that exist in the driver and vehicle profiles. Missing data in your system means missing data on the HolidayTaxis side.

3. GPS Tracking & Status Updates

For Gold-tier tracking compliance:

• Drivers must use the EasyTaxiOffice Driver App with location services enabled.

• The system will automatically send:

  • Vehicle status updates

  • Live geo-location data (lat & lng), ideally every few seconds

• If a driver is not sharing their location, HolidayTaxis will not receive the required tracking data.

4. Sending Driver Information to HolidayTaxis

When you assign a driver to a HolidayTaxis booking:

• Use Send driver to push driver and vehicle data.

• If changing to a different driver:

  • First click Remove driver

  • Then Send driver again for the new driver.

This ensures HolidayTaxis receives accurate and up-to-date information.

Benefits of Full Gold-Tier Integration

• Full compliance with HolidayTaxis' highest data-sharing requirements

• Real-time GPS tracking and live status visibility

• Reduced occurrence of “open queries” due to missing data

• Better customer experience and improved operational transparency

• Maximum automation with minimal manual intervention

Tips and Reminders

• Start with a Global Sync after setup to pull existing bookings.

• Use Single Sync to update a single booking on demand.

• Confirm Bookings before assigning drivers.

• Resolve Pending Updates regularly to maintain accurate data.

• Track driver GPS only if the driver is using the app with tracking enabled.

• Monitor Notes and Status to avoid unresolved issues or missing data.