10. Integrações e Portais¶

📍 Onde fica: Configurações → Dropzone (Bookeo e portais) 👤 Quem pode: Administrador 🔗 Pré-requisito: Produtos criados (para mapear produtos do Bookeo).

Última etapa do onboarding: conectar a DZ ao Bookeo (reservas) e abrir os portais para atletas e dobradores.

Integração Bookeo (reservas)¶

O Bookeo é a plataforma de reservas online. O Airo sincroniza as reservas e os participantes automaticamente.

Configuração¶

No bloco Bookeo das configurações da Dropzone:

Campo	O que é
Bookeo habilitado	Interruptor geral
API Key / Secret Key	Credenciais da sua conta Bookeo
Mapeamento de produtos	Liga cada produto do Bookeo a um Produto do Airo
Campos personalizados	Códigos dos campos de peso, altura e Instagram no Bookeo
Parte da empresa (company party)	A identidade da própria DZ (carteira "da casa")
Data inicial para sincronização	Cutoff: reservas com data agendada anterior são ignoradas. Deixe vazio para puxar tudo

🗓️ Por que existe a data inicial: se você só vai começar a operar pelo Airo a partir de uma data X, agendamentos antigos do Bookeo (já realizados ou cancelados fora do sistema) não devem virar reservas e créditos retroativos. Defina a data X aqui e tudo que estiver agendado antes é pulado pelo sync.

Como funciona¶

No manifesto, use Sincronizar Bookeo para puxar as reservas da data.
O Airo cria/atualiza as reservas e os participantes (passageiros).
Cada produto do Bookeo é resolvido para o Produto do Airo pelo mapeamento.
O depósito pago no Bookeo é importado e cai como crédito na carteira do passageiro.
Os telefones dos participantes são normalizados para o formato internacional E.164 (+5511999999999) — usando o País padrão (telefone) da DZ (ver 1. Configurar a Dropzone) quando o Bookeo entrega o número sem DDI.

⚠️ Mapeie os produtos antes de sincronizar. Sem o mapeamento, a reserva chega sem produto e não cobra corretamente.

💼 Identificação no extrato. Lançamentos criados pelo Bookeo aparecem na carteira com o autor Integração Bookeo Sync (Nome do admin) — ou seja, indica que veio da integração e quem disparou o sync. Útil pra auditoria.

CBPq (lookup de licenças)¶

Na ficha de uma pessoa, o botão Sincronizar CBPq importa dados da licença direto da base do CBPq (nome, número, categoria, validade, federação, clube, habilitações).

O campo Emissor da licença é preenchido automaticamente como CBPq quando o sync é executado.
Atualizações posteriores no CBPq podem ser re-importadas a qualquer momento.
Veja Pessoas, Pilotos e Licenças para detalhes do que cada campo significa.

🌐 Requisito de rede: a sincronização com o Bookeo (e o login Google) precisam de acesso à internet de saída. Em produção serverless isso tem implicações de infra — ver CLAUDE.md (seção Deployment).

Portal do Atleta¶

O atleta acessa seu próprio manifesto, carteira, logbook e perfil.

Dois níveis de liga/desliga: 1. Na DZ (Configurações → Dropzone): portal habilitado, modo de registro (só convite / aberto), auto check-in, seções visíveis (carteira/logbook/manifesto), validade do convite. 2. Por pessoa (Pessoas → (pessoa)): acesso ao portal habilitado + envio de convite.

Os dois precisam estar ligados. Detalhes do uso em Portais do Atleta e do Dobrador.

Portal do Dobrador¶

O dobrador registra dobras, vê seus ganhos e acompanha pagamentos dos atletas.

Configuração na DZ (Configurações → Dropzone): - Portal do dobrador habilitado. - Preço padrão de dobra (sugestão ao registrar dobra manual). - Gatilho de lançamento automático: gera a dobra quando a decolagem fica pousou ou decolou. - Mostrar dobras pagas pela DZ: exibe os créditos de dobra embutidos nos produtos.

Para a pessoa ser dobradora, ela precisa ter a função dobrador (e/ou prestar serviço de dobra). Veja o uso em Dobra e Dobradores.

Sessões de Exibição (telas/TVs)¶

📍 Sessões de Exibição

Para mostrar o manifesto numa TV/monitor no campo (público, sem login):

Crie uma sessão de exibição — gera um código.
Abra a tela pública de display e valide com o código.
Você pode revogar, estender a validade ou gerar novo código.

✅ Pronto quando¶

[ ] Bookeo configurado e produtos mapeados (se você usa reservas online).
[ ] Portal do atleta ligado e atletas convidados (se aplicável).
[ ] Portal do dobrador ligado e gatilho definido (se aplicável).

🎉 Onboarding completo! Sua DZ está pronta para operar. Siga para o Guia de Uso para o dia a dia.