Principais classes relacionadas aos processos de reserva, emissão e reemissão

Chamadas Rest relacionadas

TripApiOrder

Representa uma ordem criada dentro do TripApi e possui um localizador próprio.

Uma ordem no TripApi pode conter diversos AirReservations dentro, para casos onde reserva é multi-localizador Ex: Ida com a cia-aérea X voltando com a cia aérea Y.

O método Retrieve do API pode ser utilizado para obter uma Ordem criada através do Id retornado.

Caso seja necessário efetuar o retrieve de um localizador pelo localizador da cia aérea, é possível utilizar o método RetrieveByExternalLocator.

TripApiReservation

Os objetos TripApiReservation e AirReservation são análogos. O objeto TripApiReservation contém apenas propriedades de controle extras que o TripApi necessita.

AirReservation

Este objeto representa uma reserva gerada na companhia aérea. Talvez este seja o objeto com mais sinônimos dentro do turismo e por consequência dentro desta documentação. São eles: Reserva, PNR(Passenger name record), Localizador ou LOC (Abreviação de localizador ou locator). Todos eles são usados para se referir a uma reserva de vôo gerada na cia aérea.

Após a busca de vôos e FlightGroups serem selecionados, através da listagem de FlightOptions, os FlightGroups de cada trecho buscado são enviados para o método Book, junto com no mínimo as informações dos passageiros (Travellers) e informações de contato. Com esse set mínimo de informações é possível criar uma reserva. Todos os sistemas, sem exceção, conectados ao TripApi geram um número de confirmação da reservada gerada, chamado de localizador. (Por isso que o nome localizador é também utilizado para se referir a uma reserva como um todo).

O objeto AirReservation é gerado então como resultado final do processamento de uma reserva.

Uma reserva gerada, antes de ser emitida, vale até o prazo que é gerado pela cia aérea e é armazenado no campo ExpirationTime.

Propriedade	Tipo	Descrição
Locator	string	Código do localizador gerado, geralmente é um código alfanumérico de 6 digitos.
Travellers	collection	Coleção de objetos do tipo Travellers. Representa todos os passageiros da reserva.
ExpirationTime	DateTime	Representa a data e hora de validade da reserva gerada.
SupplierExpirationTime	DateTime	******* @Gabriel Marques qual é a diferença entre estas 3 datas? Pode descrever aqui?
BookTime	DateTime
SupplierSystem	string	Valor representando o SupplierSystem que gerou esta reserva.
FlightGroups	collection	Lista de objetos do tipo FlightGroups que representam os trechos da viagem reservados neste localizador.
BookingFares	collection	Lista de objetos do tipo BookingFares. Que representam os preços da reserva para cada tipo de passageiro.
Seats	collection	Lista de objetos do tipo Seat, que representa uma lista de possíveis assentos marcados.
Tickets	collection	Lista de objetos do tipo Tickets, que representa uma lista de bilhetes emitidos para esta reserva.

Traveller

Representa um viajante ou passageiro que foi reservado. Também pode ser chamado de passenger ou Pax.

Propriedade	Tipo	Descrição
FirstName	string	Primeiro Nome do viajante
MiddleName	string	Nome do meio do viajante
LastName	string	Último nome do viajante
AgeGroup	Enum	Enum do tipo AgeGroup
Gender	Enum	Enum do tipo Gender.

BookingFare

Representa uma tarifa gravada em uma reserva.

Um PNR pode possuir um ou mais preços, isso acontece por algumas razões:

Quando somente um tipo de passageiro, por exemplo, um ADT é reservado a reserva terá somente um preço, e ele estará relacionado ao passageiro ADT
Quando uma reserva contém mais de um tipo de passageiro, por exemplo 2 ADTs, 1 CHD e um INF, neste caso a reserva terá uma lista de 3 BookingFares, cada preço relacionado ao tipo de cada passageiro.
Em casos mais específicos, que acontecem geralmente em GDSs, onde uma parte dos FlightGroups do PNR é tarifado em uma tarifa e outra parte do PNR é tarifada em outra.

Propriedade	Tipo	Descrição
ExchangeRate	money	Taxa de cambio utilizada na reserva
OriginalTaxes	money	Valor total das taxas aeroportuárias na moeda original da tarifa
Taxes	money	Valor total das taxas na moeda local configurada para o SystemAccount
OriginalFare	money	Valor da tarifa, sem taxas, na moeda original
Fare	money	Valor da tarifa, sem taxas, na moeda local configurada no SystemAccount
FareBasis	string	Código alphanumérico da base tarifária
TravellerAgeGroup	enum	Enum do tipo AgeGroup. Fala de qual tipo de passageiro é esta tarifa.

Ticket

Representa um bilhete emitido depois que uma reserva é paga. Os bilhetes de uma reserva precisam ser emitidos, até a data de vencimento de uma reserva ( SupplierExpirationDate).

Quando uma reserva inteira é paga geralmente o número de bilhetes de uma reserva é dado pela formula: Nro de Passageiros X Nro de booking fares. Então no exemplo dado acima, teríamos 4 bilhetes.

Exceto em casos mais avançados de tarifação, geralmente temos um bilhete emitido por passageiro da reserva.

Propriedade	Tipo	Descrição
Number	string	Número de identificação do bilhete
Status	enum	Status que representa se o bilhete esta emitido, cancelado, reutilizado, voado, etc…
TravellerName	string	Nome do passageiro associado a esta bilhete
BookingFare	BookingFare	Objeto booking fare relacionado a esta bilhete
SupplierSystem	string	Nome do supplier system que gerou este bilhete