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



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:

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 verificadoresnuméricos. Os dígitos verificadores (DV) são calculados a partirr dos doze primeiros caracteres em duasetapas, 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