1. Cadastros

PROC002 - Cadastro de Nova Empresa
PROC003 - Cadastro de Cliente e Fornecedor
PROC004 - Cadastro de Vendedor

PROC002 - Cadastro de Nova Empresa

Projeto/Sistema:
GERENCIEAQUI - MIGRAÇÃO CNPJ ALFANUMÉRICO (NT 2026.004)

Versão do Template:
1.2

Processo:
PROC002 - Cadastro de Nova Empresa

Versão do Documento:
1.0

Responsável(eis):
Luís Leite

Data:

25/05/2026

1. Introdução

Este processo descreve a adaptação do fluxo de cadastro inicial e do cadastro adicional de empresa pelo usuário logado ao CNPJ Alfanumérico (NT 2026.004).

2. Processo

Processo	Envolvidos	Dados de Entrada	Dados de Saída
PROC002 - Cadastro de Nova Empresa	Usuário	CNPJ Alfanumérico	CNPJ Alfanumérico validado e cadastrado em banco.

Processos Relacionados

PROC001 — Núcleo de validação e formatação de CNP

Especificação Funcional

PROC002 - Cadastro de Nova Empresa:

Protótipo de Tela:

Descrição dos Campos:

Campo	Tipo	Tamanho	Obrig. ?	Máscara	Observações
CNPJ*	Texto	14	Sim	-	-

Regras de Interface:

1.Ajuste de validação: Conferir validação do campo para aceitar alfanumérico. Reaproveitar validações do PROC001 - Núcleo de validação de formatação de CNPJ
2. Normalização: Deve ser tratado para deixar todas as letras em caixa maior (maiúsculo) visando a padronização da informação.

Regras de Negócio:

1. Validação tripla mantida: O fluxo atual valida o CNPJ em três pontos (ajax onChange, novaEmpresa, EmpresaService.salvarNovaEmpresa) via CnpjUtil.isCnpjValidoSalvar. Como o util legado já usa charAt-48 e substring (tolerantes a alfanumérico), a validação funciona após a correção do PROC001.

2. Unicidade global do CNPJ: isDBContainCnpj (CnpjUtil:400) verifica via EmpresaDao.existsByCnpj se já há empresa cadastrada com o mesmo CNPJ. Bloqueia o cadastro com mensagem "Já existe uma empresa com esse CNPJ!". A collation default do MariaDB é case-insensitive — a normalização para maiúsculas elimina ambiguidades em comparações externas.

3. Token A3 sensível à caixa: Empresa.gerarTokenA3 (Empresa.java:736) faz gerarHash(cnpj + email, "SHA-256"). Como SHA-256 é sensível a caixa, o CNPJ DEVE ser gravado em maiúsculas — caso contrário, "ABC..." e "abc..." gerariam tokens diferentes e quebrariam a integração com certificado A3.

Regras de Interface:

1. Mudança na base de dados: Sem alteração. Coluna 'empresa'.'cnpj' é varchar(20).

©SOFTEN SISTEMAS 2026

PROC003 - Cadastro de Cliente e Fornecedor

Projeto/Sistema:
GERENCIAMENTO DE PROJETOS

Versão do Template:
1.2

Processo:
Descrição Processo

Versão do Documento:
1.0

Responsável(eis):
-

Data:

05/01/2026

1. Introdução

Este processo descreve a adaptação dos cadastros de Cliente e Fornecedor ao CNPJ Alfanumérico (NT 2026.004). Inclui o cadastro principal (tela de edição com aba de informações), o diálogo de cadastro rápido (dialogNovoCliente) e a listagem com filtro de busca. O fornecedor é representado pela mesma entidade Cliente.

2. Processo

Processo	Envolvidos	Dados de Entrada	Dados de Saída
PROC003 - Cadastro de Cliente e Fornecedor	Usuario	CPF (11 dígitos) ou CNPJ alfanumérico (14 caracteres) — com ou sem máscara	Cliente/Fornecedor persistido com CPF/CNPJ normalizado em maiúsculas; listagem com filtro alfanumérico
PROC003.1 - Listagem de Clientes e Fornecedores		Query de Consulta	Retorno em Listagem em Tela

Processos Relacionados

PROC001 — Núcleo de validação e formatação de CNPJ

Especificação Funcional

PROC003 - Cadastro de Cliente e Fornecedor:

Protótipo de Tela:

Descrição dos Campos:

Campo	Tipo	Tamanho	Obrig. ?	Máscara	Observações
CPF/CNPJ	Texto	11-14	Sim	-	11 dígitos = CPF (numérico); 14 caracteres = CNPJ (alfanumérico).

Regras de Interface:

1. Ajuste de validação: Deve ser alterada a validação de campo para permitir informar alfanumérico. Reaproveita util/ValidaCNPJ.java (corrigido em PROC001).

2. Caracteres especiais bloqueados: Deve ser mantida validação para caracteres especiais como acentos, til e outras pontuações não esperadas. Apenas A–Z, 0–9 e os separadores . / - (estes apenas na máscara, removidos na gravação).

3. Normalização para maiúsculas: Tratar para que as letras sejam salvas em caixa maior (maiúsculo), normalizando a informação no banco e garantindo coerência em comparações case-sensitive.

Regras de Negócio:

1. Consulta API: A requisição à API de consulta de CNPJ deve ser feita enviando o CNPJ como campo alfanumérico, preservando letras na URL/payload.

2. Detecção CPF × CNPJ por comprimento: Continua por length() sobre o valor limpo: 11 = CPF (numérico); 14 = CNPJ (alfanumérico ou numérico).

3. Verificação de duplicidade: A normalização para maiúsculas garante que CNPJ alfanumérico digitado em caixa diferente não seja considerado duplicado.

PROC003.1 - Listagem de Clientes e Fornecedores:

Campo	Tipo	Tamanho	Obrig. ?	Máscara	Observações
Busca	Texto	-	-	-	-

Regras de Interface:

1. O campo de Busca deve ser alterado para realizar a consulta de CNPJ alfanumérico. Validar 3 caracteres ou mais para a busca.

Questões Técnicas:

1. Banco de dados: O campo 'empresa'.'cnpj' no banco de dados já é definido como VARCHAR(20), não necessitando mudanças.

2. Query de busca: O campo usa LIKE compatível com texto alfanumérico. Normalizar o termo de busca para maiúsculas antes de aplicar.

©SOFTEN SISTEMAS 2026

PROC004 - Cadastro de Vendedor

Projeto/Sistema:
GERENCIEAQUI - MIGRAÇÃO CNPJ ALFANUMÉRICO (NT 2026.004)

Versão do Template:
1.2

Processo:
PROC004 - Cadastro de Vendedor

Versão do Documento:
1.0

Responsável(eis):
Luís Leite

Data:

26/05/2026

1. Introdução

Este processo descreve a adaptação do cadastro de Vendedor ao CNPJ Alfanumérico (NT 2026.004). Cobre o cadastro principal, o cadastro rápido e a listagem com filtro de busca.

2. Processo

Processo	Envolvidos	Dados de Entrada	Dados de Saída
PROC004 - Cadastro de Vendedor	Usuário	CPF (11 dígitos) ou CNPJ alfanumérico (14 caracteres), com ou sem máscara.	Vendedor cadastrado em banco com CPF/CNPJ normalizado em maiúsculas.
PROC004.1 - Listagem de Vendedor		Query de Consulta	Retorno em Listagem em Tela

Processos Relacionados

PROC001 — Núcleo de validação e formatação de CNPJ

Especificação Funcional

PROC004 - Cadastro de Vendedor

Protótipo de Tela:

Descrição dos Campos:

Campo	Tipo	Tamanho	Obrig. ?	Máscara	Observações
CPF / CNPJ *	Texto	20	Sim	-	-

Regras de Interface:

1. Ajuste de validação: Deve ser alterada a validação de campo para permitir informar alfanumérico. Reaproveita util/ValidaCNPJ.java (corrigido em PROC001).
2. Caracteres especiais bloqueados: Deve ser mantida validação para caracteres especiais como acentos, til e outras pontuações não esperadas.
3. Normalização para maiúsculas: Tratar para que as letras sejam salvas em caixa maior (maiúsculo), normalizando a informação no banco.

PROC004.1 - Listagem de Vendedor

Protótipo de Tela:

Campo	Tipo	Tamanho	Obrig. ?	Máscara	Observações
Busca	Texto	-	-	-	-

Regras de Interface:

1. O campo de Busca deve ser alterado para realizar a consulta de CNPJ alfanumérico. Validar 3 caracteres ou mais para a busca.

Questões Técnicas:

1. O campo 'vendedor'.'cnpj' no banco de dados já é definido como VARCHAR(20), não necessitando mudanças.

2. Query de Busca: Usa LIKE compatível com alfanumérico. Normalizar para maiúsculas para a consulta.