Serviços e disponibilidade
Serviços, requisitos com vários recursos, horários e como os slots são calculados.
Atualizado:
Serviços
Um serviço é o que o cliente agenda.
| Campo | Significado |
|---|---|
duration_min | Duração do serviço |
step_min | Grade de início (a cada 15, 30 minutos…) |
buffer_before_min / buffer_after_min | Tempo de preparo ou limpeza bloqueado ao redor do agendamento |
price_cents, currency | Preço que o bot informa (sempre do banco de dados) |
deposit_cents | Sinal exigido para confirmar (cobrança online: em breve) |
booking_payment | O que é cobrado ao confirmar um horário: none, deposit (o sinal) ou total (o valor da tarefa) |
lead_time_min | Antecedência mínima (por exemplo 60 minutos) |
max_advance_days | Com quanta antecedência máxima o cliente pode agendar |
window_mode | O slot é uma janela fixa (entregas: 14:00–16:00) |
fulfillment_mode | scheduled (padrão, com horário) ou queue (despacho por fila, sem horário fixo) |
location_mode | Onde o serviço é feito: no local, no endereço do cliente, à escolha ou a distância |
color | Cor que identifica o serviço em todas as telas |
intake_form | JSON Schema de dados extras a coletar (convênio, endereço…) |
requirements | Quais recursos o serviço precisa ao mesmo tempo |
Janela ou despacho: dois modos de cumprimento
Cada serviço define como o agendamento é cumprido (fulfillment_mode):
scheduled(o padrão): o agendamento ocupa um intervalo de tempo conhecido — um horário fixo ou, comwindow_mode, uma janela (entregas das 14:00 às 16:00, com cota por zona).queue(despacho, para água, gás ou delivery sob demanda): o agendamento não tem horário fixo — entra na fila de pendências de um entregador. O motor o atribui ao entregador com menos tarefas ativas e cada entregador tem um limite de tarefas ativas por vez, garantido no banco de dados. A fila usa os mesmos estados de um agendamento: pendente → aceita → iniciada → concluída (ou falhou).
Assim, um mesmo negócio de entregas pode oferecer janelas programadas, despacho imediato ou os dois.
Requisitos
Um requisito diz: deste equipe, preciso de tantas unidades. Um serviço pode ter vários; um slot só existe se todos estiverem livres.
{
"name": "Depilação a laser",
"duration_min": 45,
"buffer_after_min": 10,
"requirements": [
{ "resource_group_id": "grp_professionals", "units": 1 },
{ "resource_group_id": "grp_lasers", "units": 1 },
{ "resource_group_id": "grp_rooms", "units": 1 }
]
}
Com duas profissionais e só um laser, o Fiuit nunca oferece duas sessões de laser sobrepostas.
Opções avançadas:
units: "party_size"— consome tantas unidades quanto pessoas (restaurantes, aulas).offset_min/duration_minnum requisito — usa um recurso só em parte do serviço (por exemplo o lavatório nos últimos 15 minutos de uma coloração).
Horários
Cada recurso tem um horário: regras semanais no fuso do recurso mais exceções para datas específicas (fechado ou horário especial).
Horários que passam da meia-noite. Se a hora de fechamento é menor ou igual à de abertura, a faixa termina no dia seguinte: ["20:00", "03:00"] aparece como 20:00 – 03:00 (+1). A noite pertence ao dia em que abre: a sexta 20:00 – 03:00 (+1) vai até sábado às 03:00 mesmo com o sábado fechado, e fechar a sexta tira essa noite inteira. 24 horas se escreve ["00:00", "00:00"]. Não dá para salvar uma faixa que invada a madrugada do dia seguinte. Uma reserva pode passar da meia-noite sem ser cortada, e ao pedir os horários de «um dia» (bot, reserva pública, GET /v1/slots?day=) entram os da noite depois das 00:00. O horário de verão é respeitado: uma noite com mudança de hora dura suas horas reais.
{
"tz": "America/Sao_Paulo",
"weekly": { "tue": [["09:00", "19:00"]], "sat": [["08:00", "12:00"], ["13:00", "16:00"]] },
"overrides": [{ "date": "2026-12-24", "ranges": [["09:00", "13:00"]] }, { "date": "2026-12-25", "closed": true }]
}
Bloquear um horário
Um bloqueio é uma exceção do dia: o dia inteiro (fechado) ou algumas horas (salvo como os trechos em que se atende nesse dia: o horário semanal menos o bloqueado). No painel, o mesmo diálogo bloqueia no Calendário (tocando um horário livre ou arrastando na grade), na ficha de cada recurso (Horários e bloqueios) e, à parte, no serviço (Pausar por um período, que fecha só esse serviço e não bloqueia os recursos que o atendem). Dá para escolher um ou vários recursos, um intervalo de dias ou repetir toda semana. As tarefas que já estavam nesse horário são avisadas e não são movidas sozinhas. Se vários recursos compartilham o mesmo horário, o bloqueio vale para todos.
Dias e horários próprios do serviço
Um serviço também pode ter a sua própria janela: os dias e intervalos em que é oferecido, com o mesmo editor semanal dos recursos. A oferta é sempre a interseção: a janela do serviço corta a disponibilidade da equipe, nunca a amplia. Se o serviço não define janela, é oferecido qualquer horário que seus recursos tenham. O editor mostra uma pré-visualização com a interseção real antes de salvar, e o bot explica a janela quando não há horários.
Cor
Cada serviço escolhe uma cor da paleta do tema. Você a vê no calendário, em Hoje, em Trabalho, no mapa e nas estatísticas, junto ao nome: a cor identifica, mas não substitui o texto. Se você não escolher uma, o Fiuit atribui uma cor estável automaticamente.
Onde é feito
Cada serviço define o seu destino:
- No local: a tarefa acontece no endereço do negócio.
- No endereço do cliente: entregas, visitas, serviço em domicílio.
- À escolha do cliente: o cliente decide ao reservar.
- A distância: uma sessão por videochamada ou telefone. Nenhum endereço é pedido nem mostrado: nem no bot, nem na reserva pela web, nem nos avisos. Você pode cadastrar o link da reunião do serviço (o da sua sala de videochamada): o bot o envia ao confirmar e os lembretes o repetem. O Fiuit não gera o link.
Quando o destino é o endereço do cliente, ao criar a tarefa o Fiuit sugere o endereço que ele já tem salvo (com preenchimento automático ou carga manual, veja Mapa e endereços). Cada tarefa guarda o seu próprio destino: alterá-lo numa tarefa não toca nas demais nem no perfil. Salvar o endereço novo no perfil do cliente é opcional e separado: só acontece se você marcar a caixa de consentimento. O bot confirma o endereço, o consentimento e a reserva como passos separados.
Formulários com quantidades e cálculos
Além dos campos de texto, o formulário de um serviço aceita:
- Quantidades: quantas unidades de algo (galões, metros, pessoas, equipamentos).
- Campos calculados: uma expressão simples que combina quantidades e preços para mostrar um total (por exemplo
agua * 1500 + gas * 3000). O cálculo é validado no servidor e não pode tocar em dados de outros módulos nem de outros negócios.
O painel tem editor e pré-visualização: teste o resultado antes de salvar. Ao criar a tarefa, o formulário pede as quantidades, aplica o cálculo e mostra o total; o cliente vê um resumo claro do que pediu. A cotação fica congelada com a tarefa: se o preço do catálogo mudar antes de confirmar, a tarefa já montada mantém o seu total; editar as quantidades manualmente recalcula com o catálogo vigente.
Como os slots são calculados
- Expandir os horários para o período pedido, no fuso de cada recurso.
- Remover agendamentos e pré-reservas ativos (mais os buffers) e bloqueios manuais.
- Cortar em slots candidatos conforme duração e grade do serviço.
- Aplicar antecedência mínima e máxima, regras de corte e tamanho do grupo.
- Cruzar todos os requisitos, testando os membros de cada equipe conforme a estratégia de alocação.
- Devolver uma lista curta e ordenada.
Quando não há nada disponível, a resposta traz unavailable_reason (closed, no_staff, no_equipment, no_space, lead_time, max_advance, cutoff, full) para o bot explicar o motivo.
Os resultados passados de cada serviço —concluídas, canceladas, faturamento estimado, horário de pico e exportação CSV— estão em Resultados e vendas.
Configurar um serviço no painel
Em Meu negócio → Catálogo, abra o serviço e toque em Editar. O que cada bloco faz:
- Quem faz: escolha uma equipe. Pode haver vários requisitos ao mesmo tempo, por exemplo um box e um mecânico durante parte do tempo. A disponibilidade é a interseção do serviço, dos recursos e do horário da zona, menos os bloqueios.
- Horário próprio: um interruptor. Permite várias faixas por dia (as pausas são o espaço entre elas) e pausar por datas.
- Antecedência: o mínimo para reservar e Reservar até (dias).
- Intervalo entre horários: a grade de início (15, 30 minutos…).
- Duração: fixa, ou várias durações (de 2 a 6) que o cliente escolhe, cada uma com seu preço. Os serviços de dia inteiro deixam o cliente escolher só o dia. Há folga antes e depois.
- Preço: fixo, a partir de ou calculado pelo formulário (só pelo formulário).
- Ao reservar: sem cobrança, sinal ou pagamento total (o total exige Mercado Pago).
- Onde: no local, no endereço do cliente (com zonas), à escolha do cliente ou online com link de reunião.
- O bot oferece: interruptor para tirar o serviço do bot sem pausá-lo.
Exemplo: «Revisão completa» com duração de 2 h, equipe «Mecânicos» mais um box, sinal de 30 % e «O bot oferece» ligado.
Criar um serviço a partir de um texto
Em Meu negócio → Catálogo → Novo serviço → Adicionar com IA, escreva o serviço com as suas palavras, por exemplo: «Corte 30 min $ 5000 com barba opcional».
- Duração e preço são lidos por regras; o nome, pela IA.
- Você revisa e confirma antes de criar.
- Um extra opcional («com barba») é sugerido como outro serviço: os serviços não têm adicionais embutidos.
Também dá para importar vários serviços de uma vez, a partir de uma foto da tabela de preços ou de exemplos, na folha do catálogo (importar da foto / exemplos).
Pausar e duplicar
Pausar deixa de oferecer o serviço para novos pedidos no bot, reserva pública, Wagy e MCP. As tarefas já agendadas podem ser reagendadas, reatribuídas, concluídas e canceladas com as permissões e validações habituais. A pausa preserva os controles de horário e capacidade. Reativar volta a oferecê-lo. Pausar e desativar são a mesma ação.
Duplicar cria «
No detalhe abra ⋯ → Duplicar ou Pausar. No desktop também há um menu na lista. Wagy propõe as duas ações e aguarda a confirmação do plano. MCP permite pausar com update_service(active=false, confirm=true); duplicar ainda não tem ferramenta MCP.
Excluir e arquivar
Pausado e arquivado não são a mesma coisa. Pausado é temporário: o serviço, produto, equipe ou recurso aparece esmaecido no catálogo com «Reativar» e não aparece nos filtros de trabalho nem no bot. Arquivado some da vista: só aparece em «Arquivados» (no fim do catálogo, recolhido e oculto se estiver vazio), com «Restaurar».
⋯ → Excluir apaga de verdade se não tem histórico (nenhuma tarefa, cobrança ou registro que o use) e arquiva se tem; o diálogo diz qual dos dois acontece. Um arquivado some de tudo (catálogo, filtros, seletores, bot, site do negócio, Wagy e sugestões), mas as tarefas e cobranças antigas continuam mostrando o nome. Com tarefas futuras não exclui: elas aparecem para você reatribuir ou cancelar antes. Restaurar deixa o item pausado.
Filtros e seletores oferecem só o que está ativo; um pausado ou arquivado só aparece se há tarefas com ele, marcado «(pausado)» ou «(arquivado)». API e MCP: DELETE com ?mode=remove|archive|delete (permissão de administração; sem mode pausa, como sempre), GET …/removal para ver o que aconteceria e POST …/restore.
Testar um fluxo
Em Meu negócio → Etapas, dentro de um fluxo, ▶ Testar fluxo (no celular, ▶ Testar) percorre o rascunho que está na tela, mesmo sem salvar. Só vê quem pode editar fluxos (o Dono).
- Ver como: Equipe vê todas as telas; Cliente vê só os itens e botões marcados «Cliente». Se uma etapa não tem nada para o cliente, o teste diz «O cliente não vê esta etapa: a equipe a conclui» e oferece continuar coma equipe.
- Dados: preencha cada item ou toque em Preencher com exemplo. Um botão não avança se faltam os itens que ele pede, e o teste diz quais.
- Caminhos: os botões da etapa e, para a equipe, as saídas fixas desse ponto (Cancelar, Reagendar, Não veio e, em atendimento, Encerrar sem concluir com seu motivo).
- Mapa e registro: o mapa marca por onde vai o teste. O que aconteceria lista cada passo: o aviso ao cliente ou à equipe (com o texto de exemplo da mensagem), a atribuição e os dados que seriam salvos.
- Reiniciar volta à primeira etapa.
O teste não salva nada, não avisa ninguém, não cobra e não envia mensagens, e não deixa tarefas, histórico nem auditoria. Não simula tempos nem lembretes adiados, nem o link do cliente nem a cobrança.