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

Volta a ler cada produto aproximadamente a cada 2 horas.

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

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 Picniq não pode fazer overbooking num horário que acabou de esgotar, mesmo que a disponibilidade que tem guardada esteja ligeiramente desatualizada.

Availability Check: Picniq 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 aproximadamente a cada 30 minutos.

Availability Batch: Picniq 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 estão distribuídas de forma uniforme ao longo do dia, o que aponta para uma sincronização agendada em segundo plano e não para pesquisas de clientes em tempo real.

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

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

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

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

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