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.

CampoSignificado
duration_minDuração do serviço
step_minGrade de início (a cada 15, 30 minutos…)
buffer_before_min / buffer_after_minTempo de preparo ou limpeza bloqueado ao redor do agendamento
price_cents, currencyPreço que o bot informa (sempre do banco de dados)
deposit_centsSinal exigido para confirmar (cobrança online: em breve)
booking_paymentO que é cobrado ao confirmar um horário: none, deposit (o sinal) ou total (o valor da tarefa)
lead_time_minAntecedência mínima (por exemplo 60 minutos)
max_advance_daysCom quanta antecedência máxima o cliente pode agendar
window_modeO slot é uma janela fixa (entregas: 14:00–16:00)
fulfillment_modescheduled (padrão, com horário) ou queue (despacho por fila, sem horário fixo)
location_modeOnde o serviço é feito: no local, no endereço do cliente, à escolha ou a distância
colorCor que identifica o serviço em todas as telas
intake_formJSON Schema de dados extras a coletar (convênio, endereço…)
requirementsQuais 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, com window_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_min num 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

  1. Expandir os horários para o período pedido, no fuso de cada recurso.
  2. Remover agendamentos e pré-reservas ativos (mais os buffers) e bloqueios manuais.
  3. Cortar em slots candidatos conforme duração e grade do serviço.
  4. Aplicar antecedência mínima e máxima, regras de corte e tamanho do grupo.
  5. Cruzar todos os requisitos, testando os membros de cada equipe conforme a estratégia de alocação.
  6. 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 « (copia)» pausado com preço, regras, requisitos, formulário, produtos, horário independente e etapas. Não copia tarefas, resultados nem avaliações. Exige permissão de catálogo; sem permissão para editar etapas usa as etapas base do projeto e avisa. Revise a cópia e reative quando estiver pronta.

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.