Ir para conteúdo principal

Il Mio Viaggio a New York: conexão de revendedor

Ligue Il Mio Viaggio a New York à Ventrata para sincronizar a disponibilidade e os preços e receber reservas de imediato. Viajantes de língua italiana com destino a Nova Iorque.

Il Mio Viaggio a New York logo

 

Il Mio Viaggio a New York é um operador turístico e revendedor de língua italiana sediado em Midtown Manhattan, que realiza os seus próprios tours guiados por Manhattan, Brooklyn e Harlem e revende bilhetes para atrações, lugares na Broadway, passes urbanos e excursões de um dia. Para os operadores, traz viajantes italianos a Nova Iorque que planeiam na sua própria língua antes da partida e compram entradas, passes e excursões de um dia em torno de uma estadia na cidade.

 

Ligar Il Mio Viaggio a New York à Ventrata sincroniza a sua disponibilidade e os seus preços e entrega as reservas, alterações e cancelamentos, com os bilhetes emitidos automaticamente.

 

Para saber mais sobre uma parceria com Il Mio Viaggio a New York, visite ilmioviaggioanewyork.com.

 

Website principal

Etiquetas

Operator Reselling Others

Mercados de destino

🌎 Global

Mercados emissores

🌎 Global

Especialidades

Viajantes de língua italiana com destino a Nova Iorque

Funcionalidades da conexão

Availability Sync · Pricing Sync · Bookings Sync

GMV reservado via Ventrata (últimos 12 meses)

US$10k+

Desenvolvido por

Il Mio Viaggio a New York (através da API OCTO da Ventrata)

 

Esta conexão de revendedor permite-lhe vender os seus produtos através de Il Mio Viaggio a New York sem gerir manualmente a disponibilidade, os preços e as reservas. As funcionalidades desta conexão incluem:

  • Availability Sync – Il Mio Viaggio a New York consulta a sua disponibilidade em tempo real na Ventrata.

  • Pricing Sync – Il Mio Viaggio a New York obtém os seus preços a partir dos preços do revendedor na Ventrata.

  • Bookings Sync – as reservas, atualizações e cancelamentos de Il Mio Viaggio a New York são criados instantaneamente na Ventrata, e os clientes recebem bilhetes Ventrata.

 

Criar a conexão com Il Mio Viaggio a New York

🔐 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 Il Mio Viaggio a New York para que vendam os seus produtos. Para se informar sobre uma parceria, contacte-os através de ilmioviaggioanewyork.com.

  • Tem de criar Il Mio Viaggio a New York 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".

 

  1. No Ventrata Dashboard, aceda a Connections → Connections, clique em + New Connection e selecione Il Mio Viaggio a New York na lista de parceiros.

  2. Selecione o Reseller Il Mio Viaggio a New York 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.

  3. (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 Il Mio Viaggio a New York e quiser distingui-las mais facilmente no futuro.

  4. 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 Il Mio Viaggio a New York

Partilhe de forma segura a chave API OCTO apresentada na conexão que criou com o seu contacto em Il Mio Viaggio a New York 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 Il Mio Viaggio a New York 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

Il Mio Viaggio a New York 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 Il Mio Viaggio a New York

  • Permitir ou excluir produtos: limite os destinos, produtos e opções a que Il Mio Viaggio a New York pode aceder. Veja como permitir ou excluir produtos.

  • Mude o nome da conexão para distinguir várias conexões com Il Mio Viaggio a New York.

 

Funcionalidades da conexão em detalhe

Esta secção destina-se a quem quer saber exatamente como funciona a conexão com Il Mio Viaggio a New York: que chamadas à API OCTO da Ventrata Il Mio Viaggio a New York 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: Il Mio Viaggio a New York obtém da Ventrata tudo aquilo de que precisa. Lê os seus produtos, consulta a sua disponibilidade e os seus preços e envia reservas e cancelamentos. A Ventrata não envia alterações para Il Mio Viaggio a New York, pelo que tudo o que alterar na Ventrata chega a Il Mio Viaggio a New York na consulta seguinte.

 

Os tempos indicados são os habituais para Il Mio Viaggio a New York e estão arredondados, podendo mudar se Il Mio Viaggio a New York alterar a forma como sincroniza.

 

Product Mapping

❌

Não é possível mapear produtos a partir da Ventrata. Il Mio Viaggio a New York mapeia-os do seu lado, através do seu gestor de conta ou do portal de Il Mio Viaggio a New York.

Funciona da seguinte forma:

  • Get Products (GET /products) – quando Il Mio Viaggio a New York 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}) – Il Mio Viaggio a New York 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 Il Mio Viaggio a New York – Il Mio Viaggio a New York 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 Il Mio Viaggio a New York faz isto por si, ou pode fazê-lo no portal de Il Mio Viaggio a New York, se Il Mio Viaggio a New York disponibilizar um. Só precisa de partilhar a chave API da conexão.

 

Normalmente, com Il Mio Viaggio a New York:

  • Volta a ler cada produto aproximadamente a cada 8 horas.

 

O que isto significa para si: Il Mio Viaggio a New York só pode vender o que tiver mapeado. Quando adiciona um produto, opção ou unidade na Ventrata, Il Mio Viaggio a New York 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 Il Mio Viaggio a New York sempre que adicionar um.

Content Sync

✅ / ❌

Il Mio Viaggio a New York pode ler o conteúdo dos seus produtos, como descrições e imagens, a partir da Ventrata.

Funciona da seguinte forma:

  • Capability octo/content – quando Il Mio Viaggio a New York a adiciona ao cabeçalho Octo-Capabilities, Get Products (GET /products) e Get Product (GET /products/{productId}) devolvem também o conteúdo dos seus produtos, como descrições, destaques, inclusões e imagens.

  • As alterações de conteúdo na Ventrata chegam a Il Mio Viaggio a New York na atualização de produtos seguinte.

 

Normalmente, com Il Mio Viaggio a New York:

  • Il Mio Viaggio a New York pede octo/content.

Availability Sync

✅

Il Mio Viaggio a New York consulta a sua disponibilidade em tempo real na Ventrata. A Ventrata não envia alterações de disponibilidade para Il Mio Viaggio a New York.

Funciona da seguinte forma:

  • Availability Check (POST /availability) – Il Mio Viaggio a New York 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 Il Mio Viaggio a New York precisa para reservar esse horário.

  • Availability Calendar (POST /availability/calendar) – devolve um resumo por dia em vez de cada horário, normalmente para mostrar que datas estão abertas num seletor de datas.

  • Verificação no momento da reserva – quando um cliente reserva, a Ventrata volta a verificar a capacidade antes de criar a reserva, pelo que Il Mio Viaggio a New York não pode fazer overbooking num horário que acabou de esgotar, mesmo que a disponibilidade que tem guardada esteja ligeiramente desatualizada.

 

Normalmente, com Il Mio Viaggio a New York:

  • Availability Check: Il Mio Viaggio a New York verifica os seus produtos ao longo do dia, normalmente a partir de 16 dias de antecedência e abrangendo 31 dias por pedido, consulta até cerca de 9 meses de antecedência e volta a verificar o mesmo produto e as mesmas datas aproximadamente a cada hora.

  • Availability Calendar: Il Mio Viaggio a New York verifica os seus produtos 24 horas por dia, normalmente a partir de hoje e abrangendo cerca de um ano por pedido, consulta até cerca de um ano de antecedência e volta a verificar o mesmo produto e as mesmas datas de poucos em poucos minutos.

  • As consultas estão distribuídas de forma uniforme ao longo do dia, o que aponta para uma sincronização agendada em segundo plano e não para pesquisas de clientes em tempo real.

 

O que isto significa para si: quando fecha uma data, altera a capacidade ou um horário esgota na Ventrata, Il Mio Viaggio a New York mostra-o após a consulta seguinte. Para as datas que consulta regularmente, isso acontece em poucos minutos. As datas mais distantes são normalmente consultadas com menos frequência.

Pricing Sync

✅

Os seus preços são devolvidos em cada consulta de disponibilidade, desde que Il Mio Viaggio a New York os peça com a capability octo/pricing.

Funciona da seguinte forma:

  • Capability octo/pricing – Il Mio Viaggio a New York pede preços adicionando octo/pricing ao cabeçalho Octo-Capabilities dos seus pedidos. Sem ela, a Ventrata envia a disponibilidade sem quaisquer preços.

  • Availability Check (POST /availability) – com os preços ativados, cada dia ou horário é devolvido com o seu preço por unidade (tipo de bilhete): o preço retail que o cliente paga e o preço net que fatura a Il Mio Viaggio a New York, ambos a partir dos preços do revendedor na Ventrata (venda ao público e por grosso/comissão).

  • Preços de grupo – quando Il Mio Viaggio a New York envia também quantas pessoas de cada tipo de unidade estão a reservar, a Ventrata calcula o preço desse grupo exato. Isto é importante para tarifas Booking Size e outros preços de grupo.

  • Booking Reservation (POST /bookings) e Booking Confirmation (POST /bookings/{uuid}/confirm) – a reserva é devolvida com o preço final de venda ao público e o preço líquido, pelo que a reserva na Ventrata regista sempre o preço a que foi vendida.

 

Normalmente, com Il Mio Viaggio a New York:

  • Il Mio Viaggio a New York pede octo/pricing em todas as suas consultas de disponibilidade, pelo que vende aos seus preços da Ventrata.

  • Il Mio Viaggio a New York envia o número de pessoas por tipo de unidade, para que os preços de grupo sejam calculados com base na reserva efetiva.

 

‼️ IMPORTANTE – Peça que os preços sejam ativados. Quando pedir a Il Mio Viaggio a New York que mapeie os seus produtos, peça também que ative os preços (octo/pricing), ou ative-os diretamente se fizer o mapeamento no portal de Il Mio Viaggio a New York. Caso contrário, os preços podem ficar desativados e Il Mio Viaggio a New York não receberá os seus preços da Ventrata.

📗 DICA – Se os preços em Il Mio Viaggio a New York parecerem errados, verifique primeiro os preços do revendedor Il Mio Viaggio a New York na Ventrata: é isso que Il Mio Viaggio a New York lê.

Promotions Sync

❌

As suas promoções Ventrata não se aplicam em Il Mio Viaggio a New York.

Os preços em Il Mio Viaggio a New York não incluem as promoções que cria na Ventrata. Configure quaisquer promoções diretamente com Il Mio Viaggio a New York.

Bookings Sync

✅

As reservas e os cancelamentos feitos em Il Mio Viaggio a New York são criados instantaneamente na Ventrata, e os clientes recebem bilhetes Ventrata.

Funciona da seguinte forma:

  1. Retenção: Booking Reservation (POST /bookings) – quando um cliente inicia o checkout em Il Mio Viaggio a New York, Il Mio Viaggio a New York 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.

  2. Confirmação: Booking Confirmation (POST /bookings/{uuid}/confirm) – assim que o pagamento é aprovado, Il Mio Viaggio a New York 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. Il Mio Viaggio a New York entrega-os ao cliente, que os apresenta à sua entrada como qualquer bilhete Ventrata.

  3. Expiração: se o cliente não concluir o pagamento, Il Mio Viaggio a New York nunca confirma, e a retenção expira por si só e liberta os lugares.

  4. Cancelamento: Booking Cancellation (POST /bookings/{uuid}/cancel) – quando um cliente cancela em Il Mio Viaggio a New York, Il Mio Viaggio a New York 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 Il Mio Viaggio a New York terá de o contactar.

  5. Alteração: Il Mio Viaggio a New York 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 Il Mio Viaggio a New York:

  • Il Mio Viaggio a New York não define um tempo de retenção, pelo que se aplica o tempo de retenção predefinido.

  • Uma reserva típica em Il Mio Viaggio a New York é para cerca de 5 pessoas.

  • Il Mio Viaggio a New York também verifica as reservas que efetuou, com Get Booking (GET /bookings/{uuid}) aproximadamente a cada 12 horas, por exemplo, para reconciliar os seus registos.

 

‼️ IMPORTANTE – As reservas são sincronizadas num só sentido, de Il Mio Viaggio a New York para a Ventrata. Se cancelar, alterar ou voltar a reservar uma reserva de Il Mio Viaggio a New York na Ventrata, por exemplo no Dashboard, Il Mio Viaggio a New York não recebe qualquer notificação. Contacte Il Mio Viaggio a New York para que a reserva seja também cancelada ou alterada do lado de Il Mio Viaggio a New York, ou peça ao cliente que cancele através de Il Mio Viaggio a New York.

Pickups/Dropoff Sync

❌

Il Mio Viaggio a New York não envia dados de recolha ou largada com as suas reservas.

Se os seus produtos incluírem recolhas, confirme com Il Mio Viaggio a New York como recolhe os dados de recolha, ou combine-os com o cliente.

Custom Questions Sync

❌

Il Mio Viaggio a New York não envia as respostas às suas perguntas de reserva.

Se depender de perguntas de reserva, por exemplo nomes ou necessidades alimentares, confirme com Il Mio Viaggio a New York como recolhe essa informação.

Extras Sync

❌

Não é possível reservar extras e complementos através de Il Mio Viaggio a New York.

Em Il Mio Viaggio a New York, 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 Il Mio Viaggio a New York.

A Ventrata não notifica Il Mio Viaggio a New York quando um bilhete é digitalizado ou resgatado. Il Mio Viaggio a New York só vê um resgate se voltar a ler a reserva a partir da Ventrata.

Pass Walkup Scanning Sync

❌

Os passes de Il Mio Viaggio a New York não podem ser digitalizados à sua entrada sem uma reserva.

Os clientes de Il Mio Viaggio a New York precisam de uma reserva feita através de Il Mio Viaggio a New York antes da visita.

Gift Card Sync

❌

Os cartões-oferta Ventrata não podem ser vendidos nem resgatados através de Il Mio Viaggio a New York.

Os cartões-oferta comprados na Ventrata não podem ser utilizados em Il Mio Viaggio a New York, e Il Mio Viaggio a New York não pode vender cartões-oferta Ventrata.

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

 

Bom saber: limites e detalhes da conexão com Il Mio Viaggio a New York

  • Atrasos: a disponibilidade e os preços só chegam a Il Mio Viaggio a New York no momento em que são consultados, pelo que há sempre um pequeno atraso depois de alterar algo na Ventrata.

  • Prazo limite de cancelamento: Il Mio Viaggio a New York 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 Il Mio Viaggio a New York 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: Il Mio Viaggio a New York 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: Il Mio Viaggio a New York 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 Il Mio Viaggio a New York.

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.

 

 

Informações do parceiro

Ilmioviaggio Inc.

235 W 56 St, Suite 21D, New York, NY 10019

United States

 

ID de parceiro Ventrata: 73dcb6e4-7e58-445f-9ec1-1f811049af94

Isto respondeu à sua pergunta?