com tecnologia Bridgify (part of HBX Group)

Hotelbeds é um dos principais marketplaces B2B de viagens a nível mundial, parte do HBX Group, que distribui hotéis, transferes e experiências a cerca de 60 000 distribuidores de viagens em mais de 170 países. Para os operadores, gera apenas procura do setor profissional: operadores turísticos, consultores de viagens, companhias aéreas e programas de fidelização integram os produtos listados nas suas próprias vendas, trazendo reservas de grupo e com grande antecedência, em vez de tráfego de consumidores.

Ligar a Hotelbeds à Ventrata vai sincronizar a sua disponibilidade e os seus preços e entregar reservas, alterações e cancelamentos, com bilhetes emitidos automaticamente. A Hotelbeds funciona com Bridgify (part of HBX Group) e recebe os seus produtos através da integração certificada desta com a API OCTO da Ventrata.

Para saber mais sobre uma parceria com a Hotelbeds, visite hotelbeds.com.

📒 NOTA

Esta conexão estará disponível brevemente. Vai ligar a Hotelbeds diretamente à API OCTO da Ventrata através de Bridgify (part of HBX Group). Até estar ativa, pode ligar a Hotelbeds através de Travel Curious (formerly Redeam). Consulte Hotelbeds (via Travel Curious): conexão de revendedor.

Website principal	hotelbeds.com
Etiquetas	B2B Marketplace · Travel Agent
Mercados de destino	🌎 Global
Mercados emissores	🌎 Global
Funcionalidades da conexão	Availability Sync · Pricing Sync · Bookings Sync
Desenvolvido por	Bridgify (através da API OCTO da Ventrata)

Esta conexão de revendedor permite vender os seus produtos através da Hotelbeds sem gerir manualmente a disponibilidade, os preços e as reservas. As funcionalidades desta conexão incluem:

Availability Sync – a Hotelbeds consulta a sua disponibilidade em tempo real na Ventrata.
Pricing Sync – a Hotelbeds obtém os seus preços a partir dos preços de revendedor na Ventrata.
Bookings Sync – as reservas, atualizações e cancelamentos da Hotelbeds são criados instantaneamente na Ventrata, e os clientes recebem bilhetes Ventrata.

Criar a conexão com Hotelbeds

🔐 Permissões de função necessárias: See Connections, Modify Connections, See Connection Key

Antes de começar:

Tem de ter um acordo comercial com a Hotelbeds para que vendam os seus produtos. Para se informar sobre uma parceria, contacte-os através de hotelbeds.com.
Tem de ter a Hotelbeds criada como Reseller na Ventrata, com os respetivos preços (venda ao público, grossista/comissão) corretamente definidos. Esta conexão API exige que o revendedor esteja configurado com o método de liquidação "Bill to my account".

No Ventrata Dashboard, aceda a Connections → Connections, clique em + New Connection e selecione Hotelbeds (com tecnologia Bridgify) na lista de parceiros.
Selecione Hotelbeds Reseller na lista dos seus revendedores (tem de ser criado antes de criar uma conexão). A conexão herda a configuração do revendedor, como os preços, os destinos permitidos, os produtos, etc.
(Opcional) Também pode definir um Name à sua escolha para a conexão, o que pode ser útil se pretender ter várias conexões Hotelbeds e quiser distingui-las mais facilmente no futuro.
Clique no botão Create Octo Connection.

📗 DICA

Se necessário, também pode permitir ou excluir produtos ou destinos ao nível da conexão, além do que configurou no revendedor.

Mapear produtos para a Hotelbeds

Partilhe de forma segura a chave API OCTO apresentada na conexão que criou com o seu contacto na Hotelbeds e peça-lhe que mapeie os seus produtos através da API OCTO da Ventrata, com os preços (octo/pricing) ativados. Normalmente, a equipa da Hotelbeds não demora mais do que alguns dias úteis a concluir este processo.

A sua configuração na Ventrata está concluída. Não precisa de dar mais nenhum passo.

📗 DICA

A Hotelbeds pode aceder a todos os produtos ativados na conexão, mas também pode indicar os Product ID e Option ID da página da conexão quando a contactar, para especificar o que deve ser mapeado.

Gerir a conexão com Hotelbeds

Permitir ou excluir produtos: limite os destinos, produtos e opções a que a Hotelbeds pode aceder. Veja como permitir ou excluir produtos.
Mude o nome da conexão para distinguir várias conexões Hotelbeds.

Funcionalidades da conexão em detalhe

Esta secção destina-se a quem quer saber exatamente como funciona a conexão Hotelbeds: que chamadas à Ventrata OCTO API a Hotelbeds efetua (através da integração certificada de Bridgify (part of HBX Group)), quando as efetua e o que isso significa para si. Cada chamada tem uma ligação para a documentação da API da Ventrata.

Em resumo: a Hotelbeds obtém da Ventrata tudo aquilo de que precisa. Lê os seus produtos, consulta a sua disponibilidade e os seus preços, e envia reservas e cancelamentos. A Ventrata não envia alterações para a Hotelbeds, por isso qualquer alteração que faça na Ventrata chega à Hotelbeds na consulta seguinte.

Product Mapping	❌	Não é possível mapear produtos a partir da Ventrata. A Hotelbeds mapeia-os do seu lado, através do seu gestor de conta ou do portal da Hotelbeds. Funciona da seguinte forma: Get Products (`GET /products`) – quando a Hotelbeds configura a sua conexão, e sempre que atualiza as suas fichas, lê todos os produtos ativados na conexão, com as respetivas opções e unidades (tipos de bilhete, como Adult ou Child). Get Product (`GET /products/{productId}`) – a Hotelbeds volta a ler um único produto para obter alterações às respetivas opções, unidades, prazos limite de reserva e definições. Mapeamento do lado da Hotelbeds – a Hotelbeds associa cada opção e unidade da Ventrata à sua própria ficha e aos seus tipos de bilhete. O seu gestor de conta na Hotelbeds faz isto por si, ou fá-lo no portal da Hotelbeds, se este existir. Basta partilhar a chave API da conexão. O que isto significa para si: a Hotelbeds só pode vender o que mapeou. Quando adiciona um produto, uma opção ou uma unidade na Ventrata, a Hotelbeds pode vê-lo na atualização seguinte, mas não o vende enquanto não estiver mapeado. Por isso, informe o seu gestor de conta na Hotelbeds sempre que adicionar algum.
Content Sync	❌	A Hotelbeds não lê o conteúdo dos seus produtos a partir da Ventrata. A Hotelbeds utiliza as descrições, as imagens e outros conteúdos configurados do lado dela, por isso atualize os seus conteúdos diretamente com a Hotelbeds.
Availability Sync	✅	A Hotelbeds consulta a sua disponibilidade em tempo real na Ventrata. A Ventrata não envia alterações de disponibilidade para a Hotelbeds. Funciona da seguinte forma: Availability Check (`POST /availability`) – a Hotelbeds envia um produto, uma opção e uma data ou intervalo de datas. A Ventrata responde com cada dia ou horário reservável, o respetivo estado (`AVAILABLE`, `LIMITED`, `SOLD_OUT`, `CLOSED` ou `FREESALE`), as vagas restantes, o prazo limite de reserva e um `availabilityId`, de que a Hotelbeds precisa para reservar esse horário. Availability Calendar (`POST /availability/calendar`) – devolve um resumo por dia em vez de cada horário, normalmente para mostrar que datas estão abertas num seletor de datas. Verificação no momento da reserva – quando um cliente reserva, a Ventrata volta a verificar a capacidade antes de criar a reserva, para que a Hotelbeds não possa vender em excesso um horário que acabou de esgotar, mesmo que a disponibilidade guardada esteja ligeiramente desatualizada. O que isto significa para si: quando fecha uma data, altera a capacidade ou esgota na Ventrata, a Hotelbeds só o mostra após a consulta seguinte, pelo que pode haver um pequeno atraso. A verificação da Ventrata no momento da reserva continua a evitar vendas em excesso.
Pricing Sync	✅	Os seus preços são devolvidos em cada consulta de disponibilidade, assim que a Hotelbeds os pede com a capability octo/pricing. Funciona da seguinte forma: Capability `octo/pricing` – a Hotelbeds pede os preços acrescentando `octo/pricing` ao cabeçalho `Octo-Capabilities` dos seus pedidos. Sem isso, a Ventrata envia a disponibilidade sem quaisquer preços. Availability Check (`POST /availability`) – com os preços ativados, cada dia ou horário é devolvido com o seu preço por unidade (tipo de bilhete): o preço de venda ao público (retail) que o cliente paga e o preço líquido (net) que fatura à Hotelbeds, ambos a partir dos preços do revendedor na Ventrata (venda ao público e grossista/comissão). Preços de grupo – quando a Hotelbeds envia também quantas pessoas de cada tipo de unidade estão a reservar, a Ventrata calcula o preço desse grupo exato. Isto é importante para as tarifas Booking Size e outros preços de grupo. Booking Reservation (`POST /bookings`) e Booking Confirmation (`POST /bookings/{uuid}/confirm`) – a reserva é devolvida com o preço final de venda ao público e o preço líquido, pelo que a reserva na Ventrata regista sempre o preço a que foi vendida. ‼️ IMPORTANTE – Peça que os preços sejam ativados. Quando pedir à Hotelbeds que mapeie os seus produtos, peça-lhe também que ative os preços (`octo/pricing`), ou ative-os por si se fizer o mapeamento no portal da Hotelbeds. Caso contrário, podem ficar desativados, e a Hotelbeds não receberá os seus preços Ventrata.
Promotions Sync	❌	As suas promoções Ventrata não se aplicam na Hotelbeds. Os preços na Hotelbeds não incluem as promoções que cria na Ventrata. Configure quaisquer promoções diretamente com a Hotelbeds.
Bookings Sync	✅	As reservas e os cancelamentos feitos na Hotelbeds são criados instantaneamente na Ventrata, e os clientes recebem bilhetes Ventrata. Funciona da seguinte forma: Retenção: Booking Reservation (`POST /bookings`) – quando um cliente inicia o checkout na Hotelbeds, a Hotelbeds envia o produto, a opção, o horário escolhido (`availabilityId`) e um item de unidade por pessoa. A Ventrata volta a verificar a capacidade e cria uma reserva `ON_HOLD`, que retém os lugares enquanto o cliente paga. Se já não houver lugar, a Ventrata rejeita a retenção. Confirmação: Booking Confirmation (`POST /bookings/{uuid}/confirm`) – assim que o pagamento é concluído, a Hotelbeds confirma a retenção. A reserva passa a `CONFIRMED` na Ventrata, e a Ventrata devolve a sua referência de reserva e os bilhetes (um por pessoa) ou um voucher (um por reserva), consoante a configuração do seu produto, cada um com um código QR e uma ligação para PDF. A Hotelbeds entrega-os ao cliente, que os apresenta à entrada como qualquer bilhete Ventrata. Expiração: se o cliente não concluir o pagamento, a Hotelbeds nunca confirma, e a retenção expira por si só e liberta os lugares. Cancelamento: Booking Cancellation (`POST /bookings/{uuid}/cancel`) – quando um cliente cancela na Hotelbeds, a Hotelbeds cancela a reserva na Ventrata. A Ventrata só aceita o pedido se a reserva ainda puder ser cancelada e o prazo limite de cancelamento da opção não tiver passado. Caso contrário, rejeita o pedido, e a Hotelbeds tem de contactá-lo. Alteração: Booking Update (`PATCH /bookings/{uuid}`) – permite à Hotelbeds alterar uma reserva existente, por exemplo uma nova data, hora ou número de pessoas. Alguns revendedores cancelam e voltam a reservar. ‼️ IMPORTANTE – As reservas sincronizam num único sentido, da Hotelbeds para a Ventrata. Se cancelar, alterar ou voltar a fazer na Ventrata uma reserva da Hotelbeds, por exemplo no Dashboard, a Hotelbeds não é notificada. Contacte a Hotelbeds para que a reserva seja também cancelada ou alterada do lado dela, ou peça ao cliente que cancele através da Hotelbeds.
Pickups/Dropoff Sync	❌	A Hotelbeds não envia dados de recolha ou de largada com as reservas. Se os seus produtos incluírem recolhas, confirme com a Hotelbeds como recolhe os dados de recolha, ou combine-os com o cliente.
Custom Questions Sync	❌	A Hotelbeds não envia respostas às suas perguntas de reserva. Se depender de perguntas de reserva, por exemplo nomes ou necessidades alimentares, confirme com a Hotelbeds como recolhe essas informações.
Extras Sync	❌	Não é possível reservar extras e complementos através da Hotelbeds. Na Hotelbeds, os clientes só podem reservar os seus produtos e opções principais. Venda os extras separadamente, por exemplo à chegada.
Redemption Sync	❌	Os resgates não são comunicados à Hotelbeds. A Ventrata não notifica a Hotelbeds quando um bilhete é lido ou resgatado. A Hotelbeds só vê um resgate se voltar a ler a reserva na Ventrata.
Pass Walkup Scanning Sync	❌	Os titulares de passes da Hotelbeds não podem ser lidos à sua entrada sem uma reserva. Os clientes da Hotelbeds precisam de uma reserva feita através da Hotelbeds antes da visita.
Gift Card Sync	❌	Não é possível vender nem resgatar cartões-oferta Ventrata através da Hotelbeds. Os cartões-oferta comprados na Ventrata não podem ser utilizados na Hotelbeds, e a Hotelbeds não pode vender cartões-oferta Ventrata.

✅ suportado · ❌ não suportado

Bom saber: limites e detalhes da conexão com Hotelbeds

Atrasos: a disponibilidade e os preços só chegam à Hotelbeds quando esta consulta, pelo que existe sempre um pequeno atraso depois de alterar algo na Ventrata.
Prazo limite de cancelamento: a Hotelbeds só pode cancelar através da API antes do prazo limite de cancelamento da sua opção. Os cancelamentos posteriores têm de ser acordados consigo.
O que a Hotelbeds pode ver: apenas os destinos, produtos e opções permitidos no revendedor e na conexão, e ativados para venda na origem Direct API. Veja como permitir ou excluir produtos.
Bilhetes: a Hotelbeds emite os bilhetes ou o voucher Ventrata que recebe na confirmação, pelo que a leitura e o resgate habituais funcionam normalmente.
Reservas de teste: a Hotelbeds pode enviar reservas de teste enquanto configura a conexão. As reservas de teste não utilizam a sua disponibilidade e não são faturadas.

Perguntas frequentes

Não são apresentados produtos na página da conexão.

Verifique que destinos, produtos e opções estão permitidos no seu revendedor e na conexão. Em seguida, confirme que os seus produtos e opções estão ativados para venda na fonte Direct API. Se o problema persistir, contacte o nosso Suporte técnico.

Os meus produtos Ventrata utilizam tarifas Booking Size e os preços não funcionam corretamente na Hotelbeds.

Após cada alteração de tarifa, atualize o mapeamento do produto para garantir que as contagens de escalões do parceiro estão sincronizadas com a Ventrata. Certifique-se de que a tarifa está ativada para venda através de Direct API.

📚 Mais sobre as conexões Ventrata

Informações do parceiro

Hotelbeds Spain, S.L.U.

Camí de Son Fangos 100, Complejo Mirall Balear, Torre A, 5ª planta, 6A-7A

07007 Palma de Mallorca, Spain

hotelbeds.com

ID de parceiro Ventrata: 019f658f-9202-7f65-be27-397abdd31161

Bridgify Travel Ltd.

bridgify.io

ID de parceiro Ventrata: 019f6583-a4fa-7a28-8f2e-ffe406a089bd

Hotelbeds (via Bridgify): conexão de revendedor