CityPASS é um passe multiatrações que reúne a entrada num conjunto fixo de atrações de referência em dezassete destinos norte-americanos, de Nova Iorque, Chicago e Boston a Toronto, Orlando e ao sul da Califórnia, por um preço único com desconto, vendido através de publicidade ao consumidor, do setor profissional de viagens, de hotéis e de afiliados. Para os operadores, traz titulares de passes pré-pagos que se comprometem com várias entradas antes da chegada e as visitam ao longo de uma estadia de vários dias, viajantes que planeiam um itinerário completo pela cidade.
Conectar CityPASS à Ventrata permite-lhe ler, validar e resgatar passes de CityPASS à 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 CityPASS.
Para saber mais sobre CityPASS, visite citypass.com.
📒 NOTA
Pretende antes revender bilhetes de CityPASS? Consulte CityPASS: backend de operador.
🏆 CityPASS Preferred Integration Partner. A Ventrata foi designada CityPASS Preferred Integration Partner e suporta o conjunto completo de funcionalidades de integração de CityPASS.
Website principal | |
Etiquetas | Multi-Attraction Pass |
Tipo de conexão | Resgate de passes: lê os passes de CityPASS à sua entrada |
Funcionalidades da conexão | Product Mapping · Availability Sync · Pricing Sync · Bookings Sync · Redemption Sync · Pass Walkup Scanning Sync |
Desenvolvido por | Ventrata (através da CityPASS API) |
Esta conexão permite:
Ler códigos de barras de CityPASS e C-Ticket à sua entrada e validá-los junto de CityPASS em tempo real.
Registar cada visita com passe como uma reserva sem data definida na Ventrata, com o código de barras como referência do revendedor.
Marcar automaticamente o bilhete como utilizado em CityPASS, no momento da leitura ou mais tarde, quando é resgatado ou marcado como no-show.
Como funciona
Lê ou introduz um código de barras à sua entrada.
Se o código de barras começar por 308458, a Ventrata trata-o como um bilhete de CityPASS e valida-o com a API de CityPASS.
A Ventrata procura a linha de mapeamento correspondente à família de produtos, à atração e à classe de bilhete. Se ainda não estiver mapeado, a leitura falha até que o mapeie.
A Ventrata cria uma reserva sem data definida para o produto, a opção e a unidade mapeados, com quantidade 1 e o código de barras como referência do revendedor.
A Ventrata informa CityPASS de que o bilhete foi utilizado. Se a equipa tiver escolhido uma data ou um horário, esse valor é enviado como data de utilização; caso contrário, é utilizada a hora atual.
📒 NOTA
Apenas os códigos de barras que começam por 308458 são tratados como CityPASS.
Criar a conexão com CityPASS
🔐 Permissões de função necessárias: See Connections, Modify Connections
Antes de começar:
Tem CityPASS configurado como Reseller na Ventrata; o formulário da conexão pede-lhe que escolha um.
Tem um utilizador e uma palavra-passe de CityPASS para a API de CityPASS.
Criar a conexão com CityPASS
Selecione o Reseller CityPASS.
Introduza o utilizador e a palavra-passe de CityPASS.
Escolha que bilhetes aceitar com Is affiliate / Is not affiliate e Product families.
Guarde. A Ventrata verifica as credenciais obtendo a lista de produtos de resgate de CityPASS; se esta operação falhar, os campos de utilizador e palavra-passe são marcados como inválidos.
O formulário da conexão tem as seguintes opções:
Reseller | O revendedor cujas definições a conexão utiliza e em nome do qual as reservas são registadas. |
Utilizador de CityPASS | Utilizador da API de CityPASS. Um prefixo 'uat:' direciona a conexão para o ambiente de integração (teste) de CityPASS. |
Palavra-passe de CityPASS | Palavra-passe da API de CityPASS. |
Is affiliate | Aceita bilhetes em que CityPASS assinala a atração como afiliada/inventário. Ativado por predefinição. |
Is not affiliate | Aceita bilhetes em que CityPASS não assinala a atração como afiliada/inventário. Ativado por predefinição. |
Product families | As famílias de produtos de CityPASS que aceita: CityPASS e/ou CTicket. Ambas por predefinição. |
📗 DICA
Adicione o prefixo 'uat:' ao utilizador para direcionar a conexão para o ambiente de integração (teste) de CityPASS.
Mapear produtos
As linhas provêm da lista de produtos de resgate de CityPASS (/ventrata/redemptionproducts). As novas classes de bilhete detetadas no momento da leitura acrescentam linhas automaticamente.
Abra a conexão e mapeie cada linha de CityPASS para um produto, uma opção e uma unidade Ventrata.
📒 NOTA
Cada linha precisa de um produto, uma opção e uma unidade.
📒 NOTA
Enquanto uma linha não estiver mapeada, as leituras dessa classe de bilhete falham com ' is not mapped in <connection>'.
Redemption
Imediatamente: Predefinição: no momento da leitura, a Ventrata informa CityPASS de que o bilhete está REDEEMED (chamada Use).
No resgate ou no no-show: Redeem on undefer / no-show é suportado. A Ventrata envia a chamada Use mais tarde, com REDEEMED ou com o estado do bilhete Ventrata em maiúsculas, por exemplo, NOSHOW ou CANCELLED.
O que é enviado para CityPASS: O estado do bilhete (REDEEMED ou, no modo diferido, o estado do bilhete) e a data de utilização: a data/hora da reserva, se a equipa tiver escolhido uma, ou, caso contrário, o momento atual. Nenhum preço é enviado.
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 CityPASS para um produto Ventrata no Ventrata Dashboard. As linhas provêm da lista de produtos de resgate de CityPASS (/ventrata/redemptionproducts). As novas classes de bilhete detetadas no momento da leitura acrescentam linhas automaticamente. Cada linha precisa de um produto, uma opção e uma unidade. Enquanto uma linha não estiver mapeada, as leituras dessa classe de bilhete falham com ' is not mapped in <connection>'. |
Content Sync | ❌ |
O conteúdo dos produtos não é sincronizado. CityPASS vende o seu próprio passe. Os seus produtos e o respetivo conteúdo permanecem na Ventrata. |
Availability Sync | ✅ |
Nenhuma disponibilidade é sincronizada com CityPASS. Nenhuma disponibilidade é sincronizada com CityPASS. |
Pricing Sync | ✅ |
Os preços são partilhados com CityPASS. A reserva utiliza o preço unitário da Ventrata com liquidação por voucher. Nenhuma informação de preço é enviada para CityPASS. |
Promotions Sync | ❌ |
As promoções não se aplicam aos passes de CityPASS. As suas promoções Ventrata não se aplicam às reservas feitas através da leitura de um passe. |
Bookings Sync | ✅ |
As reservas são criadas na Ventrata quando um passe é lido. As reservas são criadas no momento da leitura, sem data definida, com quantidade 1 (um bilhete por código de barras) e com o código de barras como referência do revendedor. Não existe nenhuma chamada de cancelamento para CityPASS. No modo diferido, um estado de bilhete cancelado ou no-show pode ser reencaminhado para CityPASS na chamada Use. |
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 CityPASS. Predefinição: no momento da leitura, a Ventrata informa CityPASS de que o bilhete está REDEEMED (chamada Use). Redeem on undefer / no-show é suportado. A Ventrata envia a chamada Use mais tarde, com REDEEMED ou com o estado do bilhete Ventrata em maiúsculas, por exemplo, NOSHOW ou CANCELLED. O estado do bilhete (REDEEMED ou, no modo diferido, o estado do bilhete) e a data de utilização: a data/hora da reserva, se a equipa tiver escolhido uma, ou, caso contrário, o momento atual. Nenhum preço é enviado. |
Pass Walkup Scanning Sync | ✅ |
Lê os passes de CityPASS à sua entrada. Lê ou introduz um código de barras à sua entrada. Se o código de barras começar por 308458, a Ventrata trata-o como um bilhete de CityPASS e valida-o com a API de CityPASS. A Ventrata procura a linha de mapeamento correspondente à família de produtos, à atração e à classe de bilhete. Se ainda não estiver mapeado, a leitura falha até que o mapeie. |
Gift Card Sync | ❌ |
Não faz parte desta conexão. Os passes de CityPASS não são cartões-oferta Ventrata. |
✅ suportado · ❌ não suportado
Bom saber: limites desta conexão
Bom saber: limites desta conexão
Um bilhete por código de barras.
Apenas são reconhecidos os códigos de barras que começam por 308458.
Sem recolhas, extras nem perguntas de reserva.
Sem sincronização de disponibilidade nem de preços.
Resolução de problemas
" is not mapped in <connection>"</b>
" is not mapped in <connection>"</b>
Esta família de produtos, atração e classe de bilhete de CityPASS ainda não está mapeada para um produto Ventrata. Mapeie a linha na conexão com CityPASS para um produto, uma opção e uma unidade.
"Redemption not allowed"
"Redemption not allowed"
"Pass expired, cancelled, or already used"
"Pass expired, cancelled, or already used"
"Texto da própria mensagem de CityPASS"
"Texto da própria mensagem de CityPASS"
CityPASS rejeitou o bilhete por outro motivo; a Ventrata apresenta a mensagem tal como foi recebida.
📚 Mais sobre as conexões Ventrata
Informações do parceiro
City Pass, Inc.
ID de parceiro Ventrata: 41927759-10fb-4011-9315-aa4ece876c67