Como usar
Você precisa só do Microsoft Excel: o Python e o Java já vêm no pacote. Em quatro passos, as notas viram planilhas.
-
Baixe e descompacte
Use o botão Baixar o COIR e extraia todo o conteúdo do zip para uma pasta de sua escolha. Não execute de dentro do zip.
-
Coloque as notas na pasta Entrada
Baixe suas notas de corretagem no padrão SINACOR direto do portal da corretora e copie para a pasta
Entrada.O COIR foi testado com as corretoras XP, Clear, Rico, Necton e BTG. Se você opera em outra corretora, entre em contato pela página de contato ou abra uma issue, para que ela seja adicionada ao sistema.
-
Dê dois cliques em COIR.bat
O arquivo fica na pasta principal. Ao rodar, o COIR extrai automaticamente as notas que estiverem na pasta
Entrada.Se o Windows alertar sobre o
python.exe, é um aviso comum para programas baixados da internet; ele faz parte do pacote. -
Abra o resultado
As notas processadas são movidas de
EntradaparaSaida. O resultado fica no arquivoResultado\CPF.xlsb, onde CPF é o número do CPF do investidor. Ele traz os dados em várias planilhas: Normais, DayTrade, Contabilidade, DARF, Isentos e outras.
O que o COIR controla
Notas de corretagem da B3 (Brasil, Bolsa e Balcão) nos mercados:
- À VistaOperações comuns e Day Trade
- Futuros
- Commodities
- DerivativosOpções
- Você envia as notas. O COIR extrai os dados.
- Controle separado por CPF, com notas de várias corretoras no mesmo CPF.
- Cada mercado é contabilizado à parte.
- Apuração mensal da DARF e cálculo do IRRF.
- Apoio à declaração anual do IRPF.
História
- 2017Primeira versão, em planilhas Excel, com operações do mercado à vista.
- 2021Extração automática das notas de corretagem com Python. Até então, o trabalho era manual.
- 2022Controles de Futuros, Commodities e Derivativos (Opções).
Desde o início, o objetivo foi a simplicidade e a correção dos dados extraídos e contabilizados.
As planilhas do COIR
Resumo das funcionalidades de cada planilha do arquivo COIR.xlsb.
- Indice
- Acesso, habilitação e descrição de cada uma das planilhas do COIR.
- Normais_Op
- Operações comuns importadas automaticamente das notas de corretagens no padrão SINACOR.
- Normais_Cont
- Resultado das operações comuns, 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 Day Trade importadas automaticamente das notas de corretagens no padrão SINACOR.
- DayTrade_Cont
- Resultado das operações Day Trade 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
- Eventos da B3, tais como Bonificação, Desdobramento, Grupamento e Subscrição, que alteram o preço médio do ativo em carteira e que não constam 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
- Total do patrimônio investido em todas as classes de ativo.
- Rendimento
- Mostra a rentabilidade da carteira ao longo do tempo.
- ManejoRisco
- Destinado à configuração do Manejo de Risco por operação de renda variável.
- ManejoPosicao
- Destinado à estimativa do Tamanho de Posição para cada operação que será aberta em renda variável.
Telas do sistema
Use as setas ou deslize para ver as telas. Clique em uma imagem para ampliar.
Dúvidas frequentes
O COIR é gratuito?
Sim. É código aberto, com licença MIT.
O que preciso ter instalado?
Apenas o Microsoft Excel, em um Windows de 64 bits. O Python e o Java já vêm dentro do pacote. O passo a passo está em Como usar.
Quais corretoras funcionam?
O COIR lê notas no padrão SINACOR e foi testado com XP, Clear, Rico, Necton e BTG. Se você opera em outra corretora, entre em contato para que ela seja adicionada ao sistema.
Onde fica o resultado?
No arquivo Resultado\CPF.xlsb, onde CPF é o número do CPF do investidor.
O COIR substitui um contador?
Não. Ele organiza e calcula as informações das suas operações, mas não substitui a análise nem a responsabilidade de um profissional contábil.
Encontrei um erro. O que faço?
Abra uma issue no GitHub ou use a página de contato.