1. Cadastros 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 2026PROC003 - 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 2026PROC004 - 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. ©SOFTEN SISTEMAS 2026