Tratamento de solicitações de reserva

Evite erros e perdas gerenciando as solicitações de reserva corretamente.

Visão geral

É importante projetar o fluxo de trabalho de solicitações de reserva para que ele seja tolerante a problemas de rede. Não interprete a falta de resposta como um indicador de reserva falhada. Caso ocorra um problema de infraestrutura após o envio de uma solicitação de reserva, mas antes do recebimento da resposta, a reserva do viajante ainda poderá ter sido cobrada e confirmada em nossos sistemas. Possíveis problemas de infraestrutura são:

• A conexão de rede foi perdida (nenhuma resposta foi retornada).
• O erro Server-side (código HTTP 500 ou 503) foi retornado.
• Foi detectado um problema no gateway de rede (o código HTTP 502 foi retornado).
• Ocorreu um timeout no gateway de rede (o código HTTP 504 foi retornado).
• A resposta não está seguindo a documentação Rapid API (falta um elemento chave na mensagem).
• A resposta não está em formato JSON (por exemplo, a mensagem de resposta está em 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. OR
• O valor de itinerary_id e links.retrieve.href retornado na resposta Criar Reserva.

Nota: Itinerários recém-criados podem, por vezes, apresentar um pequeno atraso entre o momento da criação e o momento em que o itinerário pode ser recuperado. Se você receber um erro ao tentar recuperar um itinerário que foi criado com sucesso, ou se receber uma resposta com itinerary_ide creation_date_time, tente novamente a recuperação por 30 minutos antes de entrar em contato com nossos agentes de atendimento para obter mais suporte.

Procedimento recomendado

Sempre enviar affiliate_reference_id

Gere um affiliate_reference_idexclusivo para cada reserva. Se for necessário reenviar os mesmos detalhes da solicitação (como em caso de uma tentativa falha), o mesmo affiliate_reference_iddeve 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

O Rapid API se conecta a sistemas externos para fazer reservas no real-time. Os sistemas dependentes incluem sistemas de reserva ou recepção de hotéis, processadores de cartão de crédito ou sistemas de detecção de fraudes. 98% das reservas podem ser concluídas em aproximadamente 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. Para garantir a compatibilidade com cenários de degradação, tente novamente a recuperação de dados por 30 minutos antes de entrar em contato conosco para obter mais suporte.

Disputas de reserva

Caso encontre algum problema com a reserva devido a timeouts, erros de código HTTP 50x ou outros problemas de infraestrutura, forneça os seguintes registros de transação para que possamos solucionar o problema:

• A solicitação de reserva e a resposta (se disponível).
• A solicitação e a resposta de Recuperação de Reserva enviadas 30 minutos 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.

Leia mais sobre como lidar com erros comuns Rapid API, incluindo exemplos de respostas de erro HTTP, pseudocódigo usado para lidar com reservas e um exemplo de interface do usuário no Apêndice.