Pular para o conteúdo principal

Fluxo de Reserva e Ciclo de Vida do PNR

A integração com a Web API Aéreo segue uma máquina de estados estrita. Cada etapa do fluxo cumpre uma função essencial de validação junto às companhias aéreas e consolidadores.

1. Diagrama do Ciclo de Vida da Reserva​

2. Passo a Passo Detalhado de Cada Etapa​

Etapa 1: Descoberta de Fornecedores (/RecuperarSistemasPesquisa)​

  • Objetivo: Identificar quais GDSs e conexões diretas (ex: Sabre, Amadeus, Gol Direto, Latam NDC, Azul) possuem acordos ativos para o par Origem/Destino selecionado.
  • Resultado: Retorna os identificadores numéricos dos sistemas a serem consultados.

Etapa 2: Busca de Disponibilidade (/Disponibilidade)​

  • Objetivo: Efetuar a consulta massiva de voos, horários, conexões e classes disponíveis.
  • Resultado: Retorna os voos encontrados com um identificador criptografado único por opção de voo: o IdentificacaoDaViagem (também chamado de tripKey).
  • Tempo de Vida do IdentificacaoDaViagem: Esse identificador possui validade de aproximadamente 15 a 20 minutos. Após esse período, a companhia aérea pode liberar assentos e expirar a opção.

Etapa 3: Tarifação Obrigatória (/Tarifar)​

:::caution POR QUE A TARIFAÇÃO NUNCA DEVE SER PULADA? Na etapa de disponibilidade, muitos fornecedores respondem utilizando caches de alta performance. Portanto, o voo exibido na pesquisa pode ter sofrido alteração de preço ou esgotamento de classe no minuto seguinte. O endpoint /Tarifar faz uma chamada direta e síncrona à companhia aérea, revalidando a tarifa em tempo real e garantindo a vaga para o formulário de checkout. :::

  • Resultado: Retorna o detalhamento final de tarifa líquida, taxa de embarque, taxas de serviço, documentos obrigatórios e opções de parcelamento.

Etapa 4: Criação da Reserva / PNR (/Reservar)​

  • Objetivo: Bloquear formalmente os assentos na companhia aérea com os nomes e documentos dos passageiros.
  • Resultado: Retorna o Localizador (ex: SPRPMK) e a data limite máxima para emissão (DataLimiteEmissao / Time Limit). Se o bilhete não for emitido até esse prazo, a companhia aérea cancela a reserva automaticamente.

Etapa 5: Validação Pré-Emissão (/IniciarEmissao)​

  • Objetivo: Validar se o PNR necessita de dados adicionais de documento (FOID - Form of Identification), como RG, Passaporte ou CPF, e obter as formas de financiamento aprovadas para a emissão.

Etapa 6: Emissão do Bilhete (/Emitir)​

  • Objetivo: Efetuar a cobrança (cartão de crédito, faturamento aéreo, etc.) e registrar os tíquetes eletrônicos na IATA/Companhia Aérea.
  • Resultado: Retorna a lista de bilhetes gerados com o número de e-ticket por passageiro (ex: 1272300474580). Somente após esta etapa a viagem está 100% garantida.

3. Comportamento do Parâmetro Flex: true vs Flex: false​

Ao realizar a pesquisa em /Disponibilidade, o parâmetro booleano Flex determina o modelo de combinação dos voos de ida e volta:

Modo Flex: true (Itinerários Já Combinados)​

  • Utilizado quando você deseja que a companhia aérea/GDS forneça opções completas com ida e volta já combinadas de forma ideal pela menor tarifa casada.
  • Na Disponibilidade: Todas as opções completas (ida + volta) vêm na lista ViagensTrecho1. A lista ViagensTrecho2 permanece vazia.
  • Na Tarifação e Reserva: O cliente precisa enviar apenas a propriedade IdentificacaoDaViagem.

Modo Flex: false (Combinação Dinâmica de Trechos)​

  • Utilizado para permitir que o passageiro selecione livremente a ida em uma companhia/horário e a volta em outra companhia/horário.
  • Na Disponibilidade: A lista ViagensTrecho1 contém as opções para a ida, e a lista ViagensTrecho2 contém as opções para a volta.
  • Na Tarifação e Reserva: O cliente deve obrigatoriamente enviar duas chaves:
    • IdentificacaoDaViagem: Chave do trecho de ida escolhido.
    • IdentificacaoDaViagemVolta: Chave do trecho de volta escolhido.