This message returns a list of destinations loaded on the platform that are associated with the user making the request.


The response will include the list of destinations, identified by their type.

 


Endpointhttps://hotel.new.hotetec.com/webservice/integrations/pull/listLocations

 


Request message listLocations

 

The message is composed of the following elements:


 

Element

Mandatory

Values / Format

Description

sessionId

Y

Alfanumeric

Generated session ID

languageCode

Y

DE, EN, ES, FR, IT, NL, PT

Language in which the response should be returned. If not specified, Hotetec's default value for the user will be used.


ISO 639-1 codes are employed. Currently, only the codes listed under “values” are accepted.

currency

Y

EUR, USD, GBP, EGP, MXN, CHF, CUP

Currency in which the request prices should be returned. If not specified, Hotetec's default value for the user will be used.


ISO 639-1 codes are employed. Currently, only those listed under “values” are accepted.

locationCode

N

Alfanumeric

Geographic zone code where the establishment is located.

locationName

N

Alfanumeric

Name of the geographic zone where the establishment is located.

locationType

N

Alfanumeric.

Zone, Area, Region, Country

Type of geographic zone where the establishment is located.

parentLocationCode

N

Alfanumeric

Code of the higher-level geographic zone where the establishment is located.

 


Request example:


{
    "sessionId": "TES#20727#404917811765185",
    "languageCode": "ES",
    "currency": "EUR",
    "locationCode": null,
     "locationName": null,
     "locationType": null,
    "parentLocationCode": null
 }


 

Reponse message listLocations

 

The message is composed of the following elements:

 

Element

Description

sessionId

Generated session ID

notification

Notification type.
• Error: important to review in order to correct the issue indicated by the system
• Warning
• Information

notificationDetail

Descripción de la notificación indicada.

 

location

code

Geographic zone code where the establishment is located.

name

Geographic zone name where the establishment is located.

type

Geographic zone type where the establishment is located.

parentCode

Parent (upper-level) geographic zone code where the establishment is located.


Response example:


{
    "sessionId": "TES#20727#404917811765185",
    "location": [
        {
            "code": "ES-46018",
            "name": "Alcudia",
            "type": "Zone",
            "parentCode": "ESBAL03"
        },
        {
            "code": "ESBAL03",
            "name": "MALLORCA",
            "type": "Area",
            "parentCode": "ESBAL"
        },
        {
            "code": "ES-200031",
            "name": "Platja de Palma",
            "type": "Zone",
            "parentCode": "ESBAL03"
        },
        {
            "code": "ES-46393",
            "name": "Palma de Mallorca",
            "type": "Zone",
            "parentCode": "ESBAL03"
        },
        {
            "code": "ESBAL",
            "name": "ISLAS BALEARES",
            "type": "Region",
            "parentCode": "ES"
        },
        {
            "code": "ES",
            "name": "ESPAÑA",
            "type": "Country"
        }
    ]
}