Overview

Hotel-X offers a versatile feature: customizable Plugins! These plugins enable you to seamlessly integrate your unique business logic, eliminating the need for complex implementations. With Plugins, you can easily fine-tune your requests and responses as your business expands, simplifying the management of responses from various suppliers. For instance, you can customize currency exchange, establish blacklists for hotels based on different criteria, or exclusively receive the cheapest option for each meal plan.

📄️ Mapping

Mapping plugin serves to convert either the Supplier's native codes to the Buyer's codes or vice versa.

📄️ Blacklist

The Blacklist plugin lets you easily exclude specific hotel codes when executing a search. This means that hotels on your blacklist won't be requested from the supplier, helping you streamline your results and improve query efficiency. You can even exclude entire suppliers using customizable rules.

📄️ Cheapest Price

The Cheapest Price plugin allows you to find the most affordable choice among your Suppliers using various aggregation criteria. This means you can, for example, aggregate the supplier options to discover the least expensive choice for each meal plan and hotel, or even the most budget-friendly option for each hotel, supplier, and room.

📄️ Commission

Commission plugin defines the contracted/expected commission in cases where the Supplier is not able to send it via integration. The commission loaded in the SFTP is considered as a Gross commission, meaning that the commission or profit is already included in the price.

📄️ Add Parameter

The Add Parameter plugin allows to add parameters to existing accesses in the configuration. The plugin can be used in all booking services, allowing you to dynamically add parameters during the request time.

📄️ Currency Converter

The Currency Converter plugin enables the application of currency conversion to all the prices within a single option. This plugin takes an option and a currency as input and provides the same option with currency conversion applied to all the prices. It obtains rate information from a file located on our SFTP server. It's important to note that the existence of this file on the SFTP server and its compliance with specific requirements are mandatory. Otherwise, an error will be returned.

📄️ Preference

The Preference plugin works by prioritizing options that align with your preferences and presenting them in a preferred order.

📄️ Safety Margin

Safety Margin plugin allows discarding options that have a commission lower than expected. Only options that have a commission over gross, equal or lower than those reported in the file will be returned.

📄️ Virtual Credit Card

The Virtual Credit Card plugin allows you to connect with a VCC supplier who can create virtual credit cards for you at the time of reservation. For each hotel booking where you indicate the plugin, our system will connect with your VCC supplier to obtain the virtual credit card and use this information to complete the reservation with the hotel supplier.

📄️ Search by Destination

The Search by Destination plugin enables to search by destinations codes in the Search query. Destination codes will be converted to hotel codes, then merged with the hotel codes sent in criteria if any, and finally the request will be sent to the supplier. In order to achieve the destination to hotel conversion, a source must be specified in a plugin.

📄️ Markets Group

Markets Group plugin groups the input markets from Search depending on the agrupations you’ve decided beforehand. In order to be able to use the plugin, you’ll have to decide which markets to join for which supplier. This way the Search will only process as many transactions as groups have been formed by the plugin, since all of the markets of a same group would return the same options.

To utilize these plugins, simply add and configure the one that suits your needs in your requests. In some cases, you may be required to upload a specific file to your SFTP account, which we provide.

note

There's an option to load default plugins into our database. To explore this, kindly contact our dedicated Customer Care team to initiate the process by opening a ticket. These default plugins will automatically execute in all your Queries and Mutations when you haven't specified any filters. Enjoy the convenience!

SFTP Files

info

If you need help or have not yet received your SFTP credentials, please contact our team through our Support Portal. They will assist you in obtaining the necessary credentials.

SFTP Endpoint

sftp://sftp.travelgate.com

Directory Format

The structure of the directory should be in the below format, all files should be inside this directory:

sftp.xmltravelgate.com

📁HotelX
     📁HotelX _[Unique code]

Where "unique code" corresponds to the Hotel-X unique code in our system.

Example:

sftp.xmltravelgate.com

📁HotelX
     📁HotelX_1790

Upload SFTP Data

To upload an SFTP file, follow these simple steps:

1. Upload the File:

   • Once you've decided on the plugin you want to use, and if it's necessary, simply upload the required CSV file.

2. Wait for Processing:

   • Once you've uploaded the file, our system will take care of the rest.
   • We'll automatically add the "_processed" tagline to the end of the file name when the processing is complete.
   • The process of reading and loading the data files is iterative and occurs several times a day. The maximum processing time for a file can be up to 40 minutes, but this is the upper limit.

   For example, if you uploaded a file for hotel mapping plugin with the name:

   BuyerContext_SupplierContext_hotel_map_.csv

   After our system processes it, it will look like this:

   BuyerContext_SupplierContext_hotel_map_processed.csv

Update SFTP Data

To update an SFTP file, follow these simple steps:

1. If you need to update the information in the file, simply delete the old file.
2. Upload the new file with the updated information, using the correct name. You don't need to add the "processed" tagline to the name; we'll take care of that on our end.
3. The process of reading and loading the data files is iterative and occurs several times a day. The maximum processing time for a file can be up to 40 minutes, but this is the upper limit.

That's it! Updating SFTP files is as easy as that.

Delete SFTP Data

To delete all the information stored in our system, follow these straightforward steps:

1. Prepare an empty file:

   • Create a new file with empty content, including only the headers.
   • Ensure that the file structure, such as column headers, remains intact.

2. Load the empty file in the SFTP folder.

That's it! By replacing the existing data with an empty file containing headers only, you effectively delete all the information previously loaded into our system.

How to Execute a Plugin

To execute the plugins, in some cases it is enough to upload the file to the SFTP, in other cases you just have to indicate it in the request, and in some cases both actions need to be done, uploading the file to the SFTP and indicating it in the request.

In each of the plugins, you will see a section called "Execute plugin in your request", where it will be indicated how to execute that specific plugin.