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 FTP 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 FTP server. It's important to note that the existence of this file on the FTP 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. It follows a sequential process, where rules are checked one by one until a matching rule is found. When a match is found, the process stops, and your preference is applied. If no matching rule is found, the option will be validated.

📄️ 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

Virtual Credit Card plugin adds the possibility to:

📄️ 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 FTP 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!

FTP Files

Upon receiving your Onboarding Welcome Pack, you will be granted access credentials to the FTP server. In the event that you need assistance or have not received your credentials, kindly open a ticket to our Customer Care team to obtain your FTP credentials and initiate your journey.

FTP Endpoint

ftp://ftp.xmltravelgate.com

Directory Format

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

ftp.xmltravelgate.com

📁F[Folder code]_[Unique code]
     📁HotelX _[Unique code]

F[Folder code]_[Unique code]

• Folder code: corresponds to the folder number.
• Unique code: corresponds to the folder unique code in our system.

HotelX_[Unique code]

• Unique code: corresponds to the Hotel-X unique code in our system.

Example:

ftp.xmltravelgate.com

📁F0_1781
     📁HotelX_1790

Upload FTP Data

To upload an FTP 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.

   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 FTP Data

To update an FTP 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.

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

Delete FTP 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 FTP 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 FTP, 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 FTP 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.