Bókun é a plataforma de reservas e distribuição da Tripadvisor para operadores de visitas, atrações, atividades, aluguer e transporte terrestre, utilizada por milhares de empresas em todo o mundo. O seu marketplace inclui mais de 2600 OTA e revendedores, e a propriedade comum com Viator torna-a um backend frequente para operadores cuja procura vem em grande parte da Tripadvisor.
Ligar Bókun à Ventrata permite-lhe revender produtos de operadores que utilizam Bókun como sistema de reservas. A Ventrata lê a disponibilidade e os preços em tempo real a partir de Bókun, e cada reserva que recebe é criada diretamente na conta do operador em Bókun.
Para saber mais sobre Bókun, visite bokun.io.
📒 NOTA
Pretende, em vez disso, que Bókun revenda os seus produtos? Consulte Bókun: conexão de revendedor.
📒 NOTA
Esta conexão estará disponível brevemente. Está em desenvolvimento, com lançamento previsto para novembro–dezembro de 2026. Se a quiser utilizar, contacte o nosso Suporte técnico ou o seu Customer Success Manager da Ventrata.
Website principal | |
Etiquetas | Booking / Ticketing System |
Funcionalidades da conexão | Availability Sync · Pricing Sync · Bookings Sync |
Desenvolvido por | Ventrata (através da API OCTO de Bókun) |
Esta conexão de operador (também chamada backend) permite-lhe revender produtos de operadores que utilizam Bókun como sistema de reservas principal, com cada reserva criada diretamente em Bókun. As funcionalidades desta conexão incluem:
Availability Sync – a disponibilidade em tempo real vem da conta do operador em Bókun.
Pricing Sync – os preços vêm de Bókun, ou são definidos por si na Ventrata.
Bookings Sync – as reservas, atualizações e cancelamentos são enviados da Ventrata para Bókun, e Bókun emite os bilhetes ou vouchers.
Criar a conexão com Bókun
🔐 Permissões de função necessárias: See Operators, Modify Operators, See Products, Modify Products
Antes de começar:
Tem de ter um acordo comercial com o operador relativo às respetivas tarifas e condições.
Tem de ter a OCTO API Key do operador. Veja os passos abaixo.
A empresa cujos produtos pretende revender está criada como operador na Ventrata.
Os produtos do operador estão criados na Ventrata. A conexão sincroniza a disponibilidade, os preços e as reservas, mas não cria produtos.
Tem de recriar os produtos do operador na Ventrata. Veja como criar produtos. A conexão sincroniza a disponibilidade, os preços e as reservas, mas não cria produtos na Ventrata.
Passo 1: configurar o operador na Ventrata
Peça-a ao operador que utiliza Bókun. O operador cria-a em Bókun: Settings → Connectivity → API keys → Create an API key → Save → ativar OCTO nesta chave API.
No Ventrata Dashboard, aceda a Products → Operators e abra o operador. Se ainda não existir, crie-o primeiro como operador.
Na secção Backend Partner, selecione Bókun e introduza a OCTO API Key. Mantenha o endpoint predefinido
https://api.bokun.io/octo/v1, a menos que o operador ou Bókun lhe indiquem o contrário.Escolha Bókun na secção Backend Partner do operador.
Introduza a OCTO API Key. Mantenha o OCTO Endpoint com o valor predefinido já preenchido, a menos que o operador lhe indique o contrário.
Click Update Operator.
Clique em Update Operator.
📒 NOTA – Cada OCTO API Key liga-o a um operador. Configure cada operador de Bókun separadamente.
Passo 2: conecte cada produto
Abra o produto do operador em Products → Products e edite-o. Verifique se Operator está definido como este operador.
Marque Backend Connected. Marque Backend Availability para utilizar a disponibilidade de Bókun e Backend Pricing para utilizar os preços de Bókun.
Clique em Update Product.
📒 NOTA
Bókun envia apenas preços de venda ao público. Com Backend Pricing marcado, a Ventrata regista o preço de venda ao público e calcula o seu preço líquido (de custo) com a percentagem de custo definida no operador no Ventrata Dashboard.
Defina como Operator do produto o operador com o backend Bókun, marque Backend Connected e, depois, Backend Availability e/ou Backend Pricing. Sem estas opções, o produto utiliza a disponibilidade/os preços definidos na Ventrata, mas continua a enviar as reservas para Bókun.
Mapear produtos para Bókun
‼️ IMPORTANTE
O mapeamento indica à Ventrata o produto, a opção e as unidades de Bókun cuja disponibilidade deve consultar e que deve reservar. Se um produto ligado ao backend não estiver corretamente mapeado, as respetivas reservas falham. Um destaque a vermelho em toda a linha do produto indica um produto mal mapeado.
No Ventrata Dashboard, aceda a Products → Products e abra o produto.
Abra o separador Mappings. Este aparece quando o produto está definido como Backend Connected.
Para cada opção e unidade Ventrata, selecione o produto, a opção e as unidades correspondentes de Bókun nas listas pendentes, que a Ventrata carrega a partir de Bókun. Não deixe nenhum campo vazio.
Clique em Save Changes.
📗 DICA
Faça uma reserva de teste depois do mapeamento e peça ao operador que confirme que esta chegou à sua conta em Bókun.
Gerir a conexão com Bókun
Atualize o mapeamento quando o operador alterar produtos, opções ou unidades em Bókun.
Substitua a chave no operador se Bókun ou o operador emitirem uma nova.
Desative Backend Availability ou Backend Pricing num produto para utilizar a disponibilidade ou os preços da própria Ventrata. As reservas continuam a ser enviadas para Bókun.
Funcionalidades da conexão em detalhe
Esta secção destina-se a quem quer saber exatamente como funciona a conexão com Bókun. Aqui, o sentido é o inverso de uma conexão de revendedor: é a Ventrata que chama Bókun, através da API OCTO de Bókun. Para cada funcionalidade, explica que chamadas a Ventrata faz, quando as faz e o que isso significa para si.
Em resumo: a Ventrata pede a Bókun a disponibilidade e os preços sempre que alguém consulta um produto ligado ao backend, e cria cada reserva na conta do operador em Bókun. Bókun não envia alterações de volta para a Ventrata.
Os prazos são os habituais para Bókun, estão arredondados e podem mudar.
Product Mapping | ✅ |
No Ventrata Dashboard, cada produto, opção e unidade Ventrata é mapeado para o produto do operador em Bókun. Funciona da seguinte forma:
O que isto significa para si: se faltar algo na lista pendente, o operador não o disponibilizou para si em Bókun. Peça-lhe que o faça. |
Content Sync | ❌ |
A Ventrata não importa o conteúdo dos produtos de Bókun. A Ventrata não importa o conteúdo dos produtos de Bókun. É o próprio utilizador que cria e descreve os produtos na Ventrata. |
Availability Sync | ✅ |
Com Backend Availability ativado, a Ventrata consulta a disponibilidade do operador em tempo real em Bókun. Funciona da seguinte forma:
Normalmente, com Bókun:
O que isto significa para si: os clientes reservam com base na disponibilidade do operador em tempo real em Bókun, pelo que não pode vender em excesso um horário que o operador já vendeu noutro lado. |
Pricing Sync | ✅ |
Com Backend Pricing ativado, a Ventrata obtém os preços a partir de Bókun. Funciona da seguinte forma:
Bókun envia apenas preços de venda ao público. Com Backend Pricing marcado, a Ventrata regista o preço de venda ao público e calcula o seu preço líquido (de custo) com a percentagem de custo definida no operador no Ventrata Dashboard. |
Promotions Sync | ❌ |
As promoções não são enviadas para Bókun. As promoções não são enviadas para Bókun. As suas promoções Ventrata continuam a aplicar-se ao preço que o seu cliente paga na Ventrata. |
Bookings Sync | ✅ |
As reservas feitas na Ventrata para um produto ligado ao backend são criadas na conta do operador em Bókun. Funciona da seguinte forma:
As reservas, alterações e cancelamentos de produtos com Backend Connected são enviados automaticamente para Bókun: reserva provisória quando o produto é adicionado ao carrinho, confirmação após o pagamento (com os dados de contacto do cliente), atualização quando uma reserva é alterada e cancelamento quando uma reserva é cancelada. O voucher/bilhete de Bókun é importado na Ventrata, exceto PDF_FILE, que a Ventrata não suporta.
‼️ IMPORTANTE – As reservas são sincronizadas num só sentido, da Ventrata para Bókun. Se o operador alterar ou cancelar uma reserva em Bókun, a Ventrata não é notificada. Peça ao operador que o informe de quaisquer alterações que faça. |
Pickups/Dropoff Sync | ❌ |
Os dados de recolha e largada não são transmitidos a Bókun. Os dados de recolha e largada não são transmitidos a Bókun. Partilhe-os com o operador por outra via se um produto precisar deles. |
Custom Questions Sync | ❌ |
As respostas às suas perguntas de reserva não são transmitidas a Bókun. As respostas às suas perguntas de reserva não são transmitidas a Bókun. Partilhe-as com o operador por outra via se este precisar delas. |
Extras Sync | ❌ |
Os extras e complementos não são reservados em Bókun. Os extras e complementos não são reservados em Bókun. Apenas o produto, a opção e as unidades principais o são. |
Redemption Sync | ❌ |
Os resgates e outras alterações de estado em Bókun não são enviados de volta para a Ventrata depois de uma reserva ser confirmada. Os resgates e outras alterações de estado em Bókun não são enviados de volta para a Ventrata depois de uma reserva ser confirmada. Não suportado. O estado da reserva em Bókun (por exemplo, Redeemed) não é comunicado de volta à Ventrata após a confirmação. |
Pass Walkup Scanning Sync | ❌ |
A digitalização de passes sem reserva (walk-up) não está disponível com Bókun. A digitalização de passes sem reserva (walk-up) não está disponível com Bókun. |
Gift Card Sync | ❌ |
Os cartões-oferta Ventrata não são transmitidos a Bókun. Os cartões-oferta Ventrata não são transmitidos a Bókun. Os pagamentos com cartão-oferta ficam na Ventrata. |
✅ suportado · ❌ não suportado
Bom saber: limites e detalhes da conexão com Bókun
Bom saber: limites e detalhes da conexão com Bókun
Disponibilidade em tempo real: a disponibilidade vem de Bókun à medida que as pessoas navegam.
Reservas num só sentido: as alterações que o operador faz em Bókun não chegam à Ventrata.
Bókun, parte da Tripadvisor, é um sistema de reservas, inventário e gestão de canais para tours, atividades e atrações.
Perguntas frequentes
Recebo um erro quando guardo a configuração do backend do operador.
Recebo um erro quando guardo a configuração do backend do operador.
O mais provável é que a OCTO API Key ou o endpoint estejam incorretos. Confirme-os com o seu operador. Se o problema persistir, contacte o nosso Suporte técnico.
Não existe a caixa Backend Connected nas definições do produto.
Não existe a caixa Backend Connected nas definições do produto.
O mais provável é que o operador definido no produto não tenha um backend configurado. Verifique as definições de Backend Partner do operador e tente novamente. Se o problema persistir, contacte o nosso Suporte técnico.
O produto, a opção ou a unidade que pretendo mapear não aparece na lista pendente.
O produto, a opção ou a unidade que pretendo mapear não aparece na lista pendente.
As listas pendentes mostram o que o operador disponibilizou para si em Bókun. Fale com o operador. Se o problema persistir, contacte o nosso Suporte técnico.
As reservas de um produto ligado ao backend falham.
As reservas de um produto ligado ao backend falham.
Verifique primeiro o mapeamento do produto: todas as opções e unidades têm de estar mapeadas. Depois, verifique se o horário ainda está disponível em Bókun. Se o problema persistir, contacte o nosso Suporte técnico.
Erro ao atualizar o operador para guardar a configuração do backend.
Erro ao atualizar o operador para guardar a configuração do backend.
Provavelmente, a OCTO API Key ou o OCTO Endpoint estão incorretos. Confirme estes dados com o seu operador. Se o problema persistir, contacte o suporte da Ventrata.
O produto/opção/unidade que pretendo mapear não aparece na lista pendente.
O produto/opção/unidade que pretendo mapear não aparece na lista pendente.
A lista pendente é obtida a partir de Bókun com base nos produtos, opções e unidades que o operador disponibilizou para si. Confirme estes dados com o seu operador. Se o problema persistir, contacte o suporte da Ventrata.
Recursos úteis
📚 Mais sobre as conexões Ventrata
Informações do parceiro
Tripadvisor LLC dba Bókun
400 1st Avenue
Needham, MA 02494, USA
ID de parceiro Ventrata: 18d71b21-57e4-4811-8818-a7be06311725