# Tela Principal/Dados Principais

<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;">  
<span style="color: #000000;"> ![Softensistemas Logo](https://www.softensistemas.com.br/assets/img/logo.webp)</span>

</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;">**Reforma Tributária - GerencieAqui**</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.1</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>  
<span style="color: #000000;">Ajustes dos dados principais</span></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.10</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;">17/06/2025</span>

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

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

<span style="color: #000000;">**Este processo visa documentar as alterações necessárias para a adequação da reforma tributária. Os dados devem aparecer em tela em homologação após 01/07/2025.**</span>

<span style="color: #000000; background-color: #ccffcc;">**1.10 Mudanças adicionadas: 16/06/2025 - <span style="color: #0000ff;">[Conforme nova NT 2025.002-RTC - Versão 1.10](https://www.nfe.fazenda.gov.br/portal/exibirArquivo.aspx?conteudo=B7DBKw%20UPbs=)</span>**</span>

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

<span style="color: #000000;">[![image-1747050775438.png](https://docs.softensistemas.com.br/uploads/images/gallery/2025-05/scaled-1680-/image-1747050775438.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2025-05/image-1747050775438.png)</span>

<span style="color: #000000;">I - Fluxograma Exemplo</span>

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

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

</td><td bgcolor="#acb9ca" style="border-style: solid; border-color: black; width: 27%;" 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%;" 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%;" width="27%"><span style="font-size: small; color: #000000;">PROC001 - Novas Finalidades de NF-e</span>

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

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

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

</td></tr><tr><td style="border-style: solid; border-color: black; width: 27%;"><span style="font-size: small; color: #000000;">PROC002 - Dados de Compra Governamental</span>

</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;">Dados da NFe</span>

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

</td></tr><tr><td style="border-style: solid; border-color: black; width: 27%;"><span style="font-size: small; color: #000000;">PROC003 - Outros Ajustes (Arquivo XML)</span>

</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;">Dados da NFe</span>

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

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

#### <span style="color: #000000;">**Especificação Funcional**</span>

- - - - - -

#### <span style="color: #000000;">**PROC001 Novas Finalidades da NF-e:**</span>

##### <span style="color: #000000;">***Regras de Negócio:***</span>

<span style="color: #000000;">[![image-1746638063319.png](https://docs.softensistemas.com.br/uploads/images/gallery/2025-05/scaled-1680-/image-1746638063319.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2025-05/image-1746638063319.png)</span>

<span style="color: #000000;">***1. Devem ser adicionadas duas novas finalidades para a NF-e:*** 5=Nota de Crédito **e** 6=Nota de Débito;</span>

<span style="color: #000000;">**2. Ao selecionar a nota do tipo Crédito ou Débito, deve aparecer a *combobox* para a seleção do tipo da Nota**</span>

<span style="color: #000000;">**[![image-1746638806291.png](https://docs.softensistemas.com.br/uploads/images/gallery/2025-05/scaled-1680-/image-1746638806291.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2025-05/image-1746638806291.png)**</span>

<span style="color: #000000;">**2.1.** Nota de Débito, deve conter as opções:</span>

<table border="1" class="align-center" id="bkmrk-01%3Dtransfer%C3%AAncia-de-" style="border-collapse: collapse; width: 61.1111%; height: 145px;"><tbody><tr style="height: 29px;"><td class="align-left" style="width: 100%; height: 29px; border-style: solid; border-color: black;"><span style="color: #000000;">01=Transferência de créditos para Cooperativas;</span></td></tr><tr style="height: 29px;"><td class="align-left" style="width: 100%; height: 29px; border-style: solid; border-color: black;"><span style="color: #000000;">02=Anulação de Crédito por Saídas Imunes/Isentas;</span></td></tr><tr style="height: 29px;"><td class="align-left" style="width: 100%; height: 29px; border-style: solid; border-color: black;"><span style="color: #000000;">03=Débitos de notas fiscais não processadas na apuração;</span></td></tr><tr style="height: 29px;"><td class="align-left" style="width: 100%; height: 29px; border-style: solid; border-color: black;"><span style="color: #000000;">04=Multa e juros;</span></td></tr><tr style="height: 29px;"><td class="align-left" style="width: 100%; height: 29px; border-style: solid; border-color: black;"><span style="color: #000000;">05=Transferência de crédito de sucessão;</span>

</td></tr><tr><td style="width: 100%; border-style: solid; border-color: black;"><span style="color: #000000; background-color: #ccffcc;">06=Pagamento antecipado; (adicionado em 16/06/2025)</span>

</td></tr><tr><td style="width: 100%; border-style: solid; border-color: black;"><span style="color: #000000; background-color: #ccffcc;">07=Perda em estoque; (adicionado em 16/06/2025)</span>

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

<span style="color: #000000;">**<span style="background-color: #ccffcc;">2.2. Tabela dos tipos de nota de crédito: (adicionado em 16/06/2025)</span>** </span>

<table border="1" class="align-center" id="bkmrk-01%3Dmulta-e-juros%3B-02" style="border-collapse: collapse; height: 63px;" width="504"><tbody><tr style="height: 29px;"><td class="align-left" style="width: 503px; height: 29px; border-style: solid; border-color: black;"><span style="color: #000000; background-color: #ccffcc;">01=Multa e juros;</span></td></tr><tr style="height: 29px;"><td class="align-left" style="width: 503px; height: 29px; border-style: solid; border-color: black;"><span style="color: #000000; background-color: #ccffcc;">02=Apropriação de crédito presumido de IBS sobre o saldo devedor na ZFM (art. 450, § 1º, LC 214/25)</span></td></tr></tbody></table>

#### <span style="color: #000000;">**PROC002 Dados de Compra Governamental:**</span>

<span style="color: #000000; background-color: #ccffcc;">**Adição de novo campo nos dados governamentais - 16/06/2025**</span>

##### <span style="color: #000000;">***Protótipo de Tela:***</span>

<span style="color: #000000;">[![image-1746709697596.png](https://docs.softensistemas.com.br/uploads/images/gallery/2025-05/scaled-1680-/image-1746709697596.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2025-05/image-1746709697596.png)</span>

<span style="color: #000000;">Imagem I - Adicionado novo Button</span>

[![image-1750165639846.png](https://docs.softensistemas.com.br/uploads/images/gallery/2025-06/scaled-1680-/image-1750165639846.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2025-06/image-1750165639846.png)

<span style="color: #000000;">Imagem II - Dialog dos dados de compra governamental</span>

##### <span style="color: #000000;">***Descrição dos Campos:***</span>

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

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

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

</td><td bgcolor="#acb9ca" style="width: 100.375px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">**Obrigatório?**</span>

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

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

</td></tr><tr style="height: 57px;" valign="top"><td style="width: 134.525px; border-style: solid; border-color: black; height: 57px;"><span style="color: #000000;">Compra Governamental</span>

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

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

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

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

</td><td style="width: 269.112px; border-style: solid; border-color: black; height: 57px;"> </td></tr><tr style="height: 57px;"><td style="width: 134.525px; border-style: solid; border-color: black; height: 57px;"><span style="color: #000000;">Tipo de Ente Governamental</span>

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

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

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

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

</td><td style="width: 269.112px; border-style: solid; border-color: black; height: 57px;"></td></tr><tr style="height: 35px;"><td style="width: 134.525px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">% Redutor</span>

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

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

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

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

</td><td style="width: 269.112px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Percentual de redução de alíquota em </span>  
<span style="color: #000000;">compra governamental</span>

</td></tr><tr><td style="width: 134.525px; border-style: solid; border-color: black;"><span style="color: #000000; background-color: #ccffcc;">Tipo de Operação</span>

</td><td style="width: 134.525px; border-style: solid; border-color: black;"><span style="color: #000000; background-color: #ccffcc;">ComboBox</span>

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

</td><td style="width: 100.375px; border-style: solid; border-color: black;"><span style="color: #000000; background-color: #ccffcc;">Sim</span>

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

</td><td style="width: 269.112px; border-style: solid; border-color: black;"><span style="color: #000000; background-color: #ccffcc;">Adicionado 16/16/2025</span>

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

##### <span style="color: #000000;">***Regras de Interface:***</span>

<span style="color: #000000;">***1.*** Deve ser adicionado o button *"Compra Governamental"* no card de dados de emissão.</span>

<span style="color: #000000;">***2.*** Uma dialog deve ser aberta para inserção das informações referentes a compras por partes de entes vinculados ao governo.</span>

##### <span style="color: #000000;">***Regras de Negócio:***</span>

<span style="color: #000000;">1. Opções possíveis para o "Tipo de Ente Governamental":</span>

<table border="1" class="align-center" id="bkmrk-1%3Duni%C3%A3o-2%3Destado-3%3Dd" style="border-collapse: collapse; width: 57.4074%; height: 87px;"><tbody><tr style="height: 29px;"><td style="width: 100%; height: 29px; border-style: solid; border-color: black;"><span style="color: #000000;">1=União</span></td></tr><tr style="height: 29px;"><td style="width: 100%; height: 29px; border-style: solid; border-color: black;"><span style="color: #000000;">2=Estado</span></td></tr><tr style="height: 29px;"><td style="width: 100%; height: 29px; border-style: solid; border-color: black;"><span style="color: #000000;">3=Distrito Federal</span></td></tr><tr><td style="width: 100%; border-style: solid; border-color: black;"><span style="color: #000000;">4=Município</span></td></tr></tbody></table>

<span style="color: #000000;">2. Deve conter uma opção em branco na *ComboBox*, para limpar a inserção.</span>

<span style="color: #000000; background-color: #ccffcc;">3. Dados referentes a *ComboBox* do tipo de operação com ente governamental:</span>

<table border="1" class="align-center" id="bkmrk-1%3Dfornecimento-2%3Drec" style="border-collapse: collapse; width: 57.4074%; height: 87px;"><tbody><tr style="height: 29px;"><td style="width: 100%; height: 29px; border-style: solid; border-color: black;"><span style="color: #000000;">1=Fornecimento</span></td></tr><tr style="height: 29px;"><td style="width: 100%; height: 29px; border-style: solid; border-color: black;"><span style="color: #000000;">2=Recebimento do pagamento, conforme fato gerador do IBS/CBS definido no Art. 10 § 2º</span></td></tr></tbody></table>

##### <span style="color: #000000;">***Questões Técnicas:***</span>

<span style="color: #000000;">***1.*** As informações devem ficar salvas na base de dados na tabela 'nfe'</span>

<span style="color: #000000;">***2.*** O exemplo de XML se apresenta na seguinte parte da documentação.</span>

#### <span style="color: #000000;">**PROC003 Outros Ajustes (ajustes XML):**</span>

##### <span style="color: #000000;">***Regras de Negócio:***</span>

<span style="color: #000000;">***1.*** Deve ser gerada a tag para conter a informação do Código do Município de consumo, fato gerador do IBS / CBS, ou, **cMunFGIBS, só preencher quando:**</span>

<span style="color: #000000;">***1.1.*** For modelo **65 (NFCe)** e quando ***“indPres = 5 (Operação presencial, fora do estabelecimento)”***</span><span style="color: #000000;">  
</span>

<span style="color: #000000;">***2.*** Omitir a tag se existir endereço do destinatário (E05) ou local de entrega (G01), não incluir **&lt;cMunFGIBS&gt;** no XML</span>

<span style="color: #000000;">***3.*** Se a tag for necessária *(após passar pelas validações acima)*:  
 ***3.1.*** Se houver local de entrega (G01) informado, usar **IBGE** da cidade do local de entrega ***3.2.*** Se não, se cliente tiver endereço cadastrado, usar **IBGE** da cidade vinculada no cliente.  
  
 ***3.3.*** Se não, solicitar ao usuário em tela, para selecionar município de consumo:  
  
***Obs: Caso a tag não seja obrigatória conforme item 2, ignorar toda a regra 3.***</span>

<span style="color: #000000;">***4.*** O grupo de informações do ICMS e ICMS ST passam a ser não obrigatórios (0-1)  
</span>

[![image-1747157406065.png](https://docs.softensistemas.com.br/uploads/images/gallery/2025-05/scaled-1680-/image-1747157406065.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2025-05/image-1747157406065.png)

<span style="color: #000000;"> **4.1** **Obrigatoriedade do ICMS:** Os dados de ICMS deixam de ser obrigatórios.</span>  
  
<span style="color: #000000;"> **4.2** **Mesmo sendo opcional, se preencher o grupo ICMS**: Ele deve ser gerado corretamente (sem erros de schema ou valores inválidos). Se não tiver nada para informar, pode omitir totalmente.</span>

#### <span style="color: #000000;">**PROC004 Grupo de pagamento antecipado:**</span>

<span style="color: #000000;">**Protótipo de tela:** </span>

[![image-1750179067165.png](https://docs.softensistemas.com.br/uploads/images/gallery/2025-06/scaled-1680-/image-1750179067165.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2025-06/image-1750179067165.png)

##### <span style="color: #000000;">***Regras de Interface:***</span>

<span style="color: #000000;">***1.*** O funcionamento vai se assemelhar ao da inserção "Chave NFe"</span>

##### <span style="color: #000000;">***Regras de Negócio:***</span>

<span style="color: #000000;">***1.*** Devem ser validados os 44 dígitos preenchidos da chave de acesso na inserção  
</span>

<span style="color: #000000;">***2.*** São permitidas até 99 chaves de acesso referenciadas.</span>

##### <span style="color: #000000;">***Questões Técnicas Gerais:***</span>

<span style="color: #000000;">**1. A estrutura do XML deve se apresentar da seguinte forma:**</span>

```XML
<enviNFe xmlns="http://www.portalfiscal.inf.br/nfe" versao="4.00">
  <idLote>000000000003</idLote>
  <indSinc>1</indSinc>
  <NFe>
    <infNFe versao="4.00" Id="NFe35123456789012345678901234567890123456789014">
      <ide>
      <cUF>35</cUF>
      <cNF>11223344</cNF>
      <natOp>Venda de produto tributado IBS/CBS e IS</natOp>
      <mod>55</mod>
      <serie>1</serie>
      <nNF>1122</nNF>
      <dhEmi>2025-07-01T16:00:00-03:00</dhEmi>
      <tpNF>1</tpNF>
      <idDest>1</idDest>
      <cMunFG>3550308</cMunFG>
      <cMunFGIBS>3550308</cMunFGIBS>  
      <finNFe>1</finNFe>
      <tpNFDebito>01</tpNFDebito>
      <tpNFCredito>01</tpNFCredito>
      <indFinal>1</indFinal>
      <indPres>1</indPres>
      <procEmi>0</procEmi>
      <verProc>1.0</verProc>
      	<gCompraGov>
          <tpEnteGov>1</tpEnteGov>
          <pRedutor>3.20</pRedutor>
          <tpOperGov>1</tpOperGov>
        </gCompraGov>	
      <gPagAntecipado>
       <refNFe>35250627565866000104550060000001761416212811</refNFe>
      </gPagAntecipado>  
      </ide>
...
        
```

**<span style="color: #000000;">2. Mudanças na base de dados, criação de campo para armazenar as finalidades:</span>**

```SQL
ALTER TABLE nfe
ADD COLUMN TpNota CHAR(2);
```

<span style="background-color: #ccffcc;">**<span style="color: #000000;">3. Mudanças na base de dados, criação de campo para armazenar as dados da compra governamental:</span>**</span>

```SQL
ALTER TABLE nfe
ADD COLUMN TpEnteGov CHAR(2),
ADD COLUMN redutor DECIMAL,
ADD COLUMN tpOperacao CHAR(1); --NOVA COLUNA NA BASE DE DADOS 16/06/2025
```

**4. Criação da tabela para armazenar a nota referenciada de pagamento adiantado:**

```SQL

CREATE TABLE `nfantecipadoref` (
  `id` bigint NOT NULL AUTO_INCREMENT,
  `refNFe` char(44) DEFAULT NULL,
  `empresaId` bigint DEFAULT NULL,
  `nfeId` bigint DEFAULT NULL,
  PRIMARY KEY (`id`),
  FOREIGN KEY (`nfeId`) REFERENCES `nfe` (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=10 DEFAULT CHARSET=latin1;

```

<span style="color: #000000;">©SOFTEN SISTEMAS 2025</span>