Skip to main content

IRPF Investidor

Project description

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

irpf_investidor-2025.16.5.tar.gz (289.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

irpf_investidor-2025.16.5-py3-none-any.whl (18.1 kB view details)

Uploaded Python 3

File details

Details for the file irpf_investidor-2025.16.5.tar.gz.

File metadata

  • Download URL: irpf_investidor-2025.16.5.tar.gz
  • Upload date:
  • Size: 289.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for irpf_investidor-2025.16.5.tar.gz
Algorithm Hash digest
SHA256 01ee12ba0d50ae1ff19a628ee8164e38a09d25b3d47d8663316b2c891b18f5ed
MD5 a1f8acefa9b044b8dff55672b6677731
BLAKE2b-256 807e4d142b24240fd5e444af9b0cc15214f43398beba37be89c6277b0ee169d8

See more details on using hashes here.

File details

Details for the file irpf_investidor-2025.16.5-py3-none-any.whl.

File metadata

File hashes

Hashes for irpf_investidor-2025.16.5-py3-none-any.whl
Algorithm Hash digest
SHA256 9e8f9ea8f37d76c227642cb433fc91c6606728acbd789db732d3a04ad5bb318f
MD5 007a8c6a72e2b19b53c01ec2311eb994
BLAKE2b-256 94a27bffae858728cd0e1cc478ceccdbe776931e334747a7564fbf4afd8e9d49

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page