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.

Mais diretrizes para tratamento de erros.

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