IR - Projeto de calculo automático de Imposto de Renda | Bovespa

O que se propoe a fazer

Automaticamente busca todos as suas operacoes na bolsa no site do canal eletronico do investidor (CEI) (https://cei.b3.com.br/)
Funciona com FIIs, ETFs, Acoes e Opcoes
Funciona com qualquer corretora. (Na verdade, nao depende da corretora)
Apos buscar os trades no CEI, salva tudo em um arquivo csv no dropbox da sua conta
Realiza os calculos (automaticamente):
- Preco medio de compra
- Preco medio de venda
- Lucro/Prejuizo no mes
- IR a pagar, ja considerando o possivel prejuizo acumulado
- Tabela com a custodia atual para conferencia
- Envia email com todas as informacoes para voce pagar o imposto
Pode ser transformado em um processo automático
O arquivo CSV das operações é salvo caso algum papel sofra desdobramento ou mude o ticker de negociacao

O que voce vai precisar

Uma conta no CEI (https://cei.b3.com.br/)
Uma conta no dropbox com API habilitada (https://blogs.dropbox.com/developers/2014/05/generate-an-access-token-for-your-own-account/)
- Criar um app (https://www.dropbox.com/developers/apps)
- Habilitar os escopos de leitura e gravação de arquivos
- Alterar "Access token expiration" para "No expiration"
- Criar uma chage em "Generated access token"
Ter uma conta do Google para enviar o relatório final por email
- Para isso é necessário habilitar o acesso "menos seguro" por usuário e senha em alguma conta: (https://support.google.com/accounts/answer/6010255)
Configurar as variaveis de ambiente conforme (https://github.com/guilhermecgs/ir/blob/master/tests/test_environment_variables.py)
- Para isso copie o arquivo sample.env para o arquivo .env

Executando o programa

Execute o arquivo start.sh caso queira realizar todos os processos sequencialmente.
O comando segue na forma: sh ./start.sh {caminho para virualenv}. Ex:

  sh ./start.sh /home/youruser/path/to/virtualenv

Caso não queira executar o processo completo, é possível executar o passo a passo de comandos conforme descrito abaixo. Ps: dessa forma, certifique-se de carregar as variáveis de ambiente antes (export $(egrep -v '^#' .env | xargs)):

Checa se a configuração das variáveis de ambiente estão corretas.
python ./ir.py --do check_environment_variables
Faz a busca no CEI e envia o arquivo de registros ao dropbox
python ./ir.py --do busca_trades_e_faz_merge_operacoes
Realiza os calculos e envia o email
python ./ir.py --do calculo_ir

exemplo do relatorio gerado no seu email

https://github.com/guilhermecgs/ir/blob/master/exemplo_relatorio_automatico.pdf

Exemplo de variáveis de ambiente:

DROPBOX_FILE_LOCATION:/Finance/GCGS/export_operacoes_gcgs.txt
DROPBOX_API_KEY:jOznaw_xxxxxxxxxxxxxxxxxxxxtkw9ox_a9I_8-_aU2xw1xxxxxxxxxxKWek69Z
GMAIL_FROM:emailremetente@gmail.com
GMAIL_PASSWORD:minha_senha_gmail
SEND_TO:emaildestinatario@gmail.com
CPF:00098765434
SENHA_CEI:minha_senha_cei

disclaimer

Aceito PRs :-) Eu fiz o software pensando em automatizar exatamente como eu fazia as coisas manualmente
Nao funciona com daytrade
Desconsidera custos e emolumentos para simplificação do calculo

To-do list

Incluir gratuidade de 20k por mes para acoes
Incluir desconto de taxas, emolumentos e dedo duro - http://www.b3.com.br/pt_br/produtos-e-servicos/tarifas/listados-a-vista-e-derivativos/renda-variavel/tarifas-de-acoes-e-fundos-de-investimento/a-vista/
Calculo correto na venda de opções cobertas/descobertas

Tech Stack

- python
- selenium
- gitlab ci
- beautifulsoap
- pandas

TCMiranda / ir