API de reservas de hotel e voo: uma viagem, duas reservas

O ticket diz "adicionar hotéis ao fluxo de voos, um checkout, um total". É um pedido razoável de um gerente de produto e parece trabalho para um dia, porque você já tem a busca de voos e já tem uma página de pagamento. Três semanas depois, o time está discutindo o que deve acontecer quando a companhia aérea confirma e o hotel não. Uma API de reservas de hotel e voo não é uma integração com dois tipos de resultado. São duas integrações que dividem um carrinho.
Quanto antes o código admitir isso, menos dele será reescrito. O que vem a seguir é a parte que os guias de integração pulam: em que as duas metades diferem, qual delas confirmar primeiro e o que uma viagem precisa ser no seu modelo de dados.
As duas metades não se comportam da mesma forma
As duas voltam como JSON com um preço e uma referência, então parecem iguais na rede. Não são iguais no que prometem depois que você tem a referência.
| Pergunta | Voo | Hotel |
|---|---|---|
| O que você tem depois da reserva | Uma reserva (PNR) que ainda não é um bilhete | Uma confirmação que normalmente já é o que você vendeu |
| Por quanto tempo o preço vale | Até a tarifa ser recotada na reserva, e ela pode diferir da busca | Até a tarifa expirar, e uma tarifa pode mudar entre a disponibilidade e a reserva |
| O que confirma | A emissão, muitas vezes contra um prazo limite | A confirmação do fornecedor, às vezes instantânea, às vezes pendente |
| Como se desfaz | Um void se for pego cedo; depois, um reembolso pelas regras da tarifa, muitas vezes com multa | Um cancelamento pela política da própria tarifa, gratuito até um prazo em muitas tarifas |
| O que muda o valor no fim | Tarifa, taxas, às vezes a moeda da tarifa | Taxas e cobranças pagas no hotel, o regime de alimentação, o quarto efetivamente atribuído |
Você pode discordar de uma linha, já que os fornecedores variam, mas não do formato: uma metade tem uma etapa de emissão e a outra tem uma janela de cancelamento, e elas não se alinham no tempo. Tratamos o lado do voo dessa sequência em integração de API de reservas de voos e o problema do fornecedor lento no lado do hotel em design de cliente para API de disponibilidade de hotéis. Este texto começa onde aqueles terminam: na junção.
Qual você reserva primeiro?
Ninguém avisa que isso é uma decisão de design, e é ela que define quanto custa uma falha.
Imagine que um cliente compra um voo e um hotel para as mesmas datas. Você envia uma reserva e depois a outra. Três coisas podem acontecer: as duas dão certo, ou uma falha, ou uma falha depois que a outra já deu certo. A primeira é um dia bom. As outras duas definem a sua fila de suporte.
Se você emite o voo primeiro e o hotel recusa em seguida, tem um cliente com assento para uma cidade e sem quarto, que já foi cobrado, e um reembolso de bilhete que carrega multa. Se reserva o hotel primeiro e o voo falha depois, você segura um quarto que muitas vezes pode cancelar de graça, então o conserto é barato. O risco inverso também existe, já que uma tarifa de hotel não reembolsável é a pior coisa para segurar; por isso leia as condições de cancelamento da tarifa antes de deixá-la ir na frente.
Isso é uma regra prática, não uma lei, e o ponto é escolher a ordem de propósito. Confirme a metade mais fácil de desfazer antes da mais difícil, verifique o preço das duas logo antes de qualquer uma confirmar e anote o que você faz em cada um dos três resultados. Revisores raramente perguntam. Clientes sempre descobrem.
Uma viagem, duas reservas
O formato que se sustenta é um registro de viagem que possui duas reservas, cada uma com sua referência, seu status e suas condições. O cliente vê um total. O seu banco de dados vê duas linhas, e o total é uma soma que você calcula, não algo que existe no fornecedor.
Mantenha os dois status separados. "Confirmado" para o hotel e "emitido" para o voo não são o mesmo estado, e uma única coluna de status que os achata vai, cedo ou tarde, dizer "reservado" sobre uma viagem reservada pela metade.
Mantenha separadas também as duas condições de alteração, e mostre-as. Um total exibido esconde que mudar as datas é uma edição gratuita numa metade e uma taxa na outra. Se o seu front-end mostra "alterar datas" como um único botão, decida o que ele faz quando só uma metade pode mudar, antes que um cliente descubra por você. O mesmo vale para o markup: se você aplica o seu por serviço, como a maioria dos vendedores faz, o total da viagem são dois markups, e um reembolso de uma metade precisa saber qual markup está devolvendo. Dinheiro é onde uma viagem combinada fica cara, porque as linhas se liquidam em prazos diferentes, e o reembolso de um voo não chega quando chega o cancelamento do hotel.
Onde esta plataforma se encaixa
Sem rodeios: a plataforma expõe APIs de voos e de hotéis, e o acesso começa com uma conversa, não com uma chave em autoatendimento. Os serviços são ativados por tenant, então um tenant que vende hotéis e não passeios não carrega a superfície de passeios. Nada aqui promete uma única chamada que reserve as duas metades de forma atômica, e você não deve projetar como se prometesse. Trate-as como as duas reservas que são, dentro de uma viagem que é sua.
Se quiser ver as chamadas e as condições reais antes de construir em cima delas, comece pela página de APIs de viagem e leve a ordem em que pretende reservar. Se ainda está decidindo o que o acesso gratuito oferece, API gratuita de reservas de hotel explica os tipos de gratuito.
Quanto custa errar
A versão cara é a silenciosa. Um cliente tem bilhete emitido para uma cidade e o quarto sumiu, e a primeira notícia que você tem é uma mensagem à noite, de um aeroporto. Mais barato, mas ainda real: um checkout que mostra um total tranquilizador e depois, após uma checagem de preço, um segundo número com que o cliente não concordou; um reembolso que devolve o voo e esquece o hotel; e um status que diz "reservado" enquanto o fornecedor diz outra coisa.
Nada disso exige uma solução engenhosa. Exige que a viagem seja um objeto real, que a ordem seja uma decisão que alguém escreveu, e uma nova checagem dos dois preços no último momento antes de qualquer um confirmar. Construa isso uma vez e o checkout pode parecer tão simples quanto o ticket pediu.