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

Civitatis lê a sua lista completa de produtos cerca de uma vez por dia.

Volta a ler cada produto aproximadamente a cada 30 minutos.

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

Civitatis pede octo/content.

Availability Check (POST /availability) – Civitatis 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 Civitatis 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.

Availability Batch (POST /availability/batch): disponibilidade de vários produtos num único pedido, concebida para sincronizações em segundo plano.

Verificação no momento da reserva – quando um cliente reserva, a Ventrata volta a verificar a capacidade antes de criar a reserva, pelo que Civitatis não pode fazer overbooking num horário que acabou de esgotar, mesmo que a disponibilidade que tem guardada esteja ligeiramente desatualizada.

Availability Check: Civitatis verifica os seus produtos ao longo do dia, normalmente a partir de 44 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: Civitatis verifica cada produto aproximadamente a cada 12 horas.

Availability Batch: Civitatis consulta os seus produtos 24 horas por dia, normalmente a partir de hoje e abrangendo cerca de um ano por pedido, consulta até cerca de um ano de antecedência e volta a consultar o mesmo produto e as mesmas datas de poucos em poucos minutos.

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

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

Civitatis pede octo/pricing apenas em parte das suas consultas de disponibilidade, pelo que nem todos os anúncios poderão utilizar os seus preços da Ventrata.

Civitatis envia o número de pessoas por tipo de unidade, para que os preços de grupo sejam calculados com base na reserva efetiva.

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

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

Civitatis também verifica as reservas que efetuou, com Get Booking (GET /bookings/{uuid}) aproximadamente a cada 9 horas, por exemplo, para reconciliar os seus registos.

Capability octo/pickups – Civitatis 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.

Civitatis envia os dados de recolha com as suas reservas.

Capability octo/questions – Civitatis lê as perguntas definidas nos seus produtos e envia as respostas do cliente com a reserva, que pode consultar na Ventrata.

Civitatis normalmente não envia as respostas às perguntas de reserva. Se depender delas, por exemplo, para nomes ou necessidades alimentares, confirme com Civitatis como as recolhe.