# DF-e de NF-e / Entrada de NF-e

# 1. Atualizar o NCM/CEST



# PROC001 Atualização automática de NCM no DF-e

<table border="1" id="bkmrk-%C2%A0-projeto%2Fsistema%3Age" style="border-collapse: collapse; width: 100.123%; height: 68px;"><tbody><tr style="border-style: solid;"><td rowspan="3" style="width: 26.6667%; height: 68px; border-color: black; border-top-style: hidden; border-left-style: hidden; border-bottom-style: hidden;">  
[![image-1762776253666.png](https://docs.softensistemas.com.br/uploads/images/gallery/2025-11/scaled-1680-/image-1762776253666.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2025-11/image-1762776253666.png)

</td><td style="width: 49.9999%; height: 10px; border-color: black; border-style: solid;"><span style="color: #000000;">**Projeto/Sistema:**</span>  
DFe-GerencieAqui</td><td class="align-center" style="width: 23.3333%; height: 10px; border-color: black; border-style: solid;"><span style="color: #000000;">**Versão do *Template:***</span>  
<span style="color: #000000;">1.2</span></td></tr><tr style="border-style: solid;"><td style="width: 49.9999%; height: 29px; border-color: black; border-style: solid;"><span style="color: #000000;">**Processo:**</span>  
PROC001 Atualização automática de NCM no DF-e</td><td class="align-center" style="width: 23.3333%; height: 29px; border-color: black; border-style: solid;"><span style="color: #000000;">**Versão do Documento:**</span>  
<span style="color: #000000;">1.0</span></td></tr><tr style="border-style: solid;"><td style="width: 49.9999%; height: 29px; border-color: black; border-style: solid;"><span style="color: #000000;">**Responsável(eis):** </span>  
<span style="color: #000000;">Luís Leite</span></td><td class="align-center" style="width: 23.3333%; height: 29px; border-color: black; border-style: solid;"><span style="color: #000000;">**Data:** </span>

<span style="color: #000000;">09/02/2026</span>

</td></tr></tbody></table>

##### <span style="color: #000000;">**1. Introdução**</span>

<span style="color: #000000;">**Este processo visa exemplificar a criação da função de atualização automática de NCMs .**</span>

##### <span style="color: #000000;">**2. Processo**</span>

<table cellpadding="9" cellspacing="0" id="bkmrk-processo-envolvidos-" width="100%"><tbody><tr valign="top"><td bgcolor="#acb9ca" style="border-style: solid; border-color: black;" width="27%"><span style="font-size: small; color: #000000;">**Processo**</span>

</td><td bgcolor="#acb9ca" style="border-style: solid; border-color: black;" width="19%"><span style="font-size: small; color: #000000;">**Envolvidos**</span>

</td><td bgcolor="#acb9ca" style="border-style: solid; border-color: black;" width="27%"><span style="font-size: small; color: #000000;">**Dados de Entrada**</span>

</td><td bgcolor="#acb9ca" style="border-style: solid; border-color: black;" width="27%"><span style="font-size: small; color: #000000;">**Dados de Saída**</span>

</td></tr><tr valign="top"><td style="border-style: solid; border-color: black;" width="27%">PROC001 Atualização automática de NCM no DF-e

</td><td style="border-style: solid; border-color: black;" width="19%"><span style="font-size: small; color: #000000;">-</span>

</td><td style="border-style: solid; border-color: black;" width="27%"><span style="font-size: small; color: #000000;">Configuração para atualizar ou não NCMs em produtos vinculados via DFe.</span>

</td><td style="border-style: solid; border-color: black;" width="27%"><span style="color: #000000; font-size: small;">Cadastros atualizados com NCMs de notas de entrada de fornecedor.</span>

</td></tr></tbody></table>

#### **Especificação Funcional**

- - - - - -

#### **PROC001 Atualização automática de NCM no DF-e:**

##### ***Protótipo de Tela:***

[![image-1770667336208.png](https://docs.softensistemas.com.br/uploads/images/gallery/2026-02/scaled-1680-/image-1770667336208.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2026-02/image-1770667336208.png)

Imagem I - Botão de atualização de NCM

[![image-1770667414088.png](https://docs.softensistemas.com.br/uploads/images/gallery/2026-02/scaled-1680-/image-1770667414088.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2026-02/image-1770667414088.png)

Imagem II - Dialog de confirmação da configuração

##### ***Descrição dos Campos:***

<table border="1" cellpadding="7" cellspacing="0" id="bkmrk-campo-tipo-tamanho-o" style="width: 843px;"><tbody><tr valign="top"><td bgcolor="#acb9ca" style="width: 168px; border-style: solid; border-color: black;"><span style="color: #000000;">**Campo**</span>

</td><td bgcolor="#acb9ca" style="width: 102px; border-style: solid; border-color: black;"><span style="color: #000000;">**Tipo**</span>

</td><td bgcolor="#acb9ca" style="width: 88px; border-style: solid; border-color: black;"><span style="color: #000000;">**Tamanho**</span>

</td><td bgcolor="#acb9ca" style="width: 165px; border-style: solid; border-color: black;"><span style="color: #000000;">**Obrig. ?**</span>

</td><td bgcolor="#acb9ca" style="width: 119px; border-style: solid; border-color: black;"><span style="color: #000000;">**Máscara**</span>

</td><td bgcolor="#acb9ca" style="width: 201px; border-style: solid; border-color: black;"><span style="color: #000000;">**Observações**</span>

</td></tr><tr><td style="width: 168px; border-style: solid; border-color: black;"><span style="color: #000000;">Atualizar NCM/CEST dos produtos vinculados?</span>

</td><td style="width: 102px; border-style: solid; border-color: black;"><span style="color: #000000;">Botão</span>

</td><td style="width: 88px; border-style: solid; border-color: black;"><span style="color: #000000;">-</span>

</td><td style="width: 165px; border-style: solid; border-color: black;"><span style="color: #000000;">-</span>

</td><td style="width: 119px; border-style: solid; border-color: black;">-

</td><td style="width: 201px; border-style: solid; border-color: black;">-

</td></tr></tbody></table>

##### ***Regras de Interface:***

***1. Atualizar NCM/CEST dos produtos vinculados?*** Por padrão será renderizado como "Não"/*False*.

***2.*** No clique do usuário, antes de alterar o estado para *True*, deve ser exibido em tela uma confirmação **"Ao habilitar a atualização de NCM e CEST, os cadastros vinculados serão atualizados. Confirme se as alterações estão em conformidade fiscal. Deseja continuar?"** Caso o usuário clique em 'Sim', deve ser fechado a tela de aviso e alterado o estado da configuração para 'Sim'.  
Caso o usuário clique em 'Não', deve ser encerrada a tela de aviso sem modificações na nota de entrada em importação.  
(Imagem II)

##### ***Regras de Negócio:***

***1.*** Caso o usuário altere para Sim a atualização do NCM dos produtos vinculados, ao realizar a importação da Nota de Entrada, os produtos vinculados dentro do documento devem ter seu NCM atualizados. Caso possuam CEST informados, também deve ser alterado o cadastro original e vinculado no sistema.

##### ***Questões Técnicas:***

***1.*** As tabelas envolvidas são 'nfeentrada', 'nfeentradaproduto' e 'produto'

©SOFTEN SISTEMAS 2026

# 2. Impostos detalhados na importação de XML



# PROC001 - Impostos detalhados NFe de Entrada

<table border="1" id="bkmrk-%C2%A0-projeto%2Fsistema%3Age" style="border-collapse: collapse; width: 100.123%; height: 68px;"><tbody><tr style="border-style: solid;"><td rowspan="3" style="width: 26.6667%; height: 68px; border-color: black; border-top-style: hidden; border-left-style: hidden; border-bottom-style: hidden;">  
[![image-1762776253666.png](https://docs.softensistemas.com.br/uploads/images/gallery/2025-11/scaled-1680-/image-1762776253666.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2025-11/image-1762776253666.png)

</td><td style="width: 49.9999%; height: 10px; border-color: black; border-style: solid;"><span style="color: #000000;">**Projeto/Sistema:**</span>  
<span style="color: #000000;">GERENCIAMENTO DE PROJETOS</span></td><td class="align-center" style="width: 23.3333%; height: 10px; border-color: black; border-style: solid;"><span style="color: #000000;">**Versão do *Template:***</span>  
<span style="color: #000000;">1.2</span></td></tr><tr style="border-style: solid;"><td style="width: 49.9999%; height: 29px; border-color: black; border-style: solid;"><span style="color: #000000;">**Processo:**</span>  
PROC001 - Impostos detalhados NFe de Entrada</td><td class="align-center" style="width: 23.3333%; height: 29px; border-color: black; border-style: solid;"><span style="color: #000000;">**Versão do Documento:**</span>  
<span style="color: #000000;">1.0</span></td></tr><tr style="border-style: solid;"><td style="width: 49.9999%; height: 29px; border-color: black; border-style: solid;"><span style="color: #000000;">**Responsável(eis):** </span>  
<span style="color: #000000;">Luís Leite</span></td><td class="align-center" style="width: 23.3333%; height: 29px; border-color: black; border-style: solid;"><span style="color: #000000;">**Data:** </span>

<span style="color: #000000;">05/01/2026</span>

</td></tr></tbody></table>

##### <span style="color: #000000;">**1. Introdução**</span>

<table cellpadding="9" cellspacing="0" id="bkmrk-processo-envolvidos-" width="100%"><tbody><tr valign="top"><td bgcolor="#acb9ca" style="border-style: solid; border-color: black;" width="27%"><span style="font-size: small; color: #000000;">**Processo**</span>

</td><td bgcolor="#acb9ca" style="border-style: solid; border-color: black;" width="19%"><span style="font-size: small; color: #000000;">**Envolvidos**</span>

</td><td bgcolor="#acb9ca" style="border-style: solid; border-color: black;" width="27%"><span style="font-size: small; color: #000000;">**Dados de Entrada**</span>

</td><td bgcolor="#acb9ca" style="border-style: solid; border-color: black;" width="27%"><span style="font-size: small; color: #000000;">**Dados de Saída**</span>

</td></tr><tr valign="top"><td style="border-style: solid; border-color: black;" width="27%">PROC001 - Impostos detalhados NFe de Entrada

</td><td style="border-style: solid; border-color: black;" width="19%"><span style="font-size: small; color: #000000;">N/A</span>

</td><td style="border-style: solid; border-color: black;" width="27%"><span style="font-size: small; color: #000000;">N/A</span>

</td><td style="border-style: solid; border-color: black;" width="27%"><span style="font-size: small; color: #000000;">N/A</span>

</td></tr></tbody></table>

#### **Especificação Funcional**

- - - - - -

#### **PROC001 EXEMPLO:**

##### ***Protótipo de Tela:***

[![image-1774370971960.png](https://docs.softensistemas.com.br/uploads/images/gallery/2026-03/scaled-1680-/image-1774370971960.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2026-03/image-1774370971960.png)

*Imagem I - Nova coluna de imposto.*

[![image-1774372143691.png](https://docs.softensistemas.com.br/uploads/images/gallery/2026-03/scaled-1680-/image-1774372143691.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2026-03/image-1774372143691.png)

*Imagem II - Rodapé com Totais.*

[![image-1774371643191.png](https://docs.softensistemas.com.br/uploads/images/gallery/2026-03/scaled-1680-/image-1774371643191.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2026-03/image-1774371643191.png)

*Imagem III - Tela de imposto em visualização.*

##### ***Descrição dos Campos:***

<table border="1" cellpadding="7" cellspacing="0" id="bkmrk-campo-tipo-tamanho-o" style="width: 843px; height: 216px;"><tbody><tr style="height: 35px;" valign="top"><td bgcolor="#acb9ca" style="width: 167.969px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">**Campo**</span>

</td><td bgcolor="#acb9ca" style="width: 101.997px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">**Tipo**</span>

</td><td bgcolor="#acb9ca" style="width: 87.9688px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">**Tamanho**</span>

</td><td bgcolor="#acb9ca" style="width: 165px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">**Obrig. ?**</span>

</td><td bgcolor="#acb9ca" style="width: 118.976px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">**Máscara**</span>

</td><td bgcolor="#acb9ca" style="width: 200.99px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">**Observações**</span>

</td></tr><tr style="height: 57px;"><td style="width: 167.969px; border-style: solid; border-color: black; height: 57px;"><span style="color: #000000;">Imposto</span>

</td><td style="width: 101.997px; border-style: solid; border-color: black; height: 57px;">*<span style="color: #000000;">Column Header</span>*

</td><td style="width: 87.9688px; border-style: solid; border-color: black; height: 57px;"><span style="color: #000000;">-</span>

</td><td style="width: 165px; border-style: solid; border-color: black; height: 57px;"><span style="color: #000000;">-</span>

</td><td style="width: 118.976px; border-style: solid; border-color: black; height: 57px;">-

</td><td style="width: 200.99px; border-style: solid; border-color: black; height: 57px;">-

</td></tr><tr style="height: 35px;"><td style="width: 167.969px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Ver/Editar</span>

</td><td style="width: 101.997px; border-style: solid; border-color: black; height: 35px;">*<span style="color: #000000;">Link</span>*

</td><td style="width: 87.9688px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">-</span>

</td><td style="width: 165px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">-</span>

</td><td style="width: 118.976px; border-style: solid; border-color: black; height: 35px;">-

</td><td style="width: 200.99px; border-style: solid; border-color: black; height: 35px;">-

</td></tr><tr style="height: 35px;"><td style="width: 167.969px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Valor Total de ICMS</span>

</td><td style="width: 101.997px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Decimal</span>

</td><td style="width: 87.9688px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">-</span>

</td><td style="width: 165px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">-</span>

</td><td style="width: 118.976px; border-style: solid; border-color: black; height: 35px;">-

</td><td style="width: 200.99px; border-style: solid; border-color: black; height: 35px;">-

</td></tr><tr style="height: 54px;"><td style="width: 167.969px; border-style: solid; border-color: black; height: 54px;"><span style="color: #000000;">Valor Total de IPI</span><span style="color: #000000;"> </span>

</td><td style="width: 101.997px; border-style: solid; border-color: black; height: 54px;"><span style="color: #000000;">Decimal</span>

</td><td style="width: 87.9688px; border-style: solid; border-color: black; height: 54px;"><span style="color: #000000;">-</span>

</td><td style="width: 165px; border-style: solid; border-color: black; height: 54px;"><span style="color: #000000;">-</span>

</td><td style="width: 118.976px; border-style: solid; border-color: black; height: 54px;">-

</td><td style="width: 200.99px; border-style: solid; border-color: black; height: 54px;">-

</td></tr></tbody></table>

##### ***Regras de Interface:***

***1.Ver Imposto:*** Deve abrir a *Dialog* (Imagem III) contendo os preenchimentos de tributos. Mesmo principio da *Dialog* da tela de Ver/Edita da Nota Fiscal de Entrada em digitação, com ressalva que os campos devem ser todos bloqueados de preenchimento.

**2. <span style="color: #000000;">Valor Total de ICMS: </span>**<span style="color: #000000;">Totalizador dos ICMS dos produtos.</span>

**<span style="color: #000000;">3. Valor Total de IPI: </span>**<span style="color: #000000;">Totalizador do IPI dos produtos.</span>

##### ***Regras de Negócio:***

***1.*** Atualmente já existem os campos referentes aos impostos da NFe de entrada na base de dados. Devem ser inseridos os impostos do XML de entrada nas tabelas 'nfeentradaproduto' e 'nfeentradaprodutoinfo'

**2.** Validar a importação de todos os campos, até a presente data da documentação ICMS não está importando.

##### ***Questões Técnicas:***

***1. Consulta dos tributos***

```SQL
SELECT * 
FROM `gerencieaqui`.`nfeentradaproduto` AS nep
LEFT JOIN `gerencieaqui`.`nfeentradaprodutoinfo` AS nepi
    ON nepi.`id` = nep.`nfeEntradaProdutoInfoId`
WHERE nep.`Id` = 121;
```

©SOFTEN SISTEMAS 2026