Formulário de serviço: campo por campo
Atualizado em quarta-feira, 9 de setembro de 2026
Referência completa de cada campo do formulário de criação/edição de serviços.
Referência de cada campo em Serviços → Novo ou Serviços → Editar (/admin/<slug>/services/new ou /admin/<slug>/services/:id/edit).
Identidade
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| Foto | Upload PNG/JPG/WEBP/GIF, até 8 MB (ou busca de fotos Pexels) | Não | Imagem quadrada (servida recortada em 200x200). Aparece na lista de serviços do seu perfil público. Na página de reservas os serviços são listados sem foto. |
| Nome | Texto multilíngue | Sim | Claro e reconhecível. Ex.: “Corte de cabelo feminino”. Visível na página pública. |
| Descrição curta | Textarea multilíngue (3 linhas) | Não | Aparece abaixo do nome, tanto no perfil quanto na página de reservas. |
| Descrição longa | Textarea multilíngue (6 linhas) | Não | No perfil ela fica atrás de um botão “Mais informações” que a expande. Na página de reservas ela não é mostrada. |
Os três campos de texto aceitam uma versão por idioma (es / pt / en). Os idiomas sem versão própria caem no idioma em que você escreveu.
Duração e preço
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| Duração | Número (mínimo 5, passo de 5) | Sim | Minutos que o serviço dura. Padrão: 30. O passo de 5 é imposto pelo navegador; o servidor só exige que seja maior que 0. |
| Preço | Número | Não | Na moeda do negócio. Se a moeda não tiver centavos (PYG), não se mostra decimal. |
| Buffer antes | Número (min, passo de 5) | Não | Tempo de preparação antes do agendamento. Bloqueia o horário, mas não aparece para o cliente. |
| Buffer depois | Número (min, passo de 5) | Não | Tempo de limpeza/encerramento depois do agendamento. Bloqueia o horário, mas não aparece para o cliente. |
Exemplo de buffers
- Serviço: Manicure em gel, duração 60 min, buffer antes 5 min, buffer depois 10 min.
- No calendário: o agendamento ocupa 75 minutos (60 + 5 + 10).
- O cliente reserva as 10:00 e vê “Seu horário é das 10:00 às 11:00”.
- O bloco completo vai das 10:00 às 11:15: até esse horário esse profissional fica ocupado.
- O próximo horário oferecido não é necessariamente 11:15: os horários saem conforme o intervalo de slots do negócio, então aparece o primeiro que cair às 11:15 ou depois — com o intervalo padrão (30 min) é 11:30; com 15 min, sim, é 11:15.
Categorização
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| Categoria | Seletor | Não | Uma categoria do negócio (ex.: “Cortes”, “Coloração”). Você as cria em Categorias. Serve para agrupar a lista pública. |
Disponibilidade
Filiais
Toggle:
| Modo | Comportamento |
|---|---|
| Todas as filiais (padrão) | O serviço é oferecido em todas as filiais do negócio. |
| Filiais específicas | Você marca quais. O serviço aparece apenas nas marcadas. |
Profissionais
Toggle:
| Modo | Comportamento |
|---|---|
| Todos os profissionais (padrão) | Qualquer profissional pode atender este serviço. |
| Profissionais específicos | Aparece a lista da equipe como chips com foto. Você toca em quem pode atender este serviço. |
Duração e preço por profissional
O que você faz hoje para obter o mesmo efeito é criar um serviço por variante e atribuir cada um ao seu profissional:
| Você quer | Você cadastra |
|---|---|
| “Coloração com a Sofía R$ 250, com a Lara R$ 180” | Dois serviços (“Coloração · Sofía” e “Coloração · Lara”), cada um com seu preço e com Profissionais específicos apontando para uma só pessoa. |
| “O corte com o barbeiro sênior leva 45 min e com o júnior 30” | Dois serviços com durações diferentes, cada um atribuído ao seu profissional. |
O custo é que o cliente vê duas entradas na lista em vez de uma. A vantagem é que ele vê o preço real antes de escolher.
A comissão essa sim pode ser afinada por profissional e por serviço — isso vive em Comissões, não neste formulário.
O passo a passo desse padrão está em Serviços por profissional com preços diferentes.
Flags
| Campo | Tipo | Padrão | Descrição |
|---|---|---|---|
| Reservas online | Checkbox | ✅ | Se estiver ativo, o serviço aparece no link público e pode ser reservado. Se estiver desligado, só você o cria manualmente pelo calendário. |
| Ativo | Checkbox | ✅ | Se estiver desligado, o serviço não aparece em lugar nenhum (nem online nem interno). Útil para “pausar” sem excluir. |
Sinal deste serviço
Esta seção fica sempre visível, não apenas quando o negócio está no modo “Sinal exigido”. É um único seletor com quatro opções:
| Opção | O que faz |
|---|---|
| Usar a política do negócio (padrão) | O serviço não decide nada; vale o que está em Configurações → Pagamentos online. |
| Porcentagem | Este serviço pede essa % da parte dele no total. Vem pré-preenchido em 30 se você nunca cadastrou um. |
| Valor fixo | Este serviço pede esse valor, limitado ao preço da linha. |
| Sem sinal | Este serviço não pede sinal mesmo que o negócio peça. É a opção para deixar um serviço fora da política geral. |
Botões do formulário
| Botão | Ação |
|---|---|
| Salvar / Criar serviço | Persiste as alterações e volta à lista. |
É o único botão. Não existe “Duplicar”, nem “Cancelar”, nem “Excluir” neste formulário.
- Para duplicar: não existe. Crie o serviço novo na mão; são poucos campos.
- Para cancelar: use o botão voltar do navegador ou o menu lateral; nada é salvo até você tocar em Salvar.
- Para tirar um serviço de circulação: desmarque Ativo e salve. Não há exclusão real de serviços no painel — desativar é a operação equivalente e ainda preserva o histórico das reservas que já o usaram.
Permissões
| Papel | Acesso |
|---|---|
| Proprietário | Criar e editar. |
| Administrador | Criar e editar. |
| Gerente (manager) | Sem acesso. |
| Profissional | Sem acesso. |
Pré-preenchimento ao criar
| Campo | Padrão |
|---|---|
| Duração | 30 min |
| Buffer antes | 0 min |
| Buffer depois | 0 min |
| Filiais | “Todas” |
| Profissionais | “Todos” |
| Reservas online | ✅ |
| Ativo | ✅ |
Validações
| Validação do servidor | Quando dispara |
|---|---|
| Nome obrigatório | O nome está vazio no idioma em que você está escrevendo. |
| Duração maior que 0 | Você colocou 0 ou deixou o campo vazio. O múltiplo de 5 não é validado: esse passo 5 é só do campo do navegador, e um valor como 25 ou 47 é salvo do mesmo jeito se chegar ao servidor. |
| Preço maior ou igual a 0 | Você colocou um preço negativo. |
| A foto precisa ser uma imagem | Você subiu algo que não é PNG, JPG, WEBP ou GIF, ou que pesa mais de 8 MB. |
Os erros aparecem juntos em uma caixa vermelha no topo do formulário.
Como o cliente vê
Uma vez salvo e com Reservas online ativado:
No seu perfil público (citauno.com/seu-negocio), na lista de serviços:
- Cada serviço mostra foto (se você subiu), nome, duração, preço e um botão Reservar próprio.
- Abaixo vem a descrição curta, e a longa atrás de um “Mais informações” que a expande.
- Se você usa categorias, a lista vem agrupada por categoria.
Na página de reservas (citauno.com/businesses/seu-negocio/book):
- Os serviços são uma lista de caixas de seleção: nome, descrição curta, duração e preço. Sem foto e sem descrição longa.
- O cliente pode marcar vários serviços na mesma reserva; se fizer isso, aparece um aviso de que escolher vários pode reduzir os horários disponíveis, porque todos precisam caber no mesmo bloco.
- O passo de profissional vem antes do de serviços, não depois.
Erros comuns
| Sintoma | Causa | Solução |
|---|---|---|
| O serviço não aparece no link público | “Reservas online” desligado, ou sem profissional disponível | Ative o toggle e verifique os profissionais atribuídos |
| Não há horários disponíveis para o serviço | Buffer longo demais + horário do profissional apertado | Reduza os buffers ou amplie o horário do profissional |
| O cliente reservou com um preço e aparece outro | Você mudou o preço do serviço depois da reserva | A Citauno usa o preço do momento da reserva |
| Não acho como excluir o serviço | Não existe exclusão de serviços no painel | Desmarque Ativo e salve: o serviço deixa de aparecer em todo lugar e as reservas antigas mantêm o histórico |
| O serviço aparece com foto no perfil, mas sem foto ao reservar | É assim por design: a página de reservas lista os serviços sem imagem | Nada a fazer — coloque a informação importante no nome e na descrição curta |