Ir para conteúdo principal

Clorian: backend de operador

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

Clorian logo

 

Clorian é uma plataforma de bilhética sediada em Barcelona para museus, monumentos e espaços culturais, que gere vendas online e presenciais, lotação por horário de entrada e controlo de acessos em locais como a Sagrada Família, La Pedrera e a Mesquita-Catedral de Córdova. Indica mais de 28 milhões de bilhetes vendidos por ano através dos seus espaços e uma rede de mais de 14 000 revendedores.

 

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

 

Para saber mais sobre Clorian, visite clorian.com.

 

📒 NOTA

Se o seu inventário de produtos precisar dos dois métodos de pagamento (Deferred Payment e Pre-payment), crie dois operadores separados na Ventrata para tratar corretamente os pagamentos.

‼️ IMPORTANTE

O mapeamento indica à Ventrata para que produto de Clorian deve consultar a disponibilidade. Se os produtos com Backend Connected não estiverem corretamente mapeados, as reservas desses produtos falham. Um destaque a vermelho em toda a linha do produto significa que o produto não está corretamente mapeado.

 

Website principal

Etiquetas

Booking / Ticketing System

Funcionalidades da conexão

Availability Sync · Pricing Sync · Bookings Sync

Desenvolvido por

Ventrata (através da Clorian B2B API)

 

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

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

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

  • Bookings Sync – as reservas são enviadas da Ventrata para Clorian, e Clorian emite os bilhetes ou vouchers.

 

A API externa de Clorian utilizada nesta conexão é uma API personalizada que não segue o padrão OCTO API, o que pode limitar certas funcionalidades e capacidades.

 

Criar a conexão com Clorian

🔐 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 API Key, o Username e a Password do operador. Consulte os passos abaixo.

  • Um acordo comercial com o operador cujos produtos pretende revender através de Clorian.

  • Os produtos de Clorian recriados na Ventrata, respeitando exatamente a configuração de Clorian.

  • 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: Obter as suas credenciais de Clorian

Contacte Clorian e peça a sua API Key e o seu Username e Password de Clorian.

 

  • API Key

  • Username

  • Password

 

Passo 2: configurar o operador na Ventrata

Contacte Clorian e peça a sua API Key, bem como o seu Username e Password de Clorian.

 

  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 Clorian e introduza a API Key, o Username e a Password.

  3. No campo Backend Partner, selecione Clorian.

  4. Introduza a API Key, o Username e a Password que recebeu de Clorian (obrigatório).

  5. Opcional: escolha o método de pagamento dos seus produtos: Deferred Payment (predefinição de Clorian, faturado mais tarde) ou Pre-payment (depósito).

  6. Clique em Create Operator.

  7. Press Update Operator.

 

 

 

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

  3. Press Update Product.

📒 NOTA

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

 

No produto, marque Backend Connected e mantenha Backend Availability marcado.

 

Marque Backend Pricing se quiser herdar os preços de Clorian.

 

Click Update Product.

 

 

Mapear produtos para Clorian

‼️ IMPORTANTE

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

  4. Press 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 Clorian.

 

Gerir a conexão com Clorian

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

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

 

Funcionalidades da conexão em detalhe

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

 

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

Funciona da seguinte forma:

  • Produtos – a Ventrata lê os produtos, opções e unidades do operador em Clorian para preencher as listas pendentes no separador Mappings.

  • Caminhos observados: GET /v2/clients, GET /v2/products/{n}.

 

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

Content Sync

❌

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

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

Funciona da seguinte forma:

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

  • Disponibilidade em tempo real sincronizada a partir de Clorian.

  • Caminhos observados: GET /v2/products/{n}, GET /v2/products/{n}/events.

 

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

Funciona da seguinte forma:

  • Preços estáticos sincronizados a partir de Clorian, excluindo preços promocionais. São herdados quando Backend Pricing está marcado no produto.

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

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

Promotions Sync

❌

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

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

Não suportado: produtos com promoções, incluindo promoções via API.

Bookings Sync

✅

As reservas feitas na Ventrata para um produto ligado ao backend são criadas na conta do operador em Clorian.

Funciona da seguinte forma:

  1. Reter e confirmar: quando o produto é adicionado ao carrinho, a Ventrata verifica a reserva junto de Clorian e, após o pagamento, cria a reserva na conta do operador em Clorian com os dados do cliente.

  2. Bilhetes: a referência ou os bilhetes devolvidos por Clorian ficam guardados na reserva Ventrata.

  3. Chamadas observadas: Confirm Booking, Create Booking.

As reservas e os cancelamentos são enviados da Ventrata para Clorian. As atualizações de reservas da Ventrata para Clorian não são suportadas.

 

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

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

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

Extras Sync

❌

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

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

Redemption Sync

❌

Os resgates e outras alterações de estado em Clorian 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 Clorian 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 Clorian.

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

Gift Card Sync

❌

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

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

✅ suportado · ❌ não suportado

 

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

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

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

  • API personalizada: a API de Clorian não é OCTO, pelo que algumas funcionalidades podem ser limitadas em comparação com os backends OCTO.

  • Clorian é uma plataforma de bilhética para grandes locais e espaços culturais, que processa mais de 32 milhões de bilhetes por ano com uma rede de mais de 14 000 distribuidores.

  • Método de pagamento por operador: Deferred Payment (predefinição de Clorian) ou Pre-payment (depósito).

 

Perguntas frequentes

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

Muito provavelmente, a API Key, o Username e a Password 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 Clorian. 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 Clorian. Se o problema persistir, contacte o nosso Suporte técnico.

 

Recursos úteis

 

 

Informações do parceiro

Tiqueteo Spain, S.L.

Carrer de Veneçuela, 103, 1, Sant Martí

08019 Barcelona, Spain

 

ID de parceiro Ventrata: b4dc43c9-5155-4d6c-8861-a73a83fce30d

Isto respondeu à sua pergunta?