PROC007.1 - DC-e: Ajustes em Preenchimentos em Tela


image-1762776253666.png

Projeto/Sistema:
GERENCIEAQUI - MIGRAÇÃO CNPJ ALFANUMÉRICO (NT 2026.004)
Versão do Template:
1.2
Processo:
PROC007.1 - DC-e: Ajustes em Preenchimentos em Tela
Versão do Documento:
1.0
Responsável(eis): 
Luís Leite

Data: 

05/06/2026

1. Introdução

Este processo visa mapear os pontos de ajustes das alterações do CTe alfanumerico.

2. Processo

Processo

Envolvidos

Dados de Entrada

Dados de Saída

PROC007.1 - DC-e: Ajustes em Preenchimentos em Tela

N/A

N/A

N/A

 

Especificação Funcional


PROC007.1 - DC-e: Ajustes em Preenchimentos em Tela:

Protótipo de Tela:

image-1780499472284.png

Descrição dos Campos:

Campo

Tipo

Tamanho

Obrig. ?

Máscara

Observações

CNPJ da Transportadora

Texto

14

-

-

-

Regras de Interface:


1. Campos da Transportadora: conferir validação para aceitar alfanumérico. Reaproveitar a validação do PROC001.Núcleo de validação e formatação de CNPJ.
1.1. Normalização: Todos campos CNPJ devem ser tratado para deixar todas as letras em caixa alta(maiúsculo) visando a padronização da informação.

Regras de Negócio:

1.1 O CNPJ alfanumérico é composto por doze caracteres alfanuméricos e dois dígitos verificadores
numéricos. Os dígitos verificadores (DV) são calculados a partirr dos doze primeiros caracteres em duas
etapas, utlizando o módulo de divisão 11 e pesos distribuídos de 2 a 9.

1.2 Para cada um dos caracteres do CNPJ, atribuir o valor da coluna conforme a tabela abaixo. O restante do calculo do primeiro e segundo DV devem permanecer conforme MANUAL DE CALCULO DO DV DO CNPJ:

Caractere ASCII Valor no cálculo
'0' a '9' 48–57 0 a 9
'A' 65 17
'B' 66 18
'C' 67 19
'D' 68 20
'E' 69 21
'F' 70 22
'G' 71 23
'H' 72 24
'I' 73 25
'J' 74 26
'K' 75 27
'L' 76 28
'M' 77 29
'N' 78 30
'O' 79 31
'P' 80 32
'Q' 81 33
'R' 82 34
'S' 83 35
'T' 84 36
'U' 85 37
'V' 86 38
'W' 87 39
'X' 88 40
'Y' 89 41
'Z' 90 42
Questões Técnicas:

1. A coluna 'dce'.'cnpjTerceiros' é VARCHAR(18) — comporta o CNPJ alfanumérico (14) sem ajuste.
2. A coluna 'dce'.'chaveAcesso' comporta 44 caracteres alfanuméricos.
3. Coluna 'dce'.'cDV' permanece int (DV é numérico de 0–9).

4. A DCE é o documento mais "auto-suficiente" do grupo — não depende de serviço externalizado para transmitir, monta o XML inteiramente no projeto e calcula seu próprio DV. Por outro lado, isso concentra os gaps em poucos arquivos críticos: o DceXmlBuilder e seu utilitário onlyDigits (em DceXmlBase) — substituir esses pontos preserva o CNPJ alfanumérico em toda a cadeia.

Frente

Estado

Observação

Validador JSF validaCNPJ

Implementado

Anexar ao campo CNPJ Transportadora.

DTOs/Entities (Dce, DceAdapter)

Sem ação

Copiam CNPJ "como está".

Algoritmo de DV (modulo11)

Sem ação

Já compatível com alfanumérico.

Núcleo CnpjUtil

Pendente

Pré-requisito; cascateia para DceListagemService:213.

Máscara CNPJ Transportadora na tela

Crítico

editar/index.xhtml:310-311 bloqueia letras.

DceXmlBuilder.appendTransp/appendEmit/appendDest

Crítico

Usam onlyDigits — apaga letras antes do XML.

DceXmlBase.onlyDigits (utilitário base)

Crítico

Adicionar onlyAlphaNum ao lado.

DceXmlImporter — chave 44 importada

Crítico

L. 135-136 — mesmo gap.

Revalidação no save

Revisar

DceEditarService.save:55-92 não revalida.

Transmissão SOAP

Sem ação

Local; segue após XML correto.

©SOFTEN SISTEMAS 2026


Revision #1
Created 3 June 2026 15:00:13 by Luís Leite
Updated 5 June 2026 16:23:10 by Luís Leite