O CS-BOT (Conectividade Social - BOT) foi desenvolvido para simplificar o download em massa de documentos dos colaboradores no site do Conectividade Social da Caixa Econômica Federal, como os extratos do FGTS.
A ideia surgiu a partir de uma necessidade de negócio da empresa em que trabalho, onde, mensalmente, é necessário baixar os extratos do FGTS dos colaboradores, organizá-los por tomadores e enviá-los aos clientes.
Siga os passos abaixo para configurar e executar o projeto em sua máquina.
Antes de começar, verifique se você tem o Python e o pip instalados em sua máquina. Além disso, é essencial que o Chromedriver esteja instalado e configurado corretamente.
Se precisar de ajuda para instalar o Chromedriver, consulte este guia detalhado: Como instalar o Chromedriver no Windows 10.
Primeiro, clone o repositório do projeto para o seu ambiente local:
git clone https://github.com/luanvelloza/CS-BOT.git
cd CS-BOTPrimeiro, clone o repositório do projeto para o seu ambiente local:
python -m venv venvAtive o ambiente virtual que você acabou de criar:
source venv/bin/activatevenv\Scripts\activateCom o ambiente virtual ativado, instale as bibliotecas necessárias listadas no arquivo requirements.txt:
pip install -r requirements.txt`Após concluir a instalação das dependências, crie um arquivo denominado .env na raiz do projeto. Neste arquivo, defina a variável ADDRESS_FILE_FGTS, atribuindo a ela o caminho completo para um repositório temporário destinado à edição dos arquivos PDF. Por exemplo: "C:\Users\SeuUsuario\Área de Trabalho\SD2".
Após criar o arquivo .env e definir a váriavel ADDRESS_FILE_FGTS, você pode executar o programa com o seguinte comando:
python app.pyQuando terminar de usar o programa, você pode desativar o ambiente virtual com o comando:
deactivateContexto
A empresa precisa enviar aos clientes os extratos do FGTS de todos os colaboradores alocados.
Solução
O CS-BOT utiliza uma planilha do Excel contendo 4 colunas: Matrícula, Nome, Tomador e PIS. Com base nesses dados, o script pesquisa o colaborador no sistema do Conectividade Social, baixa o extrato em PDF e o salva na pasta especificada no arquivo .env, renomeando-o no seguinte modelo: NOME-DO-COLABORADOR - TOMADOR.
Acesse o caminho ./excel_tables/table-with-employees-pis e abra o arquivo employee-values.
Preencha a planilha com as seguintes informações:
- Matricula - Matricula do colaborador.
- Nome - Nome do colaborador.
- Tomador - Tomador que o colaborador esta alocado.
- PIS - Número do PIS do colaborador (usado na pesquisa, não pode conter pontuações).
Salve a planilha, mantendo-a na mesma pasta (./excel_tables/table-with-employees-pis).
Verifique se não há formatos inconsistentes ou células vazias na planilha, pois isso pode causar erros durante a execução do programa
-
Ative o ambiente virtual:
- No Linux/macOS, use:
source venv/bin/activate - No Windows, use:
venv\Scripts\activate
- No Linux/macOS, use:
-
Execute o script principal: No terminal, digite o seguinte comando para iniciar o Cajupe Bot:
python app.py
-
Selecione a funcionalidade:
-
Após a execução, o programa exibirá uma lista de funcionalidades disponíveis.
-
Digite o número correspondente à funcionalidade desejada (Baixar Extratos FGTS).
- Faça login no sistema:
-
Um navegador será aberto automaticamente no site do Conectividade Social.
-
No site, selecione o botão "Empregador".
-
Após clicar no botão, será exibida uma janela pop-up com a lista de certificados digitais disponíveis.
-
Selecione o certificado digital da sua empresa para efetuar o login.
- Acesse o serviço desejado "Solicitar Extrato do Trabalhador":
- Após o login, selecione o serviço "Solicitar Extrato do Trabalhador".
- Inicie a automação
- No console do terminal, pressione qualquer tecla para iniciar o processo de automação.
- Conclusão:
-
O CS-BOT executará automaticamente o download dos extratos FGTS.
-
Aguarde até que o processo seja concluído e verifique os arquivos na pasta de download selecionada.
Contexto
Após baixar todos os extratos do FGTS dos colaboradores, é necessário juntar os arquivos por cliente.
Solução
O CS-BOT identifica todos os arquivos PDFs na pasta especificada no .env, junta os arquivos de cada cliente em um único PDF e exclui os arquivos antigos.
-
Ative o ambiente virtual:
- No Linux/macOS, use:
source venv/bin/activate - No Windows, use:
venv\Scripts\activate
- No Linux/macOS, use:
-
Execute o script principal: No terminal, digite o seguinte comando para iniciar o Cajupe Bot:
python app.py
-
Selecione a funcionalidade:
-
Após a execução, o programa exibirá uma lista de funcionalidades disponíveis.
-
Digite o número correspondente à funcionalidade desejada (Juntar e excluir PDFs).
- Conclusão:
-
O CS-BOT juntará automaticamente os arquivos PDFs dos mesmos clientes e excluirá os arquivos antigos.
-
Aguarde até que o processo seja concluído e verifique os novos arquivos PDFs.
- Python: Linguagem de programação principal.
- Selenium: Automação de navegador.
- PyAutoGUI: Automação de interface gráfica.
- python-dotenv: Criação de variáveis de ambiente.