Pular para o conteúdo
Blog

Fornecedor de API de reserva de hotel: avalie-o na receção

Redação Tekravel
Escrito com a ajuda de IA

O primeiro pedido de suporte depois do lançamento raramente é sobre a pesquisa. É um hóspede à receção às onze da noite, com um número de confirmação no telemóvel, e um rececionista que o digita duas vezes e diz que o hotel não tem nenhuma reserva com esse nome. O hóspede pagou-lhe. O seu sistema diz que a reserva está confirmada. Ambos dizem a verdade, e é precisamente esse o problema.

É por causa desse pedido que escolher um fornecedor de API de reserva de hotel é, na verdade, uma decisão sobre o que acontece depois. A maioria das equipas decide pelo que se vê numa demonstração: quantos alojamentos aparecem numa cidade, quão limpo é o endpoint de disponibilidade, quão depressa o SDK chega a um primeiro resultado. Isso conta. Mas é mais ou menos igual em todo o lado, e nada disso decide o que se passa na receção.

Porque a cobertura é a primeira pergunta errada

Uma pesquisa que devolve mais hotéis parece uma API melhor. Mas um alojamento que pode mostrar e uma reserva que o hotel honra são duas promessas diferentes, feitas por partes diferentes do negócio do fornecedor. A primeira vem de um feed de conteúdo. A segunda vem de contratos, de ligação aos sistemas do próprio hotel e de uma equipa de apoio que alguém garante num sábado.

Se está a decidir quantos fornecedores ligar, essa pergunta tem um artigo próprio, e o problema de mapeamento que descreve é real. Este parte do princípio de que já está a escolher o fornecedor e pergunta quanto vale a resposta da reserva depois de o hóspede ter pago.

As cinco propriedades de um fornecedor de API de reserva de hotel que só aparecem depois do pagamento

Reduza a documentação do fornecedor às respostas que o seu site vai guardar depois de o dinheiro se mover. São as linhas em que dois fornecedores com endpoints de pesquisa idênticos se revelam produtos diferentes.

PropriedadeComo é uma boa respostaO que lhe custa quando falta
Condições de cancelamentoEstruturadas: um prazo, uma penalização e o fuso horário do prazoTexto livre que alguém tem de ler, e um reembolso decidido por palpite
Quem cobra o dinheiroIndicado por tarifa: pré-pago a si ou pago no hotel, e quem é o comerciante registadoUm hóspede cobrado duas vezes, uma por si e outra no check-out
Número de confirmação do próprio hotelDevolvido, ou entregue depois por um canal documentadoApenas a referência do fornecedor, que não significa nada na receção
Alteração de preço entre disponibilidade e reservaUm novo preço explícito ou uma recusa clara, nunca uma diferença silenciosaA diferença entre a tarifa mostrada e a reservada sai da sua margem
Sem registo à chegadaUm procedimento descrito e um contacto que atende fora do horário de expedienteA sua equipa ao telefone com o hotel enquanto o hóspede espera no lobby

Pode discordar da ordem. Não pode lançar um site que aceita cartões sem uma resposta para cada linha.

O cancelamento é dados, ou é um passivo

Olhe com atenção para a primeira linha, porque é a que falha mais em silêncio. Muitas respostas trazem a política de cancelamento como uma frase: cancelamento gratuito até uma data, depois cobra-se a primeira noite. Para uma pessoa lê-se bem. O seu código não consegue agir sobre uma frase sem a interpretar, e é assim que os erros chegam à produção.

O pormenor que morde é o fuso horário. Um prazo à meia-noite é um momento na cidade do hotel, outro no seu servidor e um terceiro no telemóvel do hóspede. Se o fornecedor não diz qual, um dia o seu site dirá a um hóspede que ainda pode cancelar sem custos, reembolsa-o e descobre que o hotel cobrou a penalização na mesma. Nada lançou um erro. O dinheiro simplesmente saiu.

As tarifas não reembolsáveis merecem o mesmo escrutínio. Um fornecedor que as assinala com clareza, num campo e não só no nome da tarifa, pensou no site que as vende. Peça para ver os dois tipos numa resposta real antes de assinar o que quer que seja.

Que nome aparece no extrato do cartão do hóspede

A segunda linha parece contabilidade. É, na verdade, uma questão de apoio ao cliente. Quando uma tarifa é pré-paga, o hóspede paga-lhe, você ou o fornecedor paga ao hotel, e o hotel não deve cobrar nada ao hóspede além de extras como o minibar ou uma taxa municipal cobrada na receção. Quando é paga no hotel, o seu site não recebe nada pelo quarto, e o cartão do hóspede é cobrado pelo alojamento, muitas vezes no check-in ou no check-out.

Os dois modelos funcionam. O que não funciona é um checkout que não os distingue. Se o fornecedor devolve os dois tipos de tarifa com a mesma forma, com o modelo de pagamento escondido numa descrição, mais cedo ou mais tarde o seu site cobrará um quarto que o hotel volta a cobrar. O hóspede vê duas linhas no extrato e liga para o nome da primeira, que é o seu.

Por isso a resposta que quer é por tarifa, num campo, e inclui quem é o comerciante registado. Essa última parte decide cujo descritivo aparece no cartão e quem trata de uma contestação.

Perguntas a pôr por escrito antes de assinar

As demonstrações mostram o caminho feliz. As respostas escritas mostram se o fornecedor já enfrentou os outros. Envie estas perguntas e guarde as respostas:

  • Mostre-me uma resposta de reserva para uma tarifa não reembolsável e outra para uma tarifa com prazo de cancelamento gratuito.
  • Em que fuso horário está expresso esse prazo e em que ponto da resposta isso é indicado?
  • Quando chega o número de confirmação do próprio hotel e como o recebo se vier depois da chamada de reserva?
  • Numa tarifa paga no hotel, o que vê exatamente o hóspede no cartão, vindo de quem e quando?
  • Quando um hóspede chega e o hotel não tem registo, a quem ligam eles ou eu, e a que horas?

Um fornecedor que responde à última pergunta com um procedimento já passou por isso. Um que responde com o nome de uma funcionalidade, não. O mesmo vale do lado dos voos, onde o que está por trás da API conta mais do que a API.

O que custa errar

Cada falha é pequena e repete-se. Um reembolso pago da sua margem porque um prazo foi lido no fuso horário errado. Um hóspede cobrado duas vezes porque uma tarifa paga no hotel parecia pré-paga no seu checkout. Um colaborador que passa o início de cada semana a telefonar a hotéis para reconfirmar reservas à mão, porque o fornecedor nunca devolveu um número que o hotel reconheça. Nada disto aparece numa contagem de cobertura, e tudo aparece na caixa de suporte no primeiro mês de tráfego real.

O trabalho para o evitar é uma tarde: ler cinco respostas de reserva com a tabela acima ao lado.

Onde nos situamos

A Tekravel disponibiliza APIs de hotéis e de voos. O acesso começa por uma conversa e não por uma chave de autoatendimento, os serviços são ativados por tenant e o conteúdo dos fornecedores chega a um tenant através de grupos de fornecedores e não de acordos um a um. Não publicamos contagens de alojamentos nesta página, e preferimos que nos faça as cinco perguntas acima a aceitar um número de boa-fé. Se está nessa fase, a página da API é onde a conversa começa.

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.