Skip to content

Latest commit

 

History

History
121 lines (88 loc) · 3.77 KB

README-ptbr.md

File metadata and controls

121 lines (88 loc) · 3.77 KB
Raw

OFX-BOT

Estes bots tem por objetivo automatizar a tarefa de conciliação bancária entre contas do Banco do Brasil, Caixa Econômica, Itaú, Santander e NuBank com aplicativos que aceitam o formato 'ofx' (GNUCash, HomeBank.free.fr, Microsoft Money).

ofx-bb:

  • Baixa o 'ofx' da conta corrente
  • Baixa o 'ofx' da poupança
  • Baixa o 'ofx' do cartão de crédito 'Petrobrás'

ofx-caixa:

  • Baixa o 'ofx' da conta corrente

ofx-itau:

  • Baixa o 'ofx' da conta corrente
  • Baixa o 'csv' da conta corrente
  • Baixa o 'csv' do cartão de crédito (contas com múltiplos cartões ainda não são suportadas)

Roda no Chrome (default) ou Firefox (instável) Veja: "ofx-itau --help" para mais opções.

ofx-santander:

  • Baixa o 'ofx' da conta corrente

ofx-nubank:

  • Baixa o 'ofx' dos lançamentos das faturas disponíveis. Também é capaz de gerar um CSV no formato aceito pelo HomeBank

Roda no Chrome (default) ou Firefox (instável) Veja: "ofx-nubank --help" para mais opções.

Requisitos:

Firefox ou Chrome

  • As versões mais recentes do Firefox (>=47) e do Chrome não mais podem ser utilizadas diretamente com o cliente Selenium puro e exigem a instalação de um webdriver específico. Estes novos drivers (Firefox GeckoDriver, Google Chrome Driver) precisam ser baixados e colocados em um diretório presente no PATH para funcionar.

  • Você pode achar a versão mais recente dos drivers aqui: http://www.seleniumhq.org/download/ . De qualquer forma, aqui vão os links diretos para facilitar a vida:

ofx-bb, ofx-caixa e ofx-santander

  • É necessário ter o pacote selenium do Python2:
pip2 install selenium

ofx-itau, ofx-nubank

  • É necessário ter o Haskell Stack instalado:
wget -q -O- https://s3.amazonaws.com/download.fpcomplete.com/ubuntu/fpco.key | sudo apt-key add -
echo "deb http://download.fpcomplete.com/ubuntu/$(lsb_release -sc) stable main"|sudo tee /etc/apt/sources.list.d/fpco.list
sudo apt-get update
sudo apt-get install stack
  • Para compilar:
cd itau
./build.sh

ou

cd nubank
./build.sh
  • Caso a sua instalação de Haskell seja nova, o build.sh baixará e instalará uma série de pacotes no ~/.stack. Isso pode levar algum tempo. Após compilado, os executáveis são automaticamente copiados para o diretório raiz do projeto.

Como usar:

./ofx-bb.py
./ofx-caixa.py
./ofx-itau
./ofx-santander.py
./ofx-nubank

Ou usando um aquivo de entrada, via redirecionamento:

./ofx-bb.py < input.cfg
./ofx-caixa.py < input.cfg
./ofx-itau < input.cfg
./ofx-santander.py < input.cfg
./ofx-nubank < input.cfg

Nos casos acima, a janela do Firefox ficará visível durante toda a execução dos bots, pois não há nenhum tratamento com o display. Este comportamento é interessante para acompanhar o movimento nas páginas e depurar possíveis bugs. Para deixar o browser oculto, utilize um display virtual, como no exemplo abaixo:

xvfb-run --server-args="-screen 0, 1440x900x24" ./ofx-bb.py < input.cfg

Notas:

Obviamente, este script supre minhas necessidades. Porém ele pode se tornar bem mais elaborado. Alguns pontos a se melhorar futuramente:

  • Criptografar a senha com a chave privada do usuário para evitar a digitação em todas execuções
  • Opção de mais 'ofx' de acordo com o desejo do usuário (Poupança, outros cartões, ...)
  • Mais tarefas automatizadas