Cancele uma reserva existente para um único quarto.

Para cancelar uma reserva de vários quartos, cada quarto no itinerário deve ser cancelado individualmente.

Se você precisar de ajuda para analisar ou enviar por mensagem multas por cancelamento de hotel, consulte a nossa documentação na cancelPolicyInfoList matriz.
Sempre será retornado um erro ao cancelar reservas estáticas de teste. Isso é normal; reservas de teste nunca são incluídas nos nossos sistemas de pagamento, acomodação ou inventário de quartos disponíveis.
Para verificar o seu teste de cancelamento, procure o nosso e-mail de pós-cancelamento automatizado ou use uma solicitação de itinerário de acompanhamento.

Se você receber um erro ao cancelar uma reserva ativa, consulte nossa página de erros de cancelamento.


Formatos de solicitação
URL em XML/REST: GET http://api.ean.com/ean-services/rs/hotel/v3/cancel?
Elemento pai XML: <HotelRoomCancellationRequest>



Parâmetros de solicitação

Parâmetros base
Nome Valor Obrigatório Descrição
apiExperience string sim

Use esse atributo para identificar a origem de sua solicitação. Selecione um valor aplicável do conjunto fornecido abaixo para cada solicitação enviada.

Valores:
PARTNER_CALL_CENTER - solicitação de um agente no seu call center
PARTNER_WEBSITE - solicitação de um site direcionado aos clientes
PARTNER_MOBILE_WEB - solicitação de um site formatado para dispositivos móveis
PARTNER_MOBILE_APP - solicitação de um app
PARTNER_BOT_CACHE - solicitação de um robô de cache
PARTNER_BOT_REPORTING - solicitação de um robô de relatório
PARTNER_AFFILIATE - solicitação de uma API/plataforma usada por sua própria base de afiliados

itineraryId long sim A ID de itinerário fornecida no momento da reserva.
email string sim O endereço de e-mail fornecido no momento da reserva.
confirmationNumber string sim O número de confirmação do quarto a ser cancelado.

Lembre-se de que as reservas de vários quartos devem ser canceladas em solicitações separadas, um quarto de cada vez. Enviar vários números de confirmação em uma única solicitação não funcionará.
reason string não Código do motivo do cancelamento, se apropriado. Isso não é obrigatório e, normalmente, não afeta o processamento do cancelamento.

Valores:
HOC: O hotel me pediu para cancelar
COP: Mudança de planos
FBP: Descobri um preço melhor
FBH: Descobri um hotel melhor
CNL: Decidi cancelar os meus planos
NSY: Prefiro não dizer
OTH: Outro


Conteúdo da resposta
Elemento pai: HotelRoomCancellationResponse

Nome Valor Descrição
cancellationNumber string Número de referência do cancelamento, se bem-sucedido. Os clientes devem continuar guardando seus números de itinerário e de confirmação, além deste número, para qualquer correspondência futura.

Exemplo de solicitação 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 

Exemplo de resposta JSON:

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

Exemplo de solicitação 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>

Exemplo de resposta XML:

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