Ir para conteúdo principal

Brussels Card: conexão de revendedor

Leia, valide e resgate passes de Brussels Card à sua entrada com a Ventrata, e saiba como configurar e mapear a conexão.

Brussels Card logo

 

Brussels Card é o passe oficial de visitante de Bruxelas, vendido através da visit.brussels e gerido pela Brussels Museums, que dá aos titulares entrada gratuita em mais de 40 museus durante um a três dias, bem como descontos em atrações, visitas guiadas, lojas, bares e restaurantes. Os extras opcionais incluem os transportes públicos STIB, o autocarro hop-on hop-off Tootbus e o Atomium. Para as atrações, traz visitantes em escapadinhas urbanas de curta duração que pagaram antecipadamente pela cultura e convertem os descontos do passe em visitas pagas e reservas adicionais durante a estadia.

 

Conectar Brussels Card à Ventrata permite-lhe ler, validar e resgatar passes de Brussels Card à sua entrada, em torniquetes, quiosques e terminais de ponto de venda com tecnologia Ventrata, na aplicação móvel ou no Ventrata Dashboard, sem precisar de uma aplicação separada de Brussels Card.

 

Para saber mais sobre Brussels Card, visite visit.brussels.

 

Website principal

Etiquetas

Destination Organization (DMO) · Multi-Attraction Pass

Tipo de conexão

Resgate de passes: lê os passes de Brussels Card à sua entrada

Funcionalidades da conexão

Product Mapping · Redemption Sync · Pass Walkup Scanning Sync

Desenvolvido por

Ventrata (através da API de Brussels Card)

 

Esta conexão permite:

  • Leia um código QR Brussels Card na Ventrata e verifique o cartão junto de Brussels Card em tempo real.

  • Crie automaticamente uma reserva na Ventrata para cada cartão válido, com o nome e o email do visitante copiados da encomenda de Brussels Card.

  • Registe a leitura junto de Brussels Card no momento em que lê.

 

Como funciona

  1. A equipa lê o código QR Brussels Card.

  2. Se o cartão já tiver uma reserva ativa para este revendedor, a Ventrata devolve-a.

  3. Caso contrário, a Ventrata consulta o cartão junto de Brussels Card. O estado do cartão tem de ser new ou valid.

  4. A Ventrata encontra o produto de Brussels Card no cartão e o produto, a opção e a unidade Ventrata que mapeou para ele.

  5. A Ventrata regista a leitura junto de Brussels Card (com a hora atual).

  6. Se Brussels Card aceitar a leitura, a Ventrata guarda uma reserva sem data definida para 1 unidade, com o nome próprio, o apelido e o email do visitante provenientes da encomenda de Brussels Card.

📒 NOTA

Códigos QR Brussels Card no formato 1#[#...]. A versão tem de ser 1 e o ID do cartão tem de estar presente; qualquer outro código é ignorado por esta conexão.

 

Criar a conexão com Brussels Card

🔐 Permissões de função necessárias: See Connections, Modify Connections

 

Antes de começar:

  • Tenha à mão a sua Public Key e a sua Private Key de Brussels Card.

  • Crie Brussels Card como revendedor na Ventrata e selecione-o na conexão. O formulário indica Reseller como opcional, mas as consultas precisam dele.

 

Criar a conexão

  1. Selecione o seu revendedor Brussels Card.

  2. Introduza a Public Key e a Private Key de Brussels Card.

  3. Guarde. A Ventrata carrega os seus produtos de parceiro de Brussels Card e cria uma linha de mapeamento por produto.

 

 

O formulário da conexão tem as seguintes opções:

Reseller

O revendedor sob o qual as reservas de Brussels Card são registadas. Opcional no formulário, mas necessário na prática para as consultas.

Public Key / Private Key de Brussels Card

Obrigatório. A Ventrata utiliza-as para assinar os pedidos e verifica-as sempre que guarda, carregando a sua lista de produtos de parceiro. Se esta operação falhar, é apresentado o erro de Brussels Card e ambos os campos são assinalados como inválidos.

 

Mapear produtos

Sempre que guarda, a Ventrata carrega a sua lista de produtos de parceiro de Brussels Card e cria uma linha por produto. Os produtos que já não existem são removidos.

  1. Abra a conexão e selecione cada linha de produto.

  2. Escolha o produto, a opção e a unidade Ventrata a reservar. A opção e a unidade são obrigatórias.

  3. Volte a guardar a conexão para obter os novos produtos de Brussels Card.

📒 NOTA

Um cartão cujo produto não tenha uma linha é ignorado por esta conexão.

📒 NOTA

Um cartão cuja linha de produto exista, mas não esteja mapeada, falha com " is not mapped in <connection>".

 

Redemption

  • Imediatamente: sempre. A Ventrata regista a leitura junto de Brussels Card no momento em que lê; a reserva só é guardada se Brussels Card a aceitar.

  • No resgate ou no no-show: não suportado.

  • O que é enviado para Brussels Card: um pedido RecordScan com o ID do cartão e a hora da leitura.

 

Funcionalidades da conexão em detalhe

Esta secção destina-se a quem quer conhecer os detalhes. Clique numa linha para ver como funciona cada funcionalidade.

 

Product Mapping

✅

Mapeia cada passe listado em Brussels Card para um produto Ventrata no Ventrata Dashboard.

Sempre que guarda, a Ventrata carrega a sua lista de produtos de parceiro de Brussels Card e cria uma linha por produto. Os produtos que já não existem são removidos.

Um cartão cujo produto não tenha uma linha é ignorado por esta conexão.

Um cartão cuja linha de produto exista, mas não esteja mapeada, falha com " is not mapped in <connection>".

Content Sync

❌

O conteúdo dos produtos não é sincronizado.

Brussels Card vende o seu próprio passe. Os seus produtos e o respetivo conteúdo permanecem na Ventrata.

Availability Sync

❌

A sua disponibilidade não é partilhada com Brussels Card.

Não existe troca de disponibilidade nem de capacidade com Brussels Card.

Pricing Sync

❌

Os preços não são sincronizados com Brussels Card.

A reserva utiliza o preço unitário da Ventrata e é liquidada por voucher. Nenhum preço é enviado para Brussels Card.

Promotions Sync

❌

As promoções não se aplicam aos passes de Brussels Card.

As suas promoções Ventrata não se aplicam às reservas feitas através da leitura de um passe.

Bookings Sync

✅ / ❌

Limitado: as reservas só são criadas quando um passe é lido.

Uma reserva sem data definida por cartão, com quantidade 1 da unidade mapeada, criada no momento da leitura. O nome próprio, o apelido e o email do visitante são copiados da encomenda de Brussels Card.

Não existe nenhuma chamada de cancelamento nem de anulação de leitura para Brussels Card.

Pickups/Dropoff Sync

❌

Não faz parte desta conexão.

Os resgates de passes não incluem recolhas.

Custom Questions Sync

❌

Não faz parte desta conexão.

As perguntas de reserva não são feitas nem enviadas nos resgates de passes.

Extras Sync

❌

Não faz parte desta conexão.

Não é possível adicionar extras a um resgate de passe.

Redemption Sync

✅

Os resgates são enviados para Brussels Card.

Sempre. A Ventrata regista a leitura junto de Brussels Card no momento em que lê; a reserva só é guardada se Brussels Card a aceitar.

Não suportado.

Um pedido RecordScan com o ID do cartão e a hora da leitura.

Pass Walkup Scanning Sync

✅

Lê os passes de Brussels Card à sua entrada.

A equipa lê o código QR Brussels Card.

Se o cartão já tiver uma reserva ativa para este revendedor, a Ventrata devolve-a.

Caso contrário, a Ventrata consulta o cartão junto de Brussels Card. O estado do cartão tem de ser new ou valid.

Gift Card Sync

❌

Não faz parte desta conexão.

Os passes de Brussels Card não são cartões-oferta Ventrata.

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

 

Bom saber: limites desta conexão

  • Cada cartão pode ser lido uma vez por fornecedor Ventrata. Uma nova leitura devolve a reserva existente e não regista uma nova leitura.

  • O resgate não pode ser diferido para a entrada ou para o no-show.

  • Sem recolhas, extras, perguntas personalizadas nem recursos.

  • Os resultados das consultas ficam em cache durante 5 minutos, e um tempo limite excedido é tratado como não encontrado.

 

Resolução de problemas

"%{title} is not mapped in %{connection}"

O produto de Brussels Card do cartão não tem nenhum produto, opção e unidade Ventrata mapeados. Mapeie a linha do produto na conexão e leia novamente.

"Invalid card status: %{status}"

O estado do cartão em Brussels Card não é new nem valid.

"Redemption not allowed"

 

Perguntas frequentes

O que acontece se ler o mesmo Brussels Card duas vezes?

A Ventrata devolve a reserva que já criou para esse cartão e não regista uma segunda leitura junto de Brussels Card.

 

Recursos úteis

 

 

Informações do parceiro

visit.brussels ASBL

Rue Royale 2-4, 1000 Bruxelles

Bélgica

 

ID de parceiro Ventrata: 7f83d715-2e18-45a1-a871-0c5598905836

Isto respondeu à sua pergunta?