Exchange Code For Tokens (POST /v2/oauth2/authorizations) – Ventrata → Airbnb, uma vez, quando clica em Connect with Airbnb e Allow. Airbnb dá à Ventrata acesso para gerir o calendário e as reservas das suas listagens de Airbnb. Os tokens de acesso de Airbnb têm uma duração curta, pelo que a Ventrata renova este acesso automaticamente em segundo plano (Refresh Access Token, mesmo caminho).

Get Activities (GET /v2/activities) e List all offerings (GET /v2/activities/{id}/offerings) – Ventrata → Airbnb, quando abre a página da conexão. A Ventrata lê as suas listagens de Airbnb e mostra-as à esquerda da tabela de mapeamento.

Set Attributes (PUT /v2/activities/{id}/attributes) – Ventrata → Airbnb, quando clica em Update Mapping. Depois de ler a listagem, a Ventrata envia os tipos de hóspede que a sua opção vende (Adulto, Criança, Bebé), os respetivos limites de idade a partir das suas unidades Ventrata e a idade mínima.

Set Activity Availability (PUT /v2/activities/{id}/availability) – Ventrata → Airbnb, em Update Mapping. A Ventrata ativa a sincronização da disponibilidade, o que torna a Ventrata a fonte de verdade da listagem e ativa as verificações em tempo real de Airbnb antes de cada reserva.

Set Offering (PUT /v2/activities/{id}/offerings/{id}) – Ventrata → Airbnb, em Update Mapping. A Ventrata guarda na oferta de Airbnb os IDs da sua conexão, do produto e da opção da Ventrata. Airbnb devolve estes IDs em cada verificação e reserva, e é assim que a Ventrata sabe que produto um hóspede está a reservar.

Set Offering Availability (PUT …/offerings/{id}/availability) e Set Offering Pricing (PUT …/offerings/{id}/pricing) – Ventrata → Airbnb, em Update Mapping. A Ventrata define os limites de grupo de toda a listagem, a antecedência de reserva e o tipo de reserva (por exemplo, uma reserva pública partilhada), para que a capacidade que a Ventrata envia por horário e a verificação em tempo real da Ventrata determinem o que pode ser reservado.

Set Instances (POST /v2/activities/{id}/instances) – Ventrata → Airbnb, no final de Update Mapping. A Ventrata cria os seus horários no calendário de Airbnb (consulte Availability Sync).

Atualizações de mapeamento em fila – algumas atualizações de mapeamento são executadas como tarefa em segundo plano, com os mesmos passos. A tarefa lê o seu produto através da API OCTO da Ventrata com Get Product (GET /products/{productId}).

As chamadas de mapeamento só acontecem quando alguém liga a conta, abre uma página de conexão ou clica em Update Mapping.

As renovações de acesso e as atualizações de mapeamento em fila são executadas em segundo plano a qualquer hora do dia ou da noite.

Get Instances (GET /v2/activities/{id}/instances) e Set Instances (POST /v2/activities/{id}/instances) – Ventrata → Airbnb, assim que a disponibilidade muda na Ventrata, por exemplo, após uma reserva em qualquer canal, um cancelamento ou uma alteração da capacidade ou do horário. A Ventrata lê os horários que Airbnb tem para as datas afetadas, compara-os com a Ventrata e envia apenas as diferenças num único lote: novos horários a criar, horários cujo limite de hóspedes (lugares restantes) ou preço mudou e horários a remover por já não estarem disponíveis.

Ventrata OCTO API – para calcular cada atualização, o adaptador da Ventrata lê o seu produto e a disponibilidade em tempo real através da própria API OCTO da Ventrata: Get Product (GET /products/{productId}) e Availability Check (POST /availability).

Ressincronização em segundo plano – Ventrata → Airbnb, a qualquer hora do dia ou da noite. Uma tarefa agendada percorre as listagens mapeadas, volta a comparar os horários de Airbnb com a Ventrata e corrige os que tenham divergido, enviando novamente apenas as diferenças. Algumas atualizações de disponibilidade também são colocadas em fila e enviadas como tarefa em segundo plano.

Check Availability (GET /airbnb/endpoint/reservation) – Airbnb → Ventrata, em tempo real, antes de um hóspede avançar para o checkout. Airbnb envia a listagem, os IDs de produto e opção da Ventrata guardados no mapeamento, a hora de início e o número de adultos, crianças e bebés. A Ventrata procura o produto com Get Product (GET /products/{productId}), verifica esse horário e esses tipos de hóspede em tempo real e responde sim ou não. Airbnb espera uma resposta no prazo de 2 segundos. Se a resposta for não, ou se a verificação falhar ou demorar demasiado, o hóspede não pode reservar e Airbnb remove esse horário do seu calendário.

Os envios de disponibilidade são executados a qualquer hora do dia ou da noite, acompanhando as reservas e as alterações que acontecem na Ventrata. Abrangem datas desde hoje até cerca de um ano à frente, a maioria para as próximas semanas.

A ressincronização em segundo plano é executada a qualquer hora do dia ou da noite.

As chamadas Check Availability chegam de forma uniforme a qualquer hora do dia ou da noite, sobretudo para datas nas próximas quatro semanas. Airbnb verifica com muito mais frequência do que os hóspedes reservam, pelo que a maioria das verificações não resulta numa reserva.

Set Offering Pricing (PUT /v2/activities/{id}/offerings/{id}/pricing) – Ventrata → Airbnb, em Update Mapping. A Ventrata define as configurações de preço da listagem, por exemplo, que é vendida como reserva pública partilhada.

Set Attributes (PUT /v2/activities/{id}/attributes) – Ventrata → Airbnb, em Update Mapping. A Ventrata envia os seus tipos de hóspede e intervalos de idade, para que Adulto, Criança e Bebé de Airbnb correspondam às suas unidades Ventrata.

Set Instances (POST /v2/activities/{id}/instances) – Ventrata → Airbnb, com as atualizações de disponibilidade. Quando o preço de um horário tem de ser atualizado, a Ventrata envia o preço de adulto, criança e bebé para esse horário, para que os preços específicos por data e hora definidos na Ventrata cheguem a Airbnb. Os preços provêm dos preços do revendedor Airbnb na Ventrata.

Tarifas Booking Size – as contagens por escalão do parceiro são sincronizadas quando clica em Update Mapping. Após cada alteração de tarifa, volte a atualizar o mapeamento do produto e certifique-se de que a tarifa está ativada para venda através da Direct API.

Os preços acompanham os envios de disponibilidade, a qualquer hora do dia ou da noite. A maioria dos envios altera apenas os lugares restantes; os preços são incluídos quando o preço de um horário tem de ser atualizado.

As configurações de preço de toda a listagem e os tipos de hóspede só são enviados em Update Mapping.

As reservas, alterações e cancelamentos chegam a qualquer hora do dia ou da noite, e cada um é tratado no momento em que acontece.

Cada nova reserva chega à Ventrata como uma chamada Make Reservation e como um webhook. A Ventrata faz a correspondência entre ambos através do código de confirmação de Airbnb.

Cada nova reserva é seguida de uma mensagem com os bilhetes.

As verificações de alteração (Update Reservation) são raras.

Bilhetes – Ventrata → Airbnb, logo após cada reserva: a ligação para o bilhete em PDF, a ligação para o bilhete na carteira digital e, para alguns produtos, imagens dos códigos QR, tudo nas mensagens de Airbnb do hóspede (consulte Bookings Sync). Os hóspedes apresentam-nos à sua entrada e o operador lê-os e resgata-os na Ventrata como qualquer bilhete Ventrata.

Sem atualizações de resgate – a Ventrata não envia uma atualização a Airbnb quando um bilhete é lido ou resgatado, nem quando um hóspede não comparece.

Não observamos nenhuma chamada que comunique resgates ou não comparências a Airbnb.