Categorias Financeiras
O módulo de Categorias Financeiras organiza receitas e despesas em formato de árvore (categorias e subcategorias), padronizando lançamentos financeiros e facilitando análises por tipo, status e uso.
Com ele, você consegue:
- ✅ Criar categorias raiz e subcategorias
- ✅ Classificar cada categoria como "Despesa", "Receita" ou "Despesa e Receita"
- ✅ Controlar status "Ativo/Inativo"
- ✅ Definir "Uso Financeiro" para sugestão automática em lançamentos
- ✅ Reordenar categorias com as setas ↑/↓
Visão Geral
A tela exibe uma árvore hierárquica com:
- Título "Categorias Financeiras" e descrição do módulo
- Botão "Nova Categoria"
- Menu de opções (⋯) com atalho para "Ajuda"
- Contador de categorias raiz
- Ações de "Expandir Tudo" e "Recolher Tudo"
- Badges por linha com "Tipo", "Uso Financeiro" e "Status"
Cada linha da árvore possui:
- Setas de ordenação (mover para cima/baixo)
- Expansão/recolhimento quando houver filhos
- Nome da categoria
- Ações de contexto (adicionar subcategoria, editar e menu de opções)
Acessando o Módulo
- Faça login no sistema
- No menu lateral, clique em "Financeiro"
- Selecione "Categorias Financeiras"
Estrutura em Árvore
As categorias são exibidas em níveis:
- Categoria raiz: nível principal
- Subcategoria: vinculada a uma categoria pai
Funcionalidades da árvore:
- Expandir/Recolher por nó: use a seta ao lado da linha
- Expandir Tudo / Recolher Tudo: controles no topo da árvore
- Ordenação manual: use as setas ↑/↓ para alterar a ordem entre itens irmãos
Campos exibidos por linha
| Campo | Descrição |
|---|---|
| Categoria | Nome da categoria financeira |
| Tipo | Classificação: "Despesa", "Receita" ou "Despesa e Receita" |
| Uso Financeiro | Sugestão automática em lançamentos (quando configurado) |
| Status | Situação da categoria: "Ativo" ou "Inativo" |
| Ações | Adicionar subcategoria, editar e opções de exclusão |
Categorias com subcategorias não podem ser excluídas diretamente. Primeiro remova ou reorganize os filhos.
Criando Nova Categoria
- Clique em "Nova Categoria"
- No modal "Nova Categoria Financeira", preencha os campos obrigatórios
- Clique em "Salvar"
Campos do formulário
| Campo | Obrigatório | Descrição |
|---|---|---|
| Categoria | ✅ | Nome da categoria (até 100 caracteres) |
| Tipo | ✅ | "Despesa", "Receita" ou "Despesa e Receita" |
| Status | ❌ | "Ativo" ou "Inativo" (padrão inicial: Ativo) |
| Uso Financeiro | ❌ | Define sugestão automática em lançamentos relacionados |
O formulário também possui menu de ações no cabeçalho (engrenagem), com opções de salvar e ações auxiliares da tela.
Criando Subcategoria
Para criar uma subcategoria:
- Na linha da categoria pai, clique no ícone "+"
- O modal abrirá como "Nova Subcategoria"
- Preencha os dados e clique em "Salvar"
Quando aberto como subcategoria, o sistema mostra o aviso: "Esta categoria será criada como subcategoria."
Editando Categoria
- Clique no ícone de "editar" (lápis) na linha desejada
- Altere os dados necessários
- Clique em "Salvar"
No modo de edição, o formulário mostra o título "Editar Categoria Financeira" e pode exibir o caminho hierárquico da categoria.
Excluindo Categoria
- Abra o menu de ações da linha (ícone de três pontos)
- Clique em "Excluir"
- Confirme na janela "Confirmar Exclusão"
Se houver bloqueio de regra (por exemplo, dependências), o sistema exibe alerta com a mensagem de erro retornada.
Tipos de Categoria
As categorias podem ser classificadas em:
| Tipo | Uso |
|---|---|
| Despesa | Para gastos e saídas financeiras |
| Receita | Para entradas e ganhos financeiros |
| Despesa e Receita | Quando a categoria pode ser usada nos dois contextos |
Uso Financeiro (Sugestão Automática)
O campo "Uso Financeiro" permite associar a categoria a cenários comuns, como:
- Compra de Mercadoria
- Venda de Mercadoria
- Juros Pagos e Juros Recebidos
- Multa Paga e Multa Recebida
- Frete (Compra / Venda)
- Desconto Obtido e Desconto Concedido
- Tarifas Bancárias
- Impostos
Essa associação ajuda o sistema a sugerir automaticamente categorias em lançamentos correspondentes.
Regras e Validações
- Categoria é obrigatória
- Tipo é obrigatório
- Nome da categoria limitado a "100 caracteres"
- Ao fechar o formulário sem salvar, o sistema solicita confirmação
- Exclusão exige confirmação prévia
Permissões
As ações respeitam permissões do módulo "Categorias Financeiras":
- Criar: habilita botão "Nova Categoria" e adição de subcategoria
- Editar: habilita atualização de categorias existentes
- Excluir: habilita remoção via menu de ações
Boas Práticas
Padronize nomenclaturas para evitar categorias duplicadas e facilitar filtros e relatórios.
Use subcategorias para detalhar a análise sem poluir o nível raiz.
Utilize o campo Uso Financeiro sempre que houver um destino recorrente para melhorar sugestões automáticas.
Quando houver histórico de uso, prefira inativar categorias antigas antes de excluir.