HolidayTaxis / Hotelbeds API Integration

HolidayTaxis / Hotelbeds API Integration

This article explains how RideSuite integrates with HolidayTaxis (HTX) / Hotelbeds (HBEDS) , how bookings are received, validated, and processed, and how changes or exceptions are handled within the platform.

How Bookings Are Retrieved

RideSuite polls the HTX API every 30 minutes to fetch newly created bookings. Any new booking received from HTX will appear in RideInbox → New Orders.

  • If Auto-Accept is enabled, the booking is automatically validated and moved to RideManager or RideSchedule, depending on your configuration.

  • If data is missing or cannot be validated, the booking remains in RideInbox and must be reviewed and manually accepted by a user.

When RideSuite successfully polls the booking from HTX, the API automatically updates the HTX booking status to “Accepted Confirmation (ACON)”.

Handling Missing or Incorrect Data

If a booking contains errors or incomplete information, users cannot currently raise a query directly from RideSuite.

  • To query information on a received order, users will need to manage this offline via the HTX portal or by email.

  • In the near future, a “Query” button will be added in RideInbox. This will allow users to raise a query directly with HTX, apply a Query flag, and keep the booking in RideInbox until the issue is resolved either manually or via an updated booking from HTX.

Rates

HTX bookings do not include rates or pricing information.

  • Users will need to add the rate manually when processing bookings.

  • In the near future, RideSuite will automatically fetch and populate the rate from a rate card linked to your HTX contract.

Handling Changes

If HTX sends an updated version of an order, the order automatically updates the HTX booking status to “Accepted Amendment (AAMM)”.

  • The change order will sit in RideInbox → Changed Orders and must be reviewed and manually accepted by a user.

  • If Auto-Accept is enabled, the change is automatically validated and moved to RideManager or RideSchedule, depending on your configuration.

Handling Cancellations

If HTX sends a cancellation, the order automatically updates the HTX booking status to “Accepted Cancellation (ACAN)”, and the corresponding Sales Order is marked as Cancelled in RideSuite.

  • If the booking was allocated to suppliers, the cancellation flows down the entire chain automatically.

Important Note About HTX Cancellation Rules

  • HTX’s SLA states that orders cannot be rejected or cancelled once received.

  • However, RideSuite still allows users to cancel a Sales Order internally if needed for exceptional circumstances. In this case:

    • HTX is not notified of the cancellation.

    • The user must contact HTX offline to inform them that the service will not be performed.

Vehicle Mapping

To ensure bookings are processed correctly, HTX/HBEDS vehicle types are mapped to specific RideSuite Vehicle Categories.

HTX Vehicle TypeRideSuite Vehicle TypeRidesuite Max Capacity + Code
Private Standard Car (1-3 pax)Select Car03bcr
Private Premium Car (1-3 pax)Premium Car03ccr
Private Standard Minibus (4-7 pax)Select Minivan07bmv
Private Premium Minibus (4-7 pax)Premium Minivan07cmv
Private Premium Hybrid Minibus (1-7 pax)Premium Minivan07cmv
Private Standard Minibus (8-12 pax)Select Minibus12bmb
Shared Standard ShuttleRegular Shuttle99rsh
    • Related Articles

    • Weby API Integration

      This article explains how RideSuite integrates with Weby Ltd (Airport Taxi Transfers / City Airport Taxis), how bookings are received, validated, and processed, and how changes or exceptions are handled within the platform. How Bookings Are Retrieved ...
    • Carzen + Import Template

      The Carzen+ import feature in RideSuite allows users to quickly upload and process bookings directly from the Carzen+ portal. How to Import Bookings Export from Carzen+ Log in to the Carzen+ portal and export the booking file. Make sure to download ...
    • HeyTrip Import Template

      The HeyTrip import feature in RideSuite allows users to quickly upload and process bookings directly from the HeyTrip portal. How to Import Bookings Export from HeyTrip Log in to the HeyTrip portal and export the booking file. Make sure to download ...
    • Despegar Import Template

      The Despegar import feature in RideSuite allows users to quickly upload and process bookings directly from the Despegar portal. How to Import Bookings Export from Despegar Log in to the Despegar portal and export the booking file. Make sure to ...