Certificação API de Hotel do Cangooroo

Criada por Rafaela Menegazzo, Modificado em Seg, 18 Mai na (o) 3:17 PM por Rafaela Menegazzo

Veja o que é necessário para certificar a API de Hotel:

É necessário preencher o formulário e responder as perguntas abaixo, salvar esse documento em um PDF e enviá-lo para suporte@cangooroo.net junto com os arquivos XML ou JSON do fluxo completo de cada cenário de teste detalhado abaixo, em arquivos separados para cada request e response.


Nome do Integrador 

E-mail(s) de contato 

Telefone(s) de contato


Segue abaixo o nome de todos os serviços que devem ser sempre utilizados no fluxo completo de uma reserva de hotel:
1. Search
2. GetBookingConditions
3. DoBooking
4. CancelByService ou CancelAllHotelServices (obrigatória a implementação de ao menos um dos serviços de cancelamento)


Perguntas


1. Você poderia detalhar o fluxo de reserva que está seguindo?
Gostaríamos de ter uma breve explicação sobre como funciona o fluxo de reservas do seu sistema e em que etapa você nos envia cada um dos nossos serviços.

2. Você está ciente que é importante manter a mesma nacionalidade em todas as etapas do fluxo de reserva?
Lembre-se de que é necessário definir a nacionalidade do passageiro na solicitação do DoBooking com o mesmo valor que foi solicitado inicialmente na solicitação de disponibilidade para garantir que a tarifa selecionada permanecerá disponível.

3. Você tem conhecimento de que é necessário sempre verificar o campo “MustCheckHotelInfo” retornado no método “GetBookingConditions”?
Recomenda-se que sempre que for retornado "MustCheckHotelInfo": true no método “GetBookingConditions” sejam revisados os dados de hotel do fornecedor retornados no “GetBookingConditions” (campos "SupplierHotelName" e "SupplierHotelAddress") e seja gerado algum tipo de alerta no sistema do integrador, pedindo ao usuário que confirme se os dados apresentados são do hotel que se deseja reservar antes de avançar com a reserva. Caso o campo "MustCheckHotelInfo" for igual a “true” e os dados de hotel retornados no “GetBookingConditions” forem de outro hotel, diferente do retornado na consulta de disponibilidade, o integrador se responsabiliza ao avançar com a reserva.

4. Você está tratando da forma adequada todos os possíveis status de reserva retornado no campo “Status” da resposta do método “DoBooking”?
É importante que você sempre verifique o status da reserva, pois pode ocorrer algum problema ao tentar gerar a reserva com o fornecedor. Você deve assumir que a reserva foi confirmada apenas se for recebido "Status": "Confirmed". Importante também que você NÃO deve considerar que a reserva não foi confirmada no fornecedor, caso receba algum erro na resposta do doBooking, falta de resposta ou status informando problema técnico.

5. Tem conhecimento da possibilidade de enviar a sua referência de reserva através do campo “ClientReference”?
Recomenda-se enviar esta informação junto com o pedido de confirmação de reserva, pois se houver algum problema com o processo de confirmação de reserva (e, portanto, você ainda não tem nosso localizador), sua própria referência de reserva nos ajudará a identificar se esta reserva acabou sendo criada e/ou o que aconteceu com ela.

6. Você confirma que sabe do fluxo de checagem do status da reserva sempre que houver retorno de erro HTTP (4XX ou 5XX) no metodo “DoBooking”?
É importante que seja feita a validação do status da reserva pelo metodo “CheckBookingStatus” quando o response do “DoBooking” não for conclusivo. Dessa forma você poderá confirmar se a reserva foi devidamente confirmada ou se será necessaria uma nova solicitação.
7. Você entende que só pode considerar uma reserva como “cancelada” após receber a confirmação do cancelamento?
É importante reiterar que caso o response da chamada de cancelamento não retorne o status cancelado, você deve realizar uma nova chamada para garantir que a reserva será realmente cancelada com o fornecedor. Caso contrario ela poderá permanecer ativa e gerar prejuizos.



Cenários de teste

Cenário 1: Confirmar e cancelar uma reserva com 1 quarto com 1 adulto.

Cenário 2: Confirmar e cancelar uma reserva com 2 quartos com 2 adultos no primeiro quarto e 1 adulto e 1 criança no segundo quarto.

Cenário 3: Confirmar e cancelar uma reserva com 3 quartos com 2 adultos cada.

Cenário 4: Confirmar e cancelar uma reserva com 3 quartos, sendo com 1 adulto no primeiro quarto, 1 adulto e uma criança no segundo quarto e 2 adultos e 2 crianças no terceiro quarto.

Este artigo foi útil?

Que bom!

Obrigado pelo seu feedback

Desculpe! Não conseguimos ajudar você

Obrigado pelo seu feedback

Deixe-nos saber como podemos melhorar este artigo!

Selecione pelo menos um dos motivos
A verificação do CAPTCHA é obrigatória.

Feedback enviado

Agradecemos seu esforço e tentaremos corrigir o artigo