O COIR é um sistema de extração de dados de notas de corretagens no padrão SINACOR (Sistema Integrado de Administração de Corretoras) para planilhas do Microsoft Excel. Tem como objetivo o controle de operações nos mercados Á Vista (Normal e DayTrade), Futuros, Commodities e Derivativos (Opções), na bolsa de valores da B3 (Brasil, Bolsa e Balcão).
Esse controle de operações começou em 2017, inicalmente apenas em planilhas excel com operações do mercado À Vista. Em 2021 nasceu a necessidade de automatização da extração de dados das notas de corretegens, até então todo esse trabalho era realizado de forma manual. Para essa automatização é utilizada a linguagem de programação Python. Em 2022 foram acrescentado os controles de operações dos mercados de Futuros, Commodities e Derivativos (Opções).
Desde o início, o objetivo desse controle foi a simplicidade e correção dos dados extraídos e contabilizados. Algumas das principais características do COIR são:
- Controle separado por CPF
- Possibilidade de contabilizar notas de corretagens de corretoras diferentes para um mesmo CPF
- Contabilizar operações para cada tipo de mercado (Á Vista, Futuros, Commodities e Derivativos)
- Apuração mensal da DARF
- Cáluco do Imposto de Renda Retido na Fonte (IRRF)
- Auxílio na Declaração anual de Imposto de Renda Pessoa Física (DIRPF)
Atualmente o sistema consegue manipular notas de corretagens das corretoras XP, Clear, Rico, Necton e BTG.
Para ter acesso a todas as funcionalidades do sistema será necessário o Microsoft Excel e o software Python.
-
Descompacte e copie todo o conteúdo baixado para uma pasta de seu interesse.
-
Baixe suas notas de corretagem no padrão SINACOR direto do portal de sua corretora.
- O sistema foi testado apenas para as corretoras XP, Clear, Rico, Necton e BTG.
- O sistema trabalha com notas de corretagens de um mês fechado/completo.
-
Copie as notas de corretagens baixadas para a pasta “..\Entrada”.
-
Execute o programa “COIR.py”, que se encontra na pasta principal.
- Para isso é necessário que o Python 3 estaja instalado em sua máquina, Python 3.9.2 ou superior, preferencialmente.
- Ele pode ser baixando do endereço https://www.python.org/downloads/
- Após o download e instalação do python execute o script “COIR.py”
- Na primeira execução do script devem ser instaladas algumas bibliotecas não nativas do Python e que são necessárias para a correta execução do COIR.py. O arquivo requirements.txt tem uma lista com essas bibliotecas, bastando para isso utilizar a seguinte linha de comando:
$ python -m pip install -r requirements.txt -
Após concluídas as instalações o programa fará a exportação das Nota de Corretagens presentes na pasta “..\Entrada” automaticamente.
-
As notas de corretagem processadas serão movidas da pasta “..\Entrada” para a pasta “..\Saída”.
-
O resultado da extração das notas de corretagens será inserido em 2 arquivos:
- ..\Resultado\CPF\Completo.xlsx – que contém o resultado bruto da extração de todas as notas.
- ..\Resultado\CPF\COIR.xlsb – que contém os dados extraídos das notas de corretagem em várias planilhas (Normais, Daytrade, Contabilidade, DARF, isentos, entre outras).
Contribuições são muito bem-vindas!
A seguir são apresentadas, de forma resumida, as funcionalidades das planilhas do COIR:
- Indice - Acesso, habilitação e descrição de cada uma das planilhas do COIR.
- Normais_Op - Operações Normais importadas automaticamente das notas de corretagens no padrão SINACOR.
- Normais_Cont - Resultado das operações Nomais, separado por mês e por ano no padrão do IRPF.
- Normais_Dados - Dados importados das notas de corretagens que serão utilizados na aba "Normais_Op".
- DayTrade_Op - Operações DayTrade importadas automaticamente das notas de corretagens no padrão SINACOR.
- DayTrade_Cont - Resultado das operações DayTrade separado por mês e por ano no padrão do IRPF
- DayTrade_Dados - Dados importados das notas de corretagens que serão utilizados na aba "DayTrade_Op"
- Eventos B3 - São eventos da B3, tais como; Bonificação, Desdobramento, Grupamento, Subscrição, que alteram o preço médio do ativo em carteira e que não constão das notas de corretagens.
- Isentos - Apresenta os Rendimentos Isentos e Não Tributáveis auferidos no mercado financeiro e que devem ser declarados na DIRPF
- DARF - Disponibiliza os dados para a apuração do DARF mensal.
- Custodia inicial - Dados de custódia para pessoas que já possuem resultados apurados com a Receita.
- Alocação - Saldo da Alocação por ativos com porcentagem da alocação atual e a porcentagem "desejada" para cada ativo.
- Balanceamento - Apresenta uma forma de balanceamento de carteira, com os aportes mensais ou por variação de cada ativo da carteira.
- Patrimônio - É o total do patrimônio investido em todas as classes de ativo.
- Rendimento - Mostra a rentabilidade da carteira ao longo ao tempo.
- ManejoRisco - Destinado a configuração do Manejo de Risco por operação de renda variável.
- ManejoPosicao - Destinado a estimativa do Tamanho de Posição para cada operação que será aberta em renda variável.
- Reservado0 - Planilha reservado para implementação futura.
- Reservado1 - Planilha reservado para implementação futura.
- Reservado2 - Planilha reservado para implementação futura.
- Reservado3 - Planilha reservado para implementação futura.
Tela principal
Índice
Controle das operações realizadas
Contabilidade das operações realizadas
Alocação por classe de ativo
Controle de operações isentas de IR
Controle de DARF mensal
Eventos da B3
Custódia inicial
Balanceamento da carteira
Manejo de risco antimartingale com porcentagem fixa por tipo de operação
- Armazenamento e disponibilização das informações em uma base de dados
- Implementação de uma interface web para:
- importar as notas de corretagens
- visualizar os dados armazenados por usuário com um sistema de autenticação