Get Mappings (Ventrata → Viator, quando abre a conexão no Dashboard) – a Ventrata acede automaticamente à sua conta Viator e obtém a lista de todos os produtos e opções da conta, incluindo o respetivo estado e as definições de conectividade. A Ventrata consegue fazê-lo porque a convidou como o seu sistema de reservas no passo 1.

Update Mappings (Ventrata → Viator, quando prime Update Connection Mapping) – a Ventrata acede ao produto correspondente na sua conta Viator, verifica configurações básicas como as categorias de bilhete, remove qualquer disponibilidade, preço e promoção (ofertas especiais/descontos) configurados anteriormente e atualiza o mapeamento nas definições de conectividade de acordo com a sua seleção. Associa a opção de Viator escolhida à sua opção Ventrata e aplica a definição de sincronização de preços do produto.

Mapping catalog (POST /v2/mappings/catalog) e Mapping connect (POST /v2/mappings/connect) (Ventrata → Viator, aproximadamente a cada hora) – a Ventrata lê os seus produtos e opções de Viator com o respetivo estado de mapeamento (Mapped, Unmapped ou Paused) e envia os seus mapeamentos para Viator. Estas são as APIs de mapeamento de produtos de Viator.

Tour List (POST /tourlist) (Viator → Ventrata) – Viator obtém a lista de produtos e opções disponíveis na conexão, com os respetivos identificadores Ventrata. Viator apresenta-os no separador Product Connection do Viator Management Center, que é a lista a partir da qual escolhe quando mapeia em Viator (método 2). A Ventrata responde com OCTO Get Products (GET /products).

Pricing Categories (via Calendar, Viator → Ventrata) – além disso, Viator obtém os detalhes das unidades do seu produto (tipos de bilhete) e dos respetivos preços, e atualiza-os em conformidade.

Viator volta a ler a sua lista de produtos com Tour List algumas vezes por dia, por conexão.

A verificação de mapeamentos da Ventrata é executada aproximadamente a cada hora. Lê o catálogo de mapeamentos de Viator aproximadamente a cada 30 minutos.

A Ventrata só lê e grava os seus produtos de Viator a partir do Dashboard quando abre ou atualiza a conexão.

Calendar (POST /v2/availability/calendar) (Viator → Ventrata) – Viator pede uma ou mais opções de produto para um intervalo de datas. A Ventrata responde com cada data ou hora de início reservável, o respetivo estado, a capacidade restante por tipo de bilhete, o prazo limite de reserva e os preços. Viator utiliza esta informação para preencher o calendário na página do seu produto. A Ventrata responde com OCTO Availability Check (POST /availability).

Availability Check (POST /v2/availability/check) (Viator → Ventrata) – quando um cliente escolhe um produto, uma data e uma combinação de viajantes, Viator verifica a capacidade e o preço em tempo real para essa escolha exata, e volta a fazê-lo à medida que o cliente avança no checkout. A Ventrata responde com OCTO Availability Check.

Event Notification (POST https://api.viator.com/v2/notification/events) (Ventrata → Viator, sempre que a disponibilidade muda na Ventrata, por exemplo, após uma reserva, um cancelamento ou uma alteração de capacidade ou de tarifa) – a Ventrata informa Viator sobre que opções de produto e que datas mudaram, e de que forma: um horário esgotou ou voltou a abrir (AVAILABILITY), a capacidade restante mudou (CAPACITY) ou o preço mudou (PRICING). Em seguida, Viator volta a ler essas datas. Viator trata primeiro as atualizações AVAILABILITY e PRICING.

Verificação na reserva – quando um cliente começa a pagar, a chamada Reserve de Viator faz com que a Ventrata volte a verificar a capacidade antes de bloquear os lugares. Assim, Viator não pode reservar em excesso um horário que acabou de esgotar.

Calendar: constante 24 horas por dia, o que indica uma sincronização agendada em segundo plano, e não pesquisas de clientes em tempo real.

Availability Check: 24 horas por dia, com mais atividade nas horas de maior procura, porque acompanha a navegação dos clientes.

Event Notification: a Ventrata envia estas notificações 24 horas por dia, à medida que ocorrem alterações na Ventrata.

Um pequeno número de produtos mais antigos ainda utiliza a chamada antiga Real-time Availability (v1.0) de Viator.

Não foi possível medir com quanta antecedência Viator lê os dados com Calendar, porque as datas seguem no corpo do pedido.

Calendar e Availability Check (Viator → Ventrata) – cada data ou hora de início é devolvida com um preço por tipo de bilhete (por exemplo, Adult ou Child) na sua moeda. A API de Viator suporta preços por pessoa, preços por pessoa por escalões e preços por unidade (por exemplo, por carro, barco ou grupo).

Preços de revendedor – os preços provêm dos preços do revendedor Viator na Ventrata (venda ao público, grossista/comissão), que a conexão herda. A API de Viator também pode transmitir um preço líquido por tipo de bilhete. Viator utiliza-o para operadores com um acordo de preço líquido.

Event Notification (PRICING, Ventrata → Viator) – quando o preço de venda ao público de um tipo de bilhete muda, incluindo novas ofertas especiais ou descontos, a Ventrata informa Viator, e Viator volta a ler o preço.

Reserve (Viator → Ventrata) – o bloqueio mantém o preço, além dos lugares, para que o cliente pague o preço que lhe foi apresentado.

Categorias de preço – Viator suporta bebé, criança, jovem, adulto e sénior. Utiliza Traveler quando não existe restrição de idade. As categorias têm de abranger as idades dos 0 aos 99 anos, sem lacunas nem sobreposições.

Os preços são devolvidos com cada Calendar e Availability Check, pelo que Viator os obtém com a mesma frequência com que lê a disponibilidade.

Calendar e Availability Check (Viator → Ventrata) – quando uma promoção se aplica a uma data, a Ventrata devolve o preço de venda ao público com desconto juntamente com o preço de venda ao público original e o ID da oferta especial.

Special Offers (POST /v2/product/special-offers) (Viator → Ventrata) – Viator pede os detalhes dessas ofertas, como o nome, o tipo e as datas de validade da oferta. A Ventrata responde com base nas suas promoções Ventrata. Viator utiliza esta informação para apresentar uma etiqueta de oferta especial nas datas com desconto. A etiqueta não altera o preço de venda ao público recomendado.

Mapeamento a partir do Dashboard – quando atualiza um mapeamento, a Ventrata remove as ofertas especiais/descontos previamente configurados nesse produto de Viator, para que as suas ofertas venham da Ventrata.

Viator chama Special Offers 24 horas por dia, apenas para fornecedores cujos produtos tenham promoções.

Normalmente, a Ventrata não envia chamadas Special Offers Notification. Viator obtém as ofertas através de Calendar e Special Offers.

Cada reserva começa com Reserve, seguida de Booking. Existem mais bloqueios do que reservas confirmadas. É normal: os bloqueios de clientes que não concluem o pagamento simplesmente expiram.

As alterações e os cancelamentos chegam ao longo do dia.

Viator só lhe envia um email quando uma reserva, alteração ou cancelamento via API falha (o mecanismo alternativo de Viator). As chamadas API bem-sucedidas não geram um email.

Redemption (POST /redemption) (Viator → Ventrata) – Viator pede o estado de resgate de uma reserva confirmada e de cada viajante nela incluído. A Ventrata encontra a reserva pela respetiva referência com OCTO List Bookings (GET /bookings) e responde se os bilhetes foram resgatados. Viator utiliza a resposta para decidir se um cancelamento ou reembolso deve ser permitido.

Viator verifica o estado de resgate ao longo do dia, com muito mais frequência do que envia cancelamentos.

A Ventrata não envia atualizações de resgate para Viator por iniciativa própria.

Booking (Viator → Ventrata) – se a caixa de recolha no hotel estiver ativada para o seu produto em Viator, o cliente escolhe o hotel na lista pendente de Viator, e Viator envia-o no campo de ponto de recolha da reserva. Se, em vez disso, obter os dados de recolha no campo de requisitos especiais de Viator, estes chegam nesse campo.

Booking Amendment (Viator → Ventrata) – as alterações aos dados do hotel chegam como uma alteração da reserva.

Os dados de recolha só chegam com as reservas e as alterações. A API de Viator não tem nenhuma chamada para ler os seus pontos de recolha Ventrata nem um campo de largada separado.

Booking (Viator → Ventrata) – as informações que o cliente introduz durante o processo de reserva de Viator, como os dados do voo e do navio de cruzeiro, são enviadas nos campos de pergunta e resposta da reserva.

Contacto do cliente – Viator nunca partilha o endereço de email real do cliente. Envia o número de telefone, se o cliente o fornecer.

As perguntas são configuradas do lado de Viator. A API de Viator não tem nenhuma chamada para ler as suas perguntas de reserva Ventrata.