Disponibilidad Hotel

Este mensaje devuelve la lista de hoteles que cumplen los criterios de búsqueda de la petición. El elemento distri de la petición contiene cada una de las posibles distribuciones.

DisponibilidadHotelPeticion

DisponibilidadHotelPeticion: mensaje de petición de disponibilidad para los servicios de tipo estancia.

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
codprv	N	String	Longitud máxima: 10	Código de proveedor
fecini	S	Date		Fecha inicial
fecfin	S	Date		Fecha final
codser	C	String[]	Longitud máxima: 50	Código de servicio
codzge	C	String	Longitud máxima: 50	Código de zona geográfica
nomser	C	String	Longitud máxima: 100	Nombre del servicio
subtse	C	String	Longitud máxima: 5	Código de subtipo de servicio
codsca	C	String[]	Longitud máxima: 50	Código de categoría del servicio
codcas	C	String[]	Longitud máxima: 10	Característica del servicio
codcia	C	String	Longitud máxima: 10	Código de la cadena hotelera
codloc	C	String	Longitud máxima: 10	Código de localización del servicio
medloc	C	Enumeration	KM M MI HH	Media del valor de la localización del servicio. KM: kilómetros. M: metros. MI: minutos. HH: horas.
valloc	C	String	Longitud máxima: 5	Valor de la localización del servicio. Si no está el código de localización, el valor hará referencia al centro de la zona de búsqueda
codsmo	N	String	Longitud máxima: 100	Código de la modalidad del servicio
codcha	N	String[]	Longitud máxima: 30	Código de la característica de la modalidad.
codral	N	String[]	Longitud máxima: 10	Código de régimen alimenticio
filprt	N	Filprt	Ver definición	Ver definición
codtts	N	String[]	Longitud máxima: 3	Filtro de segmentación de tarifa.
codtrf	N	String	Longitud máxima: 15	Código de tarifa
impmin	N	Double	Valor mínimo: 0 Valor máximo: 100.000	Importe mínimo
impmax	N	Double	Valor mínimo: 0 Valor máximo: 100.000	Importe máximo
tippag	N	Enumeration	C P N T F R A E I G J	Tipo de pago. C: pago a crédito. P: prepago. N: no vender. T: tarjeta de crédito. F: por teléfono. R: transferencia bancaria. A: pago al contado. E: en establecimiento. I: inmediato. G: gastos de cancelación. J: tarjeta prepago
chkscm	N	Check	Ver definición	Indica solo confirmado.Por defecto(N).
*distri*	S	*Distri[]*	*Ver definición*
chkvca	N	Check	Ver definición	Indica si hay que valorar los gastos de cancelación.
*ordena*	N	*Ordena[]*	*Ver definición*	*Ver definición*
*filtra*	N	*Filtra[]*	*Ver definición*	*Ver definición*
traduc	N	Enumeration[]	codcas, codcha, codcia, coddiv, codemp, codloc, codnot, codral, codsca, codsmo, codsup, codtse, codusu, codzge, cupest, desele, grpcas, nomzge, refnot, subtse, tipdoc, tippag, zgeori	Campos a traducir en la respuesta. Para cada campo se puede indicar sólo el nombre, o el nombre más almohadilla (#). En caso de sólo poner el nombre traducirá la descripción; si también se pone la almohadilla traducirá además el código.
numrst	N	Integer	Valor mínimo: 10 Valor máximo: 1.000	Número de resultados que se desean en la respuesta. Si el número de resultados es mayor que este valor, paginará.
indpag	N	Integer	Valor mínimo: 0 Valor máximo: 10.000	Índice de la página.
flgemp	N	String[]	A	Si en la petición se indica este nodo con el valor A (<flgemp>A</flgemp>), combinado con el codtou=HTI, el sistema devolverá el producto interno de Hotetec pero sólo de Alojamientos finales (descartando producto de receptivos).

Comentarios:

codser o codzge son obligatorios. Si se pone codzge, adicionalmente como opcionales, se pueden poner más parámetros de filtrado: nomser, subtse, codsca, codcas, codcia, codloc, medloc y valloc.
Los gastos de cancelación sólo se podrán valorar si el proveedor ofrece la información necesaria.
Filtrado: el filtrado de elementos se puede realizar de dos maneras: como elemento del propio mensaje DisponibilidadHotelPeticion indicándolos o como sub elemento de Filtra. En el primer caso la propia consulta en la plataforma ya devolverá el resultado filtrado. En el segundo caso, indicando los valores en el elemento Filtra, primero se realiza la consulta de forma general y después se filtran los resultados.
Paginación: para que la respuesta de la disponibilidad nos realice paginación a nivel de hotel se lo debemos indicar en el valor del elemento numrst. Se indica un valor por el cual, si la respuesta tiene un número de resultados mayor, entonces hará páginas del número marcado en numrst. Por ejemplo: si informamos numrst con el valor de 20 y la respuesta nos da 44 resultados, entonces nos hará dos páginas completas de 20 hoteles cada una y una de 4.

Sub elemento Filprt: Filtro de propiedades de tarifa.

Elemento	O	Tipo de datos	Restricciones	Descripción
grpfil	S	Grpfil[]	Ver definición	Ver definición

Comentarios: Todos los grupos de filtro (grpfil) se tienen que cumplir para que se retorne la tarifa. Operador lógico AND entre grupos de filtro propiedades.

Ejemplo: Ver ejemplos de filtros.

Utilizado en:

DisponibilidadHotelPeticion

Sub elemento Grpfil: agrupación de filtros de propiedades de tarifa.

Elemento	O	Tipo de datos	Restricciones	Descripción
selprt	S	Selprt[]	Ver definición	Ver definición

Comentarios: Alguno de los filtro de selección de propiedad (selprt) se tienen que cumplir para que se retorne la tarifa. Operador lógico OR entre selprt.

Utilizado en:

DisponibilidadHotelPeticion

Sub elemento Selprt: filtro de selección de una propiedad de la tarifa.

Elemento	O	Tipo de datos	Restricciones	Descripción
tipprt	S	String	Longitud máxima: 10 NRE MED UNE OFF ON MAR RES OPA REG OUT HGL II FUN EXC INC TAX AGT CC	Código de tipo de propiedad. NRE: Non Refundable MED: Older than UNE: Unemployed OFF: Offline ON: Online MAR: Market RES: Resident OPA: Opaque REG: Sign in OUT: Exclude Calendar_Alternative HGL: Highlighted Rate II: Insurance Included FUN: Public worker EXC: Excluded Country INC: Included Country TAX: Tax Included AGT: Agent CC: Call Center
valprt	N	String	Longitud máxima: 10	Valor de la propiedad. Si no se indica valor solo se filtrará por tipprt.
flgsel	S	Enumeration	INC EXC	Incluir o excluir la propiedad INC: la tarifa tiene que incluir la propiedad. EXC: la tarifa no tiene que incluir la propiedad.
nonprt	N	Enumeration	INC EXC	Indica si hay que incluir o excluir las tarifas que no contengan la propiedad tipprt INC: incluir.Valor por defecto EXC: excluir.

Comentarios: el valor indicado en nonprt solo se tendrá en cuenta si la tarifa no tiene la propiedad tipprt. Si la tarifa tiene la propiedad tipprt se retornará en función de los campos valprt y flgsel.
Ejemplo: Tarifa tiene propiedad MERCADO (tipprt=MAR) y valor BRITÁNICO (valprt=BRIT). Si se aplica un filtro tipprt=MAR y valprt=GER. Si flgsel=INC no se retornará la tarifa, si flgsel=EXC sí se retornará la tarifa.
Ejemplo: Tarifa tiene propiedad MERCADO (tipprt=MAR) y valor ITALIA (valprt=ITAL). Filtro tipprt=MAYORES y valprt=65. No se hace caso al campo flgsel. Si nonprt=INC se retornará la tarifa, si nonprt=EXC no se retornará la tarifa.

Utilizado en:

DisponibilidadHotelPeticion

Sub elemento Distri: distribución de pasajeros.

Elemento	O	Tipo de datos	Restricciones	Descripción
@id	S	String	Longitud máxima: 100	Identificador del elemento
numuni	S	Integer	Valor mínimo: 0 Valor máximo: 100	Número de unidades
numadl	C	Integer	Valor mínimo: 0 Valor máximo: 100	Número de adultos
numnin	C	Integer	Valor mínimo: 0 Valor máximo: 100	Número de niños
numbeb	C	Integer	Valor mínimo: 0 Valor máximo: 100	Número de bebes
numanc	C	Integer	Valor mínimo: 0 Valor máximo: 100	Número de ancianos
edanin	N	Integer	Valor mínimo: 0 Valor máximo: 21	Edad de un niño

Comentarios: uno de los elementos numadl, numnin, numbeb o numanc es obligatorio. Los tipos de pasajero son a título informativo. En caso de pedir disponibilidad para niños y/o bebes se recomienda informar el campo edanin con las edades respectivas de cada niño y/o bebé. Depende de cada proveedor las condiciones de consideración de los tipos según las edades. Si este campo no se informa la plataforma le dará un valor por defecto según cada caso.

Utilizado en:

DisponibilidadHotelPeticion

Sub elemento Ordena: configuración de un campo de ordenación

Elemento	O	Tipo de datos	Restricciones	Descripción
codele	S	Enumeration	codcas codcha codcia coddiv codidi codprv codral codsca codsmo codsup codtse subtse	Código de elemento. codcas: característica del servicio. codcha: característica de la modalidad. codcia: código de lacadena hotelera coddiv: código de divisa. codidi: código de idioma. codprv: código de proveedor. codral: régimen alimenticio. codsca: categoría del servicio. codsmo: modalidad del servicio. codsup: código de suplemento. codtse: tipo de servicio. subtse: subtipo de servicio.
condic	N	Enumeration	NO EQ DI GR GREQ MI MIEQ CO EX	Condición a utilizar. NO: sin condición. EQ: condición igual. DI: condición distinto. GR: condición mayor que. GREQ: condición mayor o igual que. MI: condición menor que. MIEQ: condición menor o igual que. CO: condición contenido en “[]” EX: condición no contenido en “][“
valele	N	String[]	Longitud máxima: 100	Valor del elemento
chkasc	S	Check	Ver definición	Indica si la ordenación es ascendente o descendente.

Comentarios: para realizar una ordenación de los resultados se debe indicar por qué campo se quiere ordenar en el elemento codele y también el tipo de ordenación que interese, si ascendente o descendente (chkasc).Adicionalmente se puede especificar la condición de ordenación (condic)y que valores se quieren utilizar para realizar la comparativa (valele).

Utilizado en:

DisponibilidadHotelPeticion

Sub elemento Filtra: configuración de un campo de filtrado.

Elemento	O	Tipo de datos	Restricciones	Descripción
@id	S	String	Longitud máxima: 100	Identificador del elemento
codele	S	Enumeration	codcas codcha codcia coddiv codidi codprv codral codsca codsmo codsup codtse subtse	Código de elemento. codcas: característica del servicio. codcha: característica de la modalidad. codcia: código de la cadena hotelera. coddiv: código de divisa. codidi: código de idioma. codprv: código de proveedor. codral: régimen alimenticio. codsca: categoría del servicio. codsmo: modalidad del servicio. codsup: código de suplemento. codtse: tipo de servicio. subtse: subtipo de servicio.
elesup	N	String	Longitud máxima: 6	Código de elemento superior
condic	S	Enumeration	NO EQ DI GR GREQ MI MIEQ CO EX	Condición a utilizar. NO: sin condición. EQ: condición igual. DI: condición distinto. GR: condición mayor que. GREQ: condición mayor o igual que. MI: condición menor que. MIEQ: condición menor o igual que. CO: condición contenido en “[]” EX: condición no contenido en “][“
opelog	N	Enumeration	AND OR NOT XOR THEN	Acción de cancelación. AND: Y lógica. Valor por defecto. OR: O lógica. NOT: negación. Sólo para el operador asociado. XOR: O exclusiva. THEN: Si A entonces B.
refftr	N	String	Longitud máxima: 100	Referencia al filtro al que se le aplicará el operador lógico
chksma	N	Check	Ver definición	Indica si de la lista sólo se quieren los márgenes o todos los valores.
valstr	C	String[]	Longitud máxima: 100	Cadena de caracteres
valfec	C	Date[]		Valor de una fecha
valhor	C	DateTime[]		Valor de una hora

Comentarios: valstr, valfec o valhor son obligatorios.

Utilizado en:

DisponibilidadHotelPeticion

Ejemplo de petición de disponibilidad de hotel para las fechas del 1 al 6 de junio. Se especifica el código de zona en la que se quiere realizar la disponibilidad y la distribución requerida es de una unidad de 2 adultos.

<distriid="1">

</distri>

</DisponibilidadHotelPeticion>

Disponibilidad Hotel Respuesta

DisponibilidadHotelRespuesta: mensaje de respuesta de la petición de disponibilidad de hotel.

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
*infhot*	N	*Infhot[]*	*Ver definición*	*Ver definición*
*infftr*	N	*Infftr[]*	*Ver definición*	*Ver definición*
numpag	N	Integer	Valor mínimo: 0 Valor máximo: 1.000	Número de página actual
totpag	N	Integer	Valor mínimo: 0 Valor máximo: 10.000	Número de páginas o si faltan páginas por cargar
totrst	N	Integer	Valor mínimo: 0 Valor máximo: 1.000.000	Total de resultados
*Error*	N	*error (Grupo)*	*Ver definición*	*Ver definición*

Comentarios: los campos para realizar la paginación (numpag,totpag y totrst)forman parte de un grupo único. Los campos son opcionales, pero si hay uno están todos.

Paginación: si en la petición se ha informado el campo numrst (Ver explicación), entonces en la respuesta nos vendrán informados los tres campos antes indicados.

Siguiendo con el ejemplo de antes (44 resultados y numrst con valor 20) los valores de los campos de paginación de resultado serían para totrst 44; totpag 3 (en 3 páginas se verán todos los resultados) y numpag valdrá 1, 2 o 3 según la página donde nos encontremos.

Sub elemento Infhot: información de disponibilidad de un servicio de estancia.

Elemento	O	Tipo de datos	Restricciones	Descripción
@id	S	String	Longitud máxima: 100	Identificador del elemento
fecini	S	Date		Fecha inicio
fecfin	S	Date		Fecha fin
codtse	S	String	Longitud máxima: 5	Código de tipo de servicio
subtse	N	String	Longitud máxima: 5	Código de subtipo de servicio
nomser	S	String	Longitud máxima: 100	Nombre del servicio
codsca	S	String	Longitud máxima: 50	Código de la categoría del servicio
codcia	N	String	Longitud máxima: 10	Código de la cadena hotelera
codloc	N	String	Longitud máxima: 10	Código de localización del servicio
codcas	N	String[]	Longitud máxima: 10	Característica del servicio
codzge	S	String	Longitud máxima: 50	Código de zona geográfica
coddiv	S	Enumeration	EUR, USD, GBP, EGP, MXN, CHF	Código de divisa. Se utilizan los códigos ISO 4217 para las divisas de las que, actualmente, sólo se aceptan las enumeradas.
cambio	N	Double	Valor mínimo: 0 Valor máximo: 1.000.000	Cambio con el que se calcula el precio
impbas	S	Double	Valor mínimo: 0 Valor máximo: 100.000	Importe base. Este es el importe total de la reserva menos los impuestos (incluyendo comisión en caso de que la tarifa sea comisionable)
codser	S	String	Longitud máxima: 50	Código de servicio
cupest	S	Enumeration	ND CE DS OP PC CM VL AN FA	Estado del cupo. ND: no disponible. CE: cerrado. DS: disponible. OP: opción. PC: en petición. CM: confirmado. VL: venta libre. AN: anulado. FA: facturado.
*infhab*	S	*Infhab[]*	*Ver definición*	*Ver definición*

Utilizado en:

DisponibilidadHotelRespuesta

Sub elemento Infhab: informa de la disponibilidad de una modalidad de habitación (tipo de habitación, característica y régimen).

Elemento	O	Tipo de datos	Restricciones	Descripción
@id	S	String	Longitud máxima: 100	Identificador del elemento
@refdis	N	String	Longitud máxima: 100	Referencia a una distribución
codcon	N	String	Longitud máxima: 200	Código de contrato
codtrf	N	String[]	Longitud máxima: 15	Código de tarifa
nomtrf	N	String[]	Longitud máxima: 100	Nombre de la tarifa
codsmo	S	String	Longitud máxima: 100	Código de la modalidad del servicio
codcha	S	String[]	Longitud máxima: 30	Código de la característica de la modalidad.
codral	S	String	Longitud máxima: 10	Código de régimen alimenticio
capmax	S	Integer	Valor mínimo: 0 Valor máximo: 1.000	Capacidad máxima del servicio
capmin	S	Integer	Valor mínimo: 0 Valor máximo: 1.000	Capacidad mínima del servicio
adlmax	S	Integer	Valor mínimo: 0 Valor máximo: 100	Número máximo de adultos
ninmax	S	Integer	Valor mínimo: 0 Valor máximo: 100	Número máximo de niños
cupest	S	Enumeration	ND CE DS OP PC CM VL AN FA	Estado del cupo. ND: no disponible. CE: cerrado. DS: disponible. OP: opción. PC: en petición. CM: confirmado. VL: venta libre. AN: anulado. FA: facturado.
cupinv	N	Integer	Valor mínimo: 0 Valor máximo: 1.000	Cupo actual del inventario
impnoc	C	Double	Valor mínimo: 0 Valor máximo: 100.000	Importe no comisionable
impcom	C	Double	Valor mínimo: 0 Valor máximo: 100.000	Importe comisionable
imptax	C	Double	Valor mínimo: 0 Valor máximo: 100.000	Importe de la tasa turística
ivatax	C	Double	Valor mínimo: 0 Valor máximo: 100.000	Importe del IVA de la tasa turística
tipapl	S	Enumeration	U E S P	Tipo de aplicación. U: aplicación de estancia servicio. E: aplicación de estancia pasajero. S: aplicación de día servicio. P: aplicación de día pasajero.
tippag	N	Enumeration	C P N T F R A E I G J	Tipo de pago. C: pago a crédito. P: prepago. N: no vender. T: tarjeta de crédito. F: por teléfono. R: transferencia bancaria. A: pago al contado. E: en establecimiento. I: inmediato. G: gastos de cancelación. J: tarjeta prepago
codprv	N	String	Longitud máxima: 10	Código de proveedor
*infofe*	N	*Infofe[]*	*Ver definición*	*Ver definición*
pvpobl	N	Double	Valor mínimo: 0 Valor máximo: 100.000	Precio de venta obligatorio.
*rstcan*	N	*Rstcan[]*	*Ver definición*	*Ver definición*
*infprv*	N	*Infprv*	*Ver definición*	*Ver definición*
*Infprt*	N	*Infprt[]*	*Ver definición*	*Ver definición*

Utilizado en:

Infhot

Comentarios: impcom y impnoc forman parte de un grupo opcional. Generalmente se informa uno u otro. En caso que vengan los dos informados deberán sumarse ambos importes.

Sub elemento Infofe: información de una oferta.

Elemento	O	Tipo de dato	Restricciones	Descripción
@id	S	String	Longitud máxima: 100	Identificador del elemento
codofe	S	String	Longitud máxima: 15	Código de oferta
nomofe	S	String	Longitud máxima: 100	Nombre de la oferta
codogr	N	String	Longitud máxima: 10	Código de grupo de oferta
coddiv	N	Enumeration	EUR, USD, GBP, EGP, MXN, CHF, CUP	Código de divisa. Se utilizan los códigos ISO 4217 para las divisas de las que, actualmente, sólo se aceptan las enumeradas.
impbas	C	Double	Valor mínimo: 0 Valor máximo: 100.000	Importe base. Este es el importe total de la reserva menos los impuestos (incluyendo comisión en caso de que la tarifa sea comisionable)
pordes	C	Decimal	Valor mínimo: -100 Valor máximo (inclusivo): 100 Máximo de decimales: 3 Dígitos permitidos: 6	Porcentaje de descuento
chkacu	N	Check	Ver definición	Indica si es acumulable el elemento que lo contiene.

Comentarios: impbas y pordes es obligatorio.

Utilizado en:

Infhab

Sub elemento Rstcan: restricciones de cancelación.

Elemento	O	Tipo de datos	Restricciones	Descripción
feccan	S	Date		Fecha de cancelación
porcan	C	Decimal	Valor mínimo: -100 Valor máximo (inclusivo): 100 Máximo de decimales: 3 Dígitos permitidos: 6	Porcentaje de coste de la cancelación
impcan	C	Double	Valor mínimo: 0 Valor máximo: 100.000	Importe de cancelación
aplcan	N	Enumeration	P T	Código de aplicación del cálculo de coste de la cancelación. Si el elemento no está informado el cálculo de coste es un valor fijo. P: cálculo sobre el precio de la primera noche. T: cálculo sobre el total del elemento donde se encuentre Rstcan.
txtinf	C	String	Longitud máxima: 4.000	Texto de información.

Comentarios: porcan, impcan y txtinf son obligatorios.

Utilizado en:

Estsmo

Infhab

ReservaAbrirRespuesta

ReservaCerrarRespuesta

Sub elemento Infprv: Información sobre los códigos del proveedor.

Elemento	O	Tipo de datos	Restricciones	Descripción
codsmo	N	String	Longitud máxima: 100	Código de la modalidad del servicio
nomsmo	N	String	Longitud máxima: 100	Nombre de la modalidad del servicio
codral	N	String	Longitud máxima: 10	Código de régimen alimenticio
nomral	N	String	Longitud máxima: 100	Nombre de régimen alimenticio
codtrf	N	String	Longitud máxima: 100	Código de la tarifa
nomtrf	N	String	Longitud máxima: 100	Nombre de la tarifa
codcha	N	String[]	Longitud máxima: 30	Código de la característica de la modalidad.
codsca	N	String	Longitud máxima: 100

Utilizado en:

Infhab

Sub elemento Infprt: Información sobre las propiedades de la tarifa.

Elemento	O	Tipo de datos	Restricciones	Descripción
tipprt	S	String	Longitud máxima: 10 NRE MED UNE OFF ON MAR RES OPA REG OUT HGL II FUN EXC INC TAX AGT CC	Código de tipo de propiedad. NRE: Non Refundable MED: Older than UNE: Unemployed OFF: Offline ON: Online MAR: Market RES: Resident OPA: Opaque REG: Sign in OUT: Exclude Calendar_Alternative HGL: Highlighted Rate II: Insurance Included FUN: Public worker EXC: Excluded Country INC: Included Country TAX: Tax Included AGT: Agent CC: Call Center
valprt	N	String	Longitud máxima: 10	Valor de la propiedad. Si no se indica valor solo se filtrará por tipprt.
desprt	N	String	Longitud máxima: 50	Descripción de la propiedad para el idioma actual.

Utilizado en:

Infhab

Sub elemento Infftr: valores de los elementos por los que se puede filtrar.

Elemento	O	Tipo de datos	Restricciones	Descripción
codele	S	Enumeration	codcas codcha codcia coddiv codidi codprv codral codsca codsmo codsup fcodtse subtse	Código de elemento codcas: característica del servicio. codcha: característica de la modalidad. codcia: código de la cadena hotelera. coddiv: código de divisa. codidi: código de idioma. codprv: código de proveedor. codral: régimen alimenticio. codsca: categoría del servicio. codsmo: modalidad del servicio. codsup: código de suplemento. codtse: tipo de servicio. subtse: subtipo de servicio.
*infele*	N	*Infele[]*	*Ver definición*	*Ver definición*
valstr	C	String[]	Longitud máxima: 100	Cadena de caracteres
valfec	C	Date[]		Valor de una fecha
valhor	C	DateTime[]		Valor de una hora

Comentarios: valstr, valfec Y valhor son obligatorios.

Utilizado en:

DisponibilidadHotelRespuesta

Ejemplo de respuesta de una disponibilidad de hotel.

<infhotid="29">

<nomser>Las Palomas</nomser>

<infhabid="2"refdis="0">

^<infofe>

<nomofe>Long Stay Offer</nomofe>

</infofe>

<nomofe>Promo Room</nomofe>

</infofe>

</infhab>

<infhabid="8"refdis="0">

^<infofe>

<nomofe>Long Stay Offer</nomofe>

</infofe>

</infhab>

</infhot>

</DisponibilidadHotelRespuesta>

Disponibilidad Hotel Imprimir

Artículos Relacionados