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

Gray Line Worldwide lê a sua lista completa de produtos cerca de 6 em 6 horas.

Volta a ler cada produto cerca de uma vez por dia.

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

Gray Line Worldwide pede octo/content.

Availability Check (POST /availability) – Gray Line 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 Gray Line Worldwide precisa para reservar esse horário.

Verificação no momento da reserva – quando um cliente reserva, a Ventrata volta a verificar a capacidade antes de criar a reserva, pelo que Gray Line 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: Gray Line Worldwide consulta cada produto cerca de 2 em 2 horas, normalmente a partir de cerca de 10 meses de antecedência e abrangendo 30 dias por pedido, e consulta até cerca de um ano de antecedência.

As consultas são mais frequentes entre as 05:00 e as 11:00 UTC, o que sugere que a maioria das consultas é feita em tempo real, à medida que os clientes navegam em Gray Line Worldwide.

Capability octo/pricing – Gray Line 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 Gray Line 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 Gray Line 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.

Gray Line 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 Gray Line Worldwide.

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

Uma reserva típica em Gray Line Worldwide é para cerca de 2 pessoas.