Integração de API de voos

Integração da API de voos da TBO da busca ao bilhete eletrônico

Conecte sua conta TBO ao módulo de voos do PHPTRAVELS e venda tarifas aéreas da TBO no seu site e no portal de agentes. Cada tarifa é reverificada antes do pagamento, cada chamada leva um ID de rastreio e sua equipe recebe os logs, as regras de nova tentativa e as ferramentas de reservas que mantêm estáveis as vendas diárias de voos.

  • Tarifas aéreas da TBO ao vivo
  • Reverificação de preço antes do pagamento
  • ID de rastreio em cada chamada
  • Checkout B2C e portal B2B

O que você vende

Integração da API de voos da TBO dentro do seu próprio motor de reservas

A TBO é uma distribuidora de viagens B2B cuja API aérea retorna tarifas de voos que empresas de viagens podem revender. O módulo de voos do PHPTRAVELS a chama com suas próprias credenciais TBO, mostra as tarifas nos resultados de busca e conduz toda a reserva: regras tarifárias, reverificação de preço, dados dos passageiros, pagamento, reserva e bilhete.

Nem todas as tarifas se comportam igual. Dependendo da tarifa, algumas (muitas vezes de companhias low-cost) são reservadas e emitidas em um só passo, enquanto outras podem ficar retidas como reserva e ser emitidas depois. O módulo mantém essa diferença visível para sua equipe, para que nenhuma tarifa seja cobrada sem o próximo passo correto.

Baseado emVoosSoftware de reserva de voosAPIs de viagens

DEL → DXB · 2026-11-141 adulto · Econômica
  • LCC06:10 – 08:253h 45m · DiretoTBOLow-costBilhete na reservaSó bagagem de mãoNão reembolsável₹18,450Escolher
  • FSC09:40 – 11:503h 40m · DiretoTBOPode ser retidaBagagem despachadaNão reembolsável₹21,980Escolher
  • FSC21:15 – 23:353h 50m · DiretoTBOPode ser retidaBagagem despachadaReembolsável₹26,300Escolher

Tarifas de exemplo. Cada resultado mantém a etiqueta do fornecedor, assim o suporte sempre sabe a origem.

Cadeia de chamadas

Seis chamadas entre uma busca e um bilhete

Escolha uma etapa para ver o que volta da TBO, o que o PHPTRAVELS faz com isso e o que costuma dar errado ali.

Busca

O que volta
Tarifas para a rota, datas, cabine e combinação de passageiros, cada uma com um token de resultado para as chamadas seguintes.
O que o PHPTRAVELS faz
Normaliza os resultados, aplica sua margem, guarda a busca em cache e adiciona filtros de companhia, escalas, bagagem e horário de partida.
O que pode dar errado
Tarifas em cache exibidas por tempo demais. O cache é curto e cada etapa seguinte reverifica.

Regras tarifárias

O que volta
Condições de alteração e cancelamento, franquia de bagagem e observações da tarifa escolhida.
O que o PHPTRAVELS faz
Mostra as regras no cartão da tarifa e de novo antes do pagamento, em linguagem simples quando o fornecedor envia dados estruturados.
O que pode dar errado
Clientes comprando uma tarifa que não entenderam e depois pedindo reembolsos que a tarifa não permite.

Reverificação de preço

O que volta
O preço e a disponibilidade atuais da tarifa escolhida pelo cliente.
O que o PHPTRAVELS faz
Compara com o preço exibido. Igual, segue; mais alto, pede confirmação ao cliente; esgotada, devolve o cliente aos resultados.
O que pode dar errado
Cobrar o preço antigo de uma tarifa que mudou, o que gera disputas e reembolsos manuais.

Extras

O que volta
Assentos, refeições e bagagem extra quando a companhia e a tarifa os oferecem.
O que o PHPTRAVELS faz
Lista as opções com seus preços e as soma ao total da reserva antes do pagamento.
O que pode dar errado
Vender extras que a tarifa não comporta. Só as opções retornadas são oferecidas.

Reservar

O que volta
Um localizador de reserva, ou o motivo da falha quando o assento ou o preço não existem mais.
O que o PHPTRAVELS faz
Salva a reserva com seu ID de rastreio, os dados dos passageiros e o registro de pagamento, e inicia a linha do tempo da reserva.
O que pode dar errado
Um timeout após o pagamento. O módulo consulta o status da reserva antes de enviar qualquer segunda reserva.

Bilhete

O que volta
Números de bilhete eletrônico de cada passageiro quando a companhia os emite.
O que o PHPTRAVELS faz
Salva os números de bilhete, envia o itinerário por e-mail e abre a reserva para alterações, cancelamentos e reembolsos.
O que pode dar errado
Reservas retidas sem emissão até expirarem. Reservas retidas têm um prazo visível para sua equipe.

Reverificação de preço

A tarifa é conferida de novo antes de alguém pagar

A maioria das reservas de voo que falham começa com um preço que mudou entre a busca e o pagamento. Experimente os três resultados que o checkout trata.

Regras do checkout

  1. 01Cada tarifa é reverificada com a TBO antes da cobrança.
  2. 02O pagamento é capturado uma vez por rastreio, nunca de novo numa nova tentativa.
  3. 03Regras tarifárias e bagagem aparecem de novo na etapa de pagamento.
  4. 04Quando a tarifa se esgota, a busca e os dados dos passageiros são mantidos.

Fluxos de pagamento:Gateways de pagamentoCarteiras de agentes

Reverificação de tarifaDEL → DXB · LCC
Preço na busca
₹18,450
Preço na reverificação
₹18,450
Diferença
₹0

O pagamento segue pelo preço que o cliente viu.

Preço na busca
₹18,450
Preço na reverificação
₹19,120
Diferença
₹+670

O cliente vê o novo preço e o confirma antes do pagamento. Nada é cobrado até ele confirmar.

Preço na busca
₹18,450
Preço na reverificação
Indisponível
Diferença
—

O cliente volta a resultados novos com a mesma busca e os dados dos passageiros já preenchidos.

Valores de exemplo para um adulto.

Operações

Um ID de rastreio acompanha a reserva em cada chamada

Quando uma reserva precisa de atenção, o suporte abre o rastreio e lê o que aconteceu em ordem, em vez de pedir a um desenvolvedor que procure nos logs do servidor.

trace TBO-FL-7Q2K9 --route DEL-DXB --pax ADT1

  1. 10:02:11INFOresultados guardados em cache para esta busca
  2. 10:03:40INFOregras tarifárias e bagagem anexadas à tarifa escolhida
  3. 10:05:02WARNpreço mudou, cliente convidado a confirmar a nova tarifa
  4. 10:05:31OKcliente aceitou a nova tarifa
  5. 10:06:12INFOpagamento capturado uma vez para este rastreio
  6. 10:06:19WARNtimeout do fornecedor, consulta de status enviada em vez de uma segunda reserva
  7. 10:06:27OKreserva confirmada pela consulta de status, localizador salvo
  8. 10:06:40OKnúmeros de bilhete salvos, itinerário enviado por e-mail

Um rastreio de exemplo: o preço mudou, o cliente aceitou, a chamada de reserva teve timeout e uma consulta de status a confirmou sem reservar duas vezes.

  • Logs de requisições e IDs de rastreio

    Cada chamada de busca, reverificação, reserva e bilhete é registrada sob uma referência, para isolar problemas rapidamente.

  • Biblioteca de rotas de teste

    Um conjunto fixo de rotas, datas, cabines e combinações de passageiros que você roda após cada mudança.

  • Política de timeout e nova tentativa

    Recupera-se de falhas curtas de rede sem risco de reserva duplicada.

  • Alertas em picos de falhas

    Sua equipe é avisada quando as taxas de erro sobem, antes que as vendas sejam afetadas.

Plano de lançamento

Cinco passos para vender tarifas da TBO

Equipes perdem semanas quando descobrem tarde necessidades operacionais. Este plano as coloca primeiro.

  1. 01

    Acesso e credenciais

    Abra sua conta TBO, solicite acesso à API de voos e receba credenciais de teste.

  2. 02

    Conectar e validar

    Adicione as credenciais no painel, defina os timeouts e rode a biblioteca de rotas de teste.

  3. 03

    Controle de busca e preço

    Defina margens, moedas e filtros e confirme que os preços reverificados batem com o checkout.

  4. 04

    Reservar e confirmar

    Teste de ponta a ponta dados dos passageiros, pagamento, reserva, emissão e e-mails de itinerário.

  5. 05

    Operar e escalar

    Mude para credenciais de produção, configure alertas e etapas de suporte e libere o tráfego.

Biblioteca de rotas de teste

RotaViagemPassageirosCabineO que comprova
DEL → BOMOW1 ADTYUma tarifa doméstica básica e emissão imediata
BOM → DXBRT2 ADT · 1 CHDYPreço de criança e pareamento de ida e volta
DEL → LHRRT1 ADT · 1 INFYPreço de bebê e campos de passaporte
BLR → SINOW1 ADTCTarifas de classe executiva e suas regras
HYD → JEDOW2 ADTYRegras de bagagem num trecho longo

Use as rotas que você realmente vende; estas são exemplos.

Apoio na entrega quando quiser

  • Kickoff e escopoRotas, mercados, regras de preço e necessidades de fluxo de trabalho.
  • Implementação e QATestes de busca, reverificação e sucesso das reservas.
  • Suporte no lançamentoUm manual de monitoramento e a passagem para sua equipe de suporte.

Opções

Formas de vender voos da TBO, comparadas

Cada abordagem pode funcionar. A diferença é quanto você constrói e opera por conta própria.

OpçãoTempo até o lançamentoCarga de trabalho contínuaCostuma servir para
Desenvolvimento direto na API da TBOTempo até o lançamentoMédio a longo: você constrói a interface, os preços, a reverificação, os logs e as ferramentas de suporteCarga de trabalho contínuaAltaCostuma servir paraEquipes grandes com desenvolvedores e operações internas
Uma conexão GDSTempo até o lançamentoLongo: credenciamento e implementação mais profundosCarga de trabalho contínuaAltaCostuma servir paraNecessidades complexas de conteúdo aéreo
Outra API de agregadorTempo até o lançamentoMédio: início rápido, mas o pós-reserva continua com vocêCarga de trabalho contínuaMédiaCostuma servir paraUma primeira versão rápida
PHPTRAVELS com a TBOPronto para usarTempo até o lançamentoMais curto: o fluxo de reserva e as ferramentas de gestão já existemCarga de trabalho contínuaBaixa a médiaCostuma servir paraOTAs, agências, operadoras de turismo e DMCs

O PHPTRAVELS é uma licença de pagamento único com código-fonte sob licença comercial, instalada no seu próprio servidor. Você mantém seu contrato e suas credenciais da TBO.

Use a TBO ao lado de outros fornecedores de voos

Uma busca pode juntar várias fontes de voos, cada uma com sua margem, para que você nunca dependa de um único fornecedor.

Leia também:AmadeusSistema de reservas de voos NDCPortal B2B de viagensTodas as integrações

  • Seeru
  • Amadeus
  • Duffel
  • Google Flights
  • Kayak
  • Kiwi
  • Mystifly
  • PKfare
  • Sabre
  • Travelport

Perguntas frequentes

Perguntas sobre voos da TBO

O que as equipes costumam perguntar antes de conectar a conta TBO.

Fale com vendas

Confirme que sua conta TBO tem acesso à API de voos e obtenha credenciais de teste. Depois adicione-as ao módulo de voos, passe uma pequena biblioteca de rotas e datas reais por busca, reverificação, reserva e cancelamento, e só então refine a jornada do cliente.

Mudanças de preço entre a busca e o pagamento, limites das regras tarifárias que o cliente não viu e timeouts durante a confirmação. O módulo reverifica cada tarifa antes do pagamento, registra cada etapa sob um ID de rastreio e consulta o status da reserva após um timeout em vez de reservar de novo.

Sim. Um só motor de reservas atende os dois: clientes usam um checkout público e agentes têm seus próprios preços, margens e relatórios no portal de agentes.

Não. Muitas equipes mantêm seu CRM ou ferramentas contábeis e os conectam ao motor de reservas por APIs e webhooks, de modo que a venda de voos é adicionada sem mudar a forma como o escritório trabalha.

Os hotéis da TBO usam um conector separado no módulo de hospedagem. Você pode ativar voos, hotéis ou ambos com os mesmos dados da conta TBO quando seu contrato permitir.

Sim. Hotéis, passeios, carros e traslados podem ser adicionados depois, mantendo uma só conta de cliente, um só checkout e uma só camada de relatórios.