Ir para conteúdo principal

Xola: backend de operador

Ligue Xola à Ventrata para revender produtos de operadores de Xola com disponibilidade e preços em tempo real e reservas instantâneas. Forte em experiências de aventura.

Xola logo

 

Xola é uma plataforma de reservas e comércio eletrónico para operadores de tours, atividades e atrações, que abrange checkout online, ponto de venda, quiosques, termos de responsabilidade digitais, planeamento de pessoal e equipamento, listas de espera e avaliações, com o Xolabot a tratar da recuperação de carrinhos e do acompanhamento de marketing. A sua base de operadores concentra-se em categorias de aventura e experiências, como passeios de helicóptero, slides, escape rooms, desportos aquáticos, passeios de barco e pesca desportiva.

 

Ligar Xola à Ventrata permite-lhe revender produtos de operadores que utilizam Xola como sistema de reservas. A Ventrata lê a disponibilidade e os preços em tempo real a partir de Xola, e cada reserva que recebe é criada diretamente na conta do operador em Xola.

 

Para saber mais sobre Xola, visite xola.com.

 

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 Xola)

 

Esta conexão de operador (também chamada backend) permite-lhe revender produtos de operadores que utilizam Xola como sistema de reservas principal, com cada reserva criada diretamente em Xola. As funcionalidades desta conexão incluem:

  • Availability Sync – a disponibilidade em tempo real vem da conta do operador em Xola.

  • Pricing Sync – os preços de venda ao público e os preços líquidos vêm de Xola, ou são definidos por si na Ventrata.

  • Bookings Sync – as reservas, atualizações e cancelamentos são enviados da Ventrata para Xola, e Xola emite os bilhetes ou vouchers.

 

Criar a conexão com Xola

🔐 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 estar listado como Distribution Channel na App Store de Xola. Consulte o Passo 1.

  • 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: Ficar listado na App Store de Xola

Envie um email para [email protected] e [email protected] com os nomes dos operadores de Xola aos quais pretende ligar-se, bem como o seu logótipo, o nome da empresa e uma pessoa de contacto para o anúncio da sua aplicação. Conte com vários dias para Xola analisar e aprovar o seu pedido.

 

Passo 2: Obter a OCTO API Key do operador

Depois de estar listado, peça ao operador que instale a sua aplicação em Xola, selecione as experiências que pretende partilhar consigo e partilhe de forma segura a OCTO API Key consigo.

 

Passo 3: Configurar o operador na Ventrata

  1. No Ventrata Dashboard, aceda a Products → Operators e abra o operador. Se ainda não existir, crie-o primeiro como operador.

  2. Na secção Backend Partner, selecione Xola e introduza a OCTO API Key. Mantenha o OCTO Endpoint predefinido https://octo.xola.com/latest, a menos que o operador ou Xola lhe indiquem o contrário.

  3. Press Update Operator.

 

 

Na secção Backend Partner, escolha Xola na lista de conexões disponíveis e introduza a OCTO API Key fornecida pelo seu operador. Salvo indicação em contrário do operador ou de Xola, deixe o campo OCTO Endpoint com o valor predefinido para Xola

 

📒 NOTA – Cada chave API liga-o a um único operador. Configure cada operador de Xola separadamente.

 

Passo 4: conecte cada produto

  1. Abra o produto do operador em Products → Products e edite-o. Verifique se Operator está definido como este operador.

  2. Marque Backend Connected. Marque Backend Availability para utilizar a disponibilidade de Xola e Backend Pricing para utilizar os preços de Xola.

  3. Press Update Product.

📒 NOTA

Xola 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.

 

Marque Backend Connected neste produto para utilizar a conexão API (backend). Para obter a disponibilidade a partir de Xola, certifique-se de que Backend Availability está marcado; para obter os preços, marque Backend Pricing. Se não marcar Backend Availability e/ou Backend Pricing, o produto utiliza a disponibilidade e/ou os preços configurados na Ventrata, mas continua a enviar as reservas para Xola. Clique no botão Update Product para guardar.

 

Mapear produtos para Xola

‼️ IMPORTANTE

O mapeamento indica à Ventrata o produto, a opção e as unidades de Xola 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.

 

  1. No Ventrata Dashboard, aceda a Products → Products e abra o produto.

  2. Abra o separador Mappings. Este aparece quando o produto está definido como Backend Connected.

  3. Para cada opção e unidade da Ventrata, selecione a experiência, a opção e as unidades correspondentes de Xola nas listas pendentes, que a Ventrata carrega a partir de Xola. Não deixe nenhum campo vazio.

  4. Press Save Changes.

 

A página do produto passa a apresentar um separador Mappings. Aceda a esse separador e mapeie o seu produto, opção(ões) e unidades Ventrata selecionando os produtos, opções e unidades correspondentes nas listas pendentes recebidas de Xola. Certifique-se de que nenhum campo fica vazio (sem mapeamento) e clique no botão 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 Xola.

 

Gerir a conexão com Xola

  • Atualize o mapeamento quando o operador alterar produtos, opções ou unidades em Xola.

  • Substitua a chave no operador se Xola 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 Xola.

 

Funcionalidades da conexão em detalhe

Esta secção destina-se a quem quer saber exatamente como funciona a conexão com Xola. Aqui, o sentido é o inverso de uma conexão de revendedor: é a Ventrata que chama Xola, através da OCTO API de Xola. 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 Xola 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 Xola. Xola não envia alterações de volta para a Ventrata.

 

Os prazos são os habituais para Xola, estão arredondados e podem mudar.

 

Product Mapping

✅

No Ventrata Dashboard, cada produto, opção e unidade Ventrata é mapeado para a experiência do operador em Xola.

Funciona da seguinte forma:

  • Get Products (GET /products) – a Ventrata lê as experiências que o operador partilhou consigo em Xola, com as respetivas opções e unidades, para preencher as listas pendentes no separador Mappings.

  • Capabilities (GET /capabilities) – a Ventrata verifica que capabilities OCTO a conta Xola do operador suporta.

 

Normalmente, com Xola:

  • A Ventrata volta a ler os produtos e as capabilities do operador a partir de Xola a cada poucas horas, pelo que as novas experiências que o operador partilhar consigo aparecem nas listas pendentes sem qualquer ação da sua parte.

 

O que isto significa para si: se faltar uma experiência, opção ou unidade na lista pendente, o operador ainda não a partilhou consigo em Xola. Peça-lhe que a adicione à sua aplicação.

Availability Sync

✅

Com Backend Availability ativado, a Ventrata consulta a disponibilidade do operador em tempo real em Xola.

Funciona da seguinte forma:

  • Availability Check (POST /availability) – quando alguém utiliza o calendário de disponibilidade na Ventrata, por exemplo no Dashboard, no seu Web Checkout ou num terminal, a Ventrata pede a Xola, em tempo real, a disponibilidade das datas apresentadas no ecrã. Xola responde com cada horário, o respetivo estado e a capacidade restante.

  • Antes de alguém interagir com o calendário, este pode mostrar o resultado da última vez que essas datas foram verificadas (em cache).

 

Normalmente, com Xola:

  • Normalmente, os pedidos abrangem um único dia ou alguns dias de cada vez, a partir de hoje e até cerca de 6 meses depois, à medida que as pessoas navegam.

 

O que isto significa para si: os clientes reservam sempre com base na disponibilidade em tempo real do operador em Xola, pelo que não pode vender em excesso uma vaga que o operador já vendeu noutro canal.

A Ventrata pede a disponibilidade a Xola em intervalos de 7 dias ou para um único dia.

Pricing Sync

✅

Com Backend Pricing ativado, a Ventrata obtém de Xola os preços de venda ao público e os preços líquidos.

Funciona da seguinte forma:

  • Availability Check com a capability octo/pricing – a Ventrata pede os preços a Xola em cada consulta de disponibilidade. Os preços são apresentados ao utilizador e guardados na Ventrata como tarifas geradas pela API.

  • Os preços líquidos (por grosso) de Xola são registados como preço de custo, independentemente da percentagem de custo que definiu no operador.

  • Com Backend Pricing desativado, o produto utiliza os preços que definiu na Ventrata, e as reservas continuam a ser enviadas para Xola.

Xola 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.

Bookings Sync

✅

As reservas, alterações e cancelamentos feitos na Ventrata para um produto ligado ao backend são enviados automaticamente para Xola.

Funciona da seguinte forma:

  1. Reter: Booking Reservation (POST /bookings) – quando o produto é adicionado ao carrinho na Ventrata, a Ventrata reserva os lugares em Xola.

  2. Confirmação: Booking Confirmation (POST /bookings/{uuid}/confirm) – após o pagamento, a Ventrata confirma a reserva em Xola com os dados de contacto do cliente. O bilhete ou voucher devolvido por Xola passa a ser o bilhete ou voucher da Ventrata, exceto PDF_FILE, que a Ventrata não suporta.

  3. Alteração: Booking Update (PATCH /bookings/{uuid}) – quando uma reserva é alterada na Ventrata, a alteração é enviada para Xola.

  4. Cancelamento: Booking Cancellation (POST /bookings/{uuid}/cancel) – quando uma reserva é cancelada na Ventrata, também é cancelada em Xola.

 

‼️ IMPORTANTE – As reservas são sincronizadas num só sentido, da Ventrata para Xola. Se o operador alterar ou cancelar uma reserva em Xola, a Ventrata não é notificada. Peça ao operador que o informe de quaisquer alterações que faça.

Content Sync

❌

A Ventrata não importa o conteúdo dos produtos de Xola.

A Ventrata não importa o conteúdo dos produtos de Xola. É o próprio utilizador que cria e descreve os produtos na Ventrata.

Promotions Sync

❌

As promoções não são enviadas para Xola.

As promoções não são enviadas para Xola. As suas promoções Ventrata continuam a aplicar-se ao preço que o seu cliente paga na Ventrata.

Pickups/Dropoff Sync

❌

Os dados de recolha e largada não são transmitidos a Xola.

Os dados de recolha e largada não são transmitidos a Xola. 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 Xola.

As respostas às suas perguntas de reserva não são transmitidas a Xola. Partilhe-as com o operador por outra via se este precisar delas.

Extras Sync

❌

Os extras e complementos não são reservados em Xola.

Os extras e complementos não são reservados em Xola. Apenas o produto, a opção e as unidades principais o são.

Redemption Sync

❌

Os resgates e outras alterações de estado em Xola 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 Xola não são enviados de volta para a Ventrata depois de uma reserva ser confirmada.

Pass Walkup Scanning Sync

❌

A digitalização de passes sem reserva (walk-up) não está disponível com Xola.

A digitalização de passes sem reserva (walk-up) não está disponível com Xola.

Gift Card Sync

❌

Os cartões-oferta Ventrata não são transmitidos a Xola.

Os cartões-oferta Ventrata não são transmitidos a Xola. Os pagamentos com cartão-oferta ficam na Ventrata.

✅ suportado · ❌ não suportado

 

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

  • Um operador por chave: cada operador de Xola dá-lhe a sua própria OCTO API Key.

  • Apenas experiências partilhadas: só pode mapear e vender as experiências que o operador partilhou com a sua aplicação em Xola.

  • Disponibilidade em tempo real: a disponibilidade provém de Xola à medida que as pessoas navegam, pelo que não há disponibilidade para manter sincronizada manualmente.

  • Reservas num só sentido: as alterações que o operador faz em Xola não chegam à Ventrata.

 

Perguntas frequentes

Recebo um erro quando guardo a configuração do backend do operador.

Muito provavelmente, a OCTO API Key ou o OCTO Endpoint estão incorretos. Verifique-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.

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.

As listas pendentes mostram o que o operador partilhou consigo em Xola. Peça ao operador que o partilhe. Se o problema persistir, contacte o nosso Suporte técnico.

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 Xola. Se o problema persistir, contacte o nosso Suporte técnico.

 

Recursos úteis

 

 

Informações do parceiro

Xola, Inc.

Hewes Building, 995 Market St

San Francisco, CA 94103, USA

 

ID de parceiro Ventrata: 360a0ae4-5437-4c21-9dfa-68c0e8e22c8a

Isto respondeu à sua pergunta?