Skip to main content

IRPF Investidor

PyPI Status Python Version License

Read the documentation at https://irpf-investidor.readthedocs.io/ Tests Codecov

pre-commit 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.

  2. Suporte a língua Português (Brasil) no seu sistema operacional.

    Pode ser instalado no Linux (Debian/Ubuntu) pelo comando:

    $ apt-get install language-pack-pt-base
    

Instalação

You can install IRPF Investidor via pip from PyPI:

$ 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.

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.

  1. Execute o programa através do comando:
$ 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.

Release files for irpf-investidor 2025.16.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for irpf-investidor 2025.16.5
File Size Uploaded
irpf_investidor-2025.16.5.tar.gz 289.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for irpf-investidor 2025.16.5
File Interpreter ABI Platform
irpf_investidor-2025.16.5-py3-none-any.whl Python 3 none any Details

Total release size: 307.2 kB

Release files / irpf_investidor-2025.16.5.tar.gz

Download URL irpf_investidor-2025.16.5.tar.gz
Size 289.1 kB
Tags Source
SHA-256 checksum
How to use checksums
01ee12ba0d50ae1ff19a628ee8164e38a09d25b3d47d8663316b2c891b18f5ed
BLAKE2b-256 checksum
How to use checksums
807e4d142b24240fd5e444af9b0cc15214f43398beba37be89c6277b0ee169d8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.12.9

Release files / irpf_investidor-2025.16.5-py3-none-any.whl

Download URL irpf_investidor-2025.16.5-py3-none-any.whl
Size 18.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9e8f9ea8f37d76c227642cb433fc91c6606728acbd789db732d3a04ad5bb318f
BLAKE2b-256 checksum
How to use checksums
94a27bffae858728cd0e1cc478ceccdbe776931e334747a7564fbf4afd8e9d49
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.12.9

Release history Release notifications | RSS feed

This release

2025.16.5 This release

2 release files

2022.4

2 release files

2021.2

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page