Configurar a primeira unidade

Quando o assistente aparece

O assistente fica em /configuracao/setup e só abre depois do login com a verificação em duas etapas. Ele não cria usuários: o primeiro usuário, o Proprietário, já vem criado na instalação do sistema.

• Sem nenhuma unidade ativa, quem tem a permissão de editar configurações num perfil válido para todas as unidades (o Proprietário, por exemplo) entra direto no assistente.
• Os demais usuários veem o aviso abaixo e precisam esperar o Proprietário configurar a unidade e vincular um perfil a eles.

O mínimo para operar e o que deixa a unidade pronta

A unidade começa a operar quando tem um campo ativo com preço na tabela vigente e uma política de cancelamento vigente. Enquanto faltar algum desses itens, o assistente mostra um quadro amarelo com o que falta.

O assistente não para no mínimo: você pode cadastrar todos os campos de uma vez, ajustar os parâmetros da unidade, as gavetas de caixa e as taxas de cartão. Assim a unidade já sai pronta para o dia a dia.

1Unidade

• Nome: como a unidade aparece no painel e no bot.
• Identificador (slug): opcional. Em branco, o sistema gera a partir do nome (ex.: "Arena Centro" vira arena-centro). Aceita só letras minúsculas, números e hífen.
• Fuso horário: escolha da lista. O padrão é America/Sao_Paulo.
• Virada do dia operacional: jogos antes deste horário contam no dia anterior, na agenda e no caixa. O padrão é 04:00, então um jogo de sábado à 01:00 entra no movimento de sexta.

Ao clicar em Criar unidade, ela já nasce ativa e o assistente segue para os campos.

2Campos

• Bloco: duração de cada horário vendido, de 15 a 240 minutos (padrão 60).
• Fração extra: o tamanho de cada extensão de hora extra que o operador lança quando o horário seguinte está livre (padrão 30 minutos).
• Funcionamento: desmarque os dias em que o campo fecha. Se o fechamento for igual ou anterior à abertura, o horário passa da meia-noite e o painel avisa "fecha no dia seguinte". Abertura igual ao fechamento significa 24 horas.
• Usar o horário de segunda em todos os dias copia o horário da segunda para a semana inteira.

Vários campos de uma vez

Clique em Adicionar outro campo. O campo novo já vem com o bloco, a fração extra e os horários do anterior; basta dar o nome e ajustar o que for diferente. O botão passa a mostrar quantos campos serão salvos.

3Preços

O assistente sugere uma faixa para cada horário de funcionamento de cada campo. Preencha o preço do bloco e escolha a regra de pagamento do bot:

• Integral: o cliente paga tudo no PIX do bot para garantir o horário.
• Sinal: o bot cobra o percentual informado e o restante é pago no local.

No exemplo da Arena Centro, cada campo tem dois preços: R$ 150 integral das 08:00 às 18:00, todos os dias, e R$ 200 com sinal de 50% das 18:00 até o fechamento. Como o fechamento muda conforme o dia, o preço da noite ocupa duas linhas:

1. Na primeira faixa do Campo 1, marque todos os dias, ajuste o horário para 08:00 às 18:00, preencha 150 e deixe Integral.
2. Na segunda faixa, deixe só sexta e sábado, de 18:00 às 02:00, preencha 200, escolha Sinal e informe 50 em % do preço.
3. Clique em Adicionar faixa e monte a noite dos outros dias: segunda a quinta e domingo, de 18:00 às 23:00, 200 com Sinal de 50%.
4. Clique em Usar as faixas de Campo 1 em todos os campos: as três linhas aparecem repetidas no Campo 2, com os mesmos dias, horários, preços e regra.
5. Confira e clique em Publicar tabela de preços.

• Com mais de um campo, Usar as faixas de (primeiro campo) em todos os campos copia dias, horários, preço e regra para os demais. Depois da cópia, cada faixa continua editável.
• Use Adicionar faixa para horários com preço diferente (ex.: noite mais cara).
• Campo sem nenhuma faixa aparece num aviso: ele não aceita reserva até ganhar preço.

4Política de cancelamento

A política vem preenchida com o padrão sugerido: menos de 6 h de antecedência não devolve; de 6 h a 24 h devolve 50%; 24 h ou mais devolve 100%. A antecedência conta do pedido de cancelamento até o início do jogo.

• As regras precisam começar em 0 h, emendar umas nas outras e a última fica sem fim (o "Até" vazio).
• Forma: devolução em dinheiro, em crédito para jogar de novo, ou à escolha do cliente.
• Resumo mostrado ao cliente: é o texto que o bot apresenta antes do PIX e que o cliente aceita. Ele é gerado a partir das regras; se você editar o texto, use "Gerar de novo pelas regras" para voltar ao automático.

Ao publicar, a unidade fica operacional e o assistente mostra o aviso verde com o botão Ir para a agenda.

5Opcionais: gavetas, parâmetros e taxas

Nada aqui é obrigatório, e cada bloco tem o seu botão de salvar.

Gaveta de caixa

O operador abre o caixa numa gaveta física. Sem gaveta, ninguém recebe em dinheiro ou cartão. Cadastre uma por ponto de recebimento (ex.: Balcão, Bar).

Parâmetros da unidade

Os campos já vêm com o valor que vale hoje. Altere só o que for diferente nesta unidade: o que você não mexer continua seguindo o padrão do sistema. Apagar a chave PIX ou o telefone volta ao padrão.

Taxas de cartão

Taxa (MDR) e prazo de liquidação por bandeira e modalidade (débito, crédito à vista, crédito parcelado). São usadas no DRE e no controle de recebíveis. Salvar substitui a tabela inteira; os recebíveis já registrados não mudam.

Fim do setup

Clique em Ir para a agenda. A grade do dia já mostra todos os campos com os horários livres.

Parar no meio e continuar depois

O assistente não guarda nada no navegador: a cada passo ele relê a unidade no servidor. Se a conexão cair, se você fechar a aba ou se algum passo falhar, ao voltar ele abre direto na primeira etapa que falta.

Com a unidade criada mas incompleta, a tela inicial mostra o que falta para quem pode configurar a unidade, com o botão Continuar a configuração.

As etapas já concluídas ficam marcadas com ✓ na barra do topo e podem ser abertas de novo. Na etapa de campos dá para acrescentar campos a qualquer momento; em preços e cancelamento, publicar de novo cria uma nova versão.

Configurar outra unidade

Com uma unidade já ativa, a unidade nova é criada em Configuração, aba Unidade, botão Nova unidade, por quem tem a permissão de configuração num perfil de Todas as unidades (veja Configuração · Nova unidade). O formulário é o mesmo da etapa Unidade deste assistente. Ao clicar em Criar unidade, a unidade nasce ativa, fica selecionada no topo do painel e o painel abre o mesmo assistente com o título "Configurar" e o nome da unidade, já na etapa de campos.

Se você sair no meio, escolha a unidade no seletor do topo: a tela inicial mostra o que falta e o botão Continuar a configuração, que retoma o assistente na primeira etapa que falta.

Siga as etapas como na primeira unidade. Nos opcionais, preencha a Chave PIX da unidade: a partir da segunda unidade ativa, cada unidade precisa da sua. Depois, dê à equipe os perfis na unidade nova em Acessos e escolha a unidade padrão do atendimento em Configuração.

Mensagens de erro comuns