Documentation

The Crawler is an automated service that allows for the following functions:

• Retrieves your mapping files and confirmation files (files that update only hotel active/inactive status without full mapping) using a standard template via a secure SFTP connection.
• Processes those files through our One Hotel Mapping platform.
• Generates the specified output files based on your requirements.

• Fully Automated Workflow: Eliminates manual steps and accelerates data updates.
• Up-to-Date Coverage: Ensures your hotel catalog reflects the latest products, contracts, and rate plans.
• Enhanced Visibility: Increases the number of correctly mapped hotels in your searches and distribution channels.
• Exception Management: Flags deactivated or unmapped properties for your review.
• Customized Promotions: Enables tailored offers based on your mapped hotel inventory.
• Minimal Development Effort: Simply set up an SFTP folder to integrate the template and let the Crawler run.

1. Prepare Your Input File
   1. Download the standard mapping or confirmation template (CSV or Excel).
   2. Populate mandatory fields: your hotel code, Hotelbeds hotel code (for confirmation), name, address, country, latitude, and longitude.
   3. Optionally include: category, email, phone, GIATA code, GooglePlaceID, TTID, and active status.
2. Upload via SFTP
   1. Connect to onemapping.sftp.hotelbeds.com on port 2222 and place your file in the /input directory.
3. Processing
   1. The Crawler automatically imports the file into One Hotel Mapping and runs the mapping algorithm.
4. Result Generation
   1. Output files are created based on your configured preferences, including matched hotels, missing properties, duplicates, and errors.
5. Delivery
   1. Processed files are published to your /output directory on the same SFTP server.

The information can be sent in two formats. The simplest one only includes the hotel mapping codes from the client and Hotelbeds. Alternatively, a more comprehensive file can be provided, which allows for error detection and more detailed analysis. For this type of file, the following information is required:

• Mandatory Fields:
  • Client Hotel Code
  • Hotelbeds Hotel Code
  • Hotel Name
  • Address, Location and Country
  • Latitude and Longitude
  • Active Status
• Optional Fields:
  • Category
  • Email and Phone
  • Web
  • GooglePlaceID
  • GIATA Code
  • TTIID (GIATA TTI code)

Please agree with your account owner which of these reports you would like to receive

• MATCHEDBYMAPPINGTOOLGENERAL - Hotels mapped with high confidence.
• MATCHEDBYMAPPINGTOOLCODESTOBEREVIEWED - Suggested matches requiring manual review.
• MAPPINGS_ERROR - Detected errors to correct (check daily).
• MISSINGHOTELS - Properties found in our portfolio but not mapped.
• MATCHEDBYMAPPINGTOOLDUPLICATEHOTELCODES - Duplicate hotel codes identified.
• HOTELDISTRIBUTION - Complete list of distributable properties with basic static data.

# Log in:

sftp -oPort=2222 <FTP_USERNAME>@onemapping.sftp.hotelbeds.com

# Navigate and upload:

cd input # Enter input folder

lcd /path/local # Change to your local data folder

put yourfile.csv # Upload your input

# Retrieve results:

cd output # Enter output folder

get *.csv # Download all output files

1. Activate the Crawler: Contact your Account Manager to enable the service.
2. Set Frequency: Define how often to upload files (daily, weekly, monthly).
3. Configure SFTP: Receive credentials or point to your own secure server.
4. Upload Test Files: Submit initial files and verify the output reports.