Smartvisit cria passes digitais de cidade e de destino, reunindo atrações, tours, restauração e compras em produtos baseados numa app, com resgate sem bilhete e itinerários áudio geolocalizados, para organizações de marketing de destinos, hotéis e programas de fidelização. Para os operadores, traz viajantes que já pagaram antecipadamente um pacote de destino e escolhem os locais na app quando chegam à cidade: visitas adicionais encaminhadas pelos próprios canais do emissor do passe, sendo as atrações e os tours o conteúdo principal.

Ligar Smartvisit à Ventrata sincroniza a sua disponibilidade e os seus preços e entrega reservas, alterações e cancelamentos, com bilhetes emitidos automaticamente.

Para saber mais sobre uma parceria com Smartvisit, visite smartvisit.com.

📒 NOTA

Pretende antes revender produtos de operadores que utilizam Smartvisit? Consulte Smartvisit: backend de operador.

Website principal	smartvisit.com
Etiquetas	Multi-Attraction Pass
Mercados de destino	🌎 Global
Mercados emissores	🌎 Global
Especialidades	Passes digitais de destino pré-pagos
Funcionalidades da conexão	Availability Sync · Bookings Sync
GMV reservado via Ventrata (últimos 12 meses)	US$10k+
Fornecedores com reservas via Ventrata (últimos 12 meses)	5+
Desenvolvido por	Smartvisit (através da API OCTO da Ventrata)

Esta conexão de revendedor permite-lhe vender os seus produtos através de Smartvisit sem gerir manualmente a disponibilidade e as reservas. As funcionalidades desta conexão incluem:

Availability Sync – Smartvisit consulta a sua disponibilidade em tempo real na Ventrata.
Bookings Sync – as reservas, atualizações e cancelamentos de Smartvisit são criados instantaneamente na Ventrata, e os clientes recebem bilhetes Ventrata.

Criar a conexão com Smartvisit

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

Antes de começar:

Tem de ter um acordo comercial com Smartvisit para que vendam os seus produtos. Para se informar sobre uma parceria, contacte-os através de smartvisit.com.
Tem de criar Smartvisit como Reseller na Ventrata, com os respetivos preços (venda ao público, por grosso/comissão) corretamente definidos. Tenha em atenção que esta conexão API exige que o revendedor esteja configurado com o método de liquidação "Bill to my account".

No Ventrata Dashboard, aceda a Connections → Connections, clique em + New Connection e selecione Smartvisit na lista de parceiros.
Selecione o Reseller Smartvisit na lista dos seus revendedores (tem de ser criado antes de criar a conexão). A conexão herda a configuração do revendedor, como preços, destinos permitidos, produtos, etc.
(Opcional) Também pode definir um Name à sua escolha para a conexão, o que pode ser útil se planear ter várias conexões com Smartvisit e quiser distingui-las mais facilmente no futuro.
Clique no botão Create Octo Connection.

📗 DICA

Se necessário, também pode permitir ou excluir produtos ou destinos ao nível da conexão, além do que configurou no revendedor.

Mapear produtos para Smartvisit

Partilhe de forma segura a chave API OCTO apresentada na conexão que criou com o seu contacto em Smartvisit e peça-lhe que mapeie os seus produtos através da API OCTO da Ventrata, com os preços (octo/pricing) ativados. Normalmente, a equipa de Smartvisit não demora mais do que alguns dias úteis a concluir este passo.

A sua configuração na Ventrata está concluída. Não precisa de dar mais nenhum passo.

📗 DICA

Smartvisit pode aceder a todos os produtos ativados na conexão, mas também pode indicar os IDs de produto e de opção apresentados na página da conexão quando os contactar, para especificar o que deve ser mapeado.

Gerir a conexão com Smartvisit

Permitir ou excluir produtos: limite os destinos, produtos e opções a que Smartvisit pode aceder. Veja como permitir ou excluir produtos.
Mude o nome da conexão para distinguir várias conexões com Smartvisit.

Funcionalidades da conexão em detalhe

Esta secção destina-se a quem quer saber exatamente como funciona a conexão com Smartvisit: que chamadas à API OCTO da Ventrata Smartvisit faz, quando as faz e o que isso significa para si. Cada chamada tem uma ligação para a documentação da API da Ventrata.

Em resumo: Smartvisit obtém da Ventrata tudo aquilo de que precisa. Lê os seus produtos, consulta a sua disponibilidade (e os seus preços, quando os pede) e envia reservas e cancelamentos. A Ventrata não envia alterações para Smartvisit, pelo que tudo o que alterar na Ventrata chega a Smartvisit na consulta seguinte.

Os tempos indicados são os habituais para Smartvisit e estão arredondados, podendo mudar se Smartvisit alterar a forma como sincroniza.

Product Mapping	❌	Não é possível mapear produtos a partir da Ventrata. Smartvisit mapeia-os do seu lado, através do seu gestor de conta ou do portal de Smartvisit. Funciona da seguinte forma: Get Products (`GET /products`) – quando Smartvisit configura a sua conexão, e sempre que atualiza os seus anúncios, lê todos os produtos ativados na conexão, com as respetivas opções e unidades (tipos de bilhete, como Adulto ou Criança). Get Product (`GET /products/{productId}`) – Smartvisit volta a ler um único produto para obter alterações às suas opções, unidades, prazos limite de reserva e definições. Mapeamento do lado de Smartvisit – Smartvisit associa cada opção e unidade da Ventrata ao seu próprio anúncio e aos seus tipos de bilhete. O seu gestor de conta em Smartvisit faz isto por si, ou pode fazê-lo no portal de Smartvisit, se Smartvisit disponibilizar um. Só precisa de partilhar a chave API da conexão. O que isto significa para si: Smartvisit só pode vender o que tiver mapeado. Quando adiciona um produto, opção ou unidade na Ventrata, Smartvisit pode vê-lo na atualização seguinte, mas não o venderá enquanto não estiver mapeado. Por isso, informe o seu gestor de conta em Smartvisit sempre que adicionar um.
Content Sync	❌	Smartvisit não lê o conteúdo dos seus produtos a partir da Ventrata. Smartvisit utiliza as descrições, imagens e outros conteúdos configurados do seu próprio lado, por isso atualize o seu conteúdo diretamente com Smartvisit.
Availability Sync	✅	Smartvisit consulta a sua disponibilidade em tempo real na Ventrata. A Ventrata não envia alterações de disponibilidade para Smartvisit. Funciona da seguinte forma: Availability Check (`POST /availability`) – Smartvisit envia um produto, uma opção e uma data ou intervalo de datas. A Ventrata responde com cada dia ou horário reservável, o respetivo estado (`AVAILABLE`, `LIMITED`, `SOLD_OUT`, `CLOSED` ou `FREESALE`), as vagas restantes, o prazo limite de reserva e um `availabilityId`, de que Smartvisit precisa para reservar esse horário. Verificação no momento da reserva – quando um cliente reserva, a Ventrata volta a verificar a capacidade antes de criar a reserva, pelo que Smartvisit não pode fazer overbooking num horário que acabou de esgotar, mesmo que a disponibilidade que tem guardada esteja ligeiramente desatualizada. Normalmente, com Smartvisit: Availability Check: Smartvisit verifica os seus produtos ao longo do dia e volta a verificar o mesmo produto e as mesmas datas aproximadamente a cada 8 horas. O que isto significa para si: quando fecha uma data, altera a capacidade ou esgota na Ventrata, Smartvisit apresenta a alteração após a sua próxima verificação. Para as datas que verifica regularmente, isso acontece em cerca de 8 horas. As datas mais distantes são normalmente verificadas com menos frequência.
Pricing Sync	❌	Smartvisit não obtém os seus preços a partir da Ventrata. Os preços em Smartvisit são geridos do lado de Smartvisit, pelo que deve mantê-los atualizados diretamente com Smartvisit.
Promotions Sync	❌	As suas promoções Ventrata não se aplicam em Smartvisit. Os preços em Smartvisit não incluem as promoções que cria na Ventrata. Configure quaisquer promoções diretamente com Smartvisit.
Bookings Sync	✅	As reservas e os cancelamentos feitos em Smartvisit são criados instantaneamente na Ventrata, e os clientes recebem bilhetes Ventrata. Funciona da seguinte forma: Retenção: Booking Reservation (`POST /bookings`) – quando um cliente inicia o checkout em Smartvisit, Smartvisit envia o produto, a opção, o horário escolhido (`availabilityId`) e um item de unidade por pessoa. A Ventrata volta a verificar a capacidade e cria uma reserva `ON_HOLD`, que retém os lugares enquanto o cliente paga. Se já não houver lugar, a Ventrata rejeita a retenção. Confirmação: Booking Confirmation (`POST /bookings/{uuid}/confirm`) – assim que o pagamento é aprovado, Smartvisit confirma a retenção, com a sua própria referência de reserva e os dados de contacto do cliente. A reserva passa a `CONFIRMED` na Ventrata, e a Ventrata devolve a sua referência de reserva e os bilhetes (um por pessoa) ou um voucher (um por reserva), consoante a configuração do seu produto, cada um com um código QR e uma ligação para PDF. Smartvisit entrega-os ao cliente, que os apresenta à sua entrada como qualquer bilhete Ventrata. Expiração: se o cliente não concluir o pagamento, Smartvisit nunca confirma, e a retenção expira por si só e liberta os lugares. Cancelamento: Booking Cancellation (`POST /bookings/{uuid}/cancel`) – quando um cliente cancela em Smartvisit, Smartvisit cancela a reserva na Ventrata. A Ventrata só aceita o cancelamento se a reserva ainda puder ser cancelada e o prazo limite de cancelamento da opção não tiver passado. Caso contrário, rejeita o pedido e Smartvisit terá de o contactar. Alteração: Smartvisit não utiliza Booking Update (`PATCH /bookings/{uuid}`), pelo que uma alteração chega muito provavelmente à Ventrata como um cancelamento seguido de uma nova reserva. Normalmente, com Smartvisit: Smartvisit não define um tempo de retenção, pelo que se aplica o tempo de retenção predefinido. Uma reserva típica em Smartvisit é para cerca de 2 pessoas. Smartvisit também verifica as reservas que efetuou, com Get Booking (`GET /bookings/{uuid}`) de poucos em poucos minutos, por exemplo, para reconciliar os seus registos. ‼️ IMPORTANTE – As reservas são sincronizadas num só sentido, de Smartvisit para a Ventrata. Se cancelar, alterar ou voltar a reservar uma reserva de Smartvisit na Ventrata, por exemplo no Dashboard, Smartvisit não recebe qualquer notificação. Contacte Smartvisit para que a reserva seja também cancelada ou alterada do lado de Smartvisit, ou peça ao cliente que cancele através de Smartvisit.
Pickups/Dropoff Sync	❌	Smartvisit não envia dados de recolha ou largada com as suas reservas. Se os seus produtos incluírem recolhas, confirme com Smartvisit como recolhe os dados de recolha, ou combine-os com o cliente.
Custom Questions Sync	✅ / ❌	Smartvisit envia as respostas às suas perguntas de reserva com as reservas. Funciona da seguinte forma: Capability `octo/questions` – Smartvisit lê as perguntas definidas nos seus produtos e envia as respostas do cliente com a reserva, que pode consultar na Ventrata. Normalmente, com Smartvisit: Smartvisit envia as respostas às suas perguntas de reserva.
Extras Sync	❌	Não é possível reservar extras e complementos através de Smartvisit. Em Smartvisit, os clientes só podem reservar os seus produtos e opções principais. Venda os extras separadamente, por exemplo à chegada.
Redemption Sync	❌	Os resgates não são comunicados a Smartvisit. A Ventrata não notifica Smartvisit quando um bilhete é digitalizado ou resgatado. Smartvisit só vê um resgate se voltar a ler a reserva a partir da Ventrata.
Pass Walkup Scanning Sync	❌	Os passes de Smartvisit não podem ser digitalizados à sua entrada sem uma reserva. Os clientes de Smartvisit precisam de uma reserva feita através de Smartvisit antes da visita.
Gift Card Sync	❌	Os cartões-oferta Ventrata não podem ser vendidos nem resgatados através de Smartvisit. Os cartões-oferta comprados na Ventrata não podem ser utilizados em Smartvisit, e Smartvisit não pode vender cartões-oferta Ventrata.

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

Bom saber: limites e detalhes da conexão com Smartvisit

Atrasos: a disponibilidade e os preços só chegam a Smartvisit no momento em que são consultados, pelo que há sempre um pequeno atraso depois de alterar algo na Ventrata.
Prazo limite de cancelamento: Smartvisit só pode cancelar através da API antes do prazo limite de cancelamento da sua opção. Os cancelamentos posteriores têm de ser acordados consigo.
O que Smartvisit pode ver: apenas os destinos, produtos e opções permitidos no revendedor e na conexão, e ativados para venda na fonte Direct API. Veja como permitir ou excluir produtos.
Bilhetes: Smartvisit emite os bilhetes ou o voucher Ventrata que recebe na confirmação, pelo que a digitalização e o resgate habituais funcionam normalmente.
Reservas de teste: Smartvisit pode enviar reservas de teste enquanto configura a conexão. As reservas de teste não consomem a sua disponibilidade e não são faturadas.

Perguntas frequentes

Não são apresentados produtos na página da conexão.

Verifique que destinos, produtos e opções estão permitidos no seu revendedor e na conexão. Em seguida, confirme que os seus produtos e opções estão ativados para venda na fonte Direct API. Se o problema persistir, contacte o nosso Suporte técnico.

Os meus produtos Ventrata utilizam tarifas Booking Size e os preços não estão a funcionar corretamente em Smartvisit.

Após cada alteração de tarifa, atualize o mapeamento do produto para garantir que as contagens de escalões do parceiro estão sincronizadas com a Ventrata. Certifique-se de que a tarifa está ativada para venda através de Direct API.

📚 Mais sobre as conexões Ventrata

Informações do parceiro

Smartvisit International Pty Ltd

PO Box 553, Kiama Downs, NSW

Austrália

smartvisit.com

ID de parceiro Ventrata: 8403fed5-cc6c-4dcb-9a84-6169d04f7ef4

Smartvisit: conexão de revendedor