Pular para o conteúdo
Blog

Antes de contratar uma empresa de integração de API em Dubai

Redação Tekravel
Escrito com a ajuda de IA

Há três orçamentos na mesa. Cada empresa de integração mostra um portfólio de sites de viagem, cada uma promete "conectar uma API de voos ao seu site", e a mais barata pode começar na semana que vem. Você tem uma agência em Deira, seis funcionários e uma carteira corporativa estável, e já cansou de copiar tarifas da extranet do fornecedor para mensagens de WhatsApp. Escolher a empresa de integração de API em Dubai que parece mais competente dá a sensação de ser a decisão inteira.

É mais ou menos um terço dela. O que decide se o site vende não está em nenhum dos três orçamentos, porque não é código. É com quem o contrato de fornecimento foi assinado, em nome de quem as passagens são emitidas, onde fica o dinheiro entre a reserva e a emissão, e quem cuida do reembolso quando o cliente cancela. Um integrador consegue ligar tudo isso. Não consegue ser nenhuma dessas coisas por você.

Este texto é para o dono que vai assinar o escopo do projeto, não para o desenvolvedor que vai lê-lo.

O que uma empresa de integração de API em Dubai entrega, e o que não entrega

Uma empresa de integração escreve o código entre a API de um fornecedor e o seu site: o formulário de busca, a chamada que consulta disponibilidade, a checagem de preço antes do pagamento, o pedido de reserva, as telas que mostram o resultado e, se o escopo prever, as chamadas de cancelamento e reembolso. As boas também cuidam da parte chata que importa: novas tentativas quando o fornecedor demora a responder, logs que permitem rastrear uma reserva que falhou, um ambiente de teste que se comporta como o de produção.

O que ela não pode entregar é tudo o que fica do outro lado desse código. Antes de escrever a primeira linha, a agência precisa ter:

  • uma conta no fornecedor em nome da própria agência, com acesso à API liberado para essa conta;
  • autoridade de emissão, seja credenciamento próprio, seja um consolidador que emita por ela;
  • um acordo financeiro com esse fornecedor: depósito, linha de crédito ou pagamento com cartão repassado;
  • alguém que faça o trabalho pós-emissão (voids, reembolsos, reemissões, mudanças de horário), pela API ou, se não der, à mão.

O integrador que se oferece para "resolver a parte do fornecedor" geralmente está oferecendo emprestar a dele. Para um protótipo, pode ser um atalho razoável. Para um negócio, significa que o seu site de reservas roda sobre uma relação que não é sua e que você não leva quando sair.

O briefing: sete linhas para o escopo do projeto

A maioria das brigas com integradores nasce de uma frase que ninguém escreveu. Coloque estas no documento que você assina, em linguagem simples, e peça cada resposta por escrito.

  1. Em nome de quem estão a conta no fornecedor e as chaves de API. Da agência. Chaves são credenciais: ficam no seu cofre de senhas, e o integrador recebe acesso, não a posse.
  2. Quem hospeda o site e quem é dono do domínio. O domínio é registrado em nome da agência. A conta de hospedagem é da agência, ou o contrato diz exatamente como ela é transferida.
  3. Quais operações entram no escopo. Liste pelo nome: busca, preço, reserva, emissão, cancelamento, reembolso, alteração. O que não estiver na lista continua sendo um e-mail para o balcão do fornecedor enquanto o site existir. Reembolsos e alterações são os que mais faltam, porque nenhuma demonstração os mostra.
  4. Quem mantém a integração quando o fornecedor muda a API. Fornecedores aposentam versões e renomeiam campos. Um projeto de preço fechado sem cláusula de manutenção termina no dia em que a primeira versão muda.
  5. O que significa entrega. Código-fonte em um repositório que pertence à agência, todas as credenciais e um documento que permita a outro desenvolvedor continuar o trabalho. "Mandamos um zip" não é entrega.
  6. Como se prova que está pronto. Uma reserva de teste da busca até a emissão no ambiente de teste do fornecedor, incluindo um cancelamento, antes de alguém passar o cartão de um cliente de verdade.
  7. O que acontece com os dados dos clientes. Nomes de passageiros, dados de passaporte e referências de pagamento: onde ficam guardados, quem pode lê-los e como são apagados.

Nenhum desses itens exige formação técnica para ser escrito. Todos saem mais baratos combinados antes da obra do que negociados depois dela.

Três caminhos para levar conteúdo de fornecedor ao seu site

Contratar um integrador contra a API de um fornecedor é um dos caminhos. Vale a pena olhá-lo ao lado dos outros dois antes que um orçamento faça a escolha por você.

CaminhoQuem detém a relação com o fornecedorQuem mantém a conexão funcionandoO que a agência ainda precisa construirQuanto custa sair
Integrador liga seu site à API de um fornecedorA agência, se o briefing disser; senão, muitas vezes o integradorO integrador sob contrato de manutenção, ou ninguémPainel, markups, cadastro de clientes, relatórios, pagamentos, telas de pós-vendaPouco se o código e as chaves forem seus; refazer tudo se não forem
Integrador liga seu site à API de uma plataformaA plataforma tem os contratos com fornecedores; a agência tem a conta na plataformaA plataforma do lado do fornecedor; o integrador do seu ladoSeu site, e o que a API da plataforma não cobrirReescrever o seu lado contra outra API
Loja white-label que já vem conectadaA plataforma, por meio da conta da agênciaA plataformaConteúdo, decisões de preço, seus próprios clientesMover o domínio e a lista de clientes para outro provedor

A linha que merece discussão é a primeira. Ela dá o maior controle e joga mais coisa nas suas costas: cada mudança do fornecedor, cada novo serviço e cada operação que ficou de fora na primeira versão vira outro projeto, com outro orçamento.

Como colocar busca em um site que você já tem está em adicionar busca de voos a um site existente, e como escolher de quem é a API por trás dela, em o que existe por trás de um fornecedor de API de reservas de voos. Este texto trata do contrato em volta do trabalho.

Onde esta plataforma se encaixa

A plataforma por trás deste blog oferece APIs de voos e de hotéis. O acesso começa com uma conversa, não com uma chave gerada sozinha, porque as primeiras perguntas são as de cima (quais serviços, qual mercado, como o dinheiro circula) e não qual endpoint chamar. Os serviços são ativados por conta, e cada conta tem o próprio painel administrativo com reservas, clientes, markups e relatórios, então a coluna "ainda precisa construir" da segunda linha é mais curta do que parece.

Se uma empresa de integração vai construir o seu lado, tenha essa conversa antes de aceitar um orçamento, para que o escopo descreva a API à qual ela vai de fato se conectar. A página de APIs de viagem é o ponto de partida.

Quanto custa um briefing fraco

O site entra no ar. A busca funciona, os preços parecem certos, e a primeira reserva chega numa quinta-feira à noite. Ela não pode ser emitida em nome da sua agência, porque a conta no fornecedor é do integrador e emite pelo acordo dele. O cartão do cliente já foi cobrado. Agora você tem uma reserva que não consegue emitir nem reembolsar pelo seu próprio site.

Ou funciona por um ano. Aí o fornecedor muda de versão de API, as reservas param, e o integrador, cujo contrato de preço fechado acabou na entrega, manda orçamento de um projeto novo. Você paga, porque as únicas pessoas que entendem o código são as que estão orçando.

Ou o integrador simplesmente está ocupado com outra coisa. Um cliente precisa corrigir o nome numa passagem, a operação de alteração nunca entrou no escopo, e duas pessoas da sua equipe passam a tarde mandando e-mail para o balcão do fornecedor. É exatamente o trabalho que o site deveria ter tirado de vocês.

Em todos os casos faltou uma frase no briefing. O código estava certo todas as vezes.

Redação Tekravel

Mesa de tecnologia de viagens

A mesa de tecnologia de viagens da Tekravel escreve para o setor: donos de agências, consolidadores e os programadores que os integram. Cada artigo é verificado na plataforma que descreve antes de ser publicado.