Availability by destination

 

Disponibilidad Destino

 

This message returns the list of destinations loaded on the platform that are associated with the requested company. 

 

Each geographical zone information element (Infzge) contains destination information. These elements are hierarchically ordered, with the hierarchy determined by the superior destination code (zgesup). 


 

DisponibilidadDestinoPeticion

 

If the request includes the geographical zone code element (codzge), the response will return a single geographical zone information element (Infzge) with the information corresponding to the codzge specified in the request. 

 

If the request includes the superior geographical zone element (zgesup), the response will return geographical zone information (Infzge) corresponding to all zones that hierarchically depend on the indicated superior geographical zone. 

 


DisponibilidadDestinoPeticion: Destination availability request message.

 

Element

M

Type

Values / Format

Description

ideses

Y 

String

max length:  40

Session identifyer

codtou

Y 

String

 

TTOO code

tiparb

N 

Enumeration

ZHT

Tree type requested. 

ZHT: establishment zone.

codzge

N 

String

max length : 50

Geographic zone code

nomzge

N 

String

max length : 100

Geographic zone name

tipzge

N 

Enumeration

COM

DIS

GRP

MUN

PRO

REG

SBZ

SRG

ZON

Type of geographic zone. 

 

COM: community. 

DIS: district. 

MUN: municipality. 

PRO: province. 

REG: region. 

SBZ: subzone. 

SRG: subregion. 

ZON: zone.

zgesup

N 

String

max length : 50

Higher level zone it belongs to

numniv

N 

Integer

min value: 0

max value: 100

Request depht level

 

Examples: 

 

Request message for all zones: 

 

<DisponibilidadDestinoPeticion> 

<ideses>XML#17#442106373838493</ideses>   

<codtou>HTT</codtou>  

<tipzge>ZON</tipzge>  

</DisponibilidadDestinoPeticion>

 

Request message for a specific geographical zone: 

 

<DisponibilidadDestinoPeticion> 

<ideses>XML#17#442106373838493</ideses>   

<codtou>HTT</codtou>  

<tiparb>ZHT</tiparb>  

<codzge>ES-46659</codzge>  

</DisponibilidadDestinoPeticion> 

 

In this case, it is assumed that the geographical zone code value is already known before making the request. 

 

Request message indicating a higher-level geographical zone: 


<DisponibilidadDestinoPeticion> 

<ideses>XML#17#442106373838493</ideses>   

<codtou>HTT</codtou>  

<tiparb>ZHT</tiparb>  

<zgesup>ESBAL02</zgesup>  

</DisponibilidadDestinoPeticion> 

 

In this case, it specifies the higher-level geographical zone ESBAL02, which corresponds to Menorca. The response would return all zones corersponding to Menorca (Cala Santandria, Son Bou, Ciutadella,  Binibeca, etc.).

 



DisponibilidadDestinoRespuesta

 

DisponibilidadDestinoRespuesta: Destination availability response message.

 

Element

M

Type

Values / Format

Description

ideses

Y

String

max lenght: 40

Session identifyer

codtou

Y

String

 

TTOO code

infzge

N

Infzge[]

See definition

See definition

error

N

error (Group)

See definition

See definition

 

Sub element Infzge: geographical zone information, hiearchy.

 

Element

M

Type 

Values / Format

Description

codzge

Y

String 

max lenght: 50 

geographic zone code

zgesup

N

String 

max lenght: 50 

Higher level zone it belongs to

tipzge

Y

Enumeration 

COM 

DIS 

MUN 

PRO 

REG 

SBZ 

SRG 

ZON 

Type of geographic zone. 

 

COM: community. 

DIS: district. 

MUN: municipality. 

PRO: province. 

REG: region. 

SBZ: subzone. 

SRG: subregion. 

ZON: zone.

nomzge

Y

String 

max lenght: 100 

Geographic zone name

chkfin

N

Check 

See definition 

Indicates if a hotel availability request can be made for this zone. *

 

* Comments: For example: the zone 'España' has chkfin “N”, because it is not allowed to perform a destination availaibility request for the entire country. In contrast, for the zone Mallorca, value for  chkfin will be “Y”. 


Used in: 

DisponibilidadDestinoRespuesta 

 

Examples:

Response message with a provided codzge: 

 

<DisponibilidadDestinoRespuesta> 

<ideses>XML#17#442106373838493</ideses>   

<codtou>HTT</codtou>  

<infzge> 

<codzge>ES-200016</codzge> 

<zgesup>ESBAL04</zgesup>  

<tipzge>ZON</tipzge>

<nomzge>Cala Saona</nomzge>

</infzge>

</DisponibilidadDestinoRespuesta>

 

Response message indicating a higher-level geographical zone: 

 

<DisponibilidadDestinoRespuesta> 

<ideses>XML#17#442106373838493</ideses>   

<codtou>HTT</codtou>  

<infzge> 

<codzge>ES-46659</codzge> 

<zgesup>ESBAL03</zgesup>  

<tipzge>ZON</tipzge>

 <nomzge>Valldemossa</nomzge>

          </infzge>
 

<infzge>

<codzge>ESBAL03</codzge> <zgesup>ESBAL</zgesup>  

<tipzge>PRO</tipzge>

<nomzge>MALLORCA</nomzge>

</infzge> 

<infzge>

<codzge>ESBAL</codzge> <zgesup>ES</zgesup>  

<tipzge>COM</tipzge>

<nomzge>ISLAS BALEARES</nomzge>

</infzge>

<infzge>  

<codzge>ES</codzge>      

                       <tipzge>PAI</tipze>

<nomzge>ESPAÑA></nomzge>

</infzge>

</DisponibilidadDestinoRespuesta>