Classificação automática de documentos fiscais: como o motor de regras organiza seus XMLs

Classificação automática de documentos fiscais é o uso de critérios verificáveis do XML para encaminhar cada nota a uma classe operacional, como matéria-prima, frete, transferência ou consumo interno. O objetivo não é adivinhar. É aplicar o mesmo raciocínio aos casos recorrentes e deixar os ambíguos para revisão.

Essa distinção define uma automação confiável: um bom motor não é apenas o que classifica muito, mas o que sabe quando os sinais ainda não sustentam uma decisão.

Como funciona, do XML à classe

1. O documento entra na plataforma com o XML completo.
2. A Noltyz extrai os dados relevantes: CFOP, NCM, emitente, tipo do documento, entrada ou saída, indício de transferência e trechos do conteúdo.
3. O motor de regras compara esses dados com as regras ativas da sua conta.
4. A classe vencedora é aplicada automaticamente, com rastreio do que pontuou.

Você configura uma vez. Cada novo XML passa pelo mesmo critério, de forma consistente.

O que você configura: classes e regras

A classificação na Noltyz tem duas peças:

• Classes: os “baldes” da sua operação (ex.: Compras, Frete, Transferência, Consumo interno).
• Regras: critérios com peso. Cada regra que casa com o documento soma pontos para uma classe.

Ganha a classe com maior pontuação, desde que atinja o score mínimo definido por você e fique claramente à frente da segunda colocada. Se o resultado for dúbio, a plataforma não força um rótulo: cai em uma classe de sistema (desconhecida), para revisão humana. Melhor do que classificar errado em silêncio.

Critérios que o motor entende

As regras podem usar os sinais que realmente aparecem no XML fiscal:

• CFOP da nota
• NCM completo ou por prefixo
• Fornecedor (CNPJ/CPF do emitente)
• Modelo do documento (NF-e, CT-e e demais tipos suportados)
• Entrada ou saída (tipo da NF)
• Transferência entre filiais
• Palavra-chave no conteúdo da nota

Combine critérios. Exemplo: fornecedor X + CFOP Y + peso alto = classe “Matéria-prima”. Outro CFOP do mesmo fornecedor pode ir para “Consumo”. O motor soma as regras que baterem e decide.

Automática, mas sob o seu controle

A classificação roda sozinha na chegada do documento. Se alguém corrigir a classe manualmente, essa correção prevalece e a Noltyz respeita a decisão humana nas próximas rodadas automáticas daquele documento. Quando fizer sentido, você pode pedir a reclassificação automática com o XML completo de novo.

Etiqueta não é classificação. Etiqueta marca o documento para filtros, relatórios e acompanhamento operacional. A classificação define a classe fiscal/operacional via motor de regras. O ponto de contato entre os dois: o histórico de etiquetas alimenta sugestões automáticas de classes e regras. Você valida o que entra no motor. Nada é aplicado no escuro.

Como testar uma regra antes de confiar nela

1. Separe 20 documentos já conhecidos, incluindo casos simples e exceções.
2. Defina de 5 a 10 classes que a equipe realmente usa.
3. Comece por sinais estáveis, como fornecedor recorrente, CFOP e família de NCM.
4. Execute a classificação e confira qual regra pontuou em cada resultado.
5. Analise também os documentos sem classe e os empates, não apenas os acertos.
6. Ajuste peso, score mínimo e margem antes de ampliar o conjunto.

Se uma regra acerta os exemplos fáceis e erra as exceções, ela ainda não está pronta. Acrescente um critério discriminante ou permita que o caso permaneça desconhecido.

Erros que tornam a classificação frágil

Usar somente o nome do fornecedor ignora operações diferentes da mesma empresa. Usar um CFOP isolado pode misturar finalidades distintas. Reduzir o score mínimo para eliminar a fila aumenta classificações silenciosamente erradas. E criar dezenas de classes parecidas dificulta tanto o motor quanto a revisão humana.

A classe também não corrige cadastro tributário, valida a escrituração nem substitui análise fiscal. Ela organiza o documento conforme a taxonomia definida pela empresa.

Onde a Noltyz entra

Depois que o XML chega pela Distribuição DF-e, Agente Local ou importação, a Noltyz avalia as regras ativas, registra a pontuação e aplica a classe quando os limites configurados são atendidos. Casos incertos permanecem disponíveis para revisão.

As classes tornam buscas, filtros e relatórios mais consistentes. Na análise de fornecedores e produtos, elas ajudam a separar recortes operacionais sem alterar o XML original.

Perguntas frequentes

É necessário usar inteligência artificial para classificar XML?

Não. Regras determinísticas resolvem muitos padrões recorrentes e permitem explicar por que uma classe venceu.

Uma correção manual altera o XML?

Não. A classe é um dado operacional da plataforma. O documento fiscal original permanece preservado.

O sistema aprende automaticamente com toda correção?

Não de forma cega. O histórico pode apoiar sugestões, mas o usuário valida classes e regras antes que passem a integrar o motor.

Posso classificar documentos antigos novamente?

Sim, desde que o XML completo esteja disponível. A reclassificação permite aplicar a configuração atual a documentos já recebidos.

O que acontece quando duas classes têm pontuação próxima?

A margem configurada evita uma vitória artificial. Sem distância suficiente entre as classes, o documento segue para revisão em vez de receber um rótulo incerto.

O que fazer agora

Liste as classes que a equipe usa, escolha uma amostra conhecida e comece pelas regras mais fáceis de explicar. Só aumente a cobertura depois de revisar acertos, empates e documentos sem classificação.

Quer testar esse fluxo com sua base? Comece gratuitamente na Noltyz e configure regras para os XMLs da sua operação.