> ## Documentation Index
> Fetch the complete documentation index at: https://docs.airbee.com.br/llms.txt
> Use this file to discover all available pages before exploring further.
# Integrando calendário com Booking
> Conecte o calendário da sua propriedade no Booking.com à Airbee nos dois sentidos, com os requisitos da Extranet e os limites do iCal.
Este guia mostra como ligar uma propriedade do Booking.com a uma acomodação da Airbee. Ao final, reservas recebidas pelo Booking.com ocupam as datas na Airbee, enquanto reservas diretas, bloqueios e períodos ocupados recebidos de outros canais podem fechar as mesmas datas no Booking.com.
Se ainda não conhece o funcionamento geral da integração, comece por [Integrando calendários](/guias/integrando-calendarios).
## Antes de começar
Você precisa ter:
* a acomodação já cadastrada na Airbee;
* acesso à Extranet do Booking.com como parceiro ou proprietário;
* **plano Unlimited**, porque o Booking.com é um canal exclusivo desse plano.
O Booking.com só oferece sincronização por iCal para propriedades com **até 20 tipos de quarto**, **1 unidade por tipo** e **sem channel manager XML conectado**. Se a propriedade estiver ligada a um channel manager, a opção de sincronizar calendários não aparece na Extranet.
## Parte 1 — Trazer o Booking.com para a Airbee
Acesse a Extranet com a conta que administra a propriedade.
Se você administra mais de uma, escolha a propriedade correspondente antes de continuar.
No menu principal, abra a área de tarifas e disponibilidade e depois o calendário. Em inglês, aparece como *Rates & Availability → Calendar*.
Dentro do calendário, procure a opção **Sync calendars** (Sincronizar calendários).
Se o Booking.com perguntar o que deve ser exportado, escolha a opção que inclui **reservas e períodos fechados** (*Booked + Closed*), para que os bloqueios também sejam enviados.
A URL começa com `https://ical.booking.com/` ou `https://admin.booking.com/`. É um endereço longo, sem o nome da propriedade no meio.
Na Airbee, acesse **Configurações → Integrações**, abra o **Booking.com**, selecione a acomodação e clique em **Conectar**. Cole a URL e confirme.
O mesmo bloco está disponível em **Acomodações → abrir a acomodação → Calendários**.
A primeira leitura acontece nessa ação. A Airbee informa quantas reservas foram criadas, atualizadas ou removidas.
## Parte 2 — Enviar a Airbee para o Booking.com
Esta parte é a que faz as reservas e os bloqueios reunidos pela Airbee fecharem as datas no Booking.com. Uma reserva recebida do Airbnb, por exemplo, entra na Airbee e fica disponível para o Booking.com na próxima consulta.
Em **Acomodações**, abra a acomodação e entre em **Calendários**. Na seção **Enviar esta acomodação para outros canais**, escolha **Booking.com** em **Canal de destino** e copie a URL.
Em **Sync calendars**, escolha a opção de adicionar uma conexão de calendário, logo abaixo da opção de exportar.
Use um nome que ajude a reconhecer a origem, como "Airbee". Confirme para salvar.
Na conexão criada, use **Importar agora** (*Import now*) para o Booking.com consultar a URL sem esperar o próximo ciclo automático.
### Se já existe uma conexão antiga da Airbee
Abra a conexão importada da Airbee em **Sync calendars** e substitua a URL pela que você acabou de copiar. Se a Extranet não permitir editar o endereço, remova somente a conexão importada da Airbee, adicione-a novamente e use **Importar agora**.
Essa troca acontece dentro do Booking.com. Não desconecte a URL do Booking.com cadastrada na seção **Receber reservas do Booking.com** da Airbee.
## Um detalhe importante: uma URL por tipo de quarto
O Booking.com gera **uma URL por tipo de quarto**, não uma por propriedade. Na Airbee, cada acomodação é uma unidade independente.
Por isso, conecte a URL do tipo de quarto correspondente a cada acomodação. Se todos os quartos da propriedade forem do mesmo tipo, existe uma única URL para todos — e nesse caso o iCal não informa qual quarto foi ocupado.
## Frequência das atualizações
| Sentido | Quem define o ritmo | Frequência |
| -------------------- | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Booking.com → Airbee | Airbee | A cada 1 minuto no plano Unlimited, além de **Sincronizar agora** |
| Airbee → Booking.com | Booking.com | Nas consultas automáticas observadas pela Airbee, o intervalo costuma ficar próximo de **2 horas e 30 minutos**. Não é um prazo garantido e pode demorar mais. A Extranet oferece **Importar agora** (*Import now*) para antecipar a consulta |
A Airbee monta o calendário de saída no instante em que ele é solicitado, sem atraso do nosso lado. O tempo até a data aparecer fechada no Booking.com depende de quando a plataforma vem consultar a URL.
Enquanto espera, **não feche as mesmas datas dentro da Extranet**. Um fechamento criado no Booking.com volta para a Airbee como período ocupado e só é liberado quando for removido na própria Extranet. Se precisar de efeito imediato, use **Importar agora**. Veja [Bloqueie sempre em um lugar só](/guias/integrando-calendarios).
## Exemplo: uma reserva do Airbnb precisa fechar o Booking.com
Uma reserva do Airbnb aparece na Airbee às 11h. A Airbee ocupa as datas e passa a incluí-las imediatamente no calendário disponibilizado ao Booking.com.
Se o Booking.com acabou de consultar a URL antes das 11h, ele ainda não verá essa mudança. Considerando o intervalo normalmente observado, a próxima consulta pode acontecer por volta de 13h30. Durante essa espera, a reserva já está correta na Airbee; falta apenas o Booking.com buscar a versão atualizada.
Para fechar as datas antes disso, abra a conexão importada na Extranet e use **Importar agora**. Não crie outro bloqueio manual para o mesmo período.
## Como conferir o resultado
* Na Airbee, confirme que a reserva ou o bloqueio já aparece na acomodação correta.
* Na Extranet, abra **Sync calendars** e confirme que a conexão importada usa a URL gerada para **Booking.com**.
* Use **Importar agora** e confira se as datas passam a aparecer fechadas.
* O status **Conectado** mostrado na Airbee confirma a leitura no sentido Booking.com → Airbee. Ele não significa que o Booking.com acabou de consultar a URL da Airbee.
## O que aparece na Airbee
As reservas importadas entram no calendário como reservas externas identificadas como Booking.com, sem hóspede vinculado e sem valores. O Booking.com não compartilha nome, e-mail, telefone nem valor pelo iCal.
O calendário do Booking.com marca reservas e fechamentos manuais da mesma forma. Não é possível distinguir com segurança um do outro pelo iCal, então a Airbee registra o período como ocupado sem afirmar o motivo. Para saber a origem exata, consulte a Extranet.
## Cancelamentos
Quando a reserva sai do calendário do Booking.com, a Airbee libera as datas depois de três sincronizações bem-sucedidas seguidas sem aquele evento.
Se o evento reaparecer em qualquer uma dessas leituras, a contagem é zerada. A mesma proteção vale quando o Booking.com responde com um calendário completamente vazio. Novas reservas continuam entrando já na primeira sincronização bem-sucedida.
## Se algo não sair como esperado
* **Não encontro Sync calendars na Extranet:** confirme que a propriedade atende aos requisitos — até 20 tipos de quarto, 1 unidade por tipo e sem channel manager XML. Se atender e a opção continuar ausente, fale com o suporte do Booking.com, que habilita o recurso para a conta.
* **O Booking.com aparece bloqueado na Airbee:** o canal faz parte do plano Unlimited.
* **A conexão mostra Atenção:** clique em **Sincronizar agora**. Se continuar, gere a URL novamente na Extranet, porque links antigos podem ter sido revogados.
* **Os bloqueios do Booking.com não chegam:** confira se a exportação foi criada incluindo períodos fechados, e não apenas reservas.
* **A reserva já aparece na Airbee, mas ainda não fechou o Booking.com:** confira se a conexão importada usa a URL gerada para Booking.com. Aguarde a próxima consulta, normalmente próxima de 2 horas e 30 minutos, ou use **Importar agora**.
* **As datas ocupadas estão na acomodação errada:** provavelmente a URL de um tipo de quarto foi colada na acomodação de outro. Desconecte e conecte novamente com a URL correta.
## Próximos passos
Regras gerais, limites e o que o iCal não faz.
Passo a passo do canal disponível também no plano Basic.