Salzburg Card é o cartão turístico com tudo incluído de Salzburgo, na Áustria, emitido pela Tourismus Salzburg, que dá uma entrada gratuita nos monumentos e museus da cidade, além de transportes públicos durante 24, 48 ou 72 horas. Para as atrações, traz cerca de 240 000 titulares de cartão por ano e cerca de 1,2 milhões de entradas, sendo a Alemanha, os Estados Unidos, o Reino Unido e a Itália os principais mercados de dormidas, com venda em hotéis, bilheteiras, no aeroporto e online. Salzburg Card utiliza a Feratel como sistema de bilhética principal.
Conectar Salzburg Card à Ventrata permite-lhe ler, validar e resgatar passes de Salzburg 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 Salzburg Card.
Para saber mais sobre Salzburg Card, visite salzburg.info/en/hotels-offers/salzburg-card.
Website principal | |
Etiquetas | Destination Organization (DMO) · Multi-Attraction Pass |
Tipo de conexão | Resgate de passes: lê os passes de Salzburg Card à sua entrada |
Funcionalidades da conexão | Product Mapping · Redemption Sync · Pass Walkup Scanning Sync |
Desenvolvido por | Ventrata (através da feratel CheckAPI) |
Esta conexão permite:
Leia e valide Salzburg Cards de visitantes sem reserva em hardware com tecnologia Ventrata (torniquete, quiosque de bilhetes, ponto de venda/terminal), na aplicação móvel ou no dashboard, sem um leitor ou uma aplicação feratel à parte.
Crie automaticamente uma reserva na Ventrata para cada cartão válido, para que os visitantes de Salzburg Card apareçam nos seus relatórios, na sua capacidade e na sua liquidação.
Registe a utilização do cartão em feratel de imediato, ou na entrada ou no no-show, marcando o cartão como utilizado para o seu serviço.
Como funciona
O código QR de um visitante é lido em hardware com tecnologia Ventrata ou na aplicação móvel, ou introduzido em Redeem Voucher Code no dashboard. Em alternativa, pode ser introduzido o número impresso do cartão.
Se o código não pertencer a uma das suas reservas ou bilhetes existentes, a Ventrata verifica em tempo real com feratel se se trata de um Salzburg Card válido para a sua atração nesse momento. Esta verificação não regista nenhuma utilização.
Se o cartão for válido, a Ventrata cria uma reserva no seu revendedor Salzburg Card, para o produto, a opção e a unidade que mapeou para esse serviço e tipo de cartão (por ex., Adult ou Child).
A reserva é feita para a primeira disponibilidade em curso, a menos que o pessoal escolha uma (por ex., num quiosque de bilhetes ou num ponto de venda).
A Ventrata envia a utilização do cartão a feratel como um "check with transaction": por predefinição de imediato, ou quando a reserva é resgatada/atualizada ou marcada como no-show, consoante as suas definições.
📒 NOTA
O código QR no cartão físico ou no cartão digital do visitante, ou o número impresso do cartão. Um código QR num recibo de compra não é um Salzburg Card.
Criar a conexão com Salzburg Card
🔐 Permissões de função necessárias: See Connections, Modify Connections
Antes de começar:
Tem de ser uma atração parceira de Salzburg Card com um acordo comercial com a Tourismus Salzburg GmbH.
A sua atração tem de ser ativada para a Ventrata pela Tourismus Salzburg. A Tourismus Salzburg informa feratel, e feratel ativa o ponto de controlo da sua atração para a Ventrata.
Tem de utilizar hardware com tecnologia Ventrata (torniquete, quiosque de bilhetes, ponto de venda/terminal), a aplicação móvel ou o dashboard na sua entrada.
Crie Salzburg Card como revendedor na Ventrata com os preços corretos (venda ao público, grossista/comissão) e o método de liquidação "Bill to my account".
Obtenha as suas cinco credenciais de feratel e pelo menos um Salzburg Card real de cada tipo que aceita (por ex., um Adult e um Child) que inclua os seus serviços.
A sua função precisa das permissões See Connections e Modify Connections.
Para aderir a Salzburg Card como atração parceira, contacte a Tourismus Salzburg. [email protected] Https://www.salzburg.info/en/hotels-offers/salzburg-card
Para obter ajuda com as credenciais ou a configuração, coloque a Ventrata Connectivity em cópia no seu pedido a Salzburg Card. [email protected]
Criar a conexão
No Ventrata Dashboard, aceda a Connections → Connections, clique em + New Connection e selecione Salzburg Card.
Selecione o seu revendedor Salzburg Card.
Introduza o Feratel Username, Password, Tenant ID, Client ID e Client Secret.
Escolha quando o resgate é enviado para feratel, conforme acordado com a Tourismus Salzburg, ou deixe ambas as opções desmarcadas para registar a utilização quando o cartão é validado e a reserva criada.
Opcionalmente, defina um Name, restrinja destinos, produtos ou itens e marque Test.
Clique em Create Connection e avance para o mapeamento.
O formulário da conexão tem as seguintes opções:
Reseller | O seu revendedor Salzburg Card (por ex., Tourismus Salzburg GmbH). A conexão herda os respetivos preços, destinos, produtos e itens permitidos, e todas as reservas com cartão são registadas nele. |
Feratel Username / Password / Tenant ID / Client ID / Client Secret | As suas credenciais de feratel fornecidas por Salzburg Card. |
Redeem on Redemption/Upgrade | Envie o resgate para feratel quando a reserva for resgatada na Ventrata. Recomendado quando a reserva e a entrada acontecem em momentos diferentes. |
Redeem on No-show | Envie o resgate para feratel quando a reserva for marcada como no-show na Ventrata, incluindo no-shows automáticos. |
Name | Nome opcional da conexão, à sua escolha. |
Destinos, produtos ou itens permitidos | Restrições adicionais opcionais, para além do que está definido no revendedor. |
Test | Força todas as reservas de Salzburg Card para o modo de teste e só aceita leituras de equipamentos em modo de teste. |
📗 DICA
Marque Test na conexão para forçar todas as reservas de Salzburg Card para o modo de teste e só aceitar leituras de equipamentos em modo de teste; desmarque antes de passar a produção. Os cartões de serviço de teste têm um tipo de cartão de teste, e não Adult ou Child, pelo que não podem ser utilizados para configurar o mapeamento.
Mapear produtos
A Feratel não envia os serviços juntamente com os respetivos tipos de cartão através da API. Os serviços atribuídos à sua atração são carregados automaticamente; cada tipo de cartão (por ex., Adult, Child) aparece como uma linha sob o respetivo serviço na primeira vez que é lido um cartão desse tipo.
Abra a sua conexão Salzburg Card e reveja os serviços carregados a partir de feratel. As linhas de serviço indicam à Ventrata o que verificar, mas não podem ser utilizadas sozinhas para a entrada.
Tenha à mão um cartão real de cada tipo (não um cartão de serviço de teste).
Leia cada cartão, ou introduza o respetivo código ou o número impresso do cartão em Redeem Voucher Code. A primeira leitura falha com um erro de mapeamento; isto é esperado e o cartão não é consumido.
Recarregue a página da conexão ou clique em Refresh Mapping. Aparece uma nova linha vermelha sob o serviço para cada tipo de cartão lido.
Clique em cada linha, selecione o produto, a opção e a unidade Ventrata (os três são obrigatórios) e clique em Update Mapping.
Leia novamente os mesmos cartões. É criada uma reserva e o resgate é enviado de acordo com as suas definições.
Quando é atribuído um novo serviço, clique primeiro em Refresh Mapping e depois leia e mapeie cada tipo de cartão. Para um novo tipo de cartão num serviço existente, basta lê-lo e mapeá-lo.
📒 NOTA
Se ler um cartão de serviço de teste, aparece uma linha de tipo de cartão de teste; pode deixá-la sem mapeamento.
📒 NOTA
Quando um serviço é removido em feratel, Refresh Mapping elimina-o juntamente com os mapeamentos dos respetivos tipos de cartão. Se voltar a aparecer, atualize e depois leia e mapeie-o novamente.
Redemption
De imediato: Predefinição (ambas as opções desmarcadas): a utilização do cartão é registada em feratel quando o cartão é validado e a reserva criada.
No resgate ou no no-show: Com Redeem on Redemption/Upgrade, a utilização é enviada quando a reserva é resgatada ou atualizada na Ventrata. Com Redeem on No-show, é enviada quando a reserva é marcada como no-show, incluindo no-shows automáticos.
O que é enviado para Salzburg Card: um pedido "check with transaction" para feratel, que marca o cartão como utilizado para o seu serviço. O resgate na Ventrata falha se feratel não o aceitar.
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 Salzburg Card para um produto Ventrata no Ventrata Dashboard. A Feratel não envia os serviços juntamente com os respetivos tipos de cartão através da API. Os serviços atribuídos à sua atração são carregados automaticamente; cada tipo de cartão (por ex., Adult, Child) aparece como uma linha sob o respetivo serviço na primeira vez que é lido um cartão desse tipo. Se ler um cartão de serviço de teste, aparece uma linha de tipo de cartão de teste; pode deixá-la sem mapeamento. Quando um serviço é removido em feratel, Refresh Mapping elimina-o juntamente com os mapeamentos dos respetivos tipos de cartão. Se voltar a aparecer, atualize e depois leia e mapeie-o novamente. |
Content Sync | ❌ |
O conteúdo dos produtos não é sincronizado. Salzburg Card vende o seu próprio passe. Os seus produtos e o respetivo conteúdo permanecem na Ventrata. |
Availability Sync | ✅ / ❌ |
Limitado: as visitas com cartão contam para a sua capacidade. As reservas entram na primeira disponibilidade em curso, pelo que as visitas com cartão contam para a sua capacidade. Uma verificação de validade bem-sucedida não reserva o serviço em feratel: se o cartão for utilizado noutro local antes de o resgate ser enviado, feratel rejeita-o. |
Pricing Sync | ❌ |
Os preços não são sincronizados com Salzburg Card. As reservas utilizam os preços (venda ao público, grossista/comissão) definidos no seu revendedor Salzburg Card, que tem de utilizar o método de liquidação "Bill to my account". |
Promotions Sync | ❌ |
As promoções não se aplicam aos passes de Salzburg 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 por cada cartão válido, criada automaticamente no revendedor Salzburg Card, para a primeira disponibilidade em curso, a menos que o pessoal escolha uma. O número impresso do cartão é registado como referência do revendedor e na fatura. O produto, a opção e a unidade vêm do mapeamento por serviço e tipo de cartão. Os resgates registados em feratel não podem ser revertidos a partir da Ventrata. |
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 Salzburg Card. Predefinição (ambas as opções desmarcadas): a utilização do cartão é registada em feratel quando o cartão é validado e a reserva criada. Com Redeem on Redemption/Upgrade, a utilização é enviada quando a reserva é resgatada ou atualizada na Ventrata. Com Redeem on No-show, é enviada quando a reserva é marcada como no-show, incluindo no-shows automáticos. Um pedido "check with transaction" para feratel, que marca o cartão como utilizado para o seu serviço. O resgate na Ventrata falha se feratel não o aceitar. |
Pass Walkup Scanning Sync | ✅ |
Lê os passes de Salzburg Card à sua entrada. O código QR de um visitante é lido em hardware com tecnologia Ventrata ou na aplicação móvel, ou introduzido em Redeem Voucher Code no dashboard. Em alternativa, pode ser introduzido o número impresso do cartão. Se o código não pertencer a uma das suas reservas ou bilhetes existentes, a Ventrata verifica em tempo real com feratel se se trata de um Salzburg Card válido para a sua atração nesse momento. Esta verificação não regista nenhuma utilização. Se o cartão for válido, a Ventrata cria uma reserva no seu revendedor Salzburg Card, para o produto, a opção e a unidade que mapeou para esse serviço e tipo de cartão (por ex., Adult ou Child). |
Gift Card Sync | ❌ |
Não faz parte desta conexão. Os passes de Salzburg Card não são cartões-oferta Ventrata. |
✅ suportado · ✅ / ❌ limitado · ❌ não suportado
Bom saber: limites desta conexão
Bom saber: limites desta conexão
Os tipos de cartão só podem ser mapeados depois de um cartão real desse tipo ter sido lido uma vez.
Os cartões de serviço de teste não podem ser utilizados para configurar o mapeamento de Adult ou Child.
As regras de validade (período do cartão, número de utilizações, janelas de dupla utilização) são controladas pelo emissor do cartão em feratel.
Os resgates registados em feratel não podem ser revertidos a partir da Ventrata.
Se a reserva e a entrada acontecerem em momentos diferentes, o cartão pode ser utilizado noutro local entretanto, a menos que ative Redeem on Redemption/Upgrade.
Resolução de problemas
"Erro de mapeamento na primeira leitura de um cartão"
"Erro de mapeamento na primeira leitura de um cartão"
É esperado na primeira vez que um tipo de cartão é lido. O cartão não é consumido. Recarregue a página da conexão, mapeie a nova linha e leia novamente.
"No booking found"
"No booking found"
O código lido não é um Salzburg Card, por exemplo o código QR de um recibo de compra. Leia o código QR no cartão ou no cartão digital, ou introduza o número impresso do cartão.
"Cartão rejeitado como não válido (mensagem de feratel)"
"Cartão rejeitado como não válido (mensagem de feratel)"
Reflete o estado do cartão e as regras de utilização definidas pela Tourismus Salzburg: expirado, já utilizado hoje para o seu serviço ou não válido para este serviço. Os clientes devem contactar a Tourismus Salzburg sobre o seu cartão.
"O cartão é lido, mas não é criada nenhuma reserva"
"O cartão é lido, mas não é criada nenhuma reserva"
O tipo de cartão pode ainda não estar mapeado. Recarregue a página da conexão, mapeie a nova linha e leia novamente. Para um serviço atribuído recentemente, clique primeiro em Refresh Mapping. Se o problema persistir, contacte o suporte da Ventrata.
"Não é possível criar a conexão ou não são carregados serviços"
"Não é possível criar a conexão ou não são carregados serviços"
As credenciais podem estar erradas ou o seu ponto de controlo não está ativado para a Ventrata. Verifique se as cinco credenciais de feratel estão exatamente como as recebeu e se o seu ponto de controlo está ativado. Depois, contacte o seu contacto em Salzburg Card e coloque [email protected] em cópia.
Perguntas frequentes
Qual é a relação entre feratel e Salzburg Card?
Qual é a relação entre feratel e Salzburg Card?
Salzburg Card é emitido pela Tourismus Salzburg GmbH e funciona no software Card System de feratel. feratel não é um revendedor: a sua relação comercial é com a Tourismus Salzburg, e a Ventrata utiliza a CheckAPI de feratel para validar e resgatar o cartão. Cada cartão com tecnologia feratel precisa da sua própria conexão e do seu próprio revendedor na Ventrata.
Uma leitura bem-sucedida reserva o cartão para a minha atração?
Uma leitura bem-sucedida reserva o cartão para a minha atração?
Não. A Ventrata começa por verificar o cartão sem registar nenhuma utilização. Se o cartão for utilizado noutro local antes de o resgate ser enviado, feratel rejeita-o.
Quando devo ativar Redeem on Redemption/Upgrade?
Quando devo ativar Redeem on Redemption/Upgrade?
Quando a reserva e a entrada acontecem em momentos diferentes, por exemplo num quiosque de bilhetes ou numa pré-venda num ponto de venda, para que a utilização do cartão seja registada na entrada.
Recursos úteis
📚 Mais sobre as conexões Ventrata
Informações do parceiro
Tourismus Salzburg GmbH
Auerspergstraße 6, 5020 Salzburg
Áustria
ID de parceiro Ventrata: 01a144a3-e3fa-7458-938a-1324332c0830