O que fazer ao receber um timeout na resposta doBooking?

Alguns clientes nos acionam por tickets solicitando explicações ou até reembolsos de reservas que foram geradas no Cangooroo, mas que não aparecem em seus sistemas.

Na maioria dos casos, isso acontece porque o cliente interpreta um timeout (expiração do tempo de conexão configurado) como se fosse uma negativa para criação da reserva. Porém, não é isso que ocorre. Veja como entender melhor esse cenário:

Durante o processo de criação de reservas pela API, pode acontecer de o Cangooroo não responder dentro do tempo definido para o timeout. Mesmo assim, a comunicação entre os sistemas pode ser concluída com sucesso alguns segundos depois, gerando a reserva mesmo após o encerramento da conexão. Esse comportamento está documentado e pode ser tratado pelo cliente ao condicionar reservas sem resposta clara (de sucesso ou negativa) para uma análise manual, seja pela própria agência ou pelo cliente final.

Além disso, sempre que houver retorno de erro HTTP (4XX ou 5XX), recomendamos utilizar o método CheckBookingStatus para confirmar se a reserva foi realmente criada. Esse método retorna o Booking Id e o Service Id ou um erro.

• Se receber um erro, você pode tentar novamente o método doBooking para criar a reserva.

• Caso receba os IDs de reserva e serviço, basta utilizar a API do ClientBackoffice para consultar os detalhes e status da reserva.

⚠️ Atenção: O timeout não significa falha na reserva, mas apenas o tempo limite definido para interromper a requisição. Sempre consulte também nossa documentação da API para melhores práticas e exemplos de tratamento desses cenários.