Details: Aéreo (AIR / TKT)

Esta página detalha a resposta do Details para transações aéreas:

• AIR: reserva aérea (TransactionType = 1, AirReservation). Detalhes em ProductDetail.AirReservationDetail.
• TKT: bilhete emitido (TransactionType = 100, AirTicket). Detalhes em ProductDetail.AirTicketDetail.

O exemplo abaixo é de um bilhete (TKT), com reserva, passageiros, voos, pagamento e valores.

Requisição

{
  "TransactionUniqueId": "TKT-3DEAEE0E-14A4-454B-B7A1-C2FD4591E944",
  "OffSet": "-03:00:00",
  "AccessCredentials": {
    "Company": { "Identifier": "{{identifier}}", "Password": "{{password}}" }
  }
}

Objeto Transaction

Header

Identificação principal e status da transação.

Campo	Descrição
TransactionType	Tipo numérico da transação.
TransactionTypeDescription	Descrição do tipo (AirTicket).
UniqueId	Identificador único da transação.
Locator	Localizador da companhia aérea (PNR).
Ticket	Número do bilhete emitido.
TransactionState	Status atual da transação.
TransactionStateDescription	Descrição do status (Issued).
LastUpdate	Data / hora da última atualização.

Context

Contexto organizacional e comercial: Organização, Unidade operacional, Agência e Cliente (quando houver). Esses dados definem quem vendeu, emitiu e é dono da transação.

User

Usuário responsável pela transação.

Campo	Descrição
Id	Identificador do usuário.
Name	Nome do usuário.
Username	Login.
Email	E-mail.

Payments

Como a transação foi paga.

Campo	Descrição
PaymentTypeDescription	Responsável pelo pagamento (ex.: Customer).
PaymentFormDescription	Forma de pagamento (ex.: Invoice).
CurrencyCode	Moeda.
Amount	Valor do pagamento.
PaymentStateDescription	Status do pagamento (ex.: Confirmed).

Em Payments[].Links podem aparecer transações relacionadas, como o próprio bilhete, taxas de serviço e outras vendas relacionadas.

Links (nível da transação)

Relacionamentos entre produtos. Exemplo: o TKT vinculado à sua reserva AIR de origem.

Campo	Descrição
TransactionTypeDescription	Tipo da transação relacionada.
UniqueId	UniqueId da transação relacionada.
Locator	Localizador compartilhado.

É aqui que ficam os vínculos entre produtos.

CorporateFields

Campos customizados corporativos ou de política, como centro de custo e comparação entre a menor, a cheia e a maior tarifa. Úteis para BI, compliance com políticas e relatórios.

ProductDetail: AirTicketDetail

ProductDetail: Aéreo

Conforme o tipo da transação, o objeto preenchido dentro de ProductDetail será AirTicketDetail (para bilhetes TKT) ou AirReservationDetail (para reservas AIR).

---

AirTicketDetail (Bilhete Aéreo - TKT)

Campo	Tipo	Descrição
IssueDate	string (date-time)	Data e hora de emissão do bilhete.
Tourcode	string	Tour code da companhia aérea.
Promocode	string	Código promocional aplicado.
Route / RouteDescription	integer / string	Tipo de rota: Nacional / Internacional.
FareBasisCode	string	Base tarifária aplicada.
FareCalculation	string	Linha de cálculo tarifário da companhia (IATA Fare Calculation).
Reissued	boolean	Indica se o bilhete é uma reemissão.
DepartureAirportCode	string	Código IATA do aeroporto de origem do primeiro trecho.
ArrivalAirportCode	string	Código IATA do aeroporto de destino final.
Airline	Airline	Cia aérea emissora (Code, Name, Iata).
ConjunctiveTicket	string[]	Números de bilhetes conjugados (quando o itinerário tem mais de 4 segmentos).
Passengers	Passenger[]	Lista de passageiros vinculados ao bilhete.
Flights	Flight[]	Segmentos de voo inclusos no bilhete.
MonetaryDetail	MonetaryDetail[]	Detalhamento dos valores monetários e tarifas.
TaxDetail	TaxDetail[]	Lista detalhada de taxas com códigos e valores.
Emds	Emd[]	Lista de EMDs (serviços adicionais, assentos, bagagens) vinculados ao bilhete.
RefundDetail	RefundDetail	Dados de reembolso (caso o bilhete tenha sido reembolsado).

Passengers (Passenger[])

Campo	Tipo	Descrição
FirstName	string	Primeiro nome do passageiro.
Surname	string	Sobrenome do passageiro.
TypeCode	string	Tipo do passageiro (ADT = Adulto, CHD = Criança, INF = Bebê).
Ticket	string	Número do bilhete emitido para este passageiro.
FrequentFlyer	FrequentFlyer	Número do programa de fidelidade / milhas.
Document	Document	Documento informado (CPF ou Passaporte).

Flights (Flight[])

Campo	Tipo	Descrição
DepartureAirportCode	string	Aeroporto de origem (código IATA).
ArrivalAirportCode	string	Aeroporto de destino (código IATA).
DepartureDate	string (date-time)	Data e hora de partida.
ArrivalDate	string (date-time)	Data e hora de chegada.
FlightNumber	string	Número do voo.
AirlineCode	string	Código IATA da cia aérea operadora/comercializadora.
ClassOfService	string	Letra da classe tarifária (ex.: Y, B, M).
Brand	Brand	Família de tarifa (Name, Description).
Baggage	Baggage	Franquia de bagagem inclusa no trecho (Quantity, Weight, Unit).
OperatingAirline	string	Código da companhia aérea operadora (codeshare).
Equipment	string	Modelo da aeronave.

MonetaryDetail (MonetaryDetail[])

Composição financeira completa da venda aérea:

Campo	Tipo	Descrição
Type / TypeDescription	integer / string	Tipo de valor: Total, FarePrice (Tarifa), Tax (Taxa de embarque), DU (Taxa de serviço/emissão), Rav (Comissão/Rav).
CurrencyCode	string	Código ISO da moeda (ex.: BRL, USD).
Amount	decimal	Valor monetário.
Retained	boolean	Indica se o valor é retido pela agência ou repassado ao fornecedor.

---

AirReservationDetail (Reserva Aérea - AIR)

Representa os dados da reserva original (PNR), antes ou após a emissão:

Campo	Tipo	Descrição
Deadline	string (date-time)	Time limit (prazo limite da cia aérea para emissão da reserva).
Tourcode	string	Tour code corporativo ou negociado.
Promocode	string	Código de cupom/promocional.
Route / RouteDescription	integer / string	Rota: Nacional / Internacional.
Airline	Airline	Cia aérea principal da reserva.
Passengers	Passenger[]	Passageiros da reserva (nomes, contatos e documentos).
Flights	Flight[]	Trechos de voo reservados.
Phones	Phone[]	Telefones de contato registrados no PNR.
Company	Company	Dados da agência/empresa que realizou a reserva.

Tratamento de erros

Campo	Descrição
Errors	Vazio em caso de sucesso.
Success	true quando a requisição é válida.

Resumo de boas práticas

• Obtenha sempre o TransactionUniqueId pelo List.
• Faça uma requisição por UniqueId.
• Use Links para identificar transações relacionadas (AIR, TS).
• Espere estruturas diferentes conforme o TransactionType.
• Trate os dados monetários com cuidado em relatórios e conciliações.

💡 Exemplos completos de payload (JSONs reais)

Confira as respostas reais completas com todas as tags retornadas:

• Exemplo Details AIR (Reserva aérea)
• Exemplo Details TKT (Bilhete aéreo)