# OS 78076 - OBRIGAÇÕES - FISCAL - MIT - MÓDULO DE INCLUSÃO DE TRIBUTOS

#### **Objetivo**

Esta solicitação tem por objetivo de implementar o **MIT – Módulo de Inclusão de Tributos.**

O **MIT – Módulo de Inclusão de Tributos** é uma funcionalidade do módulo Fiscal do ERP que possibilita o registro e a apuração de tributos conforme os parâmetros definidos pela Receita Federal. A funcionalidade permite que os usuários efetuem cadastro de receita, lançamentos de apuração e, ao final, gerem o arquivo **JSON** no layout oficial exigido para upload no aplicativo MIT da Receita Federal.

Ele conta com três menus principais:

- **Receitas** – manutenção dos códigos de receita e suas regras.
- **Apuração** – lançamento dos débitos, suspensões e eventos especiais por período/unidade.
- **Status da Apuração** – acompanhamento do ciclo de vida da apuração (edição, encerrado, reaberto, transmitido).

Dessa forma, o MIT centraliza toda a gestão da apuração de tributos no ERP, garantindo integridade, rastreabilidade e conformidade legal.

**Premissas:**

- Necessário o ambiente estar atualizado com as versões: 
    - Fiscal de número **120312 Genexus 17** ou superior;
    - Script de número **120608 SQL** / **119631 SQLPostgre** ou superior.

#### **Teste realizado após a atualização**

#### <span style="color: rgb(0, 0, 0);">**Cenário 1: Cadastro de Receitas.**</span>

Este cadastro receberá uma carga inicial de dados.

**Passos:**

1. Acessar o menu `Manutenção > MIT > Receita`;
2. Clicar em `Inserir`;
3. Informar os campos: Código, Descrição, Grupo, Regime de Apuração, Status, Inicio de Vigência, Final de Vigência e Configurar lançamento da Receita na Apuração
4. Confirmar.

<p class="callout info">**Resultado Esperado:** A receita é cadastrado com sucesso e aparece na listagem principal.</p>

**Acessando a funcionalidade** [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-08/scaled-1680-/ycZ6Q8nOCsYwzhW4-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-08/ycZ6Q8nOCsYwzhW4-image.png)  
[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/scaled-1680-/hfQ9mqXry8SCczha-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/hfQ9mqXry8SCczha-image.png)

**Tela de cadastro**

Ao entrar na tela serão **exibidos** os registros **realizados via carga** e os **registros manuais.**[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/scaled-1680-/tUn0BIR3LTEC37Yn-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/tUn0BIR3LTEC37Yn-image.png)

Para incluir um novo basta clicar em **Inserir**.  
Insira as informações conforme necessidade e clique em **Confirmar.**[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/scaled-1680-/K5DYtikrxrkumKHr-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/K5DYtikrxrkumKHr-image.png)Observação: Os campos marcados na configuração de lançamentos da Receita Federal, serão obrigatórios no vincula da apuração.

Após confirmar será exibida a mensagem de sucesso.[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/scaled-1680-/JUruUfcTkfCHvO7t-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/JUruUfcTkfCHvO7t-image.png)

---

#### <span style="color: rgb(0, 0, 0);">**Cenário 2: Apuração MIT.**</span>

**Passos:**

1. Acessar o menu `Manutenção > MIT > Apuração`;
2. Clicar em `Inserir`;
3. Informe os dados:
4. Salvar.

**Regras da funcionalidade**

- Será permitida a edição da apuração quando o status de apuração estiver como Edição.
- **Não** permitir **mais de uma** apuração por período/unidade.

<p class="callout info">**Resultado Esperado:** O lançamento de apuração é gerado sem erros.</p>

**Acessando a funcionalidade** [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-08/scaled-1680-/ycZ6Q8nOCsYwzhW4-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-08/ycZ6Q8nOCsYwzhW4-image.png)  
[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/scaled-1680-/umJWEKeEyEEhSOd7-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/umJWEKeEyEEhSOd7-image.png)

**Tela principal da apuração**

Ao entrar na tela serão exibidos os períodos com apuração criadas.  
Para adicionar uma nova apuração, clique em Inserir.[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/scaled-1680-/m870r8LRmKyQTmKk-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/m870r8LRmKyQTmKk-image.png)

Na tela de lançamento, insira os dados necessários e clique em Confirmar.  
[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/scaled-1680-/ayq3XbwqZ4ULXFxK-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/ayq3XbwqZ4ULXFxK-image.png)

Na Edição da Apuração são habilitadas os blocos de Débitos e Eventos Especiais.  
[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/scaled-1680-/tLEM08VbgrMJY7QI-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/tLEM08VbgrMJY7QI-image.png)

**Inclusão de débito** Para adicionar **débito**, basta clicar em **inserir** na tela de edição do período desejado.[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/scaled-1680-/ppcxFt1PxH3weeEO-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/ppcxFt1PxH3weeEO-image.png)

Insira os dados necessários e clique em **Confirmar.**[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/scaled-1680-/Aem9RvYA6pKs9vnU-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/Aem9RvYA6pKs9vnU-image.png)  
Após salvar (Confirmar), o bloco de débitos, será habilitada a inclusão de Suspensão.[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/scaled-1680-/6thWFZqSyaDawPiX-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/6thWFZqSyaDawPiX-image.png)

**Inclusão de eventos especiais.**  
Para adicionar evento especial, basta clicar em inserir na tela de edição do período desejado.[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/scaled-1680-/oxCZp41TLE6b4i3i-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/oxCZp41TLE6b4i3i-image.png)

O sistema exibirá pop-up para preenchimento das informações.  
Insira os dados necessários e clique em **Confirmar.**[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/scaled-1680-/B9V4jXPL03CFOuCu-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/B9V4jXPL03CFOuCu-image.png)

<p class="callout warning">**Observação**: Quando marcada a opção **Apuração sem movimento**, os blocos de débitos e eventos especiais são **ocultados**.</p>

---

#### <span style="color: rgb(0, 0, 0);">**Cenário 3:** </span>**Relatório de Conferência (Excel)**

**Passos:**

1. Acessar o menu `Manutenção > MIT > Apuração`;
2. Clicar em `Arquivo Excel`

<p class="callout info">**Resultado Esperado:** O Relatório é gerado com sucesso.</p>

**Acessando a funcionalidade** [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-08/scaled-1680-/ycZ6Q8nOCsYwzhW4-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-08/ycZ6Q8nOCsYwzhW4-image.png)  
[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/scaled-1680-/9TGSbFPIFF6iDBNh-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/9TGSbFPIFF6iDBNh-image.png)

**Tela principal da apuração**

Na tela principal, clique em **editar** ou **consultar**.[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/scaled-1680-/Yo6VlmCABrzTaHHf-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/Yo6VlmCABrzTaHHf-image.png)

Ao abrir a tela do período escolhido, clique no botão **Arquivo Excel**.[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/scaled-1680-/I2eL0TErq1UHdboy-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/I2eL0TErq1UHdboy-image.png)

**Relatório gerado.**[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/scaled-1680-/LbV0OBr4E8lq72c8-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/LbV0OBr4E8lq72c8-image.png)

---

#### <span style="color: rgb(0, 0, 0);">**Cenário 4:** </span>**Geração do Arquivo JSON**

**Passos:**

1. Acessar o menu `Manutenção > MIT > Apuração`;
2. Clicar em `Arquivo JSON`

<p class="callout info">**Resultado Esperado:** O Json é gerado com sucesso.</p>

**Acessando a funcionalidade** [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-08/scaled-1680-/ycZ6Q8nOCsYwzhW4-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-08/ycZ6Q8nOCsYwzhW4-image.png)  
[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/scaled-1680-/CruZqBR3ItCL0N7Z-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/CruZqBR3ItCL0N7Z-image.png)

**Tela principal da apuração.**

Na tela principal, clique em **editar** ou **consultar**.[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/scaled-1680-/PNC71WeB7XQaU5yK-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/PNC71WeB7XQaU5yK-image.png)

Ao abrir a tela do período escolhido, clique no botão **Arquivo Json**.[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/scaled-1680-/aSaPunVS6wAq6F3Q-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/aSaPunVS6wAq6F3Q-image.png)

**Json Gerado**

**Nome do arquivo: CNPJ raiz (8)** + “-MIT-” + **AAAA** + **MM** + “.json”. (`87654321-MIT-202504.json`)[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/scaled-1680-/APxNgTNRUgIOGLE1-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/APxNgTNRUgIOGLE1-image.png)

---

#### <span style="color: rgb(0, 0, 0);">**Cenário 5:**</span> **Status da Apuração (ciclo de vida).**

**Passos:**

1. Acessar o menu `Manutenção > MIT > Status da Apuração`;
2. Clicar em `Editar Sattus`
3. Selecione o novo status e **Confirme.**

<p class="callout info">**Resultado Esperado:** O sistema deve permitir realizar manutenção no status da apuração.</p>

**Acessando a funcionalidade** [![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-08/scaled-1680-/ycZ6Q8nOCsYwzhW4-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-08/ycZ6Q8nOCsYwzhW4-image.png)  
[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/scaled-1680-/SPc8j3dB1e0wqO6R-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/SPc8j3dB1e0wqO6R-image.png)

**Tela de Manutenção**

Ao entrar na tela serão exibidos as apuração.[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/scaled-1680-/hEDqUtOMH9xAa6IN-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/hEDqUtOMH9xAa6IN-image.png)

Clique em editar, o sistema exibirá um pop-up para alteração do status.  
Após seleção, confirme a gravação.[![image.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/scaled-1680-/bGZuXosr2O1Mw0B3-image.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-09/bGZuXosr2O1Mw0B3-image.png)

**Status disponíveis:**

1. **Edição:** Ao gerar o lançamento da apuração o status é gravado como Edição, nesse status é permitida manutenção na apuração.
2. **Encerrado:** Deve ser selecionada esse status quando a apuração com todos os requisitos válidos estiverem lançados e validados. Não será permitida a edição de estrutura.
3. **Reabertura:** Ao selecionar a opção, o sistema permitirá ajustes e nova geração JSON
4. **Transmitido:** Após download e upload no e-CAC (processo manual), registrar status “Transmitido”. Não será permitida a edição de estrutura.


![4.png](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-03/scaled-1680-/eO9m8fVMKPpticCz-4.png)

<p class="callout danger">**ATENÇÃO: As informações neste documento são meramente ilustrativas e utilizadas apenas para fins de teste.**</p>