Entrega de API para itinerários

Com o recurso Itinerários, você pode exibir as informações de reserva dos clientes e ajudá-los a encontrar produtos ou serviços da booking-related, como passeios ou experiências. Você também pode usar os dados para analisar tendências de reservas e criar relatórios para seus stakeholders.

Opções de entrega

A entrega de dados de itinerários pela sua API pode usar um mecanismo de envio (push) ou de solicitação (pull).

Mecanismo push

O serviço de notificações push foi projetado para enviar atualizações de itinerário assim que estiverem disponíveis no horário near-real, com foco nos detalhes principais do transaction-level. Esta opção permite que você:

Exiba as informações de reserva dos clientes em seu site ou aplicativo.
Ofereça aos viajantes produtos e serviços adicionais para compra durante a viagem.

Os eventos push serão entregues via Webhook para o URL que você fornecer, no formato de uma mensagemHTTP POST. Essas mensagens podem chegar sem ordem, portanto, consulte os elementos creation_datee update_date_timepara determinar a ordem.

Para obter detalhes sobre como adotar essa opção de entrega, consulte Configuração da API.

Mecanismo pull

O serviço de consulta fornece dados detalhados de itinerário para auxiliar em:

Análise de dados
Recuperação de dados para janelas de tempo em que a entrega push falhou.
Investigações do help desk

Este serviço consiste em dois endpoints HTTP GETque permitem:

Crie uma lista de itinerários criados ou atualizados em um intervalo de tempo específico usando as variáveis creation_date_start, creation_date_end, update_date_time_starteupdate_date_time_end.
Recupere itinerários específicos por meio deles. itinerary_id

Para obter detalhes sobre o processo de autenticação, consulte Configuração da API.

Campos disponíveis

As tabelas abaixo listam os campos, incluindo quaisquer objetos aninhados, disponíveis por meio dos nossos métodos de entrega push e pull.

Nomes de campo que começam com um nome seguido por um ponto (por exemplo, <variável>.<variável aninhada>) indicam uma relação de aninhamento.

Plataforma de viagens de marca branca

Nome do campo	Definição	Exemplo
`itinerary_id`	O número do itinerário ou número de referência do pedido do ponto de venda.	72622069245694
`status`	O status do itinerário e dos seus itens individuais.	Valores possíveis: confirmado cancelado
`creation_date`*	A data em que uma reserva foi feita inicialmente, representada no formato de data ISO 8601 (YYYY-MM-DD).	2023-02-05
`update_date_time`*	A data e hora da última atualização do itinerário, representadas no formato de data ISO 8601 (YYYY-MM-dd'T"HH:mm:ss.SSSZ).	2023-10-21T00:00:00.000Z
`online`	Indica se o itinerário foi reservado online (verdadeiro) ou por meio de um agente (falso). Representado como um booleano.	true
`package`	Indica se o itinerário faz parte de um pacote ou se é uma reserva independente. Representado como um booleano.	false
`payment_type`	A forma de pagamento usada na compra.	Valores possíveis: credit card points split pay
`point_of_sale_country_code`	O código do país do ponto de venda em que o cliente fez a reserva. Representado com duas letras, no formato ISO 3166-1 alpha-2.	GB
`purchaser`	Identificação da pessoa que fez a reserva. Consulte a tabela `purchaser` para ver uma lista dos itens aninhados.
`property_booking_items`	Componentes de acomodação reservados como parte do itinerário. Consulte a tabela `property_booking_items` para ver uma lista dos itens aninhados.
`flight_booking_items`	Componentes aéreos reservados como parte do itinerário. Consulte a tabela `flight_booking_items` para ver uma lista dos itens aninhados.
`car_booking_items`	Carros reservados como parte do itinerário. Consulte a tabela `car_booking_items` para ver uma lista dos itens aninhados.
`activity_booking_items`	Atividades reservadas como parte do itinerário. Consulte a tabela `activity_booking_items` para ver uma lista dos itens aninhados.
`insurance_booking_items`	Seguro reservado como parte do itinerário. Consulte a tabela `insurance_booking_items` para ver uma lista dos itens aninhados.
`rate`	Os detalhes do preço e da tarifa de um item da reserva ou de todo o itinerário. Consulte a tabela `rate` para ver uma lista dos itens aninhados.
`coupon`	O cupom aplicado ao itinerário, quando aplicável. Consulte a tabela `coupon` para ver uma lista dos itens aninhados.

purchaser

Estes campos identificam a pessoa que fez a reserva.

Nome do campo	Definição	Exemplo
`purchaser.email`**	Endereço de e-mail da pessoa que fez a reserva.	smith@exemplo.com
`purchaser.loyalty_id`**	Identificador da associação ao programa de fidelidade.	12345678
`purchaser.first_name`**	Primeiro nome da pessoa que fez a reserva.	Jane
`purchaser.last_name`**	Sobrenome da pessoa que fez a reserva.	Smith

property_booking_items

Estes campos listam os componentes de acomodação reservados como parte do itinerário.

Nome do campo	Definição	Exemplo
`booking_item_id`	Identificador de um item específico reservado como parte de um itinerário.	1400882912
`status`	Status do item de acomodação específico.	Valores possíveis: confirmado cancelado
`checkin_date`*	Data de check-in do item de acomodação correspondente. Representado no formato de data ISO 8601 (YYYY-MM-DD).	2023-02-01
`checkout_date`*	Data de check-out do item de acomodação correspondente. Representado no formato de data ISO 8601 (YYYY-MM-DD).	2023-02-05
`property.id`	Expedia Group é o identificador único do hotel ou aluguel de temporada propriedade.	1400882912
`property.chain_name`	Nome da rede à qual a propriedade pertence, quando aplicável.	Independent
`property.brand_name`	Nome da marca à qual a propriedade pertence, quando aplicável. Uma rede pode ter várias marcas.	Savoy Signature
`property.name`	Nome do hotel ou aluguel por temporada.	Hotel 1
`property.city`	Nome da cidade onde está a propriedade.	Toronto
`property.state_province_name`	Nome do estado ou província onde está a propriedade.	Ontário
`property.country_code`	Código do país onde está a propriedade. Representado com duas letras, no formato ISO 3166-1 alpha-2.	CA
`property.star_rating`	Classificação por estrelas da propriedade.	3.0
`room_name`	O tipo de quarto reservado, conforme definido pelo hotel ou pela empresa de aluguel de temporada.	Quarto duplo confortável com banheiro privativo.
`adult_count`	Número de adultos incluídos na reserva correspondente.	2
`child_count`	Número de crianças incluídas na reserva correspondente.	0
`expedia_collect`	Valor booleano que indica se a reserva foi paga no momento em que foi feita (true) ou se deve ser paga direto ao fornecedor (false).	true
`property_confirmation_id`***	Número de confirmação fornecido pelo hotel ou pela empresa de aluguel de temporada.	1516171819
`rate`	Os detalhes do preço e da tarifa da reserva de acomodação. Consulte a tabela `rate` para ver uma lista dos itens aninhados.

flight_booking_items

Estes campos listam os componentes aéreos reservados como parte do itinerário.

Nome do campo	Definição	Exemplo
`booking_item_id`	Identificador de um item específico reservado como parte de um itinerário.	1400882911
`status`	Status do item de viagem aérea específico.	Valores possíveis: confirmado cancelado
`departure_date`*	Data de início do item de viagem aérea correspondente. Representado no formato de data ISO 8601 (YYYY-MM-DD).	2023-02-01
`arrival_date`*	Data de término do item de viagem aérea correspondente. Representado no formato de data ISO 8601 (YYYY-MM-DD).	2023-02-02
`airline.plating_carrier_name`	Nome da companhia aérea que emitiu a passagem.	Air Canada
`airline.plating_carrier_code`	Código da Associação Internacional de Transporte Aéreo (IATA) da companhia aérea que emitiu a passagem.	AC
`carrier_pnr`	Nome do passageiro registrado junto à companhia aérea que emitiu a passagem.	SMITH
`trip_type`	O tipo de viagem reservada.	Valores possíveis: one way round trip multiple destinations
`fare_class`	A classe de tarifa do bilhete.	Econômica
`airport_origin_code`	O código IATA corresponde ao aeroporto de origem.	LHR
`airport_origin_location`	A localização do aeroporto de origem.	Londres, GB (LHR-Heathrow)
`airport_destination_code`	O código do aeroporto de destino. Representado no formato IATA.	YYZ
`airport_destination_location`	A localização do aeroporto de destino.	Toronto, ON (YYZ-Aeroporto Int. Lester B. Pearson)
`ticket_number`	Número do bilhete do voo.	123456789
`expedia_collect`	Valor booleano que indica se a reserva foi paga no momento em que foi feita (true) ou se deve ser paga direto ao fornecedor (false).	true
`segment_count`	O número de segmentos de voo da passagem aérea.	1
`rate`	Os detalhes do preço e da tarifa da reserva de voo. Consulte a tabela `rate` para ver uma lista dos itens aninhados.

car_booking_items

Estes campos listam os carros reservados como parte do itinerário.

Nome do campo	Definição	Exemplo
`booking_item_id`	Identificador de um item específico reservado como parte de um itinerário.	1400882910
`status`	Status do item de viagem carro específico.	Valores possíveis: confirmado cancelado
`pickup_date`*	Data de início do item de viagem carro. Representado no formato de data ISO 8601 (YYYY-MM-DD).	2023-02-02
`return_date`*	Data de término do item de viagem carro. Representado no formato de data ISO 8601 (YYYY-MM-DD).	2023-02-05
`rental_company.name`***	Nome da locadora de carros.	Hertz
`car_type`***	Tipo de carro alugado.	Compacto de 2/4 portas
`pickup_location`	Local de retirada do carro.	Deer Lake, NL (YDF-Aeroporto Regional de Deer Lake)
`pickup_country_code`***	Código do país do local de retirada do carro. Representado com duas letras, no formato ISO 3166-1 alpha-2.	CA
`return_location`	Local de devolução do carro.	Deer Lake, NL (YDF-Aeroporto Regional de Deer Lake)
`return_country_code`***	Código do país do local de devolução do carro. Representado com duas letras, no formato ISO 3166-1 alpha-2.	CA
`trip_type`	O tipo de viagem reservada.	Valores possíveis: one way round trip multiple destinations
`rental_company_confirmation_id`***	Número de confirmação fornecido pela locadora de veículos.	ABC1234
`expedia_collect`	Valor booleano que indica se a reserva foi paga no momento em que foi feita (true) ou se deve ser paga direto ao fornecedor (false).	false
`rate`	Os detalhes do preço e da tarifa da reserva de carro. Consulte a tabela `rate` para ver uma lista dos itens aninhados.

activity_booking_items

Estes campos listam as atividades reservadas como parte do itinerário.

Nome do campo	Definição	Exemplo
`booking_item_id`	Identificador de um item específico reservado como parte de um itinerário.	1400882910
`status`	Status da atividade específica.	Valores possíveis: confirmado cancelado
`activity_start_date`*	Data de início da atividade. Representado no formato de data ISO 8601 (YYYY-MM-DD).	2023-02-03
`activity_end_date`*	Data de término da atividade. Representado no formato de data ISO 8601 (YYYY-MM-DD).	2023-02-03
`vendor.name`***	Nome do fornecedor que oferece a atividade.	Excursões da Olivia
`vendor.city`***	Cidade onde está o fornecedor da atividade.	Deer Lake, NL (YDF-Aeroporto Regional de Deer Lake)
`vendor.country_code`***	Código do país onde está o fornecedor da atividade. Representado com duas letras, no formato ISO 3166-1 alpha-2.	CA
`offering_name`***	Nome da atividade.	Passions of Paradise Great Barrier Reef
`expedia_collect`	Valor booleano que indica se a reserva foi paga no momento em que foi feita (true) ou se deve ser paga direto ao fornecedor (false).	true
`rate`	Os detalhes do preço e da tarifa da reserva de atividade. Consulte a tabela `rate` para ver uma lista dos itens aninhados.

insurance_booking_items

Estes campos listam os seguros reservados como parte do itinerário.

Nome do campo	Definição	Exemplo
`booking_item_id`	Identificador de um item específico reservado como parte de um itinerário.	1400882610
`status`	Status do seguro específico selecionado.	Valores possíveis: confirmado cancelado
`rate`	Detalhes do preço e da tarifa do seguro selecionado. Consulte a tabela `rate` para ver uma lista dos itens aninhados.

rate

Estes campos listam os detalhes do preço e da tarifa de um item da reserva ou de todo o itinerário. Incluem valores aninhados que descrevem o valor monetário da reserva, discriminado pelo valor bruto da reserva, impostos e taxas.

Nome do campo	Definição	Exemplo
`rate_plan_name`	O nome do plano tarifário usado para definir o preço do item. Disponível apenas para itens reservados com o código propriedade.	Somente quarto
`rate_plan_type`	O tipo de tarifa usada para a reserva. Disponível apenas para itens reservados com o código propriedade.	Tarifa de distribuição
`refundable`	Se o componente da reserva correspondente é reembolsável (verdadeiro) ou não (falso).	true
`pricing`	Objeto que captura o valor monetário da reserva, discriminado pelo valor bruto da reserva, impostos e taxas.
`pricing.gross_booking_value`	Objeto que captura o valor monetário da reserva.
`pricing.gross_booking_value.billable_currency`	Objeto que representa o valor monetário da reserva na moeda utilizada para o pagamento.
`pricing.gross_booking_value.billable_currency.currency`	Moeda em que a reserva é paga pelo cliente. Representada no formato ISO 4217.	GBP
`pricing.gross_booking_value.billable_currency.value`	O valor bruto da reserva.	2.520,80
`pricing.taxes_and_fees`	O valor e a moeda dos impostos e taxas da reserva.
`pricing.taxes_and_fees.billable_currency`	O valor monetário dos impostos e taxas da reserva, na moeda utilizada para o pagamento.
`pricing.taxes_and_fees.billable_currency.currency`	Moeda em que a reserva é paga pelo cliente. Representada no formato ISO 4217.	GBP
`pricing.taxes_and_fees.billable.currency.value`	O valor bruto da reserva.	491,10

coupon

Nome do campo	Definição	Exemplo
`code`***	O código de cupom usado para a reserva.	ABCD
`name`***	O nome do cupom.	PRIME
`description`***	A descrição do cupom.	BoGo 5%
`currency`***	A moeda na qual o valor do cupom foi aplicado. Representada no formato ISO 4217.	GBP
`value`***	O valor monetário do cupom.	126,04

Observações para todos os campos da Plataforma de Viagens White Label

* Os campos de data estão em Tempo Universal Coordenado (UTC).
** Isto representa dados de Informação de Identificação Pessoal (PII). Lide com isso da maneira correta, conforme as diretrizes da sua empresa. Inclua apenas quando for necessário.
*** Os dados para esses campos estarão disponíveis entre 18h e 20h UTC do dia seguinte à criação ou atualização da reserva. Não está disponível quase em tempo real.

Programa de Afiliados para Agentes de Viagens (TAAP)

Nome do campo	Definição	Exemplo
`itinerary_id`	O número do itinerário ou número de referência do pedido do ponto de venda.	72622069245694
`status`	O status do itinerário e dos seus itens individuais.	Valores possíveis: confirmado cancelado
`creation_date`*	A data em que uma reserva foi feita inicialmente, representada no formato de data ISO 8601 (YYYY-MM-DD).	2023-02-05
`update_date_time`*	A data e hora da última atualização do itinerário, representadas no formato de data ISO 8601 (YYYY-MM-dd'T"HH:mm:ss.SSSZ).	2023-10-21T00:00:00.000Z
`online`	Indica se o itinerário foi reservado online (verdadeiro) ou por meio de um agente (falso). Representado como um booleano.	true
`point_of_sale_country_code`	O código do país em que o cliente fez a reserva. Representado com duas letras, no formato ISO 3166-1 alpha-2.	GB
`purchaser`	Identificação da pessoa que fez a reserva. Consulte a tabela `purchaser` para ver uma lista dos itens aninhados.
`agency`	Identificação da agência TAAP e do agente que fez a reserva. Consulte a tabela `agency` para ver uma lista dos itens aninhados.
`payment`	Informações de pagamento para o itinerário. Consulte a tabela `payment` para ver uma lista dos itens aninhados.
`property_booking_items`	Componentes de acomodação reservados como parte do itinerário. Consulte a tabela `property_booking_items` para ver uma lista dos itens aninhados.
`flight_booking_items`	Componentes aéreos reservados como parte do itinerário. Consulte a tabela `flight_booking_items` para ver uma lista dos itens aninhados.
`car_booking_items`	Carros reservados como parte do itinerário. Consulte a tabela `car_booking_items` para ver uma lista dos itens aninhados.
`activity_booking_items`	Atividades reservadas como parte do itinerário. Consulte a tabela `activity_booking_items` para ver uma lista dos itens aninhados.
`rate`	Os detalhes do preço e da tarifa de um item da reserva ou de todo o itinerário. Consulte a tabela `rate` para ver uma lista dos itens aninhados.
`earnings`	Detalhes da comissão referente a um item da reserva ou ao itinerário completo. Consulte a tabela `earnings` para ver uma lista dos itens aninhados.

purchaser

Esses campos identificam a pessoa que vai viajar.

Nome do campo	Definição	Exemplo
`purchaser.email`**	Endereço de e-mail do viajante.	smith@exemplo.com
`purchaser.first_name`**	Primeiro nome do viajante.	Jane
`purchaser.last_name`**	Sobrenome do viajante.	Smith

agência

Esses campos identificam a agência TAAP e o agente que fez a reserva.

Nome do campo	Definição	Exemplo
`agency.name`	Nome da agência TAAP que fez a reserva.	Viagens pelo mundo
`agency.id`	Código de rastreamento da agência TAAP que fez a reserva.	WS02555
`agency.agent.first_name`**	Primeiro nome do agente da TAAP que fez a reserva.	Bob
`agency.agent.last_name`**	Sobrenome do agente da TAAP que fez a reserva.	Jones
`agency.agent.email`**	Endereço de e-mail do agente da TAAP que fez a reserva.	bjones@worldtravel.com

pagamento

Esses campos contêm os detalhes de pagamento do itinerário.

Nome do campo	Definição	Exemplo
`payment_type`	A forma de pagamento usada na compra.	Valores possíveis: cartão de crédito pontos Pagamento dividido
`status`	Indica se o itinerário já foi pago.	Valores possíveis: pago Não remunerado
`deferred`	Se o pagamento do itinerário foi adiado (verdadeiro) ou pago (falso). Representado como um booleano.	true
`payment_due_date`	A data de vencimento do pagamento está no formato de data ISO 8601 (YYYY-MM-DD). Aplicável somente a pagamentos diferidos.	2023-02-05
`payee`	Indica quem é o responsável pelo pagamento do itinerário.	Valores possíveis: agência cliente

property_booking_items

Estes campos listam os componentes de acomodação reservados como parte do itinerário.

Nome do campo	Definição	Exemplo
`booking_item_id`	Identificador de um item específico reservado como parte de um itinerário.	1400882912
`status`	Status do item de acomodação específico.	Valores possíveis: confirmado cancelado
`checkin_date`*	Data de check-in do item de acomodação correspondente. Representado no formato de data ISO 8601 (YYYY-MM-DD).	2023-02-01
`checkout_date`*	Data de check-out do item de acomodação correspondente. Representado no formato de data ISO 8601 (YYYY-MM-DD).	2023-02-05
`property.id`	Identificador exclusivo do Expedia Group para o hotel ou propriedade de aluguel por temporada.	1400882912
`property.chain_name`	Nome da rede à qual a propriedade pertence, quando aplicável.	Independent
`property.brand_name`	Nome da marca à qual a propriedade pertence, quando aplicável. Uma rede pode ter várias marcas.	Savoy Signature
`property.name`	Nome do hotel ou aluguel por temporada.	Hotel 1
`property.city`	Nome da cidade onde está a propriedade.	Toronto
`property.state_province_name`	Nome do estado ou província onde está a propriedade.	Ontário
`property.country_code`	Código do país onde está a propriedade. Representado com duas letras, no formato ISO 3166-1 alpha-2.	CA
`property.star_rating`	Classificação por estrelas da propriedade.	3.0
`room_name`	O tipo de quarto reservado, conforme definido pelo hotel ou pela empresa de aluguel de temporada.	Quarto duplo confortável com banheiro privativo.
`adult_count`	Número de adultos incluídos na reserva.	2
`child_count`	Número de crianças incluídas na reserva.	0
`expedia_collect`	Valor booleano que indica se a reserva foi paga no momento em que foi feita (true) ou se deve ser paga direto ao fornecedor (false).	true
`property_confirmation_id`***	Número de confirmação fornecido pelo hotel ou pela empresa de aluguel de temporada.	1516171819
`rate`	Os detalhes do preço e da tarifa da reserva de acomodação. Consulte a tabela `rate` para ver uma lista dos itens aninhados.

flight_booking_items

Estes campos listam os componentes aéreos reservados como parte do itinerário.

Nome do campo	Definição	Exemplo
`booking_item_id`	Identificador de um item específico reservado como parte de um itinerário.	1400882911
`status`	Status do item de viagem aérea específico.	Valores possíveis: confirmado cancelado
`departure_date`*	Data de início do item de viagem aérea correspondente. Representado no formato de data ISO 8601 (YYYY-MM-DD).	2023-02-01
`arrival_date`*	Data de término do item de viagem aérea correspondente. Representado no formato de data ISO 8601 (YYYY-MM-DD).	2023-02-02
`airline.plating_carrier_name`	Nome da companhia aérea que emitiu a passagem.	Air Canada
`airline.plating_carrier_code`	IATA é o código da companhia aérea que emitiu a passagem.	AC
`carrier_pnr`	Nome do passageiro registrado junto à companhia aérea que emitiu a passagem.	SMITH
`trip_type`	O tipo de viagem reservada.	Valores possíveis: one way round trip multiple destinations
`fare_class`	A classe de tarifa do bilhete.	Econômica
`airport_origin_code`	O código IATA corresponde ao aeroporto de origem.	LHR
`airport_origin_location`	A localização do aeroporto de origem.	Londres, GB (LHR-Heathrow)
`airport_destination_code`	O código do aeroporto de destino. Representado no formato IATA.	YYZ
`airport_destination_location`	A localização do aeroporto de destino.	Toronto, ON (YYZ-Aeroporto Int. Lester B. Pearson)
`ticket_number`	Número do bilhete do voo.	123456789101
`expedia_collect`	Valor booleano que indica se a reserva foi paga no momento em que foi feita (true) ou se deve ser paga direto ao fornecedor (false).	true
`segment_count`	O número de trechos de voo do bilhete.	1
`rate`	Os detalhes do preço e da tarifa da reserva de voo. Consulte a tabela `rate` para ver uma lista dos itens aninhados.

car_booking_items

Estes campos listam os carros reservados como parte do itinerário.

Nome do campo	Definição	Exemplo
`booking_item_id`	Identificador de um item específico reservado como parte de um itinerário.	1400882910
`status`	Status do item de viagem carro específico.	Valores possíveis: confirmado cancelado
`pickup_date`*	Data de início do item de viagem carro. Representado no formato de data ISO 8601 (YYYY-MM-DD).	2023-02-02
`return_date`*	Data de término do item de viagem carro. Representado no formato de data ISO 8601 (YYYY-MM-DD).	2023-02-05
`rental_company.name`***	Nome da locadora de carros.	Hertz
`car_type`***	Tipo de carro alugado.	Compacto de 2/4 portas
`pickup_location`	Local de retirada do carro.	Deer Lake, NL (YDF-Aeroporto Regional de Deer Lake)
`pickup_country_code`***	Código do país do local de retirada do carro. Representado com duas letras, no formato ISO 3166-1 alpha-2.	CA
`return_location`	Local de devolução do carro.	Deer Lake, NL (YDF-Aeroporto Regional de Deer Lake)
`return_country_code`***	Código do país do local de devolução do carro. Representado com duas letras, no formato ISO 3166-1 alpha-2.	CA
`trip_type`	O tipo de viagem reservada.	Valores possíveis: one way round trip multiple destinations
`rental_company_confirmation_id`***	Número de confirmação fornecido pela locadora de veículos.	ABC1234
`expedia_collect`	Valor booleano que indica se a reserva foi paga no momento em que foi feita (true) ou se deve ser paga direto ao fornecedor (false).	false
`rate`	Os detalhes do preço e da tarifa da reserva de carro. Consulte a tabela `rate` para ver uma lista dos itens aninhados.

activity_booking_items

Estes campos listam as atividades reservadas como parte do itinerário.

Nome do campo	Definição	Exemplo
`booking_item_id`	Identificador de um item específico reservado como parte de um itinerário.	1400882910
`status`	Status da atividade específica.	Valores possíveis: confirmado cancelado
`activity_start_date`*	Data de início da atividade. Representado no formato de data ISO 8601 (YYYY-MM-DD).	2023-02-03
`activity_end_date`*	Data de término da atividade. Representado no formato de data ISO 8601 (YYYY-MM-DD).	2023-02-03
`vendor.name`***	Nome do fornecedor que oferece a atividade.	Excursões da Olivia
`vendor.city`***	Cidade onde está o fornecedor da atividade.	Deer Lake, NL (YDF-Aeroporto Regional de Deer Lake)
`vendor.country_code`***	Código do país onde está o fornecedor da atividade. Representado com duas letras, no formato ISO 3166-1 alpha-2.	CA
`offering_name`***	Nome da atividade.	Caminhada pela trilha do rio Humber
`expedia_collect`	Valor booleano que indica se a reserva foi paga no momento em que foi feita (true) ou se deve ser paga direto ao fornecedor (false).	true
`rate`	Os detalhes do preço e da tarifa da reserva de atividade. Consulte a tabela `rate` para ver uma lista dos itens aninhados.
`earnings`	Detalhes da comissão referente à reserva da atividade. Consulte a tabela `earnings` para ver uma lista dos itens aninhados.

rate

Nome do campo	Definição	Exemplo
`refundable`	Se o componente da reserva correspondente é reembolsável (verdadeiro) ou não (falso).	true
`pricing`	Objeto que captura o valor monetário da reserva, discriminado pelo valor bruto da reserva, impostos e taxas.
`pricing.gross_booking_value`	O valor monetário da reserva, incluindo impostos e taxas.
`pricing.gross_booking_value.billable_currency`	O valor monetário da reserva, na moeda utilizada para o pagamento.
`pricing.gross_booking_value.billable_currency.currency`	Moeda em que a reserva é paga pelo cliente. Representada no formato ISO 4217.	GBP
`pricing.gross_booking_value.billable_currency.value`	O valor bruto da reserva.	2.520,80
`pricing.taxes_and_fees`	O valor e a moeda dos impostos e taxas da reserva.
`pricing.taxes_and_fees.billable_currency`	O valor monetário dos impostos e taxas da reserva, na moeda utilizada para o pagamento.
`pricing.taxes_and_fees.billable_currency.currency`	Moeda em que a reserva é paga pelo cliente. Representada no formato ISO 4217.	GBP
`pricing.taxes_and_fees.billable.currency.value`	O valor bruto da reserva.	491,10

ganhos

Nome do campo	Definição	Exemplo
`commission`	Objeto que representa o valor da comissão da reserva ou do item, incluído no valor bruto da reserva.
`commission.billable_currency`	Objeto que representa o valor da comissão na moeda de pagamento.
`commission.billable_currency.currency`	Moeda do valor da comissão, representada no formato ISO 4217.	US$
`commission.billable_currency.value`	Valor monetário da comissão.	100.25
`service_charge`	Objeto que representa as taxas de serviço aplicadas por uma agência TAAP ao itinerário.
`service_charge.amount`	Objeto que representa o valor monetário da taxa de serviço aplicada por uma agência TAAP ao itinerário.
`service_charge.amount.billable_currency`	Objeto que representa o valor da taxa de serviço na moeda de pagamento.
`service_charge.amount.billable_currency.currency`	Moeda do valor da taxa de serviço, representada no formato ISO 4217.	US$
`service_charge.amount.billable_currency.value`	Valor monetário das taxas de serviço aplicadas pela agência TAAP ao itinerário.	50,50
`service_charge.taxes_and_fees`	Objeto que representa o valor e a moeda dos impostos e taxas referentes à taxa de serviço.
`service_charge.taxes_and_fees.billable_currency`	Objeto que representa o valor monetário dos impostos e taxas referentes à taxa de serviço, na moeda de pagamento.
`service_charge.taxes_and_fees.billable_currency.currency`	Moeda de pagamento, representada no formato ISO 4217.	US$
`service_charge.taxes_and_fees.billable_currency.value`	Valor dos impostos e taxas pagos pelo cliente, na moeda de cobrança.	5,25

Notas para todos os campos TAAP

Detalhes da API

Fornecemos um resumo do esquema e das configurações da API com base em como sua empresa usaria os dados da API de Itinerários. Você pode baixar as especificações OpenAPI e usar um software de teste de API para entender como os exemplos e as configurações de esquema se comparam à saída real.

Plataforma de viagens de marca branca

Os campos, incluindo quaisquer objetos aninhados, disponíveis para nossos parceiros da Plataforma de Viagens White Label por meio de nossos métodos de entrega push e pull são:

TAAP

Os campos, incluindo quaisquer objetos aninhados, disponíveis para nossos parceiros TAAP por meio de nossos métodos de entrega push e pull são: