Ir para conteúdo principal

Expian: backend de operador

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

Expian logo

 

Expian é uma plataforma de bilhética de Londres para atrações e operadores de transportes, que gere as vendas na web, no ponto de venda, em adesões, através de parceiros comerciais e de agências de viagens online numa única ferramenta de administração, com upsell, cross-sell, pacotes, produtos de terceiros e relatórios unificados em todos os canais. Os seus clientes incluem locais patrimoniais e palácios históricos, museus e galerias, espaços imersivos, empresas de visitas turísticas, linhas ferroviárias históricas e operadores de ferries como a P&O Ferries.

 

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

 

Para saber mais sobre Expian, visite expian.io.

 

📒 NOTA

Expian era anteriormente conhecido como Ticknovate.

 

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

 

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

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

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

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

 

Criar a conexão com Expian

🔐 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 e o OCTO Endpoint do operador. Consulte 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

O seu operador pede-os em Expian. Os utilizadores de Expian podem gerar a chave API para revendedores na respetiva área de administração de Expian. O operador pode contactar o respetivo Customer Success Manager de Expian para obter ajuda com o endpoint.

 

  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 Expian e introduza a OCTO API Key and OCTO Endpoint. O endpoint da Expian é normalmente único para cada operador e segue o formato octo.api.[operator].expian.io.

  3. Mantenha o campo OCTO Endpoint com o valor predefinido já preenchido, a menos que o seu operador lhe indique o contrário.

  4. Press Update Operator.

 

 

No campo Backend Partner, selecione Expian na lista de conexões disponíveis e introduza a OCTO API Key que lhe foi fornecida pelo seu operador.

 

📒 NOTA – Cada OCTO API Key e OCTO Endpoint liga-o a um operador. Configure cada operador de Expian 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 Expian e Backend Pricing para utilizar os preços de Expian.

  3. Press Update Product.

📒 NOTA

Expian 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 Connected e, em seguida, Backend Availability para obter a disponibilidade e Backend Pricing para obter os preços.

 

Sem Backend Availability e/ou Backend Pricing, o produto utiliza a disponibilidade e/ou os preços definidos na Ventrata, mas continua a enviar as reservas para Expian.

 

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

 

Mapear produtos para Expian

‼️ IMPORTANTE

O mapeamento indica à Ventrata o produto, a opção e as unidades de Expian 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 Expian nas listas pendentes, que a Ventrata carrega a partir de Expian. 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 Expian. 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 Expian.

 

Gerir a conexão com Expian

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

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

 

Funcionalidades da conexão em detalhe

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

 

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

Funciona da seguinte forma:

  • Get Products (GET /products) – a Ventrata lê os produtos, opções e unidades do operador em Expian 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 Expian. Peça-lhe que o faça.

Content Sync

❌

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

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

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

  • A Ventrata faz um pedido em tempo real a Expian quando um utilizador interage com o calendário de disponibilidade, normalmente para intervalos de 7 dias ou um dia específico. O calendário pode mostrar dados em cache, não em tempo real, do último pedido.

 

Normalmente, com Expian:

  • Os pedidos abrangem 3 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 Expian, 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 Expian.

Funciona da seguinte forma:

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

  • Com Backend Pricing, a Ventrata obtém os preços de venda ao público e os preços líquidos (por grosso). Os preços chegam com a consulta de disponibilidade e ficam em cache/guardados na Ventrata como tarifas geradas pela API. Os preços líquidos de Expian 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 Expian.

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

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

Funciona da seguinte forma:

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

  2. Confirmar: Booking Confirmation (POST /bookings/{uuid}/confirm) – após o pagamento, a Ventrata confirma a reserva em Expian com os dados de contacto do cliente, e o bilhete ou voucher devolvido por Expian 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 Expian.

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

Reserva provisória quando um produto é adicionado ao carrinho. Confirmação após o pagamento, com os dados de contacto do cliente. O voucher/bilhete de Expian é importado como voucher/bilhete na Ventrata, exceto PDF_FILE, que a Ventrata não suporta. As atualizações e os cancelamentos são enviados para Expian via API.

 

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

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

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

Extras Sync

❌

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

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

Redemption Sync

❌

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

Não suportado. O estado da reserva em Expian (por exemplo, Redeemed) não é comunicado de volta à Ventrata.

Pass Walkup Scanning Sync

❌

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

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

Gift Card Sync

❌

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

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

✅ suportado · ❌ não suportado

 

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

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

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

 

Perguntas frequentes

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

Muito provavelmente, a OCTO API Key e o OCTO Endpoint ou o 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 disponibilizou para si em Expian. 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 Expian. Se o problema persistir, contacte o nosso Suporte técnico.

Erro ao atualizar o operador para guardar a configuração do backend.

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.

O produto/opção/unidade que pretendo mapear não aparece na lista pendente.

A lista pendente é obtida a partir de Expian com base nos produtos, opções e unidades que o seu operador disponibilizou para si. Confirme com o seu operador. Se o problema persistir, contacte o suporte.

 

Recursos úteis

 

 

Informações do parceiro

Expian Ltd

Spaces, Mappin House, 4 Winsley St

London W1W 8HF, United Kingdom

 

ID de parceiro Ventrata: af1db775-3f88-4d78-8b91-b7d69c5a252b

Isto respondeu à sua pergunta?