Categorias

Categorias (/categories) classificam contas a pagar, contas a receber e lançamentos. A estrutura é hierárquica, em até três níveis.

Campos

Campo	Obrigatório	Descrição
Nome	Sim	Nome da categoria
Tipo	Sim	Receita ou Despesa
Empresa	Sim	A empresa dona da categoria
Categoria pai	Não	Categoria superior na hierarquia

Em uma subcategoria, Tipo e Empresa não aparecem — são herdados do pai. Você só escolhe os dois ao criar uma categoria raiz.

Tipo: receita ou despesa

• Despesa — aparece no seletor de contas a pagar e de lançamentos de saída.
• Receita — aparece no seletor de contas a receber e de lançamentos de entrada.

Uma subcategoria é sempre do mesmo tipo do pai. Não há como misturar: o sistema recusa a gravação com "Uma subcategoria precisa ter o mesmo tipo da categoria pai".

Mudar o tipo de uma categoria raiz é permitido, e a mudança desce para toda a subárvore — filhos e netos acompanham.

Hierarquia

Despesas Operacionais (Despesa)
├── Aluguel
├── Energia e Água
│   ├── Energia Elétrica
│   └── Água e Esgoto
└── Folha de Pagamento
    ├── Salários
    └── Encargos

Receitas (Receita)
├── Mensalidades
└── Serviços
    ├── Consultoria
    └── Suporte

observação

O limite é de três níveis. No terceiro nível o botão Adicionar subcategoria deixa de aparecer, e uma tentativa por outro caminho é recusada com "Limite de 3 níveis de hierarquia atingido."

A tela

Categorias são exibidas em cards, não em tabela. Cada card é uma categoria raiz, com suas subcategorias listadas dentro.

• Busca por nome. Um resultado em nível 2 ou 3 traz o card inteiro do ancestral para a tela, para você ver onde ele está.
• Abas com contadores: Todas · Despesas · Receitas. Os contadores contam apenas categorias raiz — é o número de cards.
• Duplo clique no nome abre a edição ali mesmo, sem diálogo.
• Badges: Receita ou Despesa no card raiz, e Não usada quando nem a categoria nem nenhuma subcategoria dela tem vínculos.
• A contagem de lançamentos de um card soma a subárvore — o número no pai inclui o que está nos filhos.

Com o seletor de empresa em "Todas", os cards são agrupados em seções recolhíveis por empresa. Escolhendo uma empresa específica, vira uma grade única.

Filtrar por categoria em outras telas

Ao filtrar lançamentos ou títulos por uma categoria pai, as subcategorias não entram automaticamente. Dentro do filtro de Categoria existe a opção Incluir subcategorias — marque para que o filtro alcance a subárvore inteira.

A opção Sem categoria, no mesmo filtro, é mutuamente exclusiva: marcá-la desabilita o Incluir subcategorias.

Importação de CSV

aviso

A importação de CSV não cria categorias. Ela apenas procura pelo nome: se existir, vincula; se não existir, o lançamento entra sem categoria — sem erro e sem aviso.

Isso é diferente de Pessoas, que a importação cria quando não encontra. Se você vai importar um arquivo, cadastre as categorias antes.

Criar categoria pelo nome funciona nos formulários e na API.

Excluir

perigo

A exclusão não é bloqueada por uso — e apaga as subcategorias junto. Excluir uma categoria remove ela e toda a sua subárvore. Os lançamentos, contas a pagar e contas a receber vinculados não são apagados: eles ficam sem categoria.

O diálogo diz exatamente isso antes de você confirmar: "Isso vai excluir esta categoria e todas as subcategorias. Esta ação não pode ser desfeita.", seguido do que encontrou — "Esta categoria está vinculada a 12 lançamentos, 3 contas a pagar (15 no total). Esses lançamentos ficarão sem categoria após a exclusão." Se não houver vínculo, ele também diz.

O aviso é informativo, não impede. Se quiser preservar a classificação, reclassifique os registros antes: nas telas de Lançamentos, Contas a pagar e Contas a receber, selecione as linhas e use Classificar selecionados.