Disponibilidad destino
Disponibilidad Destino
Este mensaje devuelve el listado de destinos cargados en la plataforma que estén asociados a la empresa que realiza la petición.
Cada elemento de información de la zona geográfica (Infzge) contiene la información del destino. Estos elementos están ordenados de forma jerárquica. La jerarquía está impuesta por el código de destino superior (zgesup).
DisponibilidadDestinoPeticion
Si en la petición se informa el elemento código de zona geográfica (codzge), la respuesta devolverá un solo elemento de información de zona geográfica (Infzge)con la información correspondiente al codzge especificado en la petición.
Si en la petición se informa el elemento de zona geográfica superior (zgesup),la respuesta devolverá la información de zonas geográficas (Infzge) correspondiente a todas las zonas que dependen jerárquicamente de la zona geográfica superior indicada.
DisponibilidadDestinoPeticion: mensaje de petición de disponibilidad de destinos.
Elemento | O | Tipo de datos | Restricciones | Descripción |
ideses | S | String | Longitud máxima: 40 | Identificador único de sesión |
codtou | S | String |
| Código de TTOO |
tiparb | N | Enumeration | ZHT | Tipo de árbol que se quiere. ZHT: zona para alojamientos. |
codzge | N | String | Longitud máxima: 50 | Código de zona geográfica |
nomzge | N | String | Longitud máxima: 100 | Nombre de la zona geográfica |
tipzge | N | Enumeration | COM DIS GRP MUN PRO REG SBZ SRG ZON | Tipo de zona geográfica.
COM: comunidad autónoma. DIS: distrito. MUN: municipio. PRO: provincia. REG: región. SBZ: sub zona. SRG: sub región. ZON: zona. |
zgesup | N | String | Longitud máxima: 50 | Zona geográfica superior a la que pertenece |
numniv | N | Integer | Valor mínimo: 0 Valor máximo: 100 | Nivel de profundidad de la petición |
Ejemplos:
Mensaje de petición para todas las zonas:
<DisponibilidadDestinoPeticion>
<ideses>XML#17#442106373838493</ideses>
<codtou>HTT</codtou>
<tipzge>ZON</tipzge>
</DisponibilidadDestinoPeticion>
Mensaje de petición para una zona geográfica en concreto:
<DisponibilidadDestinoPeticion>
<ideses>XML#17#442106373838493</ideses>
<codtou>HTT</codtou>
<tiparb>ZHT</tiparb>
<codzge>ES-46659</codzge>
</DisponibilidadDestinoPeticion>
En este caso, se presupone que ya se sabe con anterioridad el valor del código de zona geográfica, previamente a realizar la petición.
Mensaje de petición indicando una zona geográfica superior:
<DisponibilidadDestinoPeticion>
<ideses>XML#17#442106373838493</ideses>
<codtou>HTT</codtou>
<tiparb>ZHT</tiparb>
<zgesup>ESBAL02</zgesup>
</DisponibilidadDestinoPeticion>
En este caso se indica de zona geográfica superior ESBAL02, la cual corresponde a Menorca. La respuesta nos devolvería todas las zonas correspondientes a Menorca (Cala Santandria, Son Bou, Ciutadella, Binibeca, etc.).
DisponibilidadDestinoRespuesta
DisponibilidadDestinoRespuesta: mensaje de respuesta de disponibilidad de destinos.
Elemento | O | Tipo de datos | Restricciones | Descripción |
ideses | S | String | Longitud máxima: 40 | Identificador único de sesión |
codtou | S | String |
| Código de TTOO |
infzge | N | Infzge[] | Ver definición | Ver definición |
error | N | error (Grupo) |
Sub elemento Infzge: información de una zona geográfica, jerarquía.
Elemento | O | Tipo de datos | Restricciones | Descripción |
codzge | S | String | Longitud máxima: 50 | Código de zona geográfica |
zgesup | N | String | Longitud máxima: 50 | Zona geográfica superior a la que pertenece |
tipzge | S | Enumeration | COM DIS MUN PRO REG SBZ SRG ZON | Tipo de zona geográfica. COM: comunidad autónoma. DIS: distrito. MUN: municipio. PRO: provincia. REG: región. SBZ: sub zona. SRG: sub región. ZON: zona. |
nomzge | S | String | Longitud máxima: 100 | Nombre de la zona geográfica |
chkfin | N | Check | Ver definición | Indica si se puede hacer una petición de disponibilidad hotel sobre esta zona. * |
* Comentarios: Por ejemplo: la zona país España tendrá chkfin “N”, porque no se permite realizar una disponibilidad de hotel para toda España. En cambio, para Mallorca el valor de chkfin será “S”.
Utilizado en:
DisponibilidadDestinoRespuesta
Ejemplos:
Mensaje de respuesta con un codzge informado:
<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>
Mensaje de respuesta indicando una zona geográfica superior:
<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>