💰 CryptoIRPF

CryptoIRPF é uma aplicação desktop para converter valores de transações de criptomoedas para valores em Reais brasileiros (BRL) em datas específicas.

✨ Características

• 📊 Obtenção de preços históricos via API CryptoCompare
• 💱 Conversão automática USD → BRL usando API do Banco Central do Brasil
• 🔍 Visualização detalhada dos resultados em tabela
• 📂 Exportação para CSV para fácil integração com outras ferramentas
• 📝 Sistema de logs detalhado para acompanhamento e diagnóstico

🚀 Instalação

Executável pré-compilado

O executável para Windows é gerado automaticamente via GitHub Actions e pode ser baixado na página de releases.

Windows

1. Baixe o arquivo CryptoIRPF-Windows.exe
2. Execute o programa! - sem instalação necessária.

Executando a partir do código fonte

Se preferir executar o código fonte diretamente:

# Clone o repositório
git clone https://github.com/randomname124290358349/cryptoIRPF.git
cd cryptoIRPF

# Crie um ambiente virtual (opcional mas recomendado)
python -m venv venv
source venv/bin/activate  # No Windows: venv\Scripts\activate

# Instale as dependências
pip install -r requirements.txt

# Execute a aplicação
python main.py

🔍 Como usar

1. 🚀 Inicie a aplicação CryptoIRPF
2. 📁 Selecione o arquivo CSV de entrada contendo seus dados de transações de criptomoedas
   • O arquivo deve seguir o formato específico (veja abaixo)
3. 💾 Selecione o diretório de saída onde será salvo o arquivo de resultados
4. ▶️ Clique em "Iniciar Processamento" e aguarde a conclusão
5. 📊 Visualize os resultados na aba "Resultados"
6. 📋 Consulte os logs na aba "Logs" para informações detalhadas sobre o processamento
7. 📄 Verifique o arquivo CSV gerado no diretório de saída (resultados_crypto_brl.csv)

📋 Formato do arquivo CSV de entrada

O arquivo CSV de entrada deve seguir este formato:

data;ticker;quantidade
01/01/2023;BTC;0,5
15/02/2023;ETH;2,0
30/03/2023;SOL;10,0

• 📅 data: Data da transação no formato DD/MM/AAAA
• 🏷️ ticker: Símbolo da criptomoeda (BTC, ETH, SOL, etc.)
• 🔢 quantidade: Quantidade transacionada, usando vírgula como separador decimal

📸 Screenshots

Tela Principal	Logs	Resultados

🔌 Informações sobre as APIs

🪙 CryptoCompare

O aplicativo utiliza a API pública do CryptoCompare para obter preços históricos de criptomoedas em USD. Os preços correspondem ao valor de fechamento do dia especificado.

🏦 Banco Central do Brasil

Para converter valores de USD para BRL, o aplicativo consulta a API do Banco Central do Brasil para obter a cotação oficial do dólar na data da transação. Se não houver cotação disponível para a data específica (por exemplo, finais de semana ou feriados), o sistema automaticamente busca a cotação mais recente disponível.

⚠️ Resolução de problemas

1. 🌐 Falha na conexão com as APIs: Verifique sua conexão com a internet. O aplicativo precisa de acesso à internet para consultar os preços históricos.

2. 📄 Formato de CSV inválido: Certifique-se de que seu arquivo CSV siga exatamente o formato especificado, usando ponto-e-vírgula como separador e vírgula como separador decimal.

3. 🐛 Erros de execução: Consulte a aba "Logs" e "Traceback" para obter informações detalhadas sobre possíveis erros.

4. 🔍 Criptomoeda não encontrada: Verifique se o símbolo da criptomoeda está correto e é suportado pela API CryptoCompare.

🤝 Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para abrir um issue para reportar bugs, sugerir melhorias ou enviar pull requests.

⚖️ Aviso Legal

Os usuários são responsáveis por verificar a precisão dos dados gerados e por cumprir todas as obrigações fiscais aplicáveis.

Os preços históricos e taxas de câmbio são obtidos de APIs de terceiros e sua precisão não pode ser garantida.