Formulário de filial: campo por campo
Atualizado em sexta-feira, 22 de maio de 2026
Referência completa de cada campo do formulário de criação/edição de filiais.
Referência de cada campo no formulário de Unidades → Nova ou Unidades → Editar (/admin/<slug>/locations/new ou /admin/<slug>/locations/:id/edit).
Dados principais
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| Nome | Texto | Sim | Nome identificável da filial (ex.: “Centro”, “Lambaré”). Visível para o cliente ao escolher a filial. |
| Endereço | Autocompletar do Places | Não | Você começa a digitar e escolhe na lista do Google Maps. Gera as coordenadas para o mapa. |
| Cidade | Texto | Não | Preenchida automaticamente se você escolher o endereço. Editável. |
| Ativa | Checkbox | Não | Se estiver marcada, a filial aparece no link público e aceita reservas. |
Contato da filial
| Campo | Tipo | Obrigatório | Comportamento |
|---|---|---|---|
| Telefone | Telefone com código do país | Não | Toggle “Usar o do negócio” — se ativo, herda do negócio. Caso contrário, você pode cadastrar um próprio. |
| Telefone com código do país | Não | Mesmo comportamento do telefone. | |
| Texto (sem @) | Não | Toggle “Usar o do negócio” — herdar ou personalizar. Pattern: [a-zA-Z0-9_.]{1,75}. |
Horário de atendimento
Uma grade semanal com um grupo para cada dia (segunda a domingo):
| Subcampo | Tipo | Descrição |
|---|---|---|
| Toggle aberto/fechado | Boolean | Se estiver fechado, não são aceitas reservas nesse dia. |
| Horário de abertura | Hora (HH:MM) | Horário de início do dia. |
| Horário de fechamento | Hora (HH:MM) | Horário de término do dia. Deve ser posterior à abertura. |
| Intervalos | Array de [início, fim] | Vários intervalos por dia (ex.: almoço 13:00–14:00). |
Validações
- O horário de fechamento deve ser maior que o de abertura.
- Os intervalos devem estar dentro do horário do dia.
- Os intervalos não podem se sobrepor entre si.
- O início do intervalo deve ser menor que o fim.
Atalho de cópia
Botão “Copiar para outros dias” — copie o horário do dia atual para os dias que você selecionar; economiza tempo quando muitos dias são iguais.
Geolocalização
| Campo | Tipo | Editável | Descrição |
|---|---|---|---|
| Latitude | Decimal | Sim | Coordenada geográfica. Preenchida automaticamente pelo autocompletar do Places. |
| Longitude | Decimal | Sim | Coordenada geográfica. Preenchida automaticamente pelo autocompletar do Places. |
Se você editar esses valores manualmente (por exemplo, se o Google Maps marcou o ponto errado), o mapa da sua página pública usa as novas coordenadas.
Serviços e equipe
Estes não são campos do formulário diretamente — são gerenciados em Serviços e Equipe, mas a filial tem:
| Relação | Como se vincula |
|---|---|
| Serviços | Cada serviço pode ter “todas as filiais” ou ser restrito a unidades específicas (no próprio formulário dele). |
| Profissionais | Cada profissional é atribuído a uma ou várias filiais (no próprio formulário dele). |
| Reservas | Cada reserva pertence a uma filial (escolhida pelo cliente ao reservar). |
| Bloqueios | Podem ser por filial específica ou por todo o negócio. |
Botões do formulário
| Botão | Ação |
|---|---|
| Salvar | Persiste as alterações. Se houver erros de validação, mostra mensagens inline. |
| Cancelar | Volta à lista de filiais sem salvar. |
| Excluir | Apenas no modo de edição. Exclui a filial. Se houver reservas ou profissionais atribuídos, avisa você e bloqueia a operação. |
Permissões
| Papel | Acesso |
|---|---|
| Proprietário | Criar, editar, excluir. |
| Administrador | Criar, editar, excluir. |
| Membro | Sem acesso a este formulário. |
Pré-preenchimento ao criar
Quando você cria uma filial nova, os seguintes campos vêm pré-preenchidos:
- Toggle “Usar do negócio”: ativo para telefone, WhatsApp e Instagram.
- Fuso horário: herda o do negócio.
- Horário: vazio (segunda a sábado: 09:00–18:00 como sugestão).
- Ativa: marcado por padrão.
Erros típicos
| Mensagem de erro | Causa |
|---|---|
| “O horário de fechamento deve ser maior que o de abertura” | Você cadastrou fechamento 9:00 e abertura 18:00 (invertido). |
| “Há um intervalo sobreposto” | Dois intervalos compartilham horas. |
| “O intervalo deve estar dentro do horário do dia” | Intervalo fora da faixa de abertura-fechamento. |
| “A filial tem reservas futuras” (ao excluir) | Não é possível excluir se houver reservas. Cancele as reservas primeiro ou desative a filial. |
| “Este endereço já está em uso por outra filial” | Você duplicou o endereço — a Citauno impede duas filiais no mesmo ponto. |
O que acontece ao salvar
- Criar: a filial é adicionada à lista. Se for a primeira, ela passa a ser a principal automaticamente.
- Editar: as alterações são aplicadas na hora. Os profissionais atribuídos veem o novo horário.
- Excluir: a filial é removida. Serviços que só eram oferecidos ali passam ao estado “sem filial atribuída” (precisam de ajuste manual).