Demo ao vivo

Integração de fornecedores de hotéis

Integração da API Hotelbeds: conteúdo, mapeamento e reservas em tempo real

Uma integração da API Hotelbeds são dois trabalhos, não um. Você baixa e armazena o conteúdo dos hotéis e depois reserva com tarifas em tempo real. O PHPTRAVELS faz as duas coisas no módulo de hotéis, com o seu próprio contrato e as suas chaves Hotelbeds.

  • Sincronização da Content API
  • Fluxo da Booking API
  • Tarifas BOOKABLE e RECHECK
  • Mapeamento de hotéis

Como as APIs da Hotelbeds se encaixam

Integração da API Hotelbeds: conteúdo de um lado, reserva do outro

A Hotelbeds divide as suas APIs de hotéis em duas. A Content API devolve dados estáticos: descrições, imagens, comodidades, regimes e quartos. A Booking API devolve disponibilidade e preços em tempo real e efetua a reserva. Escolha uma etapa no centro para ver quais chamadas ela usa.

Content API

Estática, guardada do seu lado
  • Lista de hotéishotels · from=1&to=1000Todos os hotéis do seu portfólio, em páginas de até 1.000 hotéis por solicitação.
  • Comodidades, regimes e quartosfacilities · boards · roomsAs tabelas de códigos que transformam os códigos da Booking API em palavras que os seus hóspedes entendem.
  • Imagensphotos.hotelbeds.com/giata/Caminhos parciais de imagem, combinados com o servidor de fotos da Hotelbeds no tamanho que você precisar.
  • Alterações diáriaslastUpdateTimeApós a primeira carga, uma solicitação diária com lastUpdateTime devolve apenas o que mudou.

Fluxo de solicitações

Booking API

Em tempo real, chamada por hóspede
  • DisponibilidadePOST /hotelsQuartos, regimes, preços e taxas de cancelamento para os seus códigos de hotel, datas e ocupação.
  • Verificar tarifaPOST /checkratesPreço e condições atualizados para uma tarifa marcada como RECHECK, além de opções de upselling.
  • ReservaPOST /bookingsConfirma o rateKey escolhido com os nomes do titular e dos hóspedes e devolve a referência.
  • CancelamentoDELETE /bookings · simulateSimula um cancelamento para mostrar a taxa ou cancela a reserva de fato.
Tela de exemplo. Chamadas conforme a documentação em developer.hotelbeds.com; o fluxo é o que o PHPTRAVELS utiliza.

A maioria dos projetos Hotelbeds que falham mistura os dois lados. Chamam a Content API durante a busca do hóspede, o que é lento e, como a Hotelbeds alerta, pode bloquear as suas credenciais. Ou buscam em tempo real sem códigos guardados e não conseguem mostrar imagens nem comodidades. O PHPTRAVELS mantém os dois lados separados: o conteúdo é sincronizado em segundo plano e apenas as chamadas de disponibilidade, verificação de tarifa e reserva são executadas enquanto o hóspede espera.

Se procura informações sobre o próprio fornecedor, os seus produtos e como abrir uma conta, leia o perfil do fornecedor Hotelbeds. Esta página trata da integração técnica.

Tipos de tarifa

Os quatro campos de tarifa que mudam o seu checkout

Cada tarifa da Hotelbeds traz alguns atributos que decidem se você pode reservá-la imediatamente, que preço pode mostrar e quem recebe o dinheiro. São estes que o seu motor deve ler em cada resultado.

CampoPrimeiro casoSegundo casoO que o PHPTRAVELS faz

Reservável ou com verificação

rateType		BOOKABLE

A tarifa está atualizada. Você pode reservá-la sem outra chamada.

RECHECK

Você precisa chamar verificar tarifa primeiro para obter o preço e as condições atualizados.

Executa a verificação de tarifa antes da etapa de pagamento nas tarifas RECHECK e mostra ao hóspede qualquer alteração.

Líquida ou comissionável

net · sellingRate		net

Modelo líquido: os preços são líquidos, então você adiciona a sua própria margem.

sellingRate

Modelo comissionável: a comissão já está incluída em sellingRate e esse preço é final.

Aplica as suas regras de markup às tarifas líquidas e vende as tarifas comissionáveis pelo sellingRate.

Preço de venda fixo

hotelMandatory		true

hotelMandatory é true: você deve vender pelo sellingRate.

false · null

False ou vazio numa tarifa líquida: você pode definir a sua própria margem.

Fixa o preço exibido no sellingRate quando o hotel exige, independentemente da regra de markup.

Quando o hóspede paga

paymentType		AT_WEB

O pagamento é cobrado no momento da reserva, pelo seu site.

AT_HOTEL

O hóspede paga diretamente ao hotel.

Identifica a tarifa como pagar agora ou pagar no hotel e ajusta o checkout de acordo.

O modelo de preços que você recebe depende do seu contrato com a Hotelbeds. Como a Hotelbeds informa, o seu gerente comercial recomenda o modelo para o seu negócio.

Mapeamento de hotéis

Associe os hotéis da Hotelbeds aos hotéis que você já vende

Se você tem contratos próprios ou um segundo fornecedor, o mesmo hotel chegará com códigos diferentes. O mapeamento os vincula, para que o hóspede veja um único hotel com a melhor tarifa, e não três cópias.

Como funciona o mapeamento no PHPTRAVELS

Após cada sincronização de conteúdo, o PHPTRAVELS compara os hotéis da Hotelbeds com a sua lista de hotéis por nome, endereço, cidade e coordenadas. As correspondências próximas são vinculadas automaticamente. As duvidosas aguardam a confirmação de uma pessoa, e os hotéis sem correspondência podem ser importados como novas propriedades ou ignorados.

Os hotéis mapeados compartilham uma página, uma galeria e uma nota de avaliações no módulo Hospedagens, enquanto cada fornecedor mantém as suas próprias tarifas e regras. O mesmo mapeamento é usado pelo seu site público e pelo seu Portal de viagens B2B.

Mapeamento de hotéis
  • Harbour View HotelLisboa48291397%Associado
  • Old Town SuitesPraga11735492%Associado
  • Palm Court ResortDubai66201874%Revisar
  • Casa Azul BoutiqueSevilha–0%Sem correspondência
  • Northern Lights LodgeTromsø90522766%Revisar
  • Riverside ApartmentsBudapeste33076198%Associado

Tela de exemplo com hotéis e códigos fictícios.

Hotelbeds XML ou JSON

Cada solicitação é assinada, e os testes começam pequenos

Muitas equipes ainda procuram por Hotelbeds XML, mas a documentação atual mostra solicitações JSON. De qualquer forma, é o mesmo conjunto de operações, e cada solicitação leva dois cabeçalhos.

availability-request.sh (exemplo)
 1# X-Signature = SHA256(api key + secret + unix time in seconds) 2TS=$(date +%s) 3SIG=$(printf "%s%s%s" "$API_KEY" "$SECRET" "$TS" | sha256sum | cut -d" " -f1) 4 5curl -X POST https://api.test.hotelbeds.com/hotel-api/1.0/hotels \ 6  -H "Api-key: $API_KEY" \ 7  -H "X-Signature: $SIG" \ 8  -H "Accept: application/json" \ 9  -H "Content-Type: application/json" \10  -d '{11    "stay": { "checkIn": "2026-11-14", "checkOut": "2026-11-17" },12    "occupancies": [{ "rooms": 1, "adults": 2, "children": 0 }],13    "hotels": { "hotel": [482913, 117354] }14  }'1516# hotel codes come from your stored Content API data, never a live content call
Api-keyX-Signatureapi.test.hotelbeds.com
Dois cabeçalhos
Api-key com a sua chave e X-Signature: um hash SHA256 da sua chave, do seu segredo e da hora atual em segundos.
Servidor de teste
Como a Hotelbeds informa, os servidores de teste são iguais aos de produção, mas as reservas ali não são reais e os cartões não são cobrados.
50 solicitações por dia
Chaves novas abrem um ambiente de avaliação com uma cota de 50 solicitações por dia. A certificação libera mais.
Sem chamadas de conteúdo em tempo real
A Hotelbeds alerta que chamar a Content API em tempo real pode bloquear as credenciais. O PHPTRAVELS nunca faz isso.

Planejador de sincronização

Quantas chamadas à Content API a sua lista de hotéis precisa

Como a Hotelbeds informa, a lista de hotéis chega em páginas de até 1.000 hotéis e, após a primeira carga, uma solicitação diária com lastUpdateTime devolve apenas as alterações. Informe os seus números para planejar a sincronização.

Solicitações para a primeira carga completa
20
Solicitações por atualização diária
3
Dias para uma carga completa com a cota de avaliação
1

Apenas uma estimativa, para a lista de hotéis. As tabelas de códigos e as imagens acrescentam mais algumas chamadas. Com a cota de avaliação de 50 solicitações por dia, teste primeiro com um único destino.

Checklist de lançamento

O que ter pronto antes de passar para produção

A Hotelbeds leva você da avaliação à certificação e depois às chaves de produção pelo seu painel. Estes são os pontos que uma integração da API Hotelbeds deve cobrir primeiro, e como o PHPTRAVELS os cobre.

  • Chaves de avaliação adicionadas no painel, servidor de teste selecionado
  • Content API sincronizada com o seu banco de dados, com atualização diária agendada
  • Hotéis mapeados com a sua lista, correspondências duvidosas revisadas
  • Tarifas RECHECK passam por verificar tarifa antes do pagamento
  • sellingRate respeitado quando hotelMandatory é true
  • Comentários da tarifa e taxas de cancelamento exibidos antes de o hóspede pagar
  • O voucher mostra a referência Hotelbeds e os comentários da tarifa
  • Cancelamento simulado primeiro e depois confirmado, com a taxa registrada

As etapas de certificação e o acesso à produção são definidos pela Hotelbeds conforme o seu contrato e mercado.

Custo

Uma licença para o motor, o seu próprio contrato com a Hotelbeds

O PHPTRAVELS é uma licença única com o código-fonte. A Hotelbeds é um acordo separado entre você e a Hotelbeds, então as tarifas líquidas e as chaves continuam sendo suas.

Startup
Licença única
licença única
Agency
Licença única
licença única
Enterprise
Licença única
licença única

A Hotelbeds é uma de várias fontes de hotéis que você pode usar lado a lado. Veja como ela convive com a RateHawk na visão geral de APIs de viagem ou compare fornecedores na lista de fornecedores XML.

Ver preçosExperimentar a demo de hotéis

Perguntas frequentes

Perguntas sobre a integração da API Hotelbeds

O que desenvolvedores e empresas de viagem perguntam antes de conectar a Hotelbeds.

Fale com vendas

Duas partes. Uma sincronização em segundo plano com a Content API, que guarda hotéis, imagens, comodidades, regimes e quartos no seu banco de dados, e um fluxo em tempo real com a Booking API para disponibilidade, verificação de tarifa, reserva e cancelamento. O PHPTRAVELS executa ambas no módulo de hotéis.

Muitos ainda a chamam de Hotelbeds XML, mas a documentação atual da Hotelbeds mostra solicitações e respostas JSON. As operações são as mesmas em ambos os casos, e o PHPTRAVELS cuida do formato para você.

Uma tarifa BOOKABLE já está atualizada e pode ser reservada imediatamente. Uma tarifa RECHECK precisa antes de uma chamada de verificação de tarifa, que devolve o preço e as condições atuais. O PHPTRAVELS faz essa chamada antes da etapa de pagamento.

É lento, e a Hotelbeds alerta que usar a Content API em tempo real pode levar ao bloqueio das credenciais. O conteúdo deve ser baixado em páginas, armazenado e atualizado uma vez por dia com lastUpdateTime, que é como o PHPTRAVELS funciona.

Sim. Você se cadastra na Hotelbeds, assina o contrato e recebe a sua própria chave API e o seu segredo. Chaves novas funcionam num ambiente de avaliação com 50 solicitações por dia até você concluir a certificação.

Sim. O mapeamento de hotéis vincula a mesma propriedade entre as fontes, para que os hóspedes vejam um único hotel com a melhor tarifa disponível, enquanto cada fonte mantém o seu próprio markup e as suas regras.

Os planos do PHPTRAVELS começam em como licença única com o código-fonte. O seu contrato com a Hotelbeds é separado e firmado diretamente com a Hotelbeds. Veja a página de preços ou peça um orçamento à equipe de vendas.

Continue a explorar

Mais sobre a plataforma