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