Ir para conteúdo principal

Conexão Inntopia Commerce

Ligue Inntopia Commerce à Ventrata para vender os seus produtos no motor de reservas de carrinho único de um resort, a par do alojamento. O pagamento é cobrado por Inntopia.

Inntopia Commerce

 

Inntopia Commerce é um motor de reservas de carrinho único para destinos de montanha e resorts, que permite a um hóspede reservar alojamento, forfaits, atividades, restauração e spa a partir de sistemas subjacentes distintos numa única transação. Sediado em Stowe, no Vermont, e parte da Outside Inc., Inntopia serve estâncias de esqui, propriedades de golfe e praia, parques aquáticos e organizações de destino, sobretudo na América do Norte. É uma de duas conexões Inntopia; a outra é Inntopia Marketing Cloud.

 

Ligar Inntopia Commerce à Ventrata permite que um resort ou destino que utilize Inntopia Commerce venda os seus produtos Ventrata no respetivo motor de reservas, a par do seu alojamento e de outro inventário de viagem.

 

Para saber mais sobre Inntopia Commerce, visite corp.inntopia.com/commerce.

 

Website principal

Etiquetas

Custom Checkout

Desenvolvido por

Inntopia (através da API OCTO da Ventrata)

 

Esta conexão de aplicação liga a sua conta Ventrata a Inntopia Commerce para que os resorts possam vender as suas atividades e atrações na mesma compra que uma estadia. As funcionalidades desta conexão incluem:

  • Sincroniza o seu conteúdo, disponibilidade e preços – para o carrinho de Inntopia.

  • Vende a par do alojamento – e de outro inventário numa única transação do hóspede.

  • Envia reservas para a Ventrata – novas reservas, modificações e cancelamentos.

  • Entrega bilhetes – os vouchers ou bilhetes são emitidos pela Ventrata para o hóspede através de Inntopia.

 

‼️ IMPORTANTE

Esta é uma conexão em modo checkout, e não uma conexão de revendedor. O hóspede conclui toda a compra no carrinho de Inntopia. A Ventrata continua a ser a fonte de verdade para disponibilidade, preços e ofertas, e o pagamento é cobrado pelo gateway de pagamento gerido de Inntopia e registado na Ventrata como pagamento externo. Por isso, a configuração difere da de uma conexão de revendedor padrão.

 

‼️ IMPORTANTE

As permissões de função necessárias vão além das habituais: See Checkouts, Modify Checkouts, See Connections, Modify Connections.

 

‼️ IMPORTANTE

Inntopia Commerce irá tratar os dados pessoais dos seus clientes. Reveja a sua política de privacidade e os seus termos antes de estabelecer a conexão.

 

Criar a conexão com Inntopia Commerce

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

Antes de começar:

  • Tem de ter um acordo comercial em vigor com Inntopia para utilizar as respetivas soluções. Para começar, contacte-os através de [email protected].

  • Tem de decidir como é tratado o pagamento. Inntopia Commerce liquida normalmente as reservas com o método de gateway externo: o cartão é cobrado do lado de Inntopia e a transação é registada na reserva na Ventrata como gateway externo.

 

  1. No Ventrata Dashboard, aceda a Connections → Connections, clique em + New Connection e selecione Inntopia Commerce na lista de parceiros.

  2. Crie um novo Checkout dedicado a esta conexão API. Não integre este Checkout no seu próprio website. Inntopia carrega-o no seu carrinho para recolher as seleções de produto, opção, disponibilidade e unidade.

  3. A menos que tenha acordado separadamente processar o pagamento através do seu próprio gateway Ventrata, confirme que o Checkout utiliza o método de pagamento por cartão External Gateway.

  4. Na lista de allowed hosts desse Checkout, adicione todos os domínios a partir dos quais Inntopia vai carregar o widget. Os pedidos de qualquer domínio que não esteja na lista devolvem HOSTNAME_NOT_ALLOWED, por isso, antes de testar, peça ao seu contacto em Inntopia a lista completa dos seus domínios de staging e de produção.

  5. Ao criar a conexão, selecione Inntopia Commerce na lista de parceiros e depois selecione o Checkout que criou.

  6. Opcional: permita/exclua produtos ou destinos na conexão para expor apenas o inventário abrangido pelo seu acordo.

  7. (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 Inntopia Commerce e quiser distingui-las mais facilmente no futuro.

  8. 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, para limitar aquilo a que Inntopia Commerce pode aceder.

 

Partilhar o acesso com Inntopia Commerce

Partilhe de forma segura a chave API OCTO apresentada na conexão que criou com o seu contacto em Inntopia para concluir a configuração.

 

A sua configuração na Ventrata está concluída. Pode revogar o acesso a qualquer momento, desativando a conexão.

 

Gerir a conexão com Inntopia Commerce

  • Revogue o acesso desativando a conexão.

  • Permitir ou excluir produtos: limite os destinos, produtos e opções a que Inntopia Commerce pode aceder. Veja como permitir ou excluir produtos.

  • Mude o nome da conexão para distinguir várias conexões com Inntopia Commerce.

 

Como funcionam o pagamento e o Checkout

O hóspede conclui toda a compra no carrinho de Inntopia. A Ventrata continua a ser a fonte de verdade para disponibilidade, preços e ofertas. O pagamento é cobrado pelo gateway de pagamento gerido de Inntopia e registado na Ventrata como pagamento externo, associado à reserva como gateway externo.

O Checkout dedicado é carregado por Inntopia no seu carrinho para recolher as seleções de produto, opção, disponibilidade e unidade. Não pode ser integrado no seu próprio website.

 

Funcionalidades da conexão em detalhe

Esta secção destina-se a quem pretende saber exatamente como funciona a conexão com Inntopia Commerce: o que Inntopia Commerce faz com os seus dados da Ventrata e que chamadas à Ventrata OCTO API efetua.

 

Lê produtos

✅

Inntopia Commerce lê os produtos ativados na conexão.

Funciona da seguinte forma:

  • Get Product (GET /products/{productId}) – Inntopia Commerce volta a ler um único produto para obter as alterações.

 

Normalmente, com Inntopia Commerce: fá-lo ao longo do dia.

Consulta a disponibilidade

✅

Inntopia Commerce verifica a disponibilidade dos produtos ativados na conexão.

Funciona da seguinte forma:

  • Availability Check (POST /availability) – Inntopia Commerce envia um produto, uma opção e datas, e a Ventrata responde com cada dia ou horário reservável e o respetivo estado.

 

Normalmente, com Inntopia Commerce: fá-lo ao longo do dia.

Sincroniza conteúdo, disponibilidade e preços

✅

Os seus produtos, disponibilidade e preços vão para o carrinho de Inntopia.

O conteúdo, a disponibilidade, os preços e as ofertas vêm da Ventrata.

A Ventrata continua a ser a fonte de verdade.

 

Funciona da seguinte forma:

  • Capability octo/pricing – Inntopia Commerce pede os preços adicionando-a ao cabeçalho Octo-Capabilities dos seus pedidos. Sem ela, a Ventrata envia a disponibilidade sem preços.

 

Normalmente, com Inntopia Commerce: fá-lo ao longo do dia.

 

O que isto significa para si: os resorts vendem o que realmente tem disponível.

Recebe reservas

✅

As novas reservas, modificações e cancelamentos de Inntopia chegam à Ventrata.

O hóspede compra no carrinho de Inntopia.

As alterações e os cancelamentos são enviados para a Ventrata.

 

Funciona da seguinte forma:

  • Get Booking (GET /bookings/{uuid}) – Inntopia Commerce lê uma única reserva para obter os detalhes e o estado mais recentes.

  • Get Order (GET /orders/{id}) – Inntopia Commerce lê a encomenda a que uma reserva pertence.

 

Normalmente, com Inntopia Commerce: fá-lo de vez em quando.

 

O que isto significa para si: as encomendas aparecem como reservas normais.

Cria e altera reservas

✅

Inntopia Commerce cria ou altera reservas na Ventrata.

Funciona da seguinte forma:

  • Booking Reservation (POST /bookings) – Inntopia Commerce bloqueia lugares para uma reserva.

  • Booking Confirmation (POST /bookings/{uuid}/confirm) – Inntopia Commerce confirma a reserva, e a Ventrata devolve a sua referência de reserva e os bilhetes.

  • Booking Update (PATCH /bookings/{uuid}) – Inntopia Commerce altera uma reserva.

  • Booking Cancellation (POST /bookings/{uuid}/cancel) – Inntopia Commerce cancela uma reserva. A Ventrata só o aceita antes do prazo limite de cancelamento.

Emite bilhetes

✅

Os vouchers ou bilhetes são emitidos pela Ventrata para o hóspede através de Inntopia.

A emissão de bilhetes passa pela Ventrata.

Cobra o pagamento do lado de Inntopia

✅

O gateway de pagamento gerido de Inntopia cobra o hóspede.

O pagamento é registado na Ventrata como pagamento externo, registado como gateway externo.

 

O que isto significa para si: não processa este pagamento através da Ventrata, salvo acordo em contrário.

✅ suportado

 

Perguntas frequentes

Inntopia Commerce não aparece na lista quando crio uma nova conexão.

Esta integração é ativada por conta. Contacte [email protected] para pedir acesso.

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

Verifique que destinos, produtos e opções estão permitidos ou excluídos na conexão. Se isso não resolver, verifique se os seus produtos e opções estão disponibilizados para venda na fonte Direct API. Se o problema persistir, contacte a nossa equipa de suporte.

Vejo HOSTNAME_NOT_ALLOWED quando o widget de Inntopia carrega.

O domínio que carrega o widget não está na lista de allowed hosts do Checkout. Obtenha junto do seu contacto em Inntopia todos os domínios de staging e de produção e peça que sejam adicionados.

O hóspede foi cobrado, mas não aparece nenhuma reserva na Ventrata.

A encomenda não foi confirmada na Ventrata depois de o pagamento ter sido cobrado do lado de Inntopia. Peça ao seu contacto em Inntopia o x-request-id do pedido de confirmação para que o possamos rastrear e contacte a nossa equipa de suporte.

 

Recursos úteis

 

 

Informações do parceiro

Sterling Valley Systems, Inc.

PO Box 309, Stowe, VT 05672, United States

 

ID de parceiro Ventrata: 46209491-a755-4039-9370-8c92c0cdbafc

Isto respondeu à sua pergunta?