Berlin WelcomeCard é o bilhete turístico oficial de Berlim, emitido pelo organismo de turismo visitBerlin e vendido mais de 15 milhões de vezes. Combina transportes públicos ilimitados nas zonas AB ou ABC com descontos em mais de 170 atrações, e as versões superiores acrescentam a entrada na Ilha dos Museus ou entrada gratuita em mais de 25 atrações. Para as atrações, traz visitantes da cidade, estreantes ou habituais, da Alemanha e do estrangeiro, que compram o cartão online ou em pontos de venda e planeiam as visitas em função dele. Esta conexão é desenvolvida e gerida por Public Ticket Solution.

Conectar Berlin WelcomeCard à Ventrata permite-lhe ler, validar e resgatar passes de Berlin WelcomeCard à 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 Berlin WelcomeCard.

Para saber mais sobre Berlin WelcomeCard, visite berlin-welcomecard.de.

Website principal	berlin-welcomecard.de
Etiquetas	Destination Organization (DMO) · Multi-Attraction Pass
Tipo de conexão	Resgate de passes: lê os passes de Berlin WelcomeCard à sua entrada
Funcionalidades da conexão	Product Mapping · Redemption Sync · Pass Walkup Scanning Sync
Desenvolvido por	Ventrata (através da visitBerlin Ticket Gateway API)

Esta conexão permite:

Ler ou introduzir um código de bilhete de Berlin WelcomeCard na Ventrata e verificá-lo junto de Berlin WelcomeCard em tempo real.
Criar automaticamente uma reserva na Ventrata para cada bilhete válido.
Registar a entrada em Berlin WelcomeCard no momento da leitura, para que o bilhete fique marcado como utilizado.

Como funciona

A equipa lê ou introduz um código de bilhete WelcomeCard na Ventrata: na pesquisa de encomendas do Backoffice, num leitor ou terminal Ventrata, ou através da API OCTO de resgate/check-in da Ventrata.
A Ventrata só trata como bilhetes WelcomeCard os códigos que começam por "TE" seguidos de, pelo menos, 12 caracteres. Os restantes códigos ficam para as suas outras conexões.
Se o bilhete já tiver sido reservado para este revendedor, a Ventrata devolve essa reserva existente.
Caso contrário, a Ventrata envia para Berlin WelcomeCard uma leitura apenas de consulta para verificar o bilhete e encontrar a respetiva variante de produto.
Em seguida, a Ventrata regista uma leitura de entrada em Berlin WelcomeCard, utilizando o seu Entry Zone ID, o seu Organization ID e a hora atual.
Se Berlin WelcomeCard confirmar o êxito, a Ventrata guarda uma reserva sem data definida para 1 unidade do produto, da opção e da unidade que mapeou para essa variante.

📒 NOTA

Códigos de bilhete que correspondem a "TE" seguido de, pelo menos, 12 letras ou dígitos (regex ^TE\w{12,}$). Qualquer outro código é ignorado por esta conexão.

Criar a conexão com Berlin WelcomeCard

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

Antes de começar:

Tenha à mão as suas credenciais da API de Berlin WelcomeCard: Username, Password, Product ID, Organization ID e Entry Zone ID.
Crie Berlin WelcomeCard 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

Selecione o seu revendedor Berlin WelcomeCard.
Introduza o Username, a Password, o Product ID, o Organization ID e o Entry Zone ID.
Guarde. A Ventrata inicia sessão, obtém o produto e as respetivas variantes e cria uma linha de mapeamento por variante.

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

Reseller	O revendedor sob o qual as reservas WelcomeCard são registadas. Opcional no formulário, mas necessário na prática para as pesquisas.
Berlin Welcomecard Username / Password	A Ventrata inicia sessão com estes dados quando guarda. Se o início de sessão falhar, ambos os campos são assinalados como inválidos.
Berlin Welcomecard Product ID	O produto WelcomeCard cujas variantes a Ventrata carrega para mapeamento. Se o produto não for encontrado, o campo é assinalado como inválido.
Berlin Welcomecard Organization ID	Enviado com cada leitura de entrada. Não é verificado quando guarda.
Berlin Welcomecard Entry Zone ID	A zona de entrada em que cada leitura é registada. Não é verificado quando guarda; um valor errado só se manifesta no momento da leitura.

Mapear produtos

Quando guarda a conexão, a Ventrata cria uma linha por variante do produto WelcomeCard configurado. As variantes que já não existem são removidas. Se um bilhete lido pertencer a uma variante que ainda não tem linha, a Ventrata adiciona a linha no momento da leitura.

Abra a conexão e selecione cada linha de variante.
Escolha o produto, a opção e a unidade da Ventrata a reservar para essa variante. A opção e a unidade são obrigatórias.
Volte a guardar a conexão sempre que as variantes WelcomeCard mudarem. As linhas só são atualizadas quando guarda.

📒 NOTA

Um bilhete de uma variante não mapeada falha com " is not mapped in <connection>" até a mapear.

Redemption

Imediatamente: sempre. A leitura de entrada é registada em Berlin WelcomeCard no momento da leitura, e a reserva só é guardada se o fornecedor indicar êxito.
No resgate ou em caso de não comparência: não suportado. As opções Redeem on Redemption/Upgrade e Redeem on No-show não aparecem para esta conexão.
O que é enviado para Berlin WelcomeCard: um evento de leitura de entrada (scanEventCreate, kind entry) com a sua zona de entrada, a sua organização, a hora atual e o nome de dispositivo "Ventrata".

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 Berlin WelcomeCard para um produto Ventrata no Ventrata Dashboard. Quando guarda a conexão, a Ventrata cria uma linha por variante do produto WelcomeCard configurado. As variantes que já não existem são removidas. Se um bilhete lido pertencer a uma variante que ainda não tem linha, a Ventrata adiciona a linha no momento da leitura. Um bilhete de uma variante não mapeada falha com " is not mapped in <connection>" até a mapear.
Content Sync	❌	O conteúdo dos produtos não é sincronizado. Berlin WelcomeCard 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 Berlin WelcomeCard. Não existe troca de disponibilidade nem de capacidade com Berlin WelcomeCard.
Pricing Sync	❌	Os preços não são sincronizados com Berlin WelcomeCard. A reserva utiliza o preço unitário da Ventrata e é liquidada por voucher, pelo que o saldo da encomenda fica a zero. Não é enviado nenhum preço para Berlin WelcomeCard.
Promotions Sync	❌	As promoções não se aplicam aos passes de Berlin WelcomeCard. 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 bilhete, com quantidade 1 da unidade mapeada, criada quando o bilhete é lido. A referência do revendedor é o código do bilhete sem o prefixo "TE". As verificações de cliente, perguntas, transporte e acompanhante são ignoradas. Voltar a ler o mesmo bilhete devolve a reserva existente. Não existe nenhuma chamada de cancelamento para Berlin WelcomeCard. Uma leitura registada não pode ser anulada 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 Berlin WelcomeCard. Sempre. A leitura de entrada é registada em Berlin WelcomeCard no momento da leitura, e a reserva só é guardada se o fornecedor indicar êxito. Não suportado. As opções Redeem on Redemption/Upgrade e Redeem on No-show não aparecem para esta conexão. Um evento de leitura de entrada (scanEventCreate, kind entry) com a sua zona de entrada, a sua organização, a hora atual e o nome de dispositivo "Ventrata".
Pass Walkup Scanning Sync	✅	Lê os passes de Berlin WelcomeCard à sua entrada. A equipa lê ou introduz um código de bilhete WelcomeCard na Ventrata: na pesquisa de encomendas do Backoffice, num leitor ou terminal Ventrata, ou através da API OCTO de resgate/check-in da Ventrata. A Ventrata só trata como bilhetes WelcomeCard os códigos que começam por "TE" seguidos de, pelo menos, 12 caracteres. Os restantes códigos ficam para as suas outras conexões. Se o bilhete já tiver sido reservado para este revendedor, a Ventrata devolve essa reserva existente.
Gift Card Sync	❌	Não faz parte desta conexão. Os passes de Berlin WelcomeCard não são cartões-oferta Ventrata.

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

Bom saber: limites desta conexão

Um Product ID WelcomeCard por conexão. Para aceitar vários produtos WelcomeCard, provavelmente precisa de uma conexão por produto.
Os mapeamentos só são atualizados quando volta a guardar a conexão.
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 pesquisas ficam em cache durante 5 minutos. Se Berlin WelcomeCard não responder em cerca de 12 segundos, o código é tratado como não encontrado.

Resolução de problemas

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

A variante do bilhete não tem nenhum produto, opção e unidade da Ventrata mapeados. Mapeie a linha da variante na conexão e volte a ler o bilhete.

"Redemption not allowed"