A Otipass é uma plataforma francesa de digitalização de passes territoriais, que suporta cartões turísticos, culturais, jovens e de cidadão em mais de quarenta cidades e regiões, incluindo Lyon, Toulouse, Bordéus, Nantes, Helsínquia e Matera, vendidos a postos de turismo e municípios. Para os operadores, traz titulares de passes oficiais de cidades e regiões que pagaram antecipadamente um conjunto de entradas e escolhem os locais já no destino, sendo os museus, os monumentos e as atrações locais o conteúdo principal.
Conectar OTIPASS à Ventrata permite-lhe ler, validar e resgatar passes de OTIPASS à 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 OTIPASS.
Para saber mais sobre OTIPASS, visite otipass.com.
Website principal | |
Etiquetas | Multi-Attraction Pass |
Tipo de conexão | Resgate de passes: lê os passes de OTIPASS à sua entrada |
Funcionalidades da conexão | Product Mapping · Redemption Sync · Pass Walkup Scanning Sync |
Desenvolvido por | Ventrata (através da API da Otipass) |
Esta conexão permite:
Leia ou introduza o número de um passe OTIPASS na Ventrata e verifique-o junto de OTIPASS em tempo real para o seu serviço.
Crie automaticamente uma reserva na Ventrata para cada passe válido.
Registe a entrada junto de OTIPASS no momento em que lê.
Como funciona
A equipa lê ou introduz o número de um passe.
Se o passe já tiver uma reserva ativa, a Ventrata devolve-a.
Caso contrário, a Ventrata envia uma entrada de consulta para OTIPASS relativa ao seu serviço (ID Service) para verificar o passe.
Se o passe for válido, a Ventrata envia uma entrada de registo para OTIPASS.
Se OTIPASS confirmar, a Ventrata guarda uma reserva sem data definida para 1 unidade do produto, da opção e da unidade mapeados para a conexão.
📒 NOTA
Qualquer código não vazio é verificado junto de OTIPASS; não existe nenhum filtro de formato.
Criar a conexão com OTIPASS
🔐 Permissões de função necessárias: See Connections, Modify Connections
Antes de começar:
Tenha à mão o seu OTIPASS ID, a sua OTIPASS Api Key e o seu OTIPASS ID Service.
Crie OTIPASS como revendedor na Ventrata e selecione-o na conexão. O formulário indica Reseller como opcional, mas as consultas precisam dele.
Preveja uma conexão por cada serviço de OTIPASS que aceita.
Criar a conexão
Selecione o seu revendedor OTIPASS.
Introduza o OTIPASS ID, a Api Key e o ID Service.
Guarde. A Ventrata verifica as credenciais e cria uma única linha de mapeamento para o serviço.
O formulário da conexão tem as seguintes opções:
Reseller | O revendedor sob o qual as reservas de OTIPASS são registadas. Opcional no formulário, mas necessário na prática para as consultas. |
OTIPASS ID / OTIPASS Api Key | Obrigatório. Verificados sempre que guarda, com uma consulta de teste a OTIPASS; se falhar, é apresentada a mensagem de OTIPASS e os três campos são assinalados como inválidos. |
OTIPASS ID Service | Obrigatório. O serviço de OTIPASS para o qual esta conexão verifica e resgata passes. Torna-se também o título da única linha de mapeamento da conexão. |
Mapear produtos
Cada conexão tem exatamente uma linha de mapeamento, criada ou atualizada sempre que guarda.
Abra a conexão e selecione a linha de mapeamento.
Escolha o produto, a opção e a unidade Ventrata a reservar. A opção e a unidade são obrigatórias.
📒 NOTA
Para aceitar vários serviços de OTIPASS, crie uma conexão por serviço.
📒 NOTA
Enquanto a linha não estiver mapeada, as leituras falham com " is not mapped in ".
Redemption
Imediatamente: sempre. A Ventrata regista a entrada em OTIPASS no momento da leitura; a reserva só é guardada se OTIPASS a confirmar.
No resgate ou no no-show: não suportado.
O que é enviado para OTIPASS: um registo de entrada para o passe e o serviço, com a data na hora local de Europe/Paris.
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 OTIPASS para um produto Ventrata no Ventrata Dashboard. Cada conexão tem exatamente uma linha de mapeamento, criada ou atualizada sempre que guarda. Para aceitar vários serviços de OTIPASS, crie uma conexão por serviço. Enquanto a linha não estiver mapeada, as leituras falham com " is not mapped in ". |
Content Sync | ❌ |
O conteúdo dos produtos não é sincronizado. OTIPASS 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 OTIPASS. Não existe troca de disponibilidade nem de capacidade com OTIPASS. |
Pricing Sync | ❌ |
Os preços não são sincronizados com OTIPASS. A reserva utiliza o preço unitário da Ventrata e é liquidada por voucher. Nenhum preço é enviado para OTIPASS. |
Promotions Sync | ❌ |
As promoções não se aplicam aos passes de OTIPASS. 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 passe, com quantidade 1 da unidade mapeada, criada no momento da leitura. Não existe nenhuma chamada de cancelamento para OTIPASS. |
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 OTIPASS. Sempre. A Ventrata regista a entrada em OTIPASS no momento da leitura; a reserva só é guardada se OTIPASS a confirmar. Não suportado. Um registo de entrada para o passe e o serviço, com a data na hora local de Europe/Paris. |
Pass Walkup Scanning Sync | ✅ |
Lê os passes de OTIPASS à sua entrada. A equipa lê ou introduz o número de um passe. Se o passe já tiver uma reserva ativa, a Ventrata devolve-a. Caso contrário, a Ventrata envia uma entrada de consulta para OTIPASS relativa ao seu serviço (ID Service) para verificar o passe. |
Gift Card Sync | ❌ |
Não faz parte desta conexão. Os passes de OTIPASS 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
Um serviço de OTIPASS por conexão, mapeado para um produto, uma opção e uma unidade.
Não é possível distinguir passes de adulto e de criança dentro do mesmo serviço.
Qualquer código não vazio que seja lido pode ser enviado para OTIPASS, incluindo códigos destinados a outras conexões.
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}"
"%{title} is not mapped in %{connection}"
A linha ID Service da conexão não tem nenhum produto, opção e unidade da Ventrata mapeados. Mapeie a linha na conexão e volte a ler o código.
"Redemption not allowed"
"Redemption not allowed"
Perguntas frequentes
Como aceitar passes para mais do que um serviço de OTIPASS?
Como aceitar passes para mais do que um serviço de OTIPASS?
Crie uma conexão separada para cada ID Service de OTIPASS e mapeie cada uma para o seu próprio produto, opção e unidade.
Recursos úteis
📚 Mais sobre as conexões Ventrata
Informações do parceiro
OTIPASS SAS
8 rue du 45e Regiment de Transmissions, batiment Le Septan, entree A, 26200 Montelimar
França
ID de parceiro Ventrata: 55b217b2-35ea-454c-ac15-4630ef1cd0b9