https://github.com/staticdev/irpf-investidor
Programa auxiliar gratuito para calcular custos de ações, ETFs e fundos imobiliários.
https://github.com/staticdev/irpf-investidor
Last synced: 6 months ago
JSON representation
Programa auxiliar gratuito para calcular custos de ações, ETFs e fundos imobiliários.
- Host: GitHub
- URL: https://github.com/staticdev/irpf-investidor
- Owner: staticdev
- License: mit
- Created: 2022-01-01T16:45:25.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2025-09-04T15:44:07.000Z (7 months ago)
- Last Synced: 2025-09-24T21:47:11.463Z (6 months ago)
- Language: Python
- Size: 1.78 MB
- Stars: 36
- Watchers: 4
- Forks: 5
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# IRPF Investidor
[][pypi status]
[][pypi status]
[][pypi status]
[][license]
[][read the docs]
[][tests]
[][codecov]
[][pre-commit]
[][black]
[pypi status]: https://pypi.org/project/irpf-investidor/
[read the docs]: https://irpf-investidor.readthedocs.io/
[tests]: https://github.com/staticdev/irpf-investidor/actions?workflow=Tests
[codecov]: https://app.codecov.io/gh/staticdev/irpf-investidor
[pre-commit]: https://github.com/pre-commit/pre-commit
[black]: https://github.com/psf/black
Programa auxiliar para calcular custos de ações, ETFs e FIIs. Este programa foi feito para calcular emolumentos, taxa de liquidação e custo total para a declaração de Bens e Direitos do Imposto de Renda Pessoa Física.
**Essa aplicação foi testada e configurada para calcular tarifas referentes aos anos de 2019 a 2022 (IRPF 2020/2023) e não faz cálculos para compra e venda no mesmo dia (Day Trade), contratos futuros e Índice Brasil 50.**
## Requisitos
1. Python
Instale na sua máquina o Python 3.11.0 ou superior (versão 3.11 recomendada) para o seu sistema operacional em [python.org].
1. Suporte a língua Português (Brasil) no seu sistema operacional.
Pode ser instalado no Linux (Debian/Ubuntu) pelo comando:
```sh
$ apt-get install language-pack-pt-base
```
## Instalação
You can install _IRPF Investidor_ via [pip] from [PyPI]:
```sh
$ pip install irpf-investidor
```
## Uso
1. Entre na [Área do Investidor] da B3, faça login e entre no menu Extratos e Informativos → Negociação de Ativos → Escolha uma corretora e as datas 1 de Janeiro e 31 de Dezembro do ano em que deseja declarar. Em seguida clique no botão “Exportar para EXCEL”. Ele irá baixar o arquivo “InfoCEI.xls”.
**Ainda não é possível rodar o programa usando os novos arquivos XLSX, gerar no formato antigo.** Baixe e altere o [Template_InfoCEI.xls](Template_InfoCEI.xls).
Você pode combinar lançamentos de anos diferentes em um mesmo documento colando as linhas de um relatório em outro, mas mantenha a ordem cronológica.
2. Execute o programa através do comando:
```sh
$ irpf-investidor
```
O programa irá procurar o arquivo "InfoCEI.xls" na pasta atual (digite `pwd` no terminal para sabe qual é) ou na pasta downloads e exibirá na tela os resultados.
Ao executar, o programa pede para selecionar operações realizadas em leilão. Essa informação não pode ser obtida nos relatórios da `Área do Investidor` da B3 e precisam ser buscadas diretamente com a sua corretora de valores. Isso afeta o cálculo dos emolumentos e do custo médio.
## Aviso legal (disclaimer)
Esta é uma ferramenta com código aberto e gratuita, com licença MIT. Você pode alterar o código e distribuir, usar comercialmente como bem entender. Contribuições são muito bem vindas. Toda a responsabilidade de conferência dos valores e do envio dessas informações à Receita Federal é do usuário. Os desenvolvedores e colaboradores desse programa não se responsabilizam por quaisquer incorreções nos cálculos e lançamentos gerados.
## Créditos
Esse projeto foi gerado pelo template [@cjolowicz]'s [Hypermodern Python Cookiecutter].
[license]: https://github.com/staticdev/irpf-investidor/blob/main/LICENSE
[@cjolowicz]: https://github.com/cjolowicz
[hypermodern python cookiecutter]: https://github.com/cjolowicz/cookiecutter-hypermodern-python
[pip]: https://pip.pypa.io/
[pypi]: https://pypi.org/
[python.org]: https://www.python.org/downloads/
[uso]: https://irpf-investidor.readthedocs.io/en/latest/usage.html
[área do investidor]: https://www.investidor.b3.com.br/