Tratamento de solicitações de reserva

É importante tratar de maneira adequada as solicitações de reserva para evitar erros e perdas.

Visão geral

É importante projetar o seu fluxo de trabalho de solicitação de reserva para ser tolerante a problemas de rede. Não interprete uma falta de resposta como um indicador de falha na reserva. Se houver um problema de infraestrutura após o envio de uma solicitação de reserva, mas antes que a resposta seja recebida, a reserva do cliente ainda pode ter sido cobrada e confirmada nos sistemas do Rapid. Possíveis problemas de infraestrutura são:

• Conexão de rede perdida. Por exemplo, nenhuma resposta retornada.
• Erro do servidor retornado. Por exemplo, código HTTP 500 ou 503 retornado.
• Gateway de rede incorreto observado. Por exemplo, código HTTP 502 retornado.
• Tempo limite do gateway de rede observado. Por exemplo, código HTTP 504 retornado.
• A resposta não segue a documentação da Rapid. Por exemplo, falta um elemento-chave na mensagem de resposta.
• A mensagem de resposta não está no formato JSON. Por exemplo, a mensagem de resposta está no formato HTML.
• Outras exceções, erros, comportamento desconhecido ou interrupções.

A solicitação de criação de reserva deve ser seguida por uma solicitação de recuperação de reserva que inclua:

• O valor original de affiliate_reference_id e o e-mail usado na solicitação de criar reserva.
• Ou o valor de itinerary_id e links.retrieve.href retornado na resposta de criar reserva.

O status da reserva pode ser recuperado com exceção do resultado de novas reservas que pode demorar até 90 segundos.

Procedimento recomendado

Sempre enviar affiliate_reference_id

Gere um affiliate_reference_id exclusivo para a reserva de cada cliente. Ao reenviar os mesmos detalhes da solicitação, por exemplo, devido a uma tentativa com falha, o mesmo affiliate_reference_id deverá ser usado. Isso evita reservas duplicadas acidentais. Ao enviar uma nova solicitação de criação de reserva, a API não vai responder até que a reserva seja confirmada ou recusada. A maioria das respostas é retornada em alguns segundos. No entanto, um pequeno número de reservas pode levar vários minutos para ser processado e para gerar uma resposta.

Monitore as reservas que não sejam resolvidas com rapidez

A Rapid estabelece conexão com sistemas externos para fazer reservas em tempo real. Os sistemas dependentes podem ser os diferentes sistemas de reservas dos hotéis, sistemas de recepção, processadores de cartão de crédito ou sistemas de detecção de fraude. 98% das reservas podem concluir o processo em cerca de 13 segundos. No entanto, caso não receba a resposta da reserva após 90 segundos, verifique o andamento da reserva com uma solicitação de recuperação, usando o mesmo affiliate_reference_id que foi enviado com a reserva. Se a reserva ainda estiver em andamento ou se a reserva tiver apresentado falha, você vai receber o erro 404 para itinerário não encontrado com a solicitação informada. Após receber essa mensagem, você deve tentar de novo a sua solicitação de reserva com o mesmo affiliate_reference_id. Se a reserva ainda estiver sendo concluída, você vai ver um erro 400 com uma mensagem informando que já existe um itinerário com o ID de referência do afiliado. Se esse erro for retornado, você vai poder recuperar a reserva de novo para ver se os detalhes da reserva estão prontos para serem visualizados.

A API de recuperação pode retornar erros ou uma resposta incompleta quando uma reserva está sendo processada. Tentar de novo a chamada de recuperação de reserva mais tarde vai recuperar 99,99% dos erros. Caso contrário, entre em contato com os agentes da central de ajuda da Rapid para receber mais suporte.

Disputas de reserva

Se você encontrar algum problema com a reserva devido a tempo máximo de espera, erros de código HTTP 50x ou outros problemas de infraestrutura, forneça os seguintes logs de transações da Rapid API para a solução de problemas:

• A solicitação de reserva e a resposta (se disponível).
• A solicitação e a resposta da recuperação da reserva que foi enviada 90 segundos após a última tentativa de reserva.

O log deve incluir os cabeçalhos HTTP da solicitação e da resposta. A mensagem de resposta tem um cabeçalho transaction-id que nos ajuda a identificar a transação da Rapid API. Você pode encontrar mais diretrizes de tratamento de erros neste link.

Faça login na sua conta do suporte da Rapid para ver o exemplo de interface do usuário, o pseudocódigo para lidar com reservas e exemplos de plano de integração.