Dados do FGTS

Converta os PDFs fornecidos pela app do FGTS em dados estruturados num CSV prontinho para ser usado com o Investorzilla.

Instalação

pip install fgts_pdf_dados --user

Uso

shell> cd "Pasta com PDFs do FGTSs"
shell> ls
EXTRATO_EMPRESA_1.pdf
EXTRATO_EMPRESA_2.pdf
EXTRATO_EMPRESA_3.pdf

shell> fgts-pdf-dados

Ou converta os nomes das empresas para algo mais bonito:

shell> cd "Pasta com PDFs do FGTSs"
shell> fgts-pdf-dados \
    --nickname 'C I T SOFTWARE SA'           'CI&T' \
    --nickname 'DIGITAL HOUSE EDUCACAO LTDA' 'Digital House'

Todo mês, por volta do dia 21, eu entro na app do FGTS e salvo em PDF o extrato atualizado de todas as minhas contas ativas. As inativas (empresas que já saquei e zerei o FGTS) só preciso fazer uma vez. Mantenho tudo junto numa pasta onde rodo o comando fgts-pdf-dados. Na verdade, tenho um Makefile com o seguinte conteúdo:

all:
        # pip install --user fgts-pdf-dados
        fgts-pdf-dados \
            --nickname 'C I T SOFTWARE SA'             'CI&T' \
            --nickname 'DIGITAL HOUSE EDUCACAO LTDA'   'Digital House' \
            --nickname 'NOME FEIO CONFORME VEM NO PDF' 'Apelido Bonito' \
            --nickname 'OUTRO NOME FEIO'               'Apelido Bonito'

Aí, depois de gravar o extrato atualizado da app do FGTS, só preciso rodar make.

Resultado

O arquivo FGTS.csv vai conter uma série histórica com todos os dados de cada empresa ou conta de FGTS e já separa o que é movimentação de entrada e saída (coluna movement) e o que é juros (coluna interest). E tem também a coluna mais importante (total) com o saldo daquela conta, naquele instante do tempo:

Ao nome da conta (manipulável com o parâmetro --nickname) será adicionado o número dela conforme encontrado no PDF, então não tem problema se você usar o --nickname para converter diversos nomes feios diferentes para um único nome bonito. Isso me foi últil pois uma empresa em que trabalhei por muitas décadas foi mudando o nome em que se declarava no FGTS.

Sobre

Feito por Avi Alkalay para prover dados pessoais ao meu painel de investimentos do Investorzilla.