CityPASS gere um programa de afiliados e de trade turístico em torno do seu passe multiatrações, que reúne, a um preço fixo com desconto, a entrada em atrações conhecidas de 17 grandes cidades dos Estados Unidos e do Canadá, vendido desde 1997. O programa alarga esse inventário a editores, agentes de viagens, operadores turísticos, hotéis e organizações de marketing de destinos através de links de afiliado rastreados e contas de trade, colocando a venda de passes à frente de visitantes que já estão a planear uma viagem a uma cidade, desde viajantes individuais a famílias e grupos.
Ligar CityPASS à Ventrata permite-lhe revender produtos de operadores que utilizam CityPASS como sistema de reservas. A Ventrata lê a disponibilidade em tempo real a partir de CityPASS, e cada reserva que recebe é criada diretamente na conta do operador em CityPASS.
Para saber mais sobre CityPASS, visite citypass.com.
📒 NOTA
Pretende, em vez disso, digitalizar e resgatar bilhetes de CityPASS na sua própria entrada? Consulte CityPASS: conexão de revendedor.
📗 DICA
Faça uma reserva de teste depois do mapeamento e peça a CityPASS Affiliates & Travel Trade que confirme que esta chegou ao respetivo sistema.
Website principal | |
Etiquetas | Custom / Proprietary Operator System |
Funcionalidades da conexão | Availability Sync · Bookings Sync |
Desenvolvido por | Ventrata (através da CityPASS API) |
Esta conexão de operador (também chamada backend) permite-lhe revender produtos de operadores que utilizam CityPASS como sistema de reservas principal, com cada reserva criada diretamente em CityPASS. As funcionalidades desta conexão incluem:
Availability Sync – a disponibilidade em tempo real vem da conta do operador em CityPASS.
Bookings Sync – as reservas são enviadas da Ventrata para CityPASS, e CityPASS emite os bilhetes ou vouchers.
A API externa de CityPASS utilizada nesta conexão é uma API personalizada que não segue o padrão OCTO API, o que pode limitar certas funcionalidades e capacidades.
Criar a conexão com CityPASS
🔐 Permissões de função necessárias: See Operators, Modify Operators, See Products, Modify Products
Antes de começar:
Tem de ter um acordo comercial com o operador relativo às respetivas tarifas e condições.
Tem de ter o CityPASS User e a CityPASS Password do operador. Veja os passos abaixo.
Tem de recriar os produtos do operador na Ventrata. Veja como criar produtos. A conexão sincroniza a disponibilidade, os preços e as reservas, mas não cria produtos na Ventrata.
Passo 1: configurar o operador na Ventrata
Contacte CityPASS Affiliates & Travel Trade e peça autorização para revender os respetivos produtos através da Ventrata.
No Ventrata Dashboard, aceda a Products → Operators e abra o operador. Se ainda não existir, crie-o primeiro como operador.
Na secção Backend Partner, selecione CityPASS e introduza o CityPASS User e a CityPASS Password.
Introduza as credenciais fornecidas por CityPASS Affiliates & Travel Trade na secção Backend Partner.
Clique em Update Operator.
Passo 2: conecte cada produto
Abra o produto do operador em Products → Products e edite-o. Verifique se Operator está definido como este operador.
Marque Backend Connected. Marque Backend Availability para utilizar a disponibilidade de CityPASS.
Clique em Update Product.
Marque Backend Connected. Marque também Backend Availability para obter a disponibilidade e Backend Pricing para obter os preços. Sem estas opções, o produto utiliza a disponibilidade e os preços definidos na Ventrata, mas continua a enviar as reservas para CityPASS.
Mapear produtos para CityPASS
‼️ IMPORTANTE
O mapeamento indica à Ventrata o produto, a opção e as unidades de CityPASS cuja disponibilidade deve consultar e que deve reservar. Se um produto ligado ao backend não estiver corretamente mapeado, as respetivas reservas falham. Um destaque a vermelho em toda a linha do produto indica um produto mal mapeado.
No Ventrata Dashboard, aceda a Products → Products e abra o produto.
Abra o separador Mappings. Este aparece quando o produto está definido como Backend Connected.
Para cada opção e unidade Ventrata, selecione o produto, a opção e as unidades correspondentes de CityPASS nas listas pendentes, que a Ventrata carrega a partir de CityPASS. Não deixe nenhum campo vazio.
Clique em Save Changes.
📗 DICA
Faça uma reserva de teste depois do mapeamento e peça ao operador que confirme que esta chegou à sua conta em CityPASS.
Gerir a conexão com CityPASS
Atualize o mapeamento quando o operador alterar produtos, opções ou unidades em CityPASS.
Substitua a chave no operador se CityPASS ou o operador emitirem uma nova.
Desative Backend Availability ou Backend Pricing num produto para utilizar a disponibilidade ou os preços da própria Ventrata. As reservas continuam a ser enviadas para CityPASS.
Funcionalidades da conexão em detalhe
Esta secção destina-se a quem quer saber exatamente como funciona a conexão com CityPASS. Aqui, o sentido é o inverso de uma conexão de revendedor: é a Ventrata que chama CityPASS, através da API de CityPASS. Para cada funcionalidade, explica que chamadas a Ventrata faz, quando as faz e o que isso significa para si.
Em resumo: a Ventrata pede a CityPASS a disponibilidade sempre que alguém consulta um produto ligado ao backend, e cria cada reserva na conta do operador em CityPASS. CityPASS não envia alterações de volta para a Ventrata.
Os prazos são os habituais para CityPASS, estão arredondados e podem mudar.
Product Mapping | ✅ |
No Ventrata Dashboard, cada produto, opção e unidade Ventrata é mapeado para o produto do operador em CityPASS. Funciona da seguinte forma:
O que isto significa para si: se faltar algo na lista pendente, o operador não o disponibilizou para si em CityPASS. Peça-lhe que o faça. |
Content Sync | ❌ |
A Ventrata não importa o conteúdo dos produtos de CityPASS. A Ventrata não importa o conteúdo dos produtos de CityPASS. É o próprio utilizador que cria e descreve os produtos na Ventrata. |
Availability Sync | ✅ |
Com Backend Availability ativado, a Ventrata consulta a disponibilidade do operador em tempo real em CityPASS. Funciona da seguinte forma:
O que isto significa para si: os clientes reservam com base na disponibilidade do operador em tempo real em CityPASS, pelo que não pode vender em excesso um horário que o operador já vendeu noutro lado. |
Pricing Sync | ❌ |
A Ventrata não lê os preços de CityPASS. A Ventrata não lê os preços de CityPASS. Os produtos utilizam os preços que definiu na Ventrata, e as reservas continuam a ser enviadas para CityPASS. |
Promotions Sync | ❌ |
As promoções não são enviadas para CityPASS. As promoções não são enviadas para CityPASS. As suas promoções Ventrata continuam a aplicar-se ao preço que o seu cliente paga na Ventrata. |
Bookings Sync | ✅ |
As reservas feitas na Ventrata para um produto ligado ao backend são criadas na conta do operador em CityPASS. Funciona da seguinte forma:
Envia reservas, atualizações e cancelamentos da Ventrata para CityPASS.
‼️ IMPORTANTE – As reservas são sincronizadas num só sentido, da Ventrata para CityPASS. Se o operador alterar ou cancelar uma reserva em CityPASS, a Ventrata não é notificada. Peça ao operador que o informe de quaisquer alterações que faça. |
Pickups/Dropoff Sync | ❌ |
Os dados de recolha e largada não são transmitidos a CityPASS. Os dados de recolha e largada não são transmitidos a CityPASS. Partilhe-os com o operador por outra via se um produto precisar deles. |
Custom Questions Sync | ❌ |
As respostas às suas perguntas de reserva não são transmitidas a CityPASS. As respostas às suas perguntas de reserva não são transmitidas a CityPASS. Partilhe-as com o operador por outra via se este precisar delas. |
Extras Sync | ❌ |
Os extras e complementos não são reservados em CityPASS. Os extras e complementos não são reservados em CityPASS. Apenas o produto, a opção e as unidades principais o são. |
Redemption Sync | ❌ |
Os resgates e outras alterações de estado em CityPASS não são enviados de volta para a Ventrata depois de uma reserva ser confirmada. Os resgates e outras alterações de estado em CityPASS não são enviados de volta para a Ventrata depois de uma reserva ser confirmada. |
Pass Walkup Scanning Sync | ❌ |
A digitalização de passes sem reserva (walk-up) não está disponível com CityPASS. A digitalização de passes sem reserva (walk-up) não está disponível com CityPASS. |
Gift Card Sync | ❌ |
Os cartões-oferta Ventrata não são transmitidos a CityPASS. Os cartões-oferta Ventrata não são transmitidos a CityPASS. Os pagamentos com cartão-oferta ficam na Ventrata. |
✅ suportado · ❌ não suportado
Bom saber: limites e detalhes da conexão com CityPASS
Bom saber: limites e detalhes da conexão com CityPASS
Disponibilidade em tempo real: a disponibilidade vem de CityPASS à medida que as pessoas navegam.
Reservas num só sentido: as alterações que o operador faz em CityPASS não chegam à Ventrata.
API personalizada: a API de CityPASS não é OCTO, pelo que algumas funcionalidades podem ser limitadas em comparação com os backends OCTO.
CityPASS é um fornecedor de passes multiatrações que abrange dezassete grandes cidades dos Estados Unidos e do Canadá; o seu programa de afiliados e de trade turístico alarga o inventário a editores, agentes, operadores turísticos, hotéis e organizações de marketing de destinos.
Perguntas frequentes
Recebo um erro quando guardo a configuração do backend do operador.
Recebo um erro quando guardo a configuração do backend do operador.
O mais provável é que o CityPASS User e a CityPASS Password ou o endpoint estejam incorretos. Confirme-os com o seu operador. Se o problema persistir, contacte o nosso Suporte técnico.
Não existe a caixa Backend Connected nas definições do produto.
Não existe a caixa Backend Connected nas definições do produto.
O mais provável é que o operador definido no produto não tenha um backend configurado. Verifique as definições de Backend Partner do operador e tente novamente. Se o problema persistir, contacte o nosso Suporte técnico.
O produto, a opção ou a unidade que pretendo mapear não aparece na lista pendente.
O produto, a opção ou a unidade que pretendo mapear não aparece na lista pendente.
As listas pendentes mostram o que o operador disponibilizou para si em CityPASS. Fale com o operador. Se o problema persistir, contacte o nosso Suporte técnico.
As reservas de um produto ligado ao backend falham.
As reservas de um produto ligado ao backend falham.
Verifique primeiro o mapeamento do produto: todas as opções e unidades têm de estar mapeadas. Depois, verifique se o horário ainda está disponível em CityPASS. Se o problema persistir, contacte o nosso Suporte técnico.
Recebo um erro ao guardar a configuração do backend do operador.
Recebo um erro ao guardar a configuração do backend do operador.
O mais provável é que as credenciais estejam incorretas. Confirme-as com CityPASS Affiliates & Travel Trade. Se o problema persistir, contacte o Suporte técnico.
Não existe a caixa de verificação Backend Connected nas definições do produto.
Não existe a caixa de verificação Backend Connected nas definições do produto.
O mais provável é que o operador selecionado no produto não tenha nenhum backend configurado. Verifique a configuração do backend do operador e tente novamente.
Recursos úteis
📚 Mais sobre as conexões Ventrata
Informações do parceiro
City Pass, Inc.
ID de parceiro Ventrata: 433aac31-5f98-4ad2-908e-6bc068366e02