Get Mappings (através da API GraphQL do Supplier Portal de GetYourGuide) – quando abre a conexão ou clica em Refresh Mapping, a Ventrata inicia sessão na sua conta GetYourGuide como o utilizador Operations que adicionou no passo 2 e lê todos os seus produtos e opções de GetYourGuide, com o respetivo estado atual e as definições de conectividade. GetYourGuide não publica documentação para esta API; a ligação mostra o conceito equivalente de mapeamento autónomo na API OCTO da Ventrata.

Update Mappings (através da API GraphQL do Supplier Portal de GetYourGuide) – quando prime Update Connection Mapping, a Ventrata abre o produto correspondente na sua conta GetYourGuide. Verifica as definições básicas (como as categorias de bilhete), limpa a disponibilidade, os preços e as promoções existentes e grava o mapeamento nas definições de conectividade da opção. Também desativa os add-ons da opção e sincroniza de imediato os seus deals para esse produto (consulte Promotions Sync).

Product Details (GET /1/products/{productId}) – quando é introduzido um External Product ID para o primeiro produto que mapeia, GetYourGuide pede à Ventrata os respetivos dados básicos, incluindo o seu Ventrata API Supplier ID (= Connection ID/Key).

Products List (GET /1/suppliers/{supplierId}/products/) – com este ID, GetYourGuide obtém a lista de produtos disponíveis na conexão, com os respetivos External Product IDs, e apresenta-os numa lista pendente para facilitar o mapeamento de outros produtos. A Ventrata cria a lista com OCTO Get Products (GET /products), pelo que contém apenas os produtos ativados na conexão.

Pricing Categories (GET /1/products/{productId}/pricing-categories/) – GetYourGuide importa as unidades do seu produto como as suas categorias de preço. A Ventrata lê-as com OCTO Get Product (GET /products/{productId}).

Availability Query (GET /1/get-availabilities/) – GetYourGuide verifica se existem pelo menos 2 horários ou dias disponíveis nos próximos 365 dias, se as categorias de preço (unidades) devolvidas correspondem às configuradas ou importadas em GetYourGuide e se os preços são válidos (por exemplo, sem discrepância de moeda).

Reservation (POST /1/reserve/) – GetYourGuide faz algumas reservas de teste (reservas pendentes), normalmente para o número mínimo e máximo de participantes permitidos em cada categoria de preço (tipo de unidade).

Reservation Cancellation (POST /1/cancel-reservation/) – em seguida, GetYourGuide cancela (liberta) estas reservas de teste.

As chamadas de mapeamento só ocorrem quando alguém abre ou edita uma conexão, pelo que surgem em pequenos picos e não de forma agendada.

A Ventrata inicia sessão na sua conta GetYourGuide (incluindo o início de sessão em dois passos de GetYourGuide) sempre que lê ou guarda os seus mapeamentos.

GetYourGuide só chama Product Details, Products List e Pricing Categories enquanto alguém está a mapear no respetivo Supplier Portal.

Availability Query (GET /1/get-availabilities/, GetYourGuide → Ventrata) – GetYourGuide pede um produto e um intervalo de datas. A Ventrata responde com cada dia ou horário disponível, as vagas restantes, a hora limite de reserva e os preços, e GetYourGuide guarda esta informação em cache no seu sistema. Nos bastidores, o adaptador consulta o seu mapeamento e chama OCTO Availability Check (POST /availability). GetYourGuide volta a sincronizar com uma frequência predefinida, que pode variar em função de vários fatores:

Notify Availability Update (POST /1/notify-availability-update, Ventrata → GetYourGuide) – quando a sua disponibilidade muda devido a novas reservas na Ventrata, ou a alterações específicas de data/hora (não alterações em massa), a Ventrata envia a GetYourGuide as vagas (e os preços) atualizadas desse horário. A Ventrata envia de imediato para os horários que começam nos próximos 90 dias e têm 10 ou menos lugares disponíveis, incluindo os horários esgotados. As outras alterações chegam a GetYourGuide na sua próxima sincronização agendada.

Reservation (POST /1/reserve/, GetYourGuide → Ventrata) – quando um cliente adiciona o seu produto ao carrinho em GetYourGuide, a Ventrata volta a verificar se ainda existe capacidade suficiente e, caso contrário, rejeita a reserva provisória. Assim, GetYourGuide não pode reservar em excesso um horário, mesmo que a disponibilidade em cache esteja ligeiramente desatualizada.

Availability Query: 24 horas por dia e bastante constante, com ligeiros picos durante o dia. Em média, cada produto mapeado é verificado de poucos em poucos minutos.

Cerca de metade dos pedidos dizem respeito a datas no próximo mês. Os restantes vão mais longe, até quase um ano de antecedência.

A maioria dos pedidos diz respeito a um único dia; os pedidos mais longos abrangem normalmente cerca de uma semana.

As datas pedidas incluem um desvio de fuso horário, pelo que o fuso horário do seu produto é importante.

Notify Availability Update: enviado 24 horas por dia, poucos instantes após a alteração que o desencadeou. Os envios surgem em picos que acompanham a atividade de reservas e as suas próprias alterações.

Pricing Categories (GET /1/products/{productId}/pricing-categories/, GetYourGuide → Ventrata) – durante o mapeamento, GetYourGuide obtém os detalhes das unidades do seu produto e atualiza-os (importa-os) como as suas categorias de preço.

Availability Query (GET /1/get-availabilities/, GetYourGuide → Ventrata) – GetYourGuide chama regularmente a Ventrata para voltar a sincronizar o preço de venda ao público de cada categoria de bilhete e guarda-o em cache, com a mesma periodicidade da disponibilidade. Os preços provêm dos preços do revendedor GetYourGuide na Ventrata, através do Availability Check OCTO.

Notify Availability Update (POST /1/notify-availability-update, Ventrata → GetYourGuide) – quando a sua disponibilidade muda devido a novas reservas na Ventrata, a tarifas ou a alterações específicas de data/hora (não alterações em massa), a Ventrata envia os preços de venda ao público atualizados para GetYourGuide.

Booking (POST /1/book/, GetYourGuide → Ventrata) – cada reserva inclui o preço de venda ao público que GetYourGuide utilizou.

Booking Size Fares – a Ventrata e GetYourGuide calculam de forma diferente as estruturas de escalões com várias unidades, pelo que apenas uma unidade mapeada por produto pode utilizar preços dinâmicos por escalões. Quaisquer tarifas adicionais continuam a ser permitidas e funcionam, mas mantêm preços estáticos. Veja um exemplo em que a unidade Adult tem os preços por escalões ativados, enquanto as unidades Child e Infant se mantêm estáticas:

Não existe uma chamada de preços separada: os preços seguem com cada resposta de disponibilidade e cada envio.

GetYourGuide só chama Pricing Categories enquanto um produto está a ser mapeado.

List Deals (GET /1/deals), Delete a deal (DELETE /1/deals/{dealId}) e Create a Deal (POST /1/deals), Ventrata → GetYourGuide – para os produtos que mapeia a partir do Ventrata Dashboard (e não do portal de GetYourGuide), a Ventrata lê as suas ofertas especiais de GetYourGuide e verifica se correspondem às promoções públicas permitidas para o seu revendedor GetYourGuide. Fá-lo a cada 60 minutos. Se algo não corresponder, a Ventrata elimina todas as ofertas especiais e volta a criá-las de acordo com o Ventrata Dashboard. GetYourGuide não tem nenhuma chamada para editar um deal, pelo que cada alteração corresponde a uma eliminação seguida de um novo deal.

Quando guarda um mapeamento no Ventrata Dashboard, a Ventrata também sincroniza de imediato os deals desse produto.

Atualmente, GetYourGuide só suporta promoções públicas básicas aplicáveis a todas as unidades com configurações proporcionais. As outras promoções não são sincronizadas.

A verificação de deals é executada 24 horas por dia, em ciclos horários, e logo após alterações de mapeamento.

As eliminações e recriações são frequentes, porque qualquer diferença reconstrói os deals do produto.

Starts at

Ends at

Days Before

Notice Days

Redeemable Day

As quatro chamadas chegam 24 horas por dia, à medida que os clientes fazem compras, com picos durante o dia.

Existem mais bloqueios do que reservas. É normal: GetYourGuide liberta de imediato quase todos os bloqueios que não se tornam reservas, em vez de os deixar expirar.

Cada alteração de reserva aparece na Ventrata como uma nova reserva mais uma reserva cancelada com a mesma referência.

Se uma chamada de reserva falhar ou exceder o tempo limite, GetYourGuide tenta novamente até 10 vezes, a cada 10 minutos (consulte as novas tentativas de reserva de GetYourGuide), pelo que uma reserva pode ocasionalmente chegar um pouco depois de o cliente ter pago.

Ticket Redemption by Booking Reference (POST /1/redeem-booking, Ventrata → GetYourGuide) – assim que qualquer um dos bilhetes de uma reserva é resgatado (mesmo que a reserva só esteja parcialmente resgatada), a Ventrata envia uma notificação de resgate da reserva para GetYourGuide. Isto pode ajudar a evitar cancelamentos e reembolsos de reservas resgatadas. No entanto, sabe-se que, atualmente, GetYourGuide cancela reservas independentemente da notificação recebida.

A Ventrata comunica os resgates por reserva. A chamada de resgate por bilhete de GetYourGuide não é utilizada.

A Ventrata verifica cada atualização de uma reserva de GetYourGuide e só envia uma notificação quando a atualização inclui um resgate.

As notificações acompanham as suas leituras: são enviadas 24 horas por dia, mas sobretudo durante o dia, quando os visitantes chegam.

Crie uma lista de locais de recolha para cada um dos seus produtos/opções no GetYourGuide Supplier Portal. Atualmente, GetYourGuide não os consegue obter da Ventrata, pelo que tem de os gerir manualmente no portal de GetYourGuide.

Booking (POST /1/book/, GetYourGuide → Ventrata) – GetYourGuide envia à Ventrata o local de recolha (o hotel do viajante) com o pedido de confirmação da reserva, se tal se aplicar ao seu produto. Através da Google Maps Places API, a Ventrata faz a correspondência com o ponto de recolha mais próximo que oferece e guarda também a localização exata no campo Hotel da reserva.

Os dados de recolha só chegam com a chamada Booking. GetYourGuide nunca pede à Ventrata os seus pontos de recolha.

Mapeamento no portal de GetYourGuide: quando configura ou mapeia um produto no portal de GetYourGuide, defina a opção Allow Add-ons como No. Defini-la como Yes faz com que GetYourGuide peça dados de add-ons à API (Fetch Addons, GET /1/products/{productId}/addons/), que a Ventrata rejeita, o que provoca falhas na conexão.

Mapeamento no Ventrata Dashboard: os produtos mapeados diretamente a partir do Ventrata Dashboard ficam automaticamente com os add-ons desativados durante a configuração.