Guia de Uso - Ferramenta de Geração de JSON para Apuração de Tributos

Visão Geral

Esta ferramenta foi desenvolvida para facilitar a geração de arquivos JSON baseados em dados de planilhas Excel. Ela permite configurar e processar informações de tributos como IRPJ, CSLL, PIS e COFINS, gerando um arquivo JSON formatado para uso posterior.

Estrutura do Projeto

• src/: Contém os scripts principais, incluindo a interface gráfica e a lógica de processamento.
  • MITJSON.py: Script principal com a lógica de geração do JSON.
  • MITJSON com GUI.py: Interface gráfica para configuração e execução do processo.
• data/: Contém os arquivos Excel e JSON utilizados como entrada e saída.
• Arquivos JSON: Exemplos de arquivos gerados, como 21609217-MIT-202501 (2).json.

Pré-requisitos

• Python 3.8+
• Bibliotecas necessárias:
  • pandas
  • openpyxl
  • tkinter

Como Usar

1. Executar a Interface Gráfica

1. Abra o terminal e navegue até o diretório src/.
2. Execute o script MITJSON com GUI.py:

   python "MITJSON com GUI.py"

2. Configurar os Dados na Interface

1. Checkbox "Este arquivo é trimestral?":
   • Marque se o arquivo contém dados trimestrais (IRPJ e CSLL).
2. Arquivo Excel:
   • Clique em "Selecionar" e escolha o arquivo Excel com os dados.
3. Nome da aba de PIS/COFINS:
   • Informe o nome da aba que contém os dados de PIS e COFINS.
4. Configurações de PIS/COFINS:
   • Intervalo de colunas (exemplo: O:T).
   • Quantas linhas serão puladas até a linha com os nomes das colunas.
   • Quantas linhas têm até a última informação útil (subtraindo as linhas puladas).
5. Nome da aba de IRPJ/CSLL:
   • Informe o nome da aba que contém os dados de IRPJ e CSLL.
6. Configurações de IRPJ/CSLL:
   • Intervalo de colunas (exemplo: M:T).
   • Quantas linhas serão puladas até a linha com os nomes das colunas.
   • Quantas linhas têm até a última informação útil (subtraindo as linhas puladas).
7. Mês e Ano de Apuração:
   • Informe o mês e o ano de apuração.
8. Valores da Ostensiva:
   • Informe os valores iniciais de IRPJ, CSLL, PIS e COFINS.
9. Local para salvar o arquivo JSON:
   • Clique em "Selecionar" e escolha onde salvar o arquivo gerado.

3. Processar os Dados

• Clique no botão "Processar" para gerar o arquivo JSON.
• O arquivo será salvo no local especificado.

Validações Adicionais

• Validação de Colunas (usecols):
  • O sistema verifica se as colunas especificadas existem na aba do Excel antes de carregar os dados. Caso contrário, um erro será exibido.

Estrutura do JSON Gerado

O arquivo JSON gerado segue a estrutura abaixo:

{
  "PeriodoApuracao": {
    "MesApuracao": 3,
    "AnoApuracao": 2025
  },
  "DadosIniciais": {
    "SemMovimento": false,
    "QualificacaoPj": 1,
    "TributacaoLucro": 3,
    "VariacoesMonetarias": 1,
    "ResponsavelApuracao": {
      "CpfResponsavel": "numero cpf",
      "TelResponsavel": {
        "Ddd": "81",
        "NumTelefone": "numero telefone"
      },
      "RegistroCrc": {
        "UfRegistro": "PE",
        "NumRegistro": "numero crc"
      }
    }
  },
  "Debitos": {
    "Irpj": {
      "ListaDebitos": []
    },
    "Csll": {
      "ListaDebitos": []
    },
    "PisPasep": {
      "ListaDebitos": []
    },
    "Cofins": {
      "ListaDebitos": []
    }
  }
}

Possíveis Erros e Soluções

1. Erro: "Defining usecols with out-of-bounds indices":
   • Verifique se o intervalo de colunas (usecols) está correto e corresponde às colunas disponíveis na aba do Excel.
2. Erro: "NameError: name 'is_trimestral' is not defined":
   • Certifique-se de que o checkbox foi configurado corretamente na interface.

Contato

Para dúvidas ou problemas, entre em contato com o desenvolvedor responsável.