Pular para o conteúdo
Blog

Quantos fornecedores de API de hotéis você precisa? Conte o mapeamento

Redação Tekravel
Escrito com a ajuda de IA

A busca de hotéis entrou no ar no trimestre passado com um único fornecedor, e por um tempo ninguém reclamou. Então o comercial encaminha um print. Um cliente estava planejando Lisboa, achou um quatro estrelas no celular e perguntou por que o seu site não mostrava o hotel de jeito nenhum. Não era um preço pior. Não havia listagem. A mensagem seguinte é dirigida a você: a gente adiciona outro fornecedor?

Provavelmente. Mas quantos fornecedores de API de hotéis você precisa não é uma pergunta de cobertura com uma resposta de cobertura. Cada fornecedor que você adiciona amplia o inventário e também manda hotéis que você já tem, com outro nome, outro código e coordenadas um pouco diferentes. A segunda integração é quase só código. Tudo o que vem depois é quase só deduplicação, e esse é o custo que fica de fora quando as pessoas contam fornecedores.

Cada fornecedor são dois feeds, não um

Um fornecedor de hotéis entrega duas coisas muito diferentes, e tratá-las como uma só é a raiz da maioria dos erros iniciais.

A primeira é o conteúdo estático: nomes das propriedades, endereços, coordenadas, categoria em estrelas, fotos, descrições dos quartos, comodidades. Muda devagar. Você puxa em lote, armazena e atualiza numa cadência medida em dias. A segunda são as tarifas ao vivo: o que está disponível para estas datas, para esta ocupação, a que preço, com qual política de cancelamento. Isso muda entre a busca e a reserva. Você guarda em cache por minutos, no máximo, e confere de novo no prebook independentemente do que a busca disse.

Logo, dois tempos de cache, dois modos de falha. Conteúdo estático velho mostra a foto errada. Uma tarifa velha vende um quarto por um preço que o fornecedor não vai honrar. Quando você adiciona um fornecedor, adiciona os dois feeds, e o estático é onde o trabalho de verdade se esconde, porque é ele que você precisa reconciliar com tudo o que já tem.

Por que o mesmo hotel chega três vezes

Conecte três fornecedores na mesma cidade e faça uma busca. Você vai ver algo assim: um fornecedor chama de Grand Plaza Hotel Baixa, outro de Grand Plaza Baixa, um terceiro de GRAND PLAZA HTL - LISBOA. Três códigos internos. Três pares de coordenadas a poucos passos de distância. Três conjuntos de fotos, um deles de antes da reforma. Para o seu viajante, parece um site quebrado.

A correção é uma camada de mapeamento, e o campo pelo qual você deduplica não é o nome. É o seu próprio ID canônico da propriedade. Cada código de hotel do fornecedor aponta para ele por uma tabela de mapeamento: fornecedor, código do hotel no fornecedor, ID canônico. O código do fornecedor nunca vira a chave primária do seu catálogo, porque no momento em que você adiciona um segundo fornecedor essa decisão fica muito cara de desfazer.

Como decidir que dois códigos são um hotel só é um problema de matching, e raramente é limpo:

  • Um código de mapeamento externo compartilhado, quando os fornecedores o trazem, é o sinal mais forte. Nem todos trazem, e não para toda propriedade.
  • Coordenadas dentro de um raio pequeno, mais um nome normalizado (tire “hotel”, a cidade, pontuação, maiúsculas), pegam a maior parte do resto.
  • Endereço e telefone resolvem os casos apertados. Duas unidades da mesma rede na mesma rua são exatamente o caso em que nome e distância concordam e os hotéis são diferentes.
  • O que sobra vai para uma fila de revisão humana. Não entra no ar por palpite.

Quartos são mais difíceis que hotéis

Depois que a propriedade está mapeada, os quartos ainda discordam. “Deluxe King”, “Superior Room, 1 King Bed” e “Quarto Duplo - Vista Cidade” podem ser o mesmo quarto ou três diferentes. A maioria das equipes compara as ofertas no nível da propriedade, por regime de alimentação, condições de cancelamento e preço, em vez de tentar mapear cada nome de quarto entre fornecedores. É uma escolha defensável. Só faça de propósito, e mostre ao viajante o bastante da descrição original do fornecedor para que ele saiba o que está reservando.

Um fornecedor, vários, ou um agregador

Três caminhos, e a comparação honesta é sobre quem carrega o mapeamento e o risco de paridade tarifária, não sobre a cobertura de vitrine.

 CoberturaRisco de paridade tarifáriaEsforço de integraçãoQuem cuida do mapeamento
Um fornecedor, diretoForte onde esse fornecedor é forte, rala no restoAlto: quando o preço dele está errado, você não tem segunda cotaçãoUma integração, os dois feedsNinguém precisa; um código por hotel
Vários fornecedores, diretosA mais ampla que você controlaMenor: você escolhe a melhor cotação por estadiaUma por fornecedor, mais a camada de mapeamento, mais a manutenção delaVocê, permanentemente
Um agregadorAmpla, definida pelas fontes do agregadorMisto: você vê o preço que ele escolhe repassarUma integraçãoO agregador, com o seu julgamento sobre o que escapa

Você pode discordar da linha do meio, e muitas equipes discordam: ser dono do mapeamento é também ser dono da qualidade dos seus resultados, e algumas nunca entregariam isso. A questão é que se trata de uma decisão de equipe tanto quanto técnica. A tabela de mapeamento não é um projeto com data de término.

Decidindo o número

Conte mercados, não fornecedores. Comece com um fornecedor forte onde você mais vende. Mantenha um registro das buscas que voltaram vazias ou ralas, e dos prints que o comercial encaminha. Adicione o segundo fornecedor quando você conseguir nomear as cidades e propriedades que faltam no primeiro, e confira se o candidato realmente as cobre antes de assinar qualquer coisa.

Cada adição deve fechar uma lacuna que você consegue listar. Se não consegue listar, o novo fornecedor vai mandar principalmente duplicatas de hotéis que você já vende. Escrevemos à parte sobre como julgar APIs de viagem pelos seus eixos e não pelos folhetos, e aquele critério vale para todo candidato daqui.

Não integrar tudo por conta própria

Há um quarto caminho: integrar uma vez só com uma plataforma que já tem as conexões com fornecedores. Nessa plataforma o conteúdo dos fornecedores é compartilhado por grupos de fornecedores em vez de acordos um a um, e cada tenant vê os fornecedores que seus grupos lhe concedem. Para um desenvolvedor, isso tira a pergunta “quais fornecedores estão por trás da minha busca de hotéis” do código e leva para a configuração: você constrói contra uma única API de hotéis, e o mix de fornecedores vira um arranjo comercial, não mais um sprint de integração.

Isso não elimina as perguntas deste artigo. Pergunte como o mapeamento é tratado para os fornecedores que você receberia, e teste nas cidades em que você vende, não na cidade da demo. O acesso às APIs de voos e hotéis começa com uma conversa e não com uma chave self-service, que é o momento certo para fazer exatamente essa pergunta.

O que integrar de menos custa a você

O hotel que falta no print não é uma reserva perdida. É um cliente que agora confere o celular antes de mandar mensagem e, depois de mais alguns episódios, em vez de mandar mensagem. A agência não errou em nada no atendimento. A busca dela simplesmente não sabia que a propriedade existia.

Integrar demais custa de outro jeito: três linhas do mesmo hotel nos resultados, três políticas de cancelamento para explicar no balcão, três contratos e três conjuntos de credenciais para rotacionar. Nenhuma das duas falhas aparece na contagem de fornecedores. As duas aparecem no que o viajante vê na página de resultados.

Construa o lado das tarifas ao vivo para aguentar fornecedores lentos; tratamos disso em como desenhar um cliente de disponibilidade hoteleira. Depois deixe as lacunas que você consegue nomear decidirem quantos fornecedores ficam por trás dele.

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.