Ir para conteúdo principal

Local Experiences: conexão de revendedor

Ligue Local Experiences à Ventrata para sincronizar a disponibilidade e os preços e receber reservas de imediato.

Local Experiences logo

 

Local Experiences é um marketplace online de visitas e atividades sediado em Londres que revende inventário de operadores sem organizar visitas próprias, oferecendo passeios guiados, bilhetes com acesso prioritário e experiências curtas em cidades europeias como Roma, Florença, Veneza, Nápoles, Paris, Barcelona, Lisboa e Atenas, bem como no Dubai. Para os operadores, traz viajantes individuais e grandes grupos que reservam a preços acessíveis em mais de 20 línguas de visita, com compras para oferta e reservas de grupo tratadas a par dos bilhetes normais.

 

Ligar a Local Experiences à 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 a Local Experiences, visite localexperiences.tours.

 

Website principal

Etiquetas

Travel Agent

Mercados de destino

🌎 Global

Mercados emissores

🌎 Global

Especialidades

Grandes grupos e compras para oferta a preços acessíveis

Funcionalidades da conexão

Availability Sync · Pricing Sync · Bookings Sync

Desenvolvido por

Local Experiences (através da API OCTO da Ventrata)

 

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

  • Availability Sync – a Local Experiences consulta a sua disponibilidade em tempo real na Ventrata.

  • Pricing Sync – a Local Experiences obtém os seus preços a partir dos preços de revendedor na Ventrata.

  • Bookings Sync – as reservas, atualizações e cancelamentos da Local Experiences são criados instantaneamente na Ventrata, e os clientes recebem bilhetes Ventrata.

 

Criar a conexão com Local Experiences

🔐 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 Local Experiences para que vendam os seus produtos. Para se informar sobre uma parceria, contacte-os através de localexperiences.tours.

  • Tem de ter a Local Experiences 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".

 

  1. No Ventrata Dashboard, aceda a Connections → Connections, clique em + New Connection e selecione Local Experiences na lista de parceiros.

  2. Selecione Local Experiences 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.

  3. (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 Local Experiences e quiser distingui-las mais facilmente no futuro.

  4. 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 Local Experiences

Partilhe de forma segura a chave API OCTO apresentada na conexão que criou com o seu contacto na Local Experiences 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 Local Experiences 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

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

 

 

Gerir a conexão com Local Experiences

  • Permitir ou excluir produtos: limite os destinos, produtos e opções a que a Local Experiences pode aceder. Veja como permitir ou excluir produtos.

  • Mude o nome da conexão para distinguir várias conexões Local Experiences.

 

Funcionalidades da conexão em detalhe

Esta secção destina-se a quem quer saber exatamente como funciona a conexão Local Experiences: que chamadas à Ventrata OCTO API a Local Experiences efetua, 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 Local Experiences 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 Local Experiences, por isso qualquer alteração que faça na Ventrata chega à Local Experiences na consulta seguinte.

 

Os tempos indicados são típicos da Local Experiences e arredondados, e podem mudar se a Local Experiences alterar a forma como sincroniza.

 

Product Mapping

❌

Não é possível mapear produtos a partir da Ventrata. A Local Experiences mapeia-os do seu lado, através do seu gestor de conta ou do portal da Local Experiences.

Funciona da seguinte forma:

  • Get Products (GET /products) – quando a Local Experiences 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 Local Experiences 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 Local Experiences – a Local Experiences associa cada opção e unidade da Ventrata à sua própria ficha e aos seus tipos de bilhete. O seu gestor de conta na Local Experiences faz isto por si, ou fá-lo no portal da Local Experiences, se este existir. Basta partilhar a chave API da conexão.

 

Normalmente, com a Local Experiences:

  • A Local Experiences lê a sua lista completa de produtos cerca de uma vez por dia.

  • Volta a ler cada produto cerca de uma vez por dia.

 

O que isto significa para si: a Local Experiences só pode vender o que mapeou. Quando adiciona um produto, uma opção ou uma unidade na Ventrata, a Local Experiences 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 Local Experiences sempre que adicionar algum.

Content Sync

✅ / ❌

A Local Experiences 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 a Local Experiences a acrescenta 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 à Local Experiences na atualização de produtos seguinte.

 

Normalmente, com a Local Experiences:

  • A Local Experiences pede octo/content.

Availability Sync

✅

A Local Experiences consulta a sua disponibilidade em tempo real na Ventrata. A Ventrata não envia alterações de disponibilidade para a Local Experiences.

Funciona da seguinte forma:

  • Availability Check (POST /availability) – a Local Experiences 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 Local Experiences precisa para reservar esse horário.

  • Availability Batch (POST /availability/batch): disponibilidade de vários produtos num único pedido, concebida para sincronizações em segundo plano.

  • 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 Local Experiences não possa vender em excesso um horário que acabou de esgotar, mesmo que a disponibilidade guardada esteja ligeiramente desatualizada.

 

Normalmente, com a Local Experiences:

  • Availability Check: a Local Experiences verifica os seus produtos 24 horas por dia, normalmente a partir de hoje e abrangendo cerca de um ano 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 2 horas.

  • Availability Batch: a Local Experiences verifica os seus produtos 24 horas por dia, normalmente a partir de hoje e abrangendo cerca de um ano 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 20 minutos.

  • As consultas estão distribuídas de forma uniforme ao longo do dia, o que aponta para uma sincronização agendada em segundo plano e não para pesquisas de clientes em tempo real.

 

O que isto significa para si: quando fecha uma data, altera a capacidade ou esgota na Ventrata, a Local Experiences apresenta a alteração após a sua próxima verificação. Para as datas que verifica regularmente, isso acontece em cerca de 2 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, assim que a Local Experiences os pede com a capability octo/pricing.

Funciona da seguinte forma:

  • Capability octo/pricing – a Local Experiences 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 à Local Experiences, ambos a partir dos preços do revendedor na Ventrata (venda ao público e grossista/comissão).

  • Preços de grupo – quando a Local Experiences 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.

 

Normalmente, com a Local Experiences:

  • A Local Experiences pede octo/pricing em todas as consultas de disponibilidade, pelo que vende aos seus preços Ventrata.

  • A Local Experiences não envia o número de pessoas por tipo de unidade, pelo que os preços são devolvidos por pessoa, e os preços de grupo, como as tarifas Booking Size, podem não aparecer corretamente na Local Experiences.

 

‼️ IMPORTANTE – Peça que os preços sejam ativados. Quando pedir à Local Experiences 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 Local Experiences. Caso contrário, podem ficar desativados, e a Local Experiences não receberá os seus preços Ventrata.

📗 DICA – Se os preços na Local Experiences parecerem errados, verifique primeiro os preços do revendedor Local Experiences na Ventrata: é isso que a Local Experiences lê.

Promotions Sync

❌

As suas promoções Ventrata não se aplicam na Local Experiences.

Os preços na Local Experiences não incluem as promoções que cria na Ventrata. Configure quaisquer promoções diretamente com a Local Experiences.

Bookings Sync

✅

As reservas e os cancelamentos feitos na Local Experiences são criados instantaneamente na Ventrata, e os clientes recebem bilhetes Ventrata.

Funciona da seguinte forma:

  1. Retenção: Booking Reservation (POST /bookings) – quando um cliente inicia o checkout na Local Experiences, a Local Experiences 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.

  2. Confirmação: Booking Confirmation (POST /bookings/{uuid}/confirm) – assim que o pagamento é concluído, a Local Experiences 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 Local Experiences entrega-os ao cliente, que os apresenta à entrada como qualquer bilhete Ventrata.

  3. Expiração: se o cliente não concluir o pagamento, a Local Experiences nunca confirma, e a retenção expira por si só e liberta os lugares.

  4. Cancelamento: Booking Cancellation (POST /bookings/{uuid}/cancel) – quando um cliente cancela na Local Experiences, a Local Experiences 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 Local Experiences tem de contactá-lo.

  5. Alteração: Booking Update (PATCH /bookings/{uuid}) – permite à Local Experiences 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 Local Experiences para a Ventrata. Se cancelar, alterar ou voltar a fazer na Ventrata uma reserva da Local Experiences, por exemplo no Dashboard, a Local Experiences não é notificada. Contacte a Local Experiences para que a reserva seja também cancelada ou alterada do lado dela, ou peça ao cliente que cancele através da Local Experiences.

Pickups/Dropoff Sync

❌

A Local Experiences não envia dados de recolha ou de largada com as reservas.

Se os seus produtos incluírem recolhas, confirme com a Local Experiences como recolhe os dados de recolha, ou combine-os com o cliente.

Custom Questions Sync

❌

A Local Experiences não envia respostas às suas perguntas de reserva.

Se depender de perguntas de reserva, por exemplo nomes ou necessidades alimentares, confirme com a Local Experiences como recolhe essas informações.

Extras Sync

❌

Não é possível reservar extras e complementos através da Local Experiences.

Na Local Experiences, 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 à Local Experiences.

A Ventrata não notifica a Local Experiences quando um bilhete é lido ou resgatado. A Local Experiences só vê um resgate se voltar a ler a reserva na Ventrata.

Pass Walkup Scanning Sync

❌

Os titulares de passes da Local Experiences não podem ser lidos à sua entrada sem uma reserva.

Os clientes da Local Experiences precisam de uma reserva feita através da Local Experiences antes da visita.

Gift Card Sync

❌

Não é possível vender nem resgatar cartões-oferta Ventrata através da Local Experiences.

Os cartões-oferta comprados na Ventrata não podem ser utilizados na Local Experiences, e a Local Experiences não pode vender cartões-oferta Ventrata.

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

 

Bom saber: limites e detalhes da conexão com Local Experiences

  • Atrasos: a disponibilidade e os preços só chegam à Local Experiences quando esta consulta, pelo que existe sempre um pequeno atraso depois de alterar algo na Ventrata.

  • Prazo limite de cancelamento: a Local Experiences 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 Local Experiences 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 Local Experiences 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 Local Experiences 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 Local Experiences.

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.

 

 

Informações do parceiro

LOCAL EXPERIENCES LTD

20 Wenlock Road, London, England, N1 7GU

United Kingdom

 

ID de parceiro Ventrata: e79dc9d6-619e-4dc9-a995-09295960c72b

Isto respondeu à sua pergunta?