Regras automáticas
Regras automáticas (/automatic-rules) classificam lançamentos automaticamente conforme critérios cadastrados, dispensando a categorização manual de documentos recorrentes.
Escopo da regra
Cada regra tem um escopo fixo (definido na criação, imutável) e pertence a uma entidade. O escopo é um par de abas no topo do formulário, sem rótulo — as duas opções são:
- Contas financeiras — dispara em lançamentos recém-criados.
- Contas a pagar / receber — dispara em títulos recém-criados.
Como funciona
Avaliado um documento, o sistema percorre as regras da mesma entidade e do mesmo escopo, em ordem de precedência. A primeira regra ativa cujos critérios batam todos é aplicada — e só ela. Os campos definidos na regra sobrescrevem os valores do documento, mesmo já preenchidos.
Critérios
A regra combina critérios com lógica E — todos precisam bater. O montador tem dois lados, SE (critérios) e ENTÃO (ações), com uma pré-visualização em linguagem corrente.
| Critério | Como compara |
|---|---|
| Entidade | Obrigatório — a empresa da regra |
| Conta | Igualdade (só no escopo Contas financeiras) |
| Tipo de lançamento | Pagamentos ou Recebimentos |
| Cliente/Fornecedor | Igualdade |
| Descrição original contém | Trecho do texto, ignorando maiúsculas |
| Observação contém | Trecho do texto, ignorando maiúsculas |
Maiúsculas são ignoradas; acentos não. A comparação baixa a caixa das duas pontas, mas não remove acento: uma regra com "Pao" não pega uma descrição escrita "Pão". Escreva o critério como o texto realmente chega.
Não existe critério de valor ou faixa, nem operadores "igual a / começa com / termina com" — texto é sempre "contém".
O link "Exibir lançamentos afetados por esse critério" abre a pré-visualização com o que a regra pegaria hoje — vale conferir antes de salvar.
Ações
| Ação | Descrição |
|---|---|
| Descrição | Reescreve a descrição |
| Cliente/Fornecedor | Atribui a pessoa |
| Categoria | Atribui a categoria |
| Centro de classificação | Atribui um centro |
| Pagar/Receber via | Define a conta prevista (só no escopo Contas a pagar / receber) |
A ação de centro de classificação não rateia. Ela atribui um único centro — o seletor é de escolha única. Para dividir entre centros, use o Rateio no formulário do título. Ver Centros de classificação.
Precedência
Regras só competem dentro do próprio grupo: entidade × escopo. Cada card traz as setas "Mover para cima" e "Mover para baixo", e a regra de menor posição vence primeiro.
As setas param na borda do grupo. Mesmo havendo um card logo acima na tela, a seta não passa por cima dele se for de outro grupo — a listagem mostra todos os grupos em uma coluna só, mas a ordenação é por grupo. Não é travamento: mover para lá não faria sentido, porque regras de grupos diferentes nunca disputam o mesmo documento.
- Num grupo de uma regra só, as setas não aparecem — não há contra quem ordenar.
- Na primeira do grupo, a seta para cima fica desabilitada; na última, a de baixo.
- Não há aviso ao mover: o card mudando de lugar é a confirmação.
A ordem dos grupos entre si não significa nada. Os grupos são listados por identificador interno da entidade, não por nome nem por relevância. Um grupo aparecer acima de outro não lhe dá precedência — a disputa nunca cruza grupos.
Ativar e pausar
A pílula no rodapé do card mostra o estado — "Regra ativa" ou "Regra desativada" — e o clique faz a ação oposta, que o tooltip anuncia: "Pausar" ou "Retomar". Os avisos são "Regra ativada" e "Regra desativada".
Regra pausada nunca dispara. Ela não é apenas ignorada na listagem: a avaliação só considera regras ativas. Pausar é a forma de desligar uma regra sem perdê-la.
Onde as regras disparam
- Criação de lançamentos e títulos (formulário e API).
- Importação CSV — lançamentos, contas a pagar e contas a receber.
- Extratos bancários, ao commitar o extrato.
- Parcelas geradas — cada parcela do grupo é avaliada por conta própria, porque um critério de descrição pode depender do sufixo ("1/12").
- Importação do Fintera — nos três importadores: contas a pagar, contas a receber e lançamentos.
- Sincronização de extrato do Gateway Bancário.
Aplicar às já existentes
Não é uma ação da listagem. É o checkbox "Aplicar regra aos lançamentos já existentes?", no rodapé do formulário. Marcado, salvar pede confirmação e enfileira a aplicação retroativa — que roda em segundo plano ("Aplicação retroativa enfileirada").
Diferente do diálogo "Classificar" em massa, que define categoria e centro manualmente sobre uma seleção, sem criar regra.
Criar uma regra
- Em
/automatic-rules, use "Nova regra". - Escolha a Entidade e, nas abas do topo, o escopo — "Contas financeiras" ou "Contas a pagar / receber". Só dá para escolher agora: depois de salva, a regra não muda de escopo.
- Monte os critérios (SE) e as ações (ENTÃO), conferindo a pré-visualização.
- Salve — a regra vale imediatamente para os novos documentos.
Excluir
O diálogo é "Excluir regra automática": "A regra será removida permanentemente. Lançamentos já classificados não são afetados."