Rotterdampas é o passe anual oficial de descontos da região de Roterdão, emitido para residentes e estudantes, que abrange centenas de espaços culturais, de lazer, desportivos e familiares com entrada gratuita ou com desconto. Para os operadores, traz um público local e nacional, cerca de 170 000 titulares de passes por ano que visitam repetidamente e fora das horas de ponta, sendo os museus, as atrações e as atividades familiares os principais resgates. Rotterdampas utiliza Intersolve como o seu principal sistema de bilhética.
Conectar Rotterdampas à Ventrata permite-lhe ler, validar e resgatar passes de Rotterdampas à 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 Rotterdampas.
Para saber mais sobre Rotterdampas, visite rotterdampas.nl.
📒 NOTA
Rotterdampas funciona em Intersolve. Consulte Intersolve: conexão de revendedor.
Website principal | |
Etiquetas | Multi-Attraction Pass |
Tipo de conexão | Resgate de passes: lê os passes de Rotterdampas à sua entrada |
Funcionalidades da conexão | Product Mapping · Redemption Sync · Pass Walkup Scanning Sync |
Desenvolvido por | Ventrata (através da API de Rotterdampas) |
Esta conexão permite:
Leia ou introduza o número de um cartão Rotterdampas e veja os vouchers desse cartão que são válidos no seu espaço.
Crie automaticamente uma reserva na Ventrata para cada voucher utilizável, para que uma leitura possa dar entrada a vários vouchers.
Registe a utilização do voucher junto de Rotterdampas no momento da leitura, ou mais tarde, quando o visitante entra ou é marcado como no-show.
Como funciona
A equipa lê ou introduz o número de um cartão Rotterdampas, opcionalmente seguido de #PIN.
A Ventrata pede a Rotterdampas (Intersolve) os vouchers emitidos para esse cartão.
Cada voucher utilizável torna-se o seu próprio código resgatável (/), pelo que um cartão pode devolver várias reservas.
Os vouchers com o estado Normal recebem uma nova reserva, ou é devolvida a reserva existente. Os vouchers já Redeemed só devolvem uma reserva Ventrata existente.
A Ventrata cria uma reserva sem data definida para cada voucher, utilizando o produto, a opção e a unidade que mapeou para esse tipo de voucher.
A Ventrata envia Redeem para Rotterdampas para cada bilhete, de imediato ou mais tarde, consoante as suas definições de resgate.
📒 NOTA
Um número de cartão Rotterdampas, opcionalmente seguido de #PIN. Pode ser o número curto de 1 a 7 dígitos (a Ventrata completa-o com o prefixo fixo de Rotterdampas até ao formato de 19 dígitos) ou o número completo com prefixo.
Criar a conexão com Rotterdampas
🔐 Permissões de função necessárias: See Connections, Modify Connections
Antes de começar:
Tenha à mão o seu User Name e a sua Password da API de Rotterdampas.
Crie Rotterdampas como revendedor na Ventrata se pretender que as reservas sejam registadas sob esse revendedor (o campo Reseller é opcional no formulário).
Tenha um cartão Rotterdampas real com os seus vouchers. Os tipos de voucher só aparecem para mapeamento depois de um cartão ter sido lido.
Criar a conexão
Selecione o seu revendedor Rotterdampas (opcional).
Introduza o User Name e a Password de Rotterdampas.
Escolha quando o resgate é enviado: deixe ambas as opções desativadas para resgatar no momento da leitura, ou assinale Redeem on Redemption/Upgrade e/ou Redeem on No-show.
Guarde. A Ventrata valida as credenciais junto de Rotterdampas.
O formulário da conexão tem as seguintes opções:
Reseller | O revendedor sob o qual as reservas de Rotterdampas são registadas. Opcional no formulário. |
Rotterdampas User Name / Password | Obrigatório. A Ventrata verifica-os com uma chamada de teste quando cria a conexão ou os altera; se falharem, ambos os campos são assinalados como inválidos. |
Redeem on Redemption/Upgrade | Envia o resgate para o fornecedor conectado quando a reserva é resgatada na Ventrata. |
Redeem on No-show | Envia o resgate para o fornecedor conectado quando a reserva é marcada como no-show na Ventrata, incluindo os no-shows automáticos. |
Mapear produtos
As linhas são criadas na primeira vez que a Ventrata deteta um tipo de voucher (VoucherId) num cartão lido. Não existe nenhuma lista para carregar antecipadamente.
Leia um cartão Rotterdampas que contenha o seu voucher.
Abra a conexão e encontre a nova linha desse tipo de voucher.
Escolha o produto, a opção e a unidade Ventrata a reservar. A opção e a unidade são obrigatórias.
Leia novamente o cartão para criar a reserva.
📒 NOTA
Uma linha só conta como mapeada se o produto estiver ativo e a opção e a unidade estiverem definidas e não descartadas.
📒 NOTA
Enquanto uma linha não estiver mapeada, o voucher falha com " is not mapped in <connection>".
Redemption
Imediatamente: predefinição (ambas as opções desativadas): no momento da leitura, a Ventrata valida a encomenda e envia Redeem para Rotterdampas para cada bilhete.
No resgate ou no no-show: com Redeem on Redemption/Upgrade e/ou Redeem on No-show assinalados, a reserva é guardada, mas ainda não é resgatada em Rotterdampas. A Ventrata envia Redeem quando o bilhete é resgatado ou atualizado na Ventrata, ou marcado como no-show.
O que é enviado para Rotterdampas: um pedido Redeem para o voucher emitido, com o preço do bilhete como TransactionAmount em cêntimos e uma referência fixa por bilhete, para que uma nova tentativa não resgate duas vezes.
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 Rotterdampas para um produto Ventrata no Ventrata Dashboard. As linhas são criadas na primeira vez que a Ventrata deteta um tipo de voucher (VoucherId) num cartão lido. Não existe nenhuma lista para carregar antecipadamente. Uma linha só conta como mapeada se o produto estiver ativo e a opção e a unidade estiverem definidas e não descartadas. Enquanto uma linha não estiver mapeada, o voucher falha com " is not mapped in <connection>". |
Content Sync | ❌ |
O conteúdo dos produtos não é sincronizado. Rotterdampas 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 Rotterdampas. Não existe troca de disponibilidade nem de capacidade com Rotterdampas. |
Pricing Sync | ❌ |
Os preços não são sincronizados com Rotterdampas. A reserva utiliza o preço unitário da Ventrata e é saldada com uma transação de voucher. No resgate, a Ventrata envia o preço do bilhete para Rotterdampas como TransactionAmount na menor unidade monetária (cêntimos). |
Promotions Sync | ❌ |
As promoções não se aplicam aos passes de Rotterdampas. 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 cada voucher utilizável, pelo que uma leitura pode criar várias reservas. Os IDs de voucher são reutilizados entre temporadas, pelo que a Ventrata só associa uma reserva anterior feita dentro do período de validade (valid-from/valid-until) do voucher com o mesmo produto, opção e unidade. Não existe nenhuma chamada de cancelamento nem de anulação de resgate para Rotterdampas. |
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 Rotterdampas. Predefinição (ambas as opções desativadas): no momento da leitura, a Ventrata valida a encomenda e envia Redeem para Rotterdampas para cada bilhete. Com Redeem on Redemption/Upgrade e/ou Redeem on No-show assinalados, a reserva é guardada, mas ainda não é resgatada em Rotterdampas. A Ventrata envia Redeem quando o bilhete é resgatado ou atualizado na Ventrata, ou marcado como no-show. Um pedido Redeem para o voucher emitido, com o preço do bilhete como TransactionAmount em cêntimos e uma referência fixa por bilhete, para que uma nova tentativa não resgate duas vezes. |
Pass Walkup Scanning Sync | ✅ |
Lê os passes de Rotterdampas à sua entrada. A equipa lê ou introduz o número de um cartão Rotterdampas, opcionalmente seguido de #PIN. A Ventrata pede a Rotterdampas (Intersolve) os vouchers emitidos para esse cartão. Cada voucher utilizável torna-se o seu próprio código resgatável (/), pelo que um cartão pode devolver várias reservas. |
Gift Card Sync | ❌ |
Não faz parte desta conexão. Os passes de Rotterdampas 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 voucher só aparecem para mapeamento depois de um cartão real ter sido lido, pelo que não é possível mapear antes da entrada em produção, a menos que conheça os IDs dos vouchers.
Um voucher já resgatado noutro local nunca volta a dar entrada na Ventrata.
Os textos de erro de Rotterdampas são apresentados à equipa palavra por palavra.
Os pedidos excedem o tempo limite após 20 segundos.
Sem recolhas, extras, perguntas personalizadas nem recursos.
Resolução de problemas
"%{title} is not mapped in %{connection}"
"%{title} is not mapped in %{connection}"
O tipo de voucher não tem nenhum produto, opção e unidade Ventrata mapeados. Mapeie a linha na conexão e leia novamente.
"Invalid card status: %{status}"
"Invalid card status: %{status}"
O estado do voucher em Rotterdampas não é Normal nem Redeemed.
"Redemption not allowed"
"Redemption not allowed"
"This Rotterdampas voucher has already been redeemed"
"This Rotterdampas voucher has already been redeemed"
O voucher foi utilizado noutro local e não tem nenhuma reserva na sua conta Ventrata.
"Invalid response from Rotterdampas"
"Invalid response from Rotterdampas"
Rotterdampas enviou uma resposta que a Ventrata não conseguiu ler.
"Rotterdampas request failed (code %{code})"
"Rotterdampas request failed (code %{code})"
Rotterdampas devolveu um código de erro sem descrição.
Perguntas frequentes
Porque é que uma leitura criou várias reservas?
Porque é que uma leitura criou várias reservas?
Um cartão Rotterdampas pode conter vários vouchers. A Ventrata cria uma reserva para cada voucher utilizável.
Qual é a relação entre Rotterdampas e Intersolve?
Qual é a relação entre Rotterdampas e Intersolve?
Rotterdampas funciona na plataforma de vouchers de Intersolve. Intersolve desenvolveu Rotterdampas e é o seu sistema de bilhética, pelo que esta conexão comunica com a API de Intersolve.
O que acontece se a equipa ler novamente o cartão?
O que acontece se a equipa ler novamente o cartão?
Para um voucher já reservado na Ventrata, é devolvida a reserva existente em vez de uma nova. Em caso de nova tentativa, o pedido Redeem utiliza a mesma referência, pelo que Rotterdampas não é cobrado duas vezes.
Recursos úteis
📚 Mais sobre as conexões Ventrata
Informações do parceiro
Gemeente Rotterdam
Rotterdampas Servicepunt, Halvemaanpassage 90 (Timmerhuis), 3011 DL Rotterdam
Países Baixos
ID de parceiro Ventrata: 1ae100da-b3b2-4726-a71e-6185dd3f65db