Classificadores personalizados
Classificadores personalizados (/custom-classifiers) são dimensões de classificação que você cria — como "Região", "Produto" ou "Canal" — para além dos eixos fixos (categoria e centro de classificação). Cada dimensão tem seus próprios valores, e um mesmo título pode receber várias dimensões ao mesmo tempo.
"Crie dimensões próprias (ex.: Região, Produto) e seus valores para classificar seus lançamentos."
Dois níveis: dimensão e valor
O catálogo tem dois níveis:
- Dimensão — o eixo. Só tem um nome (ex.: "Região").
- Valor — cada opção dentro da dimensão (ex.: "Sul", "Sudeste"). Vive dentro da dimensão.
Uma dimensão sem valores aparece na listagem marcada como "Sem valores" — ela existe, mas ainda não classifica nada até você adicionar ao menos um valor.
Campos
| Campo | Nível | Descrição |
|---|---|---|
| Nome da dimensão | Dimensão | Obrigatório. Ex.: "Região" |
| Empresa | Dimensão | A dimensão pertence a uma empresa |
| Ativo | Dimensão | Liga/desliga. "Dimensões inativas não aparecem nos formulários." |
| Valor | Valor | Obrigatório. Ex.: "Sudeste" |
| Ativo | Valor | Liga/desliga o valor individualmente |
A tela
A gestão fica em Eixos → Classificadores personalizados, em uma tabela onde cada linha é uma dimensão com seus valores em chips ao lado.
- Busca por nome da dimensão ("Buscar dimensão...").
- Nova dimensão cria o eixo; o diálogo de valores adiciona, renomeia, ativa/desativa e exclui cada valor ao vivo ("Adicionar valor", "Novo valor...").
- Um valor pode ser ativado ou desativado individualmente sem sair da dimensão.
Quando não há nenhuma dimensão cadastrada, a tela mostra o estado vazio: "Nenhum classificador cadastrado — Crie dimensões como 'Região' ou 'Produto' e seus valores para classificar seus lançamentos."
Ativo e inativo
O flag Ativo existe nos dois níveis, e o efeito é o mesmo dos centros de classificação: desativar não apaga.
- Uma dimensão inativa sai dos formulários, mas o histórico que já a referencia permanece.
- Um valor inativo some do seletor para novas escolhas — mas, se um título já o usa, ele continua aparecendo ali como o valor selecionado, para não sumir do registro.
Exclusão
Como nos centros de classificação, o produto converte a exclusão em desativação quando há uso — não existe caminho que largue os lançamentos sem classificação.
Valor em uso — não há exclusão: "Valor está em uso por lançamentos. Desative em vez de excluir."
Dimensão em uso — o diálogo é "Classificador em uso":
"Este classificador está em uso por lançamentos e não pode ser excluído. Deseja desativá-lo?"
O botão é "Desativar". Excluir a dimensão só é possível quando nenhum dos seus valores está atribuído a um título.
Classificar um lançamento
O bloco "Classificadores personalizados" aparece nos formulários de contas a pagar, contas a receber e lançamentos — as três telas, e também na visão de detalhe de cada uma.
- Há um seletor por dimensão ativa. Todas as dimensões ativas ficam sempre visíveis.
- A seleção é um valor por dimensão (seleção única) — diferente do rateio de centros de classificação, aqui não se divide um título entre valores.
- O seletor faz "selecionar ou criar": digitando um valor que ainda não existe, ele oferece "Cadastrar valor '...' ao salvar" e cria o valor na dimensão quando você grava o título.
A classificação não se espalha automaticamente para as parcelas 2 em diante. Ao publicar um título parcelado, a dimensão fica na parcela âncora — o mesmo comportamento do centro de classificação. Para aplicar em várias linhas de uma vez, use Classificar selecionados nas listagens de Lançamentos, Contas a pagar e Contas a receber.
Pesquisa avançada
Na pesquisa avançada de Lançamentos, Contas a pagar e Contas a receber há um facet único "Classificador", que reúne os valores de qualquer dimensão. Marcando um ou mais valores, a busca traz os títulos que os carregam.
O mesmo facet oferece "Sem classificador", para achar os títulos que não receberam nenhuma dimensão. O facet só aparece quando existe ao menos uma dimensão cadastrada.
Relatórios
Os relatórios (normal e fiscal) aceitam agrupar por classificador: escolhida uma dimensão, cada linha do relatório é um valor dela, e os títulos sem aquela dimensão caem em "(sem classificador)" — nunca somem do total.
Importação de CSV
Diferente de categorias e centros de classificação, a importação de CSV cria os valores que faltam.
- Cada dimensão ativa vira uma coluna no arquivo, com o nome da dimensão no cabeçalho.
- No momento da importação, o valor de cada linha é procurado e criado se não existir naquela dimensão.
As dimensões em si não são criadas pela importação — cadastre-as antes; os valores, sim, nascem do arquivo.
Na API
A API pública v1 expõe o catálogo em /api/v1/custom-classifiers (dimensões, com os valores em rotas aninhadas /{id}/values) sob o escopo finance.custom_classifiers (leitura) e finance.custom_classifiers.write (escrita).
Nos títulos, o campo custom_classifications acompanha contas a pagar, contas a receber e lançamentos: uma contagem na listagem, a lista completa no detalhe, e, na escrita, você informa o valor por id ou pelo nome (selecionar-ou-criar). Detalhes na referência da API.
Origem Fintera
Quando a integração com a Fintera está ativa, os classificadores e seus valores são importados de lá (somente leitura). O vínculo de um título nomeia o valor por texto, resolvido para o valor correspondente no Financeiro Inteligente no momento da importação. Ver Integração Fintera.