Vervotech
  1. Operational APIs
Vervotech
  • Hotel Mapping
    • Getting Started
    • Access & Onboarding with Vervotech
    • Explore your providers
    • Integration and Go Live
    • Map Providers Content
    • Webhook
    • References
    • FAQ
    • Metadata Content
      • Get All Vervotech Ids
      • Get Master Hotel Facilities
      • Get Master Hotel Chains
      • Get Master Hotel Brands
      • Get Master Property Types
      • Get All Master Countries
    • Mappings
      • Get Hotel count for new, updated and deleted.
      • Get Mappings
      • Get New Mappings
      • Get Updated Mappings
      • Get Deleted Mappings
      • Get Mapping Statistics
      • Get Provider Hotel Mappings By VervotechId
      • Get Provider Hotel Mappings by ProviderId
      • Export Mappings File
    • Curated Content
      • Get Curated Content By Provider Hotel Ids
      • Get Curated Content By Vervotech Ids
    • Provider Content
      • Get Provider Content By Provider Hotel Ids
      • Get Provider Content By Vervotech Ids
      • Get All Provider names
      • Get Unmapped Provider Hotels
      • Get Unmapped Provider Hotels V2
      • Create Unmapped Provider Hotels File
    • Location Content
      • Get Location By ID
      • Get All Locations
    • Operational APIs
      • Review Mappings of Booked Hotels
        POST
      • Review Mappings of Booked Hotels By File
        GET
      • Start Mapping By Ftp Folder
        GET
      • Get Mappings History By RunId
        POST
    • Dynamic Mapping APIs
      • Find Match
    • Dual Mapping APIs
      • Overview
      • Get Mappings by Provider Hotel Id.
      • Get Mappings with content by Provider Hotel Id.
      • Get summary for your dual mapping APIs
  • Room Mapping
    • Getting Started
    • File Based Room Mapping (Offline)
    • References
    • FAQ
    • Mapping API
      • Map Rooms
      • Get Master Room Amenities
      • Get Master Room Attributes
      • Get Provider Names
      • Get All Provider Names
    • Async Room Mapping API
      • Map Large Rooms Async
      • Get Async Room Mapping API Response
  1. Operational APIs

Start Mapping By Ftp Folder

GET
/mappings/StartMappingByFtpFolder

Exports all the mappings associated to the given account in the .csv format and the file is sent to you by email.
The associated files will be uploaded into your ftp account. The files can be accessed by ftp credentials, which is already been shared during the signup process.

File description:

When this API is requested by the client the following files are generated -:

  1. Mapping File.
    This file contains mapping information in your account corresponding to each provider. The file name convention is -: accountname_mappings_guid.csv
  • Following are the columns included in the template:

    • UnicaId: The name of the provider providing that hotel. This must be from the master Vervotech Mappings master provider names
    • ProviderHotelId: This would be the property's ID, provided by the provider.
    • ProviderFamily: Name of the provider.
    • ModifiedOn: Date of the mapping when updated.
    • ChannelIds: ChannelName.Rate plan type for the provider.
    • ProviderLocationid: DestinationCode for providerHotelId grouped under unicaId.
    • Please refer the mapping file template here,
ddd 2.png
2) Mapping File(New format). This file contains mapping information in new csv format to each provider. The file name convention is -: accountname_transformed_guid.csv * Following are the columns included in the template:
  • UnicaId: Unique Vervotech hotel Id
  • Provider Name: This would be the property Id provided by the provider which exist in that vervotech Id group.
  • Please refer the mapping file template in new format here,
ddd 2.png
  1. Content File.
    This file contains mapping information in new csv format to each provider. The file name convention is -: accountname_hotels_guid.csv
  • Following are the columns included in the template:

    • UnicaId: Unique Id for each group of similar hotels.
    • HotelName: Name of the property.
    • Lat: Latitude of the property.
    • Long: Longitude of the property.
    • AddressLine1 : Property's address line 1.
    • AddressLine2 : Property's address line 2.
    • City : Name of the city where the property is located.
    • State: Name of the state where the property is located.
    • StateCode : Code of the state where the property is located.
    • CountryName: Name of the country where the property is located. Either one of the CountryName and CountryCode is sufficient.
    • CountryCode : ISO country code where the property is located.
    • PostalCode: Zipcode of the property.
    • StarRating: Star ratings of the property.
    • PropertyType: Hotel property type. Eg: - Motel, Resort, Villa, etc.
    • ChainName: Information about the chain name.
    • BrandName: Information about the brand name.
    • CityLocationId: Master city location id associated with this property.
    • MasterCityName: MasterCityLocationName is the cityname associated with city location id.
    • LocationIds: Master location ids associated with this property.
    • Phones: Property's phone numbers.
    • Fax: Property's fax number.
    • Email: Property's email address.
    • Website: Property's official website address.
    • AirportCodes: List of Airports nearby the hotel.
    • TrainStations: List of TrainStations nearby the hotel.
    • ProviderHotelId: Provider hotel id.
    • ProviderFamily: Name of hotel provider.
    • GooglePlusCode: GooglePlusCode is the unique code for the property.
    • Please refer the curated content file template here,
ddd 2.png
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://hotelmapping.vervotech.com/api/3.0/mappings/StartMappingByFtpFolder?templateType=Vervotech_Template&folderName=18122019/HotelBeds/johndoe__johndoe__HotelBeds' \
--header 'apikey: 056ec4c3-be6b-4c36-a4cc-a403ce9592a1' \
--header 'accountId: DemoAccount'
Response Response Example
200 - Example 1
{
    "RunId": "rc1234-3232-5657",
    "MappingStats": [
        {
            "RunId": "f676e8a6-00b4-4231-8a1a-5a19d290837d",
            "DownloadStats": {},
            "MissingCountryCodes": 0,
            "MissingGeoCodes": 0,
            "MissingHotelChains": 0,
            "MissingPhones": 0,
            "MissingStarRatings": 0,
            "MissingZipCodes": 0,
            "MissingCity": 0,
            "MissingFax": 0,
            "MissingName": 0,
            "MissingState": 0,
            "MissingAddress": 0,
            "PublishCount": 0,
            "TotalProviderCount": 0,
            "StorageFilePath": "11092022/MGHoliday/via__via__MGHoliday/MGHoliday.csv",
            "ValidationMessage": "File format is Valid. Hotel count 269076.",
            "Status": "Completed",
            "StartDate": "2022-09-12T10:03:57.134Z",
            "EndDate": "2022-09-12T11:30:07.219Z",
            "WorkFlowType": "FTPDownloader"
        }
    ],
    "Status": true,
    "Message": "Success",
    "StatusCode": 2000
}

Request

Query Params

Header Params

Responses

🟢200OK
application/json
OK
Body

🟠403Forbidden
🟠404Record Not Found
🔴500Server Error
🔴503Service Unavailable
Previous
Review Mappings of Booked Hotels By File
Next
Get Mappings History By RunId
Built with