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

City Sightseeing Worldwide lê a sua lista completa de produtos aproximadamente a cada 11 horas.

Volta a ler cada produto aproximadamente a cada 9 horas.

Capability octo/content – quando City Sightseeing Worldwide 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 City Sightseeing Worldwide na atualização de produtos seguinte.

City Sightseeing Worldwide pede octo/content.

Availability Check (POST /availability) – City Sightseeing Worldwide 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 City Sightseeing Worldwide 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 City Sightseeing Worldwide não pode fazer overbooking num horário que acabou de esgotar, mesmo que a disponibilidade que tem guardada esteja ligeiramente desatualizada.

Availability Check: City Sightseeing Worldwide verifica os seus produtos ao longo do dia, normalmente a partir de 10 dias de antecedência e abrangendo um único dia por pedido, consulta até cerca de um ano de antecedência e volta a verificar o mesmo produto e as mesmas datas aproximadamente a cada 4 horas.

Availability Calendar: City Sightseeing Worldwide verifica cada produto cerca de uma vez por dia.

As consultas distribuem-se ao longo do dia sem um pico acentuado, o que sugere uma combinação de sincronizações agendadas e pesquisas de clientes em tempo real.

Capability octo/pricing – City Sightseeing Worldwide 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 City Sightseeing Worldwide, ambos a partir dos preços do revendedor na Ventrata (venda ao público e por grosso/comissão).

Preços de grupo – quando City Sightseeing Worldwide 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.

City Sightseeing Worldwide não costuma pedir octo/pricing, pelo que muito provavelmente utiliza preços guardados do seu lado, que teria de manter atualizados manualmente com City Sightseeing Worldwide.

City Sightseeing Worldwide retém os lugares durante cerca de 60 minutos enquanto o cliente paga (expirationMinutes).

Uma reserva típica em City Sightseeing Worldwide é para cerca de 2 pessoas.

É normal ver mais retenções do que reservas confirmadas: as retenções de clientes que não concluem o pagamento simplesmente expiram.