Visão Geral
Ao executar a ação de Consultar Reserva utilizando os conectores de companhias aéreas (Azul, GOL e LATAM) na plataforma Ligaí, o robô retorna o objeto Summary. Este bloco consolida o status operacional do bilhete, informações de multas, reembolsos e o detalhamento de créditos gerados por alterações ou cancelamentos.
Dicionário Unificado de Campos
Embora o Ligaí padronize a maior parte das respostas de API, existem variações sutis e campos específicos em cada companhia devido aos seus respectivos sistemas de distribuição. Abaixo está a descrição de cada campo retornado no mapeamento:
Credit: Valor total do crédito disponível gerado a partir do bilhete.
CreditExpirationDate: Data limite para a utilização do crédito gerado junto à companhia aérea.
CreditStatus: Indica a situação atual do saldo de crédito (veja os status possíveis abaixo).
CreditUsed (Exclusivo Azul): Indica o valor parcial ou total de crédito que já foi consumido de forma ativa dentro do ciclo do bilhete.
Fine: Bloco que detalha valores de multas contratuais ou taxas aplicadas pelas companhias aéreas.
ExchangeCancel: Valor da multa cobrada por alteração ou cancelamento voluntário.
NoShow: Valor da multa cobrada pelo não comparecimento do passageiro ao embarque.
Refund: Valor cobrado como taxa administrativa para processar o reembolso.
OAC (Exclusivo Gol): Código identificador do escritório ou agência emissora responsável pelo bilhete.
Payback: Valor total a ser reembolsado (estornado) ao cliente.
PaybackDate: Data em que o processo de reembolso foi registrado ou efetivado.
StationNumber (Exclusivo Latam): Identificador do terminal ou canal físico/lógico onde a transação original foi registrada.
Comments (Exclusivo Latam): Armazena observações técnicas ou mensagens do sistema da companhia aérea.
TicketPaidWith (Exclusivo Azul): Descreve o método de pagamento original utilizado para a compra do bilhete.
TicketCreditBase (Gol e Latam): Valor base da tarifa que foi convertido em crédito.
TicketCreditFee (Gol e Latam): Taxas de serviço ou de alteração associadas ao crédito do bilhete.
TicketCreditTax (Gol e Latam): Valor das taxas aeroportuárias (taxas de embarque) convertidas em crédito.
TicketCreditTotal (Gol e Latam): Soma totalizada dos valores que compõem o crédito gerado.
TicketStatus: Indica a situação real e operacional em que o bilhete aéreo se encontra (veja os status possíveis abaixo).
AZUL
GOL
LATAM
Mapeamento de Status do Bilhete (TicketStatus)
O campo TicketStatus define o ciclo de vida atual da passagem aérea nas três companhias:
POR VOAR: A data do voo ainda não aconteceu; o bilhete está ativo e pronto para o embarque.
VOADO: O passageiro realizou o embarque e o trecho foi integralmente concluído.
NAO VOADO: O passageiro não compareceu ao voo (no-show) e o horário do embarque já expirou.
CANCELADO: O bilhete foi cancelado por desistência da viagem.
ESTORNADO: O valor do bilhete foi devolvido integralmente ou parcialmente como estorno financeiro.
ABERTO: O bilhete possui um saldo ou crédito que ainda não foi totalmente utilizado, permanecendo disponível dentro do período regulamentar de uso (geralmente de 1 ano a partir da emissão).
REEMITIDO: A passagem original foi remarcada, sofrendo alterações de data, horário ou rota, gerando um novo bilhete associado.
FECHADO: Não existem informações ativas do PNR disponíveis para leitura na API, indicando que os dados já foram purgados (limpos) do sistema da companhia aérea devido ao tempo decorrido.
Mapeamento de Status de Crédito (CreditStatus)
O campo CreditStatus determina a disponibilidade financeira do saldo gerado por modificações no bilhete:
DISPONIVEL: O crédito está ativo e pode ser utilizado imediatamente para novas compras ou reemissões.
UTILIZADO: O saldo de crédito já foi totalmente consumido em outra transação.
REEMBOLSADO: O valor que estava retido como crédito foi convertido e pago como reembolso ao comprador.
EXPIRADO: O prazo de validade para uso do crédito terminou (ultrapassou a data contida em
CreditExpirationDate).INDISPONIVEL: O saldo encontra-se bloqueado temporariamente para análise ou congelado devido a alguma contestação ou processo interno na companhia aérea.
N/A: Retornado quando a reserva consultada não possuir ou não tiver gerado nenhum status de crédito associado (comum em bilhetes com status
VOADO, por exemplo).