Classe processual, assunto e órgão julgador no cadastro: como padronizar os campos categóricos para o relatório por área fechar

Classe processual no cadastro não é caixa de texto: é campo de domínio fechado, com lista de valores permitidos, código como chave e rótulo apenas como exibição. O relatório por área não fecha porque classe, assunto e órgão julgador são digitados como texto livre, e cada digitação cria um rótulo novo no lugar de uma categoria.

• Classe é o tipo de ação, assunto é a matéria e órgão julgador é onde tramita: três perguntas que não cabem em um campo só de “tipo”.
• Grave o código como chave e o rótulo como exibição — assim o texto muda sem quebrar relatório.
• O vocabulário interno do escritório vira um de-para com dono e data, de muitos termos para um código.
• Área de atuação e carteira são camada derivada do campo oficial, nunca gravadas por cima dele.

Classe processual no cadastro é campo de domínio fechado, não caixa de texto

Campo de domínio fechado é o campo que só aceita valor de uma lista previamente definida. O oposto é o campo aberto, que aceita qualquer texto. Classe, assunto e órgão julgador pertencem ao primeiro grupo e quase sempre são cadastrados como se fossem do segundo.

O sintoma aparece no relatório. A mesma ação vira “Execução de Título Extrajudicial” em uma linha, “exec. titulo extrajud” em outra e “cobrança” na terceira. São três rótulos, e o relatório por área conta três coisas diferentes.

Não existe momento em que o sistema recuse o valor, então nada aparece como erro na hora. Isso não se corrige com treinamento nem com convenção combinada em reunião: enquanto o campo aceitar qualquer coisa, a base guarda grafias no lugar de categorias. O raciocínio é o mesmo de padronizar dados de cliente: a chave nunca é o texto exibido.

Classe, assunto e órgão julgador: três campos, três perguntas diferentes

Os três costumam morar em um campo único de “tipo”. São perguntas distintas.

• Classe responde “que tipo de ação é esta?” — o formato processual pelo qual o caso tramita.
• Assunto responde “sobre o que é?” — a matéria discutida. Um mesmo tipo de ação carrega assuntos muito diferentes.
• Órgão julgador responde “onde tramita?” — a unidade concreta que conduz o caso dentro de um tribunal.

Classe costuma ser um valor por processo. Assunto admite mais de um. Órgão julgador muda ao longo da vida do processo, e o histórico precisa sobreviver à mudança.

Colapsar os três é o que faz o relatório por área não bater com o relatório por vara: os dois leem o mesmo campo esperando respostas diferentes. Nada disso é enquadramento jurídico: o assunto é estrutura de dado, não qual classificação cabe a um caso concreto.

Código como chave, rótulo como exibição: o papel das tabelas do CNJ

Tabelas Processuais Unificadas (TPU) são as tabelas mantidas pelo CNJ que padronizam classe, assunto e movimento com código e descrição. Órgão julgador tem tabela própria, definida por tribunal. Nos dois casos vale o mesmo princípio: vocabulário externo comum, no lugar da taxonomia que cada escritório inventa e depois precisa traduzir a cada integração.

O desenho do campo tem duas partes: gravar o código como chave — o que agrupa, filtra e soma — e o rótulo como exibição, o que aparece na tela e no relatório. O rótulo pode ser reescrito, abreviado ou traduzido sem quebrar relatório, porque a soma nunca depende do texto.

A hierarquia da tabela é útil para agregar — somar por ramo, não só por folha. Mas quem grava no registro é sempre a folha escolhida, nunca o nível intermediário: nível intermediário gravado é detalhe perdido que não volta.

O de-para entre o vocabulário interno e o código oficial

De-para é uma tabela de tradução: de um lado o termo que o time usa, do outro o código oficial correspondente. Ninguém vai parar de dizer “a execução do banco” — e não precisa. O de-para preserva o apelido interno e o amarra a um código único.

1. Extrair da base os valores distintos que já existem hoje.
2. Ordenar por volume de registros.
3. Mapear primeiro os que respondem pela maior parte dos registros; o resto vira fila.
4. Registrar dono e data em cada entrada. Termo novo não entra por digitação, entra por decisão registrada.

A relação tem direção: um termo interno aponta para um código, e um código recebe vários termos internos. É de muitos para um, nunca o contrário — o inverso devolve a ambiguidade que o de-para existe para eliminar. E mapear é escolher, não adivinhar: termo ambíguo vai para exceção com dono, não para o código mais parecido.

Se a base vem de planilha, esse mapeamento pertence ao plano de carga inicial e é decidido antes de importar.

Quando a fonte consultada devolve um valor fora da sua lista

A fonte oficial pode devolver descrição fora do seu de-para: rótulo atualizado, variação de escrita, valor que o escritório nunca recebeu antes. Três saídas parecem práticas e precisam estar proibidas por escrito.

• Descartar o valor silenciosamente — o registro chega classificado como vazio e ninguém sabe que houve perda.
• Forçar o código mais parecido — o relatório soma no lugar errado e não acusa nada.
• Reabrir o campo e gravar o texto como veio — o campo fechado deixa de ser fechado no dia em que dá trabalho.

O caminho é outro: gravar o valor original em campo de origem, marcar o registro como “não classificado” no campo oficial e mandar para fila de exceção com dono e prazo. O processo segue rastreável; o que fica pendente é a classificação, não o cadastro.

Valor não mapeado que reaparece é item faltando no de-para, não erro do operador, e a correção é na lista. Vale a disciplina já descrita para a fila de entrada: sem dono e prazo, exceção vira limbo.

Área de atuação e carteira: classificação interna é camada derivada

O escritório precisa de recortes que a tabela oficial não tem: área de atuação, carteira, time responsável, tipo de cliente. Esses recortes são camada derivada — calculada a partir do código oficial por regra escrita e gravada em campo próprio.

A regra que não pode ser quebrada: classificação interna nunca sobrescreve o campo oficial. Sobrescrever perde a única referência comparável entre tribunais. Quando o escritório muda áreas ou carteiras, basta reprocessar a camada derivada, porque o dado de origem continua intacto.

A derivação pode combinar mais de um campo — classe mais assunto, ou assunto mais órgão julgador — e admite exceção manual, desde que a exceção fique marcada como tal. Ela falha quando o dado a montante é ruim: registro sem assunto preenchido não cai em área nenhuma. O furo aparece no relatório por área, mas nasceu no cadastro.

Onde a validação de domínio entra: na gravação, não no relatório

No cadastro tratado como pipeline — captura, higienização, conferência, exceção e publicação —, a validação de domínio é regra de gravação: valor fora da lista não é aceito. Lista suspensa na tela ajuda o operador, mas não é controle, porque importação, integração e carga em lote não passam pela tela.

Corrigir categoria na hora de montar o relatório é a pior posição possível: o ajuste vive na planilha de quem monta e precisa ser refeito no mês seguinte. É o mesmo princípio do bloqueio de duplicidade — a checagem vale onde o registro é gravado, não onde é consultado.

Dentro do pipeline, a ordem sugerida é:

1. Conferir número e existência do processo, nas camadas de validação do número CNJ.
2. Resolver as partes e os vínculos.
3. Classificar classe, assunto e órgão julgador.
4. Publicar.

A ordem não é estética. Classificar registro que aponta para o processo errado é trabalho jogado fora, e dado categórico inconsistente publicado vira relatório entregue que precisa ser desfeito.

O que medir: cobertura de classe e assunto e volume não classificado

Dois números mostram se a padronização está funcionando.

• Cobertura: percentual de registros com classe e assunto vindos da lista — não apenas preenchidos, mas preenchidos com código válido.
• Volume parado em “não classificado”, medido junto com a idade do item mais antigo. Volume estável com idade crescente é fila sem dono.

Um terceiro sinal: quantos valores de origem ainda não têm entrada no de-para.

Meça por etapa do pipeline, não no total — o total esconde onde a classificação está falhando. A linha de base é a do próprio escritório no início da medição.

Campo categórico fechado é o que faz o relatório por área fechar

São quatro decisões de desenho: lista de valores permitidos no lugar de texto livre, código como chave e rótulo como exibição, classificação interna derivada do campo oficial e validação na gravação — o que não passa vai para fila de exceção com dono.

O relatório por área fecha quando classe, assunto e órgão julgador deixam de ser digitados e passam a ser escolhidos. Para desenhar esse de-para dentro do fluxo e dos sistemas que o escritório já usa, fale com a gente.

Perguntas frequentes

Qual a diferença entre classe, assunto e órgão julgador?

Classe responde 'que tipo de ação é esta?' — o formato processual pelo qual o caso tramita. Assunto responde 'sobre o que é?' — a matéria discutida. Órgão julgador responde 'onde tramita?' — a unidade concreta que conduz o caso dentro de um tribunal.

Classe costuma ser um valor por processo. Assunto admite mais de um. Órgão julgador muda ao longo da vida do processo, e o histórico precisa sobreviver à mudança.

Por que o mesmo tipo de processo aparece escrito de formas diferentes no sistema?

Quando classe, assunto e órgão julgador são digitados como texto livre, cada digitação cria um rótulo novo no lugar de uma categoria. O sintoma aparece no relatório: a mesma ação vira 'Execução de Título Extrajudicial' em uma linha, 'exec. titulo extrajud' em outra e 'cobrança' na terceira — três rótulos diferentes que o relatório conta como três coisas diferentes.

O que é um de-para no contexto de cadastro de processos?

De-para é uma tabela de tradução entre o vocabulário interno do escritório e os códigos oficiais. Um termo interno aponta para um código, e um código recebe vários termos internos — é uma relação de muitos para um. Preserva o apelido interno e o amarra a um código único.

O que fazer quando a consulta devolve uma classe ou assunto que não existe na lista?

Deve-se gravar o valor original em campo de origem, marcar o registro como 'não classificado' no campo oficial e mandar para fila de exceção com dono e prazo. O processo segue rastreável; o que fica pendente é a classificação, não o cadastro.

Três práticas que precisam estar proibidas: descartar o valor silenciosamente (o registro chega como vazio e ninguém sabe que houve perda), forçar o código mais parecido (o relatório soma no lugar errado) ou reabrir o campo (o campo fechado deixa de ser fechado).

Por que a validação deve acontecer na gravação e não no relatório?

Corrigir categoria na hora de montar o relatório é a pior posição possível: o ajuste vive na planilha de quem monta e precisa ser refeito no mês seguinte. A validação de domínio é regra de gravação — valor fora da lista não deve ser aceito. Isso vale porque importação, integração e carga em lote não passam pela tela.

Se faz sentido acelerar o cadastro sem abrir mão da conferência com o CNJ, fale com a equipe Projask sobre fluxo automatizado e integração. Você também pode usar o formulário na seção Contratar solução na página inicial.