Cancela una reserva existente para una habitación individual. Para cancelar una reserva completa de varias habitaciones, se debe cancelar una por una todas las habitaciones del itinerario.

Si necesita ayuda para validar o enviar un mensaje sobre las penalizaciones por cancelación del hotel, consulte nuestra documentación en la matriz de cancelPolicyInfoList.

Si recibe un error al cancelar una reserva activa, consulte nuestra página de errores de cancelación. Consulte nuestros procedimientos de reservas de prueba si necesita ayuda con las reservas de prueba.

 


Formatos de solicitud
URL de XML/REST: GET http://api.ean.com/ean-services/rs/hotel/v3/cancel?
Elemento principal de XML: <HotelRoomCancellationRequest>



Parámetros de solicitud

Parámetros base
Nombre Valor Requerido Descripción
apiExperience cadena

Utilice este atributo para identificar el origen de su solicitud. Para cada solicitud que envíe, elija un valor aplicable del conjunto de opciones que se proporciona a continuación.

Valores:
PARTNER_CALL_CENTER - solicitud de un agente de su centro de llamadas
PARTNER_WEBSITE - solicitud de un sitio web para clientes
PARTNER_MOBILE_WEB - solicitud de un sitio web para móviles
PARTNER_MOBILE_APP - solicitud de una aplicación para móviles
PARTNER_BOT_CACHE - solicitud de un bot de caché
PARTNER_BOT_REPORTING - solicitud de un bot de informes
PARTNER_AFFILIATE - solicitud de una plataforma o API que sirve a su propia base de afiliación

itineraryId largo El ID del itinerario proporcionado en el momento en que se efectuó la reserva.
email cadena La dirección de correo electrónico que se proporcionó en el momento en que se efectuó la reserva.
confirmationNumber cadena El número de confirmación correspondiente a la habitación que se debe cancelar.

Recuerde que las reservas de varias habitaciones deben cancelarse habitación por habitación en solicitudes independientes (no funcionará el envío de varios números de confirmación en una sola solicitud).
reason cadena no Código del motivo de la cancelación, si corresponde. No es obligatorio y no suele afectar al procesamiento de la cancelación.

Valores:
HOC: El hotel me ha solicitado una cancelación.
COP: Cambio de planes.
FBP: He encontrado un precio mejor.
FBH: He encontrado un hotel mejor.
CNL: He decidido cancelar mis planes.
NSY: Prefiero no dar detalles.
OTH: Otros.


Contenido de la respuesta
Elemento principal: HotelRoomCancellationResponse

Nombre Valor Descripción
cancellationNumber cadena Número de referencia de la cancelación, si se realiza correctamente. Los clientes deberían conservar sus números de itinerario y de confirmación además de este, como referencia por si reciben más correspondencia en el futuro.

Ejemplo de solicitud REST:

http://api.ean.com/ean-services/rs/hotel/v3/cancel?
minorRev=[current minorRev #]
&cid=54321
&sig=5432145
&apiKey=[xxx-yourOwnKey-xxx]
&customerUserAgent=[xxx]
&customerIpAddress=[xxx]
&customerSessionId=[xxx]
&locale=en_US
&currencyCode=USD
&itineraryId=xxxxxxx
&email=email@domain.com
&reason=COP
&confirmationNumber=xxxxxxxx 

Ejemplo de respuesta JSON:

{"HotelRoomCancellationResponse":{"customerSessionId":"XXXX","cancellationNumber":"XXXXX"}}

Ejemplo de solicitud XML:

http://api.ean.com/ean-services/rs/hotel/v3/cancel?
minorRev=[current minorRev #]
&cid=#####
&sig=##############
&apiKey=[xxx-yourOwnKey-xxx]
&customerUserAgent=[xxx]
&customerIpAddress=[xxx]
&customerSessionId=[xxx]
&locale=en_US
&currencyCode=USD
&xml=
<HotelRoomCancellationRequest>
	<itineraryId>xxxxxxx</itineraryId>
	<email>email@domain.com</email>
	<reason>COP</reason>
	<confirmationNumber>xxxxxxxx</confirmationNumber>
</HotelRoomCancellationRequest>

Ejemplo de respuesta XML:

<ns2:HotelRoomCancellationResponse> 
   <customerSessionId>XXXX</customerSessionId>
   <cancellationNumber>XXXXXX</cancellationNumber>
</ns2:HotelRoomCancellationResponse>