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

WeKnow lê a sua lista completa de produtos aproximadamente a cada 10 horas.

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

WeKnow pede octo/content.

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

Availability Check: WeKnow verifica os seus produtos ao longo do dia, sobretudo uma data de cada vez, consulta até cerca de 2 meses de antecedência e volta a verificar o mesmo produto e as mesmas datas aproximadamente a cada 12 horas.

Availability Calendar: WeKnow verifica os seus produtos ao longo do dia, normalmente a partir de hoje e abrangendo cerca de 2 meses por pedido, consulta até cerca de 3 meses de antecedência e volta a verificar o mesmo produto e as mesmas datas aproximadamente a cada 10 horas.

As verificações concentram-se entre as 08:00 e as 14:00 UTC, o que sugere que a maioria é feita em tempo real, enquanto os clientes navegam em WeKnow.

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

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

WeKnow pede octo/pricing em todas as suas consultas de disponibilidade, pelo que vende aos seus preços da Ventrata.

WeKnow não envia o número de pessoas por tipo de unidade, pelo que os preços são devolvidos por pessoa e os preços de grupo, como as tarifas Booking Size, podem não ser apresentados corretamente em WeKnow.

Capability octo/offers: com ela, a Ventrata aplica as suas promoções elegíveis aos preços de disponibilidade e às reservas, e WeKnow também pode enviar um código promocional (offerCode).

As promoções funcionam em conjunto com os preços, pelo que também precisam de octo/pricing.

Isto abrange as promoções que cria na Ventrata (promoções iniciadas pelo fornecedor).

WeKnow pede octo/offers.

WeKnow não define um tempo de retenção, pelo que se aplica o tempo de retenção predefinido.

Uma reserva típica em WeKnow é 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.

Capability octo/pickups – WeKnow pode ver que opções oferecem recolha e quais os respetivos pontos de recolha, e envia com a reserva o ponto de recolha ou o hotel do cliente.

Se um hotel não corresponder a um dos seus pontos de recolha, a Ventrata guarda-o com a reserva para que possa organizar a recolha.

WeKnow envia os dados de recolha com as suas reservas.