com tecnologia Ventrata

Tootbus é a marca de turismo da RATP Dev, com circuitos hop-on hop-off em autocarros panorâmicos descapotáveis de baixas emissões em Paris, Londres, Bruxelas, Barcelona, Madrid, Roma e Toscana. Agrupa atrações parceiras, cruzeiros fluviais e visitas a pé em pacotes Discovery e combinações de atrações, a par dos seus próprios passes de um a três dias. Para os operadores, traz visitantes que chegam pela primeira vez à cidade, no início da estadia, que compram um passe de autocarro e juntam produtos de terceiros no mesmo carrinho, sendo as escapadinhas urbanas em França, no Reino Unido e na Bélgica os mercados principais.

Conectar Tootbus à Ventrata sincroniza a sua disponibilidade e os seus preços e entrega reservas, alterações e cancelamentos com bilhetes emitidos automaticamente. Tootbus utiliza a Ventrata como o seu principal sistema de bilhética.

Para saber mais sobre uma parceria com Tootbus, visite tootbus.com.

Website principal	tootbus.com
Etiquetas	Operator Reselling Others · Sightseeing & Hop-On Hop-Off · Ventrata Client
Mercados de destino	🇧🇪 Bélgica · 🇫🇷 França · 🇬🇧 Reino Unido
Mercados emissores	🌎 Global
Especialidades	Pacotes de atrações para quem visita a cidade pela primeira vez
Funcionalidades da conexão	Availability Sync · Pricing Sync · Bookings Sync
GMV reservado via Ventrata (últimos 12 meses)	US$100k+
Desenvolvido por	Ventrata (através da API OCTO da Ventrata)

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

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

Criar a conexão com Tootbus

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

Antes de começar:

Tem um acordo comercial com Tootbus para que este venda os seus produtos.
Tootbus está criado como Reseller na Ventrata, com preços de venda ao público e preços grossistas/de comissão configurados.

Tootbus funciona na Ventrata, pelo que se trata de uma conexão Ventrata-Ventrata. Cria uma Ventrata Reseller Connection para Tootbus e partilha a respetiva chave API de forma segura. Em seguida, Tootbus conecta e mapeia os seus produtos na sua própria conta Ventrata.

No Ventrata Dashboard, aceda a Connections > Connections, prima + New Connection e pesquise Ventrata Reseller Connection.
Selecione Tootbus como revendedor. Se necessário, permita ou exclua destinos e produtos na conexão e, em seguida, prima Create Connection.
Prima o ícone do olho para revelar a chave API, copie-a e partilhe-a de forma segura com o seu contacto em Tootbus.
Tootbus adiciona-o como operador com Ventrata (Operator Backend) como backend e, em seguida, conecta e mapeia cada produto. Peça-lhe que faça uma reserva de teste e verifique se esta aparece na sua tabela de reservas.

📗 DICA

Para todos os passos com capturas de ecrã, consulte Ventrata: conexão de revendedor. Tootbus segue Ventrata: backend de operador.

Gerir a conexão com Tootbus

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

Funcionalidades da conexão em detalhe

Esta secção destina-se a quem pretende saber exatamente como funciona a conexão com Tootbus: que chamadas à Ventrata OCTO API Tootbus efetua (através da integração certificada da Ventrata), 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: Tootbus 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 Tootbus, pelo que tudo o que alterar na Ventrata chega a Tootbus na consulta seguinte.

Os tempos indicados são os habituais para Tootbus e estão arredondados, podendo mudar se Tootbus alterar a forma como sincroniza.

Product Mapping	✅	Tootbus mapeia os seus produtos para os produtos próprios na sua conta Ventrata. Em cada produto conectado ao backend, Tootbus escolhe o produto, a opção e as unidades correspondentes da sua conta no separador Mappings do produto. Os produtos que não estão mapeados corretamente são destacados a vermelho e as reservas desses produtos falham. Consulte Ventrata: backend de operador.
Content Sync	❌	Tootbus não lê o conteúdo dos seus produtos a partir da Ventrata. Tootbus utiliza as descrições, imagens e outros conteúdos configurados do seu próprio lado, por isso atualize o seu conteúdo diretamente com Tootbus.
Availability Sync	✅	Tootbus consulta a sua disponibilidade em tempo real na Ventrata. A Ventrata não envia alterações de disponibilidade para Tootbus. Funciona da seguinte forma: Availability Check (`POST /availability`) – Tootbus 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 Tootbus 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, pelo que Tootbus não pode fazer overbooking num horário que acabou de esgotar, mesmo que a disponibilidade que tem guardada esteja ligeiramente desatualizada. Normalmente, com Tootbus: Availability Check: Tootbus verifica os seus produtos ao longo do dia, normalmente a partir de 28 dias de antecedência e abrangendo 7 dias por pedido, consulta até cerca de um ano de antecedência e volta a verificar o mesmo produto e as mesmas datas aproximadamente a cada 40 minutos. Availability Calendar: Tootbus verifica os seus produtos ao longo do dia, normalmente a partir de hoje e abrangendo um único dia por pedido, consulta até cerca de 6 meses de antecedência e volta a verificar o mesmo produto e as mesmas datas aproximadamente a cada 2 horas. As consultas distribuem-se ao longo do dia sem um pico acentuado, o que sugere uma combinação de sincronizações agendadas e pesquisas de clientes em tempo real. O que isto significa para si: quando fecha uma data, altera a capacidade ou esgota na Ventrata, Tootbus apresenta a alteração após a sua próxima verificação. Para as datas que verifica regularmente, isso acontece em cerca de 40 minutos. As datas mais distantes são normalmente verificadas com menos frequência.
Pricing Sync	✅	Os seus preços são devolvidos em cada consulta de disponibilidade, desde que Tootbus os peça com a capability octo/pricing. Funciona da seguinte forma: Normalmente, com Tootbus: 📗 DICA – Se os preços em Tootbus parecerem errados, verifique primeiro os preços do revendedor Tootbus na Ventrata: é isso que Tootbus lê. Tootbus pode utilizar os seus preços com Backend Pricing no respetivo produto ou definir os seus próprios preços na sua conta.
Promotions Sync	❌	As suas promoções Ventrata não se aplicam em Tootbus. Os preços em Tootbus não incluem as promoções que cria na Ventrata. Configure quaisquer promoções diretamente com Tootbus.
Bookings Sync	✅	As reservas e os cancelamentos feitos em Tootbus 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 em Tootbus, Tootbus 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 é aprovado, Tootbus confirma a retenção, com a sua própria referência de reserva e os dados de contacto do cliente. 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. Tootbus entrega-os ao cliente, que os apresenta à sua entrada como qualquer bilhete Ventrata. Expiração: se o cliente não concluir o pagamento, Tootbus 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 em Tootbus, Tootbus cancela a reserva na Ventrata. A Ventrata só aceita o cancelamento 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 Tootbus terá de o contactar. Alteração: Tootbus não utiliza Booking Update (`PATCH /bookings/{uuid}`), pelo que uma alteração chega muito provavelmente à Ventrata como um cancelamento seguido de uma nova reserva. Normalmente, com Tootbus: Tootbus não define um tempo de retenção, pelo que se aplica o tempo de retenção predefinido. Uma reserva típica em Tootbus é para cerca de 2 pessoas. É normal ver mais retenções do que reservas confirmadas: as retenções de clientes que não concluem o pagamento simplesmente expiram. Tootbus também verifica as reservas que efetuou, com Get Booking (`GET /bookings/{uuid}`) aproximadamente a cada 30 minutos, por exemplo, para reconciliar os seus registos. ‼️ IMPORTANTE – As reservas são sincronizadas num só sentido, de Tootbus para a Ventrata. Se cancelar, alterar ou voltar a reservar uma reserva de Tootbus na Ventrata, por exemplo no Dashboard, Tootbus não recebe qualquer notificação. Contacte Tootbus para que a reserva seja também cancelada ou alterada do lado de Tootbus, ou peça ao cliente que cancele através de Tootbus.
Pickups/Dropoff Sync	❌	Tootbus não envia dados de recolha ou largada com as suas reservas. Se os seus produtos incluírem recolhas, confirme com Tootbus como recolhe os dados de recolha, ou combine-os com o cliente.
Custom Questions Sync	❌	Tootbus não envia as respostas às suas perguntas de reserva. Se depender de perguntas de reserva, por exemplo nomes ou necessidades alimentares, confirme com Tootbus como recolhe essa informação.
Extras Sync	❌	Não é possível reservar extras e complementos através de Tootbus. Em Tootbus, 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 a Tootbus. A Ventrata não notifica Tootbus quando um bilhete é digitalizado ou resgatado. Tootbus só vê um resgate se voltar a ler a reserva a partir da Ventrata.
Pass Walkup Scanning Sync	❌	Os passes de Tootbus não podem ser digitalizados à sua entrada sem uma reserva. Os clientes de Tootbus precisam de uma reserva feita através de Tootbus antes da visita.
Gift Card Sync	❌	Os cartões-oferta Ventrata não podem ser vendidos nem resgatados através de Tootbus. Os cartões-oferta comprados na Ventrata não podem ser utilizados em Tootbus, e Tootbus não pode vender cartões-oferta Ventrata.

✅ suportado · ❌ não suportado

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

Atrasos: a disponibilidade e os preços só chegam a Tootbus no momento em que são consultados, pelo que há sempre um pequeno atraso depois de alterar algo na Ventrata.
Prazo limite de cancelamento: Tootbus 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 Tootbus pode ver: apenas os destinos, produtos e opções permitidos no revendedor e na conexão, e ativados para venda na fonte Direct API. Veja como permitir ou excluir produtos.
Bilhetes: Tootbus emite os bilhetes ou o voucher Ventrata que recebe na confirmação, pelo que a digitalização e o resgate habituais funcionam normalmente.
Reservas de teste: Tootbus pode enviar reservas de teste enquanto configura a conexão. As reservas de teste não consomem 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 estão a funcionar corretamente em Tootbus.

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

RATP Development SA

9 Rue Brahms

75012 Paris, France

tootbus.com

ID de parceiro Ventrata: b3f1d7b2-1cca-481a-af23-5c56d6103277

Ventrata Ltd

55 Baker Street

London, W1U 7EU, United Kingdom

ventrata.com

ID de parceiro Ventrata: a6a2a406-088a-4466-b87c-7fcc17770b71

Tootbus: conexão de revendedor