Full Distribution solution Roadmap & Timings

Find out what Full Distribution solution onboarding looks like and what you can expect in terms of timing so you can plan the setup accordingly.

Starting a new project is always a tricky task - it's often difficult to accurately estimate the resources and time required and this can lead to a possible inefficiency and ineffectiveness of the project, as well as a waste of time and resources.
At TravelgateX we want to ease that process by providing all the necessary information, roadmap and timings to effectively calculate the amount of resources and timing that will require the Full Solution setup. That's why we've splitted the Full Distribution solution setup in 5 steps:

Activate your Sellers

*In case you are going to start only with your own direct portfolio (static rates), you can jump straightly to the next step. 

First step will be to activate the connection with the Sellers from whom you are going to buy your product, so you can then supply it to your Partners (see how here).

Note that before requesting the Seller activation, you should previously have an agreement with them.

You can also visit our Network and find new potential Partners and check the Sellers activation status through our "Connections" section. 

Inventory Setup

The Inventory setup step will be required in three scenarios, uploading your direct portfolio (static rates), connecting with a Channel Manager and both of them (you can skip this part in case you are going to connect only with pull Sellers).

Below you will find each scenario splitted into small steps:

Connecting with a Channel Manager


  1. Activate your connection with the Channel Manager
  2. Setup your Inventory (see how on our documentation and video tutorials
  3. Contact the hotelier and Channel Manager to push allotment and prices into our database. 

Upload your direct portfolio


  1. Setup your direct portfolio (see how on our documentation and video tutorials)
  2. Configure the availability (see how on our documentation and video tutorials)
  3. Configure the prices (see how on our documentation and video tutorials)

*Note that since it is your direct portfolio, you should keep availability and prices updated manually. 

Hotel-X Mapping

Our Full Solution is composed of multiple layers (see schema here) and one of them is the Hotel-X API. It is the one that aggregates all your product (direct and third party), so you can then distribute it to your Buyers.

In order to do so, our Hotel-X API needs to know what is the relation between your own codes and the Sellers codes. 

FTP access and credentials 

You can access our FTP from any FTP application by configuring the following:

  • Port: 21
  • Host: ftp.xmltravelgate.com
  • Credentials: We sent them to the organization owner at TravelgateX.com, along with the welcome email (we sent them from jenkins-ci) 

Hotel-X Mapping files

There are six mapping files in Hotel-X (the more you map, the more accurate you can bee in your aggregation). We recommend to start at least with the following ones:

  • Hotel Map
  • Board Map
  • Room Map

Our mapping formats share a common structure. In order to load your maps you just need to follow the instructions below:

Create the maps directory

Unfold your organization folder and click on the "F0_" folder. Then click on the "HotelX_" folder and create the "Maps" folder:

The "Maps" folder will be the one where you will have to allocate all the  mapping files.

Hotel-X mapping files format

You should follow the below format when generating the mapping files:

    • File Name: [Context Source]_[Context Destination]_[entity]_map.csv
      • Context Source: it corresponds to your own codes
      • Context Destination: it corresponds to the supplier code
      • 1 file for each supplier
    • Header Row: Code Source, Code Destination
      • Context Source: it corresponds to your own codes
      • Context Destination: it corresponds to the supplier codes
    • Delimiter: Comma (“,”)
    • Directory: /F[folder code]_[unique code]/HotelX_[unique code]/Maps/[entity]/

File names:

  • Hotel Map: [Context Source]_[Context Destination]_hotel_map.csv
  • Board Map: [Context Source]_[Context Destination]_board_map.csv
  • Room Map: [Context Source]_[Context Destination]_room_map.csv 

Master files definition

Through the master files you will be able to setup the static content your Buyers will be downloading when connecting to you. That is, your own hotel, room, board...codes. 

There are up to 10 master files, but we recommend to start at least with three of them:

  • Hotels
  • Rooms
  • Mealplans

Master files directory

You should upload the master files into the Distribution folder as per below: 

Master files format

You should follow the format detailed for each of them:

Distribution setup

Before being able to connect your first Buyer, you should create the agency or agencies that will represent it on our Distribution extranet.

Once created, you'll be able to configure the distribution rules applicable for that agency.

Activativate your Buyers

The last step will be requesting the activation of the Buyers you have an agreement with through our Connect Form:

1. In order to request the activation you will have to retrieve the user and the access token from our Distribution extranet:

  • User: It is the ID of the agency you created for the Buyer you want to connect:

    *In case you would like to activate multiple accesses (B2B, B2C...) for a specific Buyer, you'll have to repeat the process for each one. 
  • Access Token: Automatically generated when creating the agency, it can be obtained by clicking the Token button:

2. Once you've the user and the access token, log onto TravelgateX.com. Then click on "Connections" and select "My Connections" option.

Once you are in "My Connections" page, click on the "New connection" button. 

3. Fill the form with the user and access token:

And click on the "Create connection" button.

Our team will take care of the activation and will let you know when this is ready. 

*You can personalize the access name according to your preferences or the type of access you are activating (B2B, B2C...).

*In the "Notification emails" box, you should specify the contacts you want us to send the access details.