Financeiro - Categorias e Subcategorias

O que é

A página Categorias Financeiras é onde você organiza, em árvore, todas as classificações usadas pelos lançamentos do módulo financeiro. Cada categoria tem um tipo (Receita, Despesa ou Receita e Despesa) e uma cor, e pode conter várias subcategorias filhas que herdam o tipo e a cor da categoria pai.

Você normalmente chega aqui ao configurar o financeiro pela primeira vez, depois de cadastrar as Contas Bancárias, e antes de começar a registrar transações ou contas a pagar. Se a página estiver vazia na primeira visita, o sistema cria automaticamente um conjunto inicial de categorias padrão (marcadas como "Sistema") para você ter um ponto de partida.

Como usar

1. Vá em Financeiro > Categorias Financeiras no menu lateral. A página mostra um grid com duas colunas, cada card representando uma categoria pai com suas subcategorias listadas abaixo.

2. Para criar uma categoria pai, clique em Nova Categoria (botão azul no topo da página). No modal:

   • Nome - obrigatório, até 100 caracteres (exemplos visuais no campo: "Alimentação", "Marketing").
   • Tipo - obrigatório, escolha entre Receita, Despesa ou Receita e Despesa.
   • Cor - selecione um dos círculos coloridos disponíveis (verde, esmeralda, turquesa, azul, índigo, roxo e demais cores da paleta). A cor escolhida pinta a faixa superior do card e o ponto identificador.
   • Confirme em Salvar.

3. Para adicionar uma subcategoria, clique no botão verde Subcategoria dentro do cabeçalho da categoria pai. No modal:

   • Informe apenas o Nome - o tipo e a cor são herdados automaticamente da categoria pai e não aparecem no formulário.
   • Confirme em Salvar.

4. Para editar uma categoria pai, clique em Editar (botão azul claro no cabeçalho do card). É possível alterar o Nome e a Cor - a cor escolhida é propagada para todas as subcategorias filhas. O Tipo é exibido como somente leitura com o aviso "O tipo não pode ser alterado após a criação".

5. Para editar uma subcategoria, use o botão Editar ao lado dela na lista. Só o nome pode ser alterado.

6. Para excluir, clique em Excluir no cabeçalho (categoria pai) ou ao lado da subcategoria. Um modal de confirmação aparece com o resumo de subcategorias e transações vinculadas, se houver.

Casos especiais

Categorias padrão criadas automaticamente

Se a empresa nunca cadastrou nenhuma categoria, ao abrir a página o FinanceiroService::seedCategoriasDefault() é executado e cria uma árvore inicial com categorias como Receitas, Custos Operacionais, Despesas Administrativas e suas subcategorias típicas do turismo (Vendas de Pacotes, Hospedagem, Combustível etc.). Essas categorias nascem com a marcação Sistema.

Categorias do sistema (bloqueadas)

Toda categoria criada pelo seed inicial recebe a marca Sistema. Para essas categorias pai, o botão Editar e Excluir não aparece no cabeçalho. Para subcategorias do sistema, no lugar dos botões aparece a tag cinza Sistema. Você só pode adicionar novas subcategorias dentro delas (botão Subcategoria continua disponível).

Subcategoria herda tipo e cor

O formulário de subcategoria não pede tipo nem cor - o controller força tipo e cor do pai no momento de salvar. Se você mudar a cor da categoria pai depois, todas as subcategorias são atualizadas automaticamente para a nova cor.

Excluir categoria com filhos ou lançamentos

Quando a categoria tem subcategorias ou transações/contas a pagar vinculadas, a primeira tentativa de exclusão é bloqueada com aviso. O modal de confirmação exibe o detalhe (por exemplo, "tem 3 subcategorias e 12 transações") e o botão muda para Excluir mesmo assim. Ao confirmar:

• As subcategorias não-sistema são apagadas em cascata.
• As transações e contas a pagar vinculadas ficam sem categoria (categoria_id passa a null), mas não são removidas.

Categoria do tipo "Receita e Despesa"

O sistema aceita o tipo Receita e Despesa, útil quando a mesma categoria pode receber lançamentos dos dois lados (exemplo: ajustes, reembolsos). Use com critério, pois afeta a leitura dos relatórios por tipo.

Erros comuns e como resolver

• "Categorias do sistema não podem ser editadas." - Causa: você tentou editar uma categoria marcada como sistema. Solução: crie uma nova categoria/subcategoria sua e use-a no lugar; categorias do sistema só aceitam novas subcategorias filhas.
• "Categorias do sistema não podem ser excluídas." - Causa: tentativa de excluir categoria criada pelo seed inicial. Solução: deixe a categoria sistema viva (não atrapalha) e ignore-a no uso diário.
• "Esta categoria possui subcategorias. Confirme a exclusão para apagar todas." - Causa: a categoria pai ainda tem filhos. Solução: se realmente quiser remover o ramo inteiro, confirme em Excluir mesmo assim no modal - as subcategorias não-sistema serão apagadas em cascata.
• "Esta categoria possui transações vinculadas. Confirme a exclusão - as transações ficarão sem categoria." - Causa: já há lançamentos usando essa categoria. Solução: avalie se quer deixar transações sem categoria nos relatórios; se sim, confirme. Como alternativa, edite as transações antes para apontar outra categoria.

Onde encontrar

• URL: /admin/financeiro/categorias
• Caminho no menu: Financeiro > Categorias Financeiras
• Permissões necessárias: ver o financeiro e financeiro.categorias
• Módulo necessário: Gestão Financeira (gestao-financeira)

Veja também

• Visão Geral do Financeiro
• Transações Financeiras
• Contas Bancárias
• Contas a Pagar
• DRE - Demonstração de Resultado