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