Entrega File-based para Itinerários
O relatório padrão da API de Itinerários no Portal de Parceiros inclui reservas transaction-level, seja apenas para hospedagem ou para várias linhas de negócios (LOBs). Ao utilizar nossos relatórios padrão, você poderá obter seus dados rapidamente, sem tempo adicional de desenvolvimento.
Os relatórios da API de Itinerários são gerados no nível da transação e oferecem uma lista selecionada de mais de 60 campos para escolher para Hospedagem, além de mais de 100 campos para relatórios multi-LOB. As opções de campo incluem:
- Informações básicas da reserva, como datas da viagem, itinerários e valores da viagem.
- Informações do cliente viajante e comprador (se diferentes)
- Informações sobre o produto, como números de confirmação, fornecedores e locais, número de linhas de negócios utilizadas e custos.
Saiba mais sobre a configuração de entrega de arquivos.
Recomendações para a ingestão de arquivos
Campos padrão do relatório
Existem muitos campos para escolher ao personalizar seus relatórios. Esses dados são incluídos por padrão nos relatórios padrão.
| Nome do campo | Tipo de dados | Descrição | Exemplo |
|---|---|---|---|
book_date | em | A data em que uma reserva foi feita inicialmente, representada no formato de data ISO 8601 (YYYY-MM-DD). | 2023-02-05 |
transaction_date | em | A data em que uma reserva foi modificada pela última vez. Isso é o mesmo quebook_datese a reserva nunca for atualizada. A data é representada no formato de data ISO 8601 (YYYY-MM-DD). | 2023-02-05 |
begin_use_date | em | A data de início da viagem: data de partida, data check-in, data pick-up, etc., representada no formato de data ISO 8601 (YYYY-MM-DD). | 2023-04-05 |
end_use_date | em | A data de término da viagem: data de chegada, data check-out, data drop-off, etc., representada no formato de data ISO 8601 (YYYY-MM-DD). | 2023-04-06 |
transaction_type | varchar(200) | O tipo de transação registrada. | Valores possíveis: compra, prêmio, modificação, cancelamento. |
product_line_name | varchar(200) | O tipo de negócio ao qual o item de reserva pertence. | Valores possíveis: Passagem aérea, Carro, Cruzeiro, Serviços no destino, Seguro, Hospedagem, Pacote, desconhecido |
package_indicator | varchar(100) | Se o item da reserva faz parte de um pacote (como voo + hotel). | Valores possíveis: parte de um pacote, independente, desconhecido |
product_component | varchar(200) | Produtos incluídos na compra do pacote. Se a compra não for um pacote, apenas o nome de uma única linha de produtos será exibido. | Ar, Carro |
itinerary_number | varchar(50) | O número do itinerário ou número de referência do pedido do ponto de venda. | 12345678910111 |
booking_item_id | varchar(50) | Identificador de um item específico reservado como parte de um itinerário. O valor do campo pode ser positivo ou negativo. | 1400882912 |
currency_code | char(3) | Moeda em que a reserva foi paga, representada no formato padrão de código de moeda do Número Internacional de Conta Bancária (IBAN). | US$ |
gbv_local | decimal(18,4) | O valor bruto da reserva (GBV, na sigla em inglês), ou seja, o valor total da reserva, incluindo impostos e taxas, na moeda utilizada para o pagamento. | 694.89 |
order_count | pequeno | Número de pedidos (não itens) no pacote comprado. | 1 |
Campos opcionais adicionais
Nota: A tabela abaixo não representa a ordem em que os campos serão exibidos no relatório. A ordem dos campos é determinada pela ordem em que os campos são habilitados durante a criação/edição.
| Nome do campo | Tipo de dados | Descrição | Exemplo |
|---|---|---|---|
transaction_datetime | Carimbo de data/hora | A data/hora da última atualização (modificação) da reserva é a mesma que a data da reserva, caso ela nunca seja alterada. | 2023-02-05 06:05:00 |
booking_window | inteiro | Dias entre a data reservada e a data check-in. | 32 |
booking_status | varchar(50) | Aberto, em andamento, concluído, premiado ou cancelado. | Em andamento |
online_offline_indicator | varchar(100) | Indicação se a reserva foi feita online ou offline por meio de um agente. | on-line |
point_of_sale_country | char(3) | Ponto de venda a partir do qual o cliente está fazendo a reserva. | US$ |
payment_type | varchar(50) | Método de pagamento utilizado (cartão de crédito, pontos, pagamento parcelado). | Pagamento dividido |
coupon_code | varchar(100) | Código do cupom utilizado. | ABCD |
coupon_name | varchar(200) | Nome do cupom. | PRIME |
coupon_description | varchar(510) | Descrição do cupom utilizado. | BoGo 5% |
coupon_price_amount_usd | decimal(18,4) | Valor do cupom em dólares americanos. | -58.6877 |
gbv_usd | decimal(18,4) | Valor bruto da reserva em dólares americanos. | 694.8941 |
gbv_tpid | decimal(18,4) | Fornece o GBV total na moeda TPID. | 694.8941 |
taxes_and_fees_local | decimal(18,4) | Total de impostos e taxas em moeda local. | 144.77 |
taxes_and_fees_usd | decimal(18,4) | Total de impostos e taxas em dólares americanos. | 144,77 |
taxes_and_fees_tpid | decimal(18,4) | Total de impostos e taxas em moeda TPID. | 144,77 |
insurance_gbv_local | decimal(18,4) | Valor do seguro em moeda local. | 80.4 |
insurance_gbv_usd | decimal(18,4) | Valor do seguro em dólares americanos. | 80,4 |
air_supplier_pnr | varchar(100) | Registro de nome do passageiro aéreo do provedor. | ABCDEF |
air_carrier_pnr | varchar(100) | Registro de nome do passageiro da companhia aérea. | BCDEFG |
air_business_model | varchar(200) | Modelo de negócio do componente aéreo da reserva. | Agência |
air_trip_type | varchar(200) | Tipo de viagem aérea. | Somente ida |
air_fare_class | varchar(200) | Classe da passagem aérea adquirida. | Classe executiva |
air_plating_carrier | varchar(200) | Nome da companhia aérea. | Air Canada |
airport_origin_code | char(3) | Código do aeroporto de partida/origem do voo. | YYZ |
airport_origin_location | varchar(406) | Local de partida/origem do voo. | Toronto, Ontário, Canadá |
airport_destination_code | char(3) | Código do aeroporto de chegada/destino do voo. | FLL |
airport_destination_location | varchar(406) | Local de chegada do voo/destino. | Fort Lauderdale, Flórida, EUA |
air_ticket_number | varchar(100) | Número do bilhete aéreo. | 123456789101 |
air_ticket_count | pequeno | Número de passagens aéreas na reserva (com arquivos detalhados incluindo o ID do item da reserva, geralmente 0 ou 1). | 1 |
air_segment_count | pequeno | Número de trechos da viagem aérea (se agregados acima do nível de ID do item de reserva, será a soma de todos os trechos para todos os passageiros da reserva). | 2 |
air_gbv_local | decimal(18,4) | Valor bruto da reserva referente à parte aérea, em moeda local. | 694.8941 |
air_gbv_usd | decimal(18,4) | Valor bruto da reserva referente à parte aérea, em dólares americanos. | 694.8941 |
air_gbv_tpid | decimal(18,4) | Valor bruto da reserva referente à parte aérea, em moeda TPID. | 694.8941 |
air_tpid_currency_code | char(3) | A moeda de reserva do TPID é representada no formato padrão de código de moeda do Número Internacional de Conta Bancária (IBAN). | US$ |
total_person_count | inteiro | Número total de pessoas incluídas na reserva (apenas hospedagem). | 3 |
adult_count | pequeno | Número de adultos incluídos na reserva (apenas hospedagem). | 2 |
child_count | pequeno | Número de crianças incluídas na reserva (apenas hospedagem). | 1 |
lodging_supplier_confirmation_code | varchar(100) | Código de confirmação fornecido por propriedade no momento da reserva. | 1516171819 |
lodging_business_model | varchar(200) | Modelo de negócio do componente de hospedagem da reserva. | Merchant |
lodging_chain_independent | varchar(200) | Indicador que mostra se propriedade é independente ou faz parte de uma cadeia. | Independent |
lodging_chain_name | varchar(200) | Nome da rede (marca) de propriedade reservada. | Independent |
lodging_property_name | varchar(200) | Nome da reserva propriedade | Hotel Cordélia |
lodging_star_rating | float | Classificação por estrelas de propriedade reservado. | 3 |
lodging_property_city | varchar(40) | Cidade onde está localizado o imóvel reservado com o número propriedade. | Paris |
lodging_property_market_name | varchar(80) | Mercado onde está localizado o imóvel reservado propriedade. | IDF - Paris, França |
lodging_property_state_province | varchar(40) | Estado/província onde está localizado o voo propriedade. | Paris |
lodging_property_country | varchar(80) | Código do país onde se encontra a reserva propriedade. | França |
lodging_refundable_rate_indicator | varchar(100) | Indicação se a tarifa reservada é reembolsável ou não reembolsável. | Taxa de cancelamento reembolsável. |
lodging_rate_plan_name | varchar(200) | Nome do plano tarifário reservado. | Pacote |
lodging_rate_type_name | varchar(200) | Nome do tipo de tarifa reservada. | Pacote |
lodging_room_type_name | varchar(200) | Nome do tipo de quarto reservado. | Quarto duplo confortável com banheiro privativo. |
lodging_length_of_stay | inteiro | Duração da estadia (número de noites) na reserva propriedade. | 5 |
lodging_room_count | pequeno | Número de quartos reservados em propriedade. | 1 |
lodging_room_night_count | pequeno | Número de diárias na reserva (duração da estadia * número de quartos). | 5 |
lodging_gbv_local | decimal(18,4) | Valor bruto da reserva referente à hospedagem, em moeda local. | 1379.8 |
lodging_gbv_usd | decimal(18,4) | Valor bruto da reserva referente à hospedagem, em dólares americanos. | 1029.9317 |
lodging_gbv_tpid | decimal(18,4) | Valor bruto da reserva referente à hospedagem, na moeda do TPID. | 1029.9317 |
lodging_average_daily_rate_local | decimal(18,4) | Tarifa média diária da reserva propriedade (GBV / duração da estadia) em moeda local. | 275.96 |
lodging_average_daily_rate_usd | decimal(18,4) | Tarifa média diária da reserva propriedade (GBV / duração da estadia) em dólares americanos. | 205.9863 |
lodging_tpid_currency_code | char(3) | A moeda de reserva do TPID (Número de Identificação de Programa de Hospedagem) é representada no formato padrão de código de moeda do Número Internacional de Conta Bancária (IBAN). | US$ |
car_supplier_confirmation_code | varchar(100) | Código de confirmação fornecido pela locadora de veículos no momento da reserva. | ABC1234 |
car_business_model | varchar(200) | Modelo de negócio do componente de reserva de carros. | n/d |
car_vendor_name | varchar(200) | Nome da locadora de veículos contratada. | Hertz |
car_type | varchar(200) | Tipo de carro reservado. | Compacto de 2/4 portas |
car_pickup_location_code | char(3) | Código de localização (normalmente o código do aeroporto) onde o carro reservado deve ser retirado. | YDF |
car_pickup_location | varchar(200) | Local onde o carro reservado deve ser retirado. | Deer Lake, NL (YDF-Aeroporto Regional de Deer Lake) |
car_dropoff_location_code | char(3) | Código de localização (normalmente o código do aeroporto) onde o carro reservado deve ser devolvido. | YDF |
car_dropoff_location | varchar(200) | Local onde o carro reservado deve ser devolvido. | Deer Lake, NL (YDF-Aeroporto Regional de Deer Lake) |
car_trip_type | varchar(200) | Se o carro foi reservado para ida e volta ou apenas para ida. | Ida e volta |
car_rental_day_count | pequeno | Número de dias em que o carro foi reservado. | 7 |
car_count | pequeno | Número de carros reservados. | 1 |
car_gbv_local | decimal(18,4) | Valor bruto da reserva do veículo (parte da reserva) em moeda local. | 310.8 |
car_gbv_usd | decimal(18,4) | Valor bruto da reserva do carro, em dólares americanos. | 231.9919 |
car_gbv_tpid | decimal(18,4) | Valor bruto da reserva do veículo (parte da reserva) na moeda TPID. | 1029.9317 |
car_tpid_currency_code | char(3) | A moeda de reserva do TPID do carro é representada no formato padrão de código de moeda do Número Internacional de Conta Bancária (IBAN). | US$ |
activity_offering_name | varchar(200) | Nome da atividade da Destination Services reservada. | Passions of Paradise Great Barrier Reef |
activity_vendor_name | varchar(200) | Nome do provedor de serviços de destino reservado. | Viator (3P) |
activity_vendor_city | varchar(200) | Cidade onde se localiza a filial do provedor. | Desconhecido |
activity_vendor_country_code | char(3) | Código do país onde se localiza a filial do provedor. | NZL |
activity_ticket_count | pequeno | Número de bilhetes reservados para a atividade. | 1 |
activity_gbv_local | decimal(18,4) | Valor bruto da reserva referente aos Serviços de Destino, em moeda local. | 204.02 |
activity_gbv_usd | decimal(18,4) | Valor bruto da reserva referente aos Serviços de Destino, em dólares americanos. | 152.2878 |
activity_gbv_tpid | decimal(18,4) | Valor bruto da reserva referente à parte da reserva relacionada às atividades, na moeda do TPID. | 1029.9317 |
activity_tpid_currency_code | char(3) | A moeda de reserva do TPID da atividade é representada no formato padrão de código de moeda do Número Internacional de Conta Bancária (IBAN). | US$ |
loyalty_id | varchar(200) | Número de identificação de fidelidade/membro. | 12345678 |
program_id | varchar(200) | Representa informações de nível | 6549 |
passenger_name | varchar(200) | Nome da pessoa associada à reserva (geralmente o mesmo que o nome do comprador, exceto em reservas de passagens aéreas, onde todos os passageiros com bilhete são listados). | James Smith |
purchaser_first_name | varchar(200) | Nome da pessoa que efetuou a reserva. | James |
purchaser_last_name | varchar(200) | Sobrenome da pessoa que está efetuando a reserva. | Smith |
purchaser_email_address | varchar(200) | Endereço de e-mail da pessoa que efetuou a reserva. | james.smith@email.com |
billing_address | varchar(200) | Endereço da pessoa que efetuou a reserva (incluindo rua, cidade, estado/província, país e código postal). | 123 1st Street, Nova Iorque, NY |
billing_phone_number | varchar(200) | Número de telefone da pessoa que efetuou a reserva. | 10111213141 |
promotional_mail_indicator | char(3) | Indicador que mostra se o indivíduo está cadastrado para receber correspondências promocionais. | 0 |