Ir para conteúdo principal

Zaui: backend de operador

Ligue Zaui à Ventrata para revender produtos de operadores de Zaui com disponibilidade, preços e reservas em tempo real.

Zaui logo

 

Zaui é uma plataforma de reservas sediada em Vancouver para operadores de tours, atividades, transportes e aluguer, em funcionamento desde 1999 e criada para inventário baseado em lugares e horários. Um dos seus pontos fortes são as empresas com forte componente de transporte, abrangendo shuttles, autocarros interurbanos, transferes para aeroportos e portos de cruzeiros e serviços de barco, a par de visitas turísticas e circuitos de vários dias, com gestão de canais, preços dinâmicos e check-in móvel a partir de um único painel.

 

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

 

Para saber mais sobre Zaui, visite zaui.com.

 

📒 NOTA

Pretende, em vez disso, que Zaui revenda os seus produtos? Consulte Zaui: conexão de revendedor.

 

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

 

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

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

  • Pricing Sync – os preços vêm de Zaui, ou são definidos por si na Ventrata.

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

 

Criar a conexão com Zaui

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

  • 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 ao seu operador a OCTO API Key. Os operadores podem configurar a conexão (canal) e obter a chave em Zaui, em Resellers > Channel Partners, selecionando depois 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 Zaui e introduza a OCTO API Key. Mantenha o endpoint predefinido https://api.zaui.io/octo, a menos que o operador ou Zaui lhe indiquem o contrário.

  3. Deixe o campo OCTO Endpoint com o valor de Zaui pré-preenchido, salvo indicação em contrário do operador ou de Zaui.

  4. Clique em Update Operator.

 

 

Na secção Backend Partner, escolha Zaui 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 Zaui, deixe o campo OCTO Endpoint com o valor predefinido para Zaui

 

📒 NOTA – Cada OCTO API Key liga-o a um operador. Configure cada operador de Zaui separadamente.

 

Passo 2: 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 Zaui e Backend Pricing para utilizar os preços de Zaui.

  3. Clique em Update Product.

📒 NOTA

Zaui envia preços de venda ao público e preços líquidos. Com Backend Pricing marcado, a Ventrata regista o preço de venda ao público como o seu preço de venda e o preço líquido como o seu preço de custo, independentemente da percentagem de custo definida no operador.

 

Marque Backend Availability para obter a disponibilidade a partir de Zaui e Backend Pricing para obter os preços.

 

Sem estas opções, o produto utiliza a disponibilidade e os preços definidos na Ventrata, mas continua a enviar as reservas para Zaui.

 

Marque Backend Connected neste produto para utilizar a conexão API (backend). Para obter a disponibilidade a partir de Zaui, 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 Zaui. Clique no botão Update Product para guardar.

 

Mapear produtos para Zaui

‼️ IMPORTANTE

O mapeamento indica à Ventrata o produto, a opção e as unidades de Zaui 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 Ventrata, selecione o produto, a opção e as unidades correspondentes de Zaui nas listas pendentes, que a Ventrata carrega a partir de Zaui. Não deixe nenhum campo vazio.

  4. Clique em 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 Zaui. 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 Zaui.

 

Gerir a conexão com Zaui

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

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

 

Funcionalidades da conexão em detalhe

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

 

Os prazos são os habituais para Zaui, 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 Zaui.

Funciona da seguinte forma:

  • Get Products (GET /products) – a Ventrata lê os produtos, opções e unidades do operador em Zaui para preencher as listas pendentes no separador Mappings.

 

O que isto significa para si: se faltar algo na lista pendente, o operador não o disponibilizou para si em Zaui. Peça-lhe que o faça.

Content Sync

❌

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

A Ventrata não importa o conteúdo dos produtos de Zaui. É 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 Zaui.

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 Zaui, em tempo real, a disponibilidade das datas apresentadas no ecrã.

  • Com Backend Availability ativado, a Ventrata faz um pedido em tempo real a Zaui quando um utilizador interage com o calendário de disponibilidade (dashboard, web checkout, terminal, etc.). Normalmente, os pedidos abrangem um intervalo de 7 dias ou um dia específico. Até o utilizador interagir com o calendário, este pode mostrar dados em cache, não em tempo real, do pedido anterior.

 

Normalmente, com Zaui:

  • Os pedidos abrangem 7 dias de cada vez, desde hoje até cerca de um ano depois, à medida que as pessoas navegam e a Ventrata carrega o calendário.

 

O que isto significa para si: os clientes reservam com base na disponibilidade do operador em tempo real em Zaui, 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 Zaui.

Funciona da seguinte forma:

  • Availability Check com a capability octo/pricing – a Ventrata pede a Zaui os preços em cada consulta de disponibilidade.

  • Com Backend Pricing ativado, a Ventrata obtém de Zaui tanto os preços de venda ao público como os preços líquidos (por grosso), na mesma consulta de disponibilidade em tempo real. Os preços são apresentados ao utilizador e guardados em cache/armazenados na Ventrata como tarifas geradas por API. Os preços líquidos são registados como preços de custo, independentemente da percentagem de custo definida no operador.

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

Zaui envia preços de venda ao público e preços líquidos. Com Backend Pricing marcado, a Ventrata regista o preço de venda ao público como o seu preço de venda e o preço líquido como o seu preço de custo, independentemente da percentagem de custo definida no operador.

Promotions Sync

❌

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

As promoções não são enviadas para Zaui. 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 Zaui.

Funciona da seguinte forma:

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

  2. Confirmar: Booking Confirmation (POST /bookings/{uuid}/confirm) – após o pagamento, a Ventrata confirma a reserva em Zaui com os dados de contacto do cliente, e o bilhete ou voucher devolvido por Zaui passa a ser o bilhete ou voucher Ventrata.

  3. Alterar: Booking Update (PATCH /bookings/{uuid}) – as alterações feitas na Ventrata são enviadas para Zaui.

  4. Cancelar: Booking Cancellation (POST /bookings/{uuid}/cancel) – os cancelamentos feitos na Ventrata são enviados para Zaui.

Reserva provisória quando um produto é adicionado ao carrinho. Confirmação após o pagamento, com o envio dos dados de contacto do cliente; o voucher/bilhete de Zaui é importado na Ventrata (exceto PDF_FILE, que a Ventrata não suporta). As atualizações e os cancelamentos feitos na Ventrata são enviados para Zaui.

 

‼️ IMPORTANTE – As reservas são sincronizadas num só sentido, da Ventrata para Zaui. Se o operador alterar ou cancelar uma reserva em Zaui, 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 Zaui.

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

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

Extras Sync

❌

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

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

Redemption Sync

❌

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

Não suportado. O estado da reserva em Zaui, como Redeemed, não é enviado de volta para a 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 Zaui.

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

Gift Card Sync

❌

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

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

✅ suportado · ❌ não suportado

 

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

  • Disponibilidade em tempo real: a disponibilidade vem de Zaui à medida que as pessoas navegam.

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

 

Perguntas frequentes

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.

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 disponibilizou para si em Zaui. Fale com o operador. 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 Zaui. Se o problema persistir, contacte o nosso Suporte técnico.

Recebo um erro ao guardar a configuração do backend do operador.

Muito provavelmente, a OCTO API Key ou o OCTO Endpoint estão incorretos. Confirme-os com o seu operador. Se o problema persistir, contacte o suporte.

Não existe a caixa de verificação Backend Connected nas definições do produto.

Muito provavelmente, o operador selecionado no produto não tem nenhum backend configurado. Verifique a configuração do backend e tente novamente. Se o problema persistir, contacte o suporte.

 

Recursos úteis

 

 

Informações do parceiro

Zaui Software Ltd.

Suite 423 - 119 Pender Street West

Vancouver, BC V6B 1S5, Canada

 

ID de parceiro Ventrata: 09fc078e-fea1-4519-92d4-5eef643ca954

Isto respondeu à sua pergunta?