Coco-Moola é uma agência de viagens online (OTA) para Londres que vende bilhetes para atrações, visitas turísticas de autocarro e de barco, exposições imersivas, chás da tarde e excursões de um dia a parques temáticos ingleses, a Bath e a locais no campo. O site está disponível em dez línguas, incluindo francês, alemão, espanhol, polaco, russo e mandarim, com preços em libras, euros e dólares americanos. Para os operadores, traz sobretudo visitantes europeus e asiáticos que chegam a Londres, mais do que excursionistas nacionais, e que reservam as principais atrações e visitas turísticas na sua própria língua para uma escapadinha urbana.

Ligar Coco-Moola à Ventrata sincroniza a sua disponibilidade e os seus preços e entrega reservas, alterações e cancelamentos, com bilhetes emitidos automaticamente.

Para saber mais sobre uma parceria com Coco-Moola, visite cocomoola.com.

Website principal	cocomoola.com
Etiquetas	Sightseeing & Hop-On Hop-Off
Mercados de destino	🌎 Global
Mercados emissores	🌎 Global
Especialidades	Atrações e circuitos turísticos multilingues em Londres para visitantes estrangeiros
Funcionalidades da conexão	Availability Sync · Pricing Sync · Bookings Sync
GMV reservado via Ventrata (últimos 12 meses)	US$10k+
Desenvolvido por	Coco-Moola (através da API OCTO da Ventrata)

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

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

Criar a conexão com Coco-Moola

🔐 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 Coco-Moola para que vendam os seus produtos. Para se informar sobre uma parceria, contacte-os através de cocomoola.com.
Tem de criar Coco-Moola como Reseller na Ventrata, com os respetivos preços (venda ao público, por grosso/comissão) corretamente definidos. Tenha em atenção que 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 Coco-Moola na lista de parceiros.
Selecione o Reseller Coco-Moola na lista dos seus revendedores (tem de ser criado antes de criar a conexão). A conexão herda a configuração do revendedor, como preços, destinos permitidos, produtos, etc.
(Opcional) Também pode definir um Name à sua escolha para a conexão, o que pode ser útil se planear ter várias conexões com Coco-Moola 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 Coco-Moola

Partilhe de forma segura a chave API OCTO apresentada na conexão que criou com o seu contacto em Coco-Moola 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 de Coco-Moola não demora mais do que alguns dias úteis a concluir este passo.

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

📗 DICA

Coco-Moola pode aceder a todos os produtos ativados na conexão, mas também pode indicar os IDs de produto e de opção apresentados na página da conexão quando os contactar, para especificar o que deve ser mapeado.

Gerir a conexão com Coco-Moola

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

Funcionalidades da conexão em detalhe

Esta secção destina-se a quem quer saber exatamente como funciona a conexão com Coco-Moola: que chamadas à API OCTO da Ventrata Coco-Moola faz, quando as faz e o que isso significa para si. Cada chamada tem uma ligação para a documentação da API da Ventrata.

Em resumo: Coco-Moola 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 Coco-Moola, pelo que tudo o que alterar na Ventrata chega a Coco-Moola na consulta seguinte.

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

Product Mapping	❌	Não é possível mapear produtos a partir da Ventrata. Coco-Moola mapeia-os do seu lado, através do seu gestor de conta ou do portal de Coco-Moola. Funciona da seguinte forma: Get Products (`GET /products`) – quando Coco-Moola configura a sua conexão, e sempre que atualiza os seus anúncios, lê todos os produtos ativados na conexão, com as respetivas opções e unidades (tipos de bilhete, como Adulto ou Criança). Get Product (`GET /products/{productId}`) – Coco-Moola volta a ler um único produto para obter alterações às suas opções, unidades, prazos limite de reserva e definições. Mapeamento do lado de Coco-Moola – Coco-Moola associa cada opção e unidade da Ventrata ao seu próprio anúncio e aos seus tipos de bilhete. O seu gestor de conta em Coco-Moola faz isto por si, ou pode fazê-lo no portal de Coco-Moola, se Coco-Moola disponibilizar um. Só precisa de partilhar a chave API da conexão. O que isto significa para si: Coco-Moola só pode vender o que tiver mapeado. Quando adiciona um produto, opção ou unidade na Ventrata, Coco-Moola pode vê-lo na atualização seguinte, mas não o venderá enquanto não estiver mapeado. Por isso, informe o seu gestor de conta em Coco-Moola sempre que adicionar um.
Content Sync	✅ / ❌	Coco-Moola pode ler o conteúdo dos seus produtos, como descrições e imagens, a partir da Ventrata. Funciona da seguinte forma: Capability `octo/content` – quando Coco-Moola a adiciona ao cabeçalho `Octo-Capabilities`, Get Products (`GET /products`) e Get Product (`GET /products/{productId}`) devolvem também o conteúdo dos seus produtos, como descrições, destaques, inclusões e imagens. As alterações de conteúdo na Ventrata chegam a Coco-Moola na atualização de produtos seguinte. Normalmente, com Coco-Moola: Coco-Moola pede `octo/content`.
Availability Sync	✅	Coco-Moola consulta a sua disponibilidade em tempo real na Ventrata. A Ventrata não envia alterações de disponibilidade para Coco-Moola. Funciona da seguinte forma: Availability Check (`POST /availability`) – Coco-Moola 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 Coco-Moola 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 Coco-Moola não pode fazer overbooking num horário que acabou de esgotar, mesmo que a disponibilidade que tem guardada esteja ligeiramente desatualizada. Normalmente, com Coco-Moola: Availability Check: Coco-Moola verifica os seus produtos ao longo do dia, normalmente a partir de amanhã e abrangendo um único dia por pedido, consulta até 10 dias de antecedência e volta a verificar o mesmo produto e as mesmas datas aproximadamente a cada 16 horas. Availability Calendar: Coco-Moola verifica os seus produtos ao longo do dia, normalmente a partir de hoje e abrangendo 31 dias por pedido, consulta até 28 dias de antecedência e volta a verificar o mesmo produto e as mesmas datas aproximadamente a cada 13 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, Coco-Moola apresenta a alteração após a sua próxima verificação. Para as datas que verifica regularmente, isso acontece em cerca de 13 horas. 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 Coco-Moola os peça com a capability octo/pricing. Funciona da seguinte forma: Capability `octo/pricing` – Coco-Moola pede preços adicionando `octo/pricing` ao cabeçalho `Octo-Capabilities` dos seus pedidos. Sem ela, 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 retail que o cliente paga e o preço net que fatura a Coco-Moola, ambos a partir dos preços do revendedor na Ventrata (venda ao público e por grosso/comissão). Preços de grupo – quando Coco-Moola 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 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. Normalmente, com Coco-Moola: Coco-Moola pede `octo/pricing` em todas as suas consultas de disponibilidade, pelo que vende aos seus preços da Ventrata. Coco-Moola envia o número de pessoas por tipo de unidade, para que os preços de grupo sejam calculados com base na reserva efetiva. ‼️ IMPORTANTE – Peça que os preços sejam ativados. Quando pedir a Coco-Moola que mapeie os seus produtos, peça também que ative os preços (`octo/pricing`), ou ative-os diretamente se fizer o mapeamento no portal de Coco-Moola. Caso contrário, os preços podem ficar desativados e Coco-Moola não receberá os seus preços da Ventrata. 📗 DICA – Se os preços em Coco-Moola parecerem errados, verifique primeiro os preços do revendedor Coco-Moola na Ventrata: é isso que Coco-Moola lê.
Promotions Sync	❌	As suas promoções Ventrata não se aplicam em Coco-Moola. Os preços em Coco-Moola não incluem as promoções que cria na Ventrata. Configure quaisquer promoções diretamente com Coco-Moola.
Bookings Sync	✅	As reservas e os cancelamentos feitos em Coco-Moola 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 Coco-Moola, Coco-Moola 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, Coco-Moola 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. Coco-Moola entrega-os ao cliente, que os apresenta à sua entrada como qualquer bilhete Ventrata. Expiração: se o cliente não concluir o pagamento, Coco-Moola 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 Coco-Moola, Coco-Moola 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 Coco-Moola terá de o contactar. Alteração: Coco-Moola 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 Coco-Moola: Coco-Moola retém os lugares durante cerca de 60 minutos enquanto o cliente paga (`expirationMinutes`). Uma reserva típica em Coco-Moola é para cerca de 1 pessoa. ‼️ IMPORTANTE – As reservas são sincronizadas num só sentido, de Coco-Moola para a Ventrata. Se cancelar, alterar ou voltar a reservar uma reserva de Coco-Moola na Ventrata, por exemplo no Dashboard, Coco-Moola não recebe qualquer notificação. Contacte Coco-Moola para que a reserva seja também cancelada ou alterada do lado de Coco-Moola, ou peça ao cliente que cancele através de Coco-Moola.
Pickups/Dropoff Sync	❌	Coco-Moola não envia dados de recolha ou largada com as suas reservas. Se os seus produtos incluírem recolhas, confirme com Coco-Moola como recolhe os dados de recolha, ou combine-os com o cliente.
Custom Questions Sync	❌	Coco-Moola não envia as respostas às suas perguntas de reserva. Se depender de perguntas de reserva, por exemplo nomes ou necessidades alimentares, confirme com Coco-Moola como recolhe essa informação.
Extras Sync	❌	Não é possível reservar extras e complementos através de Coco-Moola. Em Coco-Moola, 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 Coco-Moola. A Ventrata não notifica Coco-Moola quando um bilhete é digitalizado ou resgatado. Coco-Moola só vê um resgate se voltar a ler a reserva a partir da Ventrata.
Pass Walkup Scanning Sync	❌	Os passes de Coco-Moola não podem ser digitalizados à sua entrada sem uma reserva. Os clientes de Coco-Moola precisam de uma reserva feita através de Coco-Moola antes da visita.
Gift Card Sync	❌	Os cartões-oferta Ventrata não podem ser vendidos nem resgatados através de Coco-Moola. Os cartões-oferta comprados na Ventrata não podem ser utilizados em Coco-Moola, e Coco-Moola não pode vender cartões-oferta Ventrata.

✅ suportado · ✅ / ❌ limitado · ❌ não suportado

Bom saber: limites e detalhes da conexão com Coco-Moola

Atrasos: a disponibilidade e os preços só chegam a Coco-Moola no momento em que são consultados, pelo que há sempre um pequeno atraso depois de alterar algo na Ventrata.
Prazo limite de cancelamento: Coco-Moola 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 Coco-Moola 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: Coco-Moola 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: Coco-Moola 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 Coco-Moola.

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

Coco-Moola Limited

cocomoola.com

ID de parceiro Ventrata: e81dc09c-f3f9-4bfc-9424-690aca408ca3

Coco-Moola: conexão de revendedor