Bem-vindo ao Tutorial do Robô Financeiro

Este tutorial mostra, em vídeo, o funcionamento completo do RotinasInterweg.exe. Cada módulo e independente, assista na sequência ou pule direto para o que precisar.

Extrato BancárioBradesco Net Empresa
Envio do arquivoEnvio do PDF
RecebimentosLançamento automático Nibo
PagamentosMódulo de pagamentos
ConciliaçãoImportação de extrato PDF
0

Visão Geral do Sistema

O que o robô faz e como ele esta organizado

Leitura rápida
O RotinasInterweg.exe e o executável central da automação financeira da Interweg. Ao abrir, exibe um menu com todas as rotinas disponíveis organizadas por empresa (ADM, Benefícios, Gecorp).

O que o robô faz, passo a passo:

1
Acessa o Bradesco Net Empresa e baixa o extrato bancário (PDF + Excel)
2
Salva os arquivos automaticamente em pastas organizadas por data
3
Faz login no Nibo com autenticacao MFA via WhatsApp quando necessário
4
Lança recebimentos no Nibo a partir dos créditos identificados no extrato, com categoria e centro de custo preenchidos por IA (GPT-4o)
5
Lança pagamentos no Nibo a partir dos boletos enviados para a sua caixa de entrada, com categoria e centro de custo preenchidos por IA (GPT-4o)
6
Realiza a conciliação bancária importando o PDF do extrato no Nibo
7
Registra logs detalhados de cada execução para rastreabilidade
Localização do executável:
C:\Users\valeria.melo\Desktop\nibo\Executavel\dist\RotinasInterweg.exe
1

Extrato Bancário — Bradesco

Download automático do extrato em PDF e Excel

Vídeo disponível
1
Abra o RotinasInterweg.exe e selecione a empresa e a rotina Extrato Bancário
2
O robo abre o Chrome e acessa o Bradesco Net Empresa com as credenciais do arquivo .env
3
Se aparecer CAPTCHA, resolva manualmente na janela aberta — o robô aguarda
4
O robo navega ate Saldos e Extratos → Extrato Mensal/Por Periodo, preenche as datas e busca o extrato
5
Salva o extrato em PDF e Excel (.xlsx) na pasta data\raw\bradesco\YYYY-MM-DD\
Se o CAPTCHA aparecer com frequência, aguarde o robo pausar e resolva na janela do Chrome que ele abriu, não feche a janela.
2

Nibo — Acesso, Menu Principal e envio do arquivo PDF

Login, MFA e seleção de empresa

Video disponivel
O robô salva a sessão do Nibo para evitar MFA repetido. Se a sessão expirar, o fluxo abaixo é ativado automaticamente.
1
O robô verifica o arquivo nibo_storage_state.json — se a sessão estiver válida, pula o login
2
Se necessário, faz login com e-mail e senha e aciona o MFA via WhatsApp
3
Você tem 120 segundos para digitar o código recebido no WhatsApp na janela do Chrome
4
Após confirmar, o robô salva a sessão e seleciona a empresa correta pelo CNPJ
5
Seleciona conciliação, e faz upload do arquivo PDF no Nibo
3

Recebimentos — Lançamento Automático

Leitura do extrato e agendamento no Nibo com IA

Vídeo disponível
1
Pré-requisito: o extrato Excel ja deve estar baixado (Módulo 1)
2
O robô varre a pasta de extratos e localiza os arquivos .xlsx ainda nao processados
3
Lê cada crédito (entrada de dinheiro): data, descrição e valor
4
A IA (GPT-4o-mini) categoriza cada lançamento e sugere o centro de custo automaticamente
5
Para cada crédito, abre o formulário Recebimentos → Agendar no Nibo e preenche todos os campos
6
Após agendar tudo, o Excel e movido para a pasta agendado/ e a sessão do Nibo e salva
Exemplos de categorização automática: "Recebimento de comissão"
4

Pagamentos

Módulo de agendamento de pagamentos no Nibo

Vídeo disponível
1
Selecione a rotina Pagamentos no menu principal do executavel
2
O robo acessa o Nibo e navega ate o modulo de Pagamentos
3
Le os debitos identificados no extrato e agenda cada pagamento com data, valor e categoria
4
O centro de custo e preenchido automaticamente pela IA com base na descricao do lancamento
5
Log de execucao e gerado ao final com os pagamentos agendados e eventuais pendencias
O modulo de pagamentos e independente do módulo de recebimentos — pode ser executado separadamente ou em sequência.
5

Conciliação Bancária

Importação do extrato PDF e conciliação automática no Nibo

Video disponivel
1
Prerequisito: extrato PDF ja deve estar baixado pelo Modulo 1
2
O robo acessa o Nibo e navega para Gestao de Caixa → Contas & Extratos
3
Seleciona a conta bancaria correta pelo nome (ex.: Conta Bradesco - INTERWEG BENEFICIOS)
4
Clica em Conciliar extrato → Importar e envia o arquivo PDF do extrato
5
Aguarda o Nibo processar. Apos importar com sucesso, move o PDF para a pasta conciliado/
6
Gera log com resultado: conciliados, pendentes e divergências
Após a conciliação, verifique os lançamentos pendentes no Nibo e ajuste manualmente se necessário antes do fechamento mensal.
RotinasInterweg v1.2 · Março 2026 · Uso Interno · Dúvidas: TI Interweg
Uso Interno · Confidencial

Robô Financeiro — RotinasInterweg

Automação de pagamentos, recebimentos e conciliação bancária · Intermezzo Seguros / Interweg

PeríodoJan – Mar 2026
PlataformaNibo + Bradesco
TecnologiaPython · Playwright · GPT-4o
EntregaMarço 2026
Calendário do Projeto — Jan a Mar/2026
Nota: O calendário original passou por revisões devido a cenários críticos não mapeados — como instabilidade no login do Bradesco Net Empresa e variações no fluxo de MFA do Nibo.
Janeiro 2026 — Semanas 1 e 2
Kick-off e Levantamento de Requisitos
Reuniões com o time na operação. Mapeamento de processos: extrato bancário, lançamentos manuais, conciliação. Trabalho a quatro mãos com a equipe financeira.
Concluído
Janeiro 2026 — Semanas 3 e 4
Definição de arquitetura e criação de contas de teste
Escolha da arquitetura de microsserviços. Criação de 2 contas de teste no Nibo. Definição do stack: Python, Playwright, OpenAI GPT-4o-mini, PyInstaller.
Concluído
01 a 07 Fev 2026 — Cenário Crítico #1
Instabilidade no Login do Bradesco Net Empresa
O robô encontrou falhas intermitentes de autenticação. O fluxo de CAPTCHA não estava mapeado. Calendário reajustado em +1 semana.
Bloqueio — Calendário replanejado
08 a 21 Fev 2026
Desenvolvimento dos módulos principais
Módulo de extrato bancário (PDF + Excel), módulo de recebimentos com IA, módulo de conciliação bancária. Sistema de logs e sessão salva do Nibo.
Concluído
22 a 28 Fev 2026 — Cenário Crítico #2
Fluxo MFA via WhatsApp — variação de tela
O Nibo alterou o layout da tela de autenticação MFA. Ajuste emergencial no módulo de login. Janela de 120s para entrada do código reimplementada.
Bloqueio — Hotfix aplicado
01 a 14 Mar 2026
Testes com contas de produção e ajuste de categorias por IA
Primeiros testes reais com dados da empresa ADM e Benefícios. Refinamento do prompt de categorização (GPT-4o-mini). Geração de logs para rastreabilidade.
Concluído
18 Mar 2026
Validação de Centro de Custo e Categorias
Revisão completa das categorias e centros de custo com o time. Aprovação formal. OK passado para a equipe.
OK passado ao time
19 Mar 2026
Testes do fluxo completo
Execução end-to-end: extrato, recebimentos, conciliação. Validação dos três módulos em sequência com dados reais.
Aprovado
20 Mar 2026
Acompanhamento de comportamento em produção
Monitoramento nas máquinas do escritório. Ajuste de processamento. Novas regras de categorias nos robôs.
Estável
23 a 27 Mar 2026 — EM ANDAMENTO
Acompanhamento da utilização pelo time
Semana de acompanhamento da operação. Suporte ao time. Atualização semanal do Nibo pela equipe.
Em execução
Março 2026 — Meta do mês
Pagamento, recebimento e conciliação 100% com os robôs
Encerrar março sem nenhum lançamento manual. Todo o fluxo financeiro das três empresas executado pelos robôs.
Meta do mês
Mapa Estratégico do Projeto
Objetivo Principal
Automação Financeira Total
Zero lançamento manual em março
Empresas cobertas
ADM · Benefícios · Gecorp
1 conta Nibo centralizada
Tecnologia
Python + Playwright + GPT-4o
Microsserviços independentes
Decisão de custo
Executável Local (.exe)
Sem custo de servidor/hospedagem
Arquitetura
Microsserviços
Flexibilidade para novos insights
Metodologia
Co-criação com o time
Levantamento na operação

Arquitetura de Microsserviços

Módulo Extrato
Bradesco PDF + Excel
→
Módulo IA
Categorização GPT-4o
→
Módulo Recebimentos
Lançamento automático Nibo
→
Módulo Conciliação
Importa PDF no Nibo
→
Módulo Logs
Rastreabilidade completa
Fluxograma — Execução Diária do Robô
Usuário abre RotinasInterweg.exe
↓
Seleciona empresa e rotina no menu
↓
Acessa Bradesco Net Empresa
↓
CAPTCHA presente?
SIM
Aguarda resolução manual
NÃO
Login automático
↓
Baixa extrato (PDF + Excel) e salva em pastas por data
↓
Acessa Nibo — verifica sessão salva
↓
Sessão válida?
SIM
Pula login
NÃO
Login + MFA WhatsApp (120s)
↓
Lê créditos do Excel (data, descrição, valor)
↓
GPT-4o-mini categoriza cada lançamento (categoria + centro de custo)
↓
Agenda Recebimentos no Nibo (formulário automático)
↓
Agenda Pagamento no Nibo (formulário automático)
↓
Importa PDF no Nibo — Conciliação Bancária
↓
Gera log de execução (conciliados / pendentes / divergências)
↓
Rotina concluída — arquivos movidos para /agendado e /conciliado
Padrões de Projeto Aplicados
Microservices Pattern
Arquitetura
Cada rotina é um módulo independente. Falha em um não derruba os outros. Permite atualização isolada de cada parte.
extrato_module.py → recebimento_module.py → conciliacao_module.py
Strategy Pattern
Comportamental (GoF)
A lógica de categorização é plugável: hoje usa GPT-4o, mas pode ser substituída por outra IA ou regra manual sem alterar o restante do sistema.
categorizador = GPT4oCategorizador()
Repository Pattern
Dados
A camada de acesso ao Nibo e ao Bradesco é encapsulada em repositórios, isolando a lógica de negócio da automação de navegador.
NiboRepository.agendar_recebimento(lancamento)
Session State Pattern
Resiliência
A sessão autenticada do Nibo é persistida em arquivo, evitando MFA repetido e tornando a execução mais rápida e resiliente.
storage_state = "nibo_storage_state.json"
Observer / Log Pattern
Rastreabilidade
Cada ação do robô gera um registro de log com timestamp. Facilita auditoria, debugging e demonstração de resultado para o time financeiro.
logger.info("Recebimento agendado: R$ valor — categoria")
Fail-Safe / Graceful Degradation
Resiliência
Cenários críticos (CAPTCHA, MFA, instabilidade de login) são tratados com espera manual controlada, sem crash.
if captcha_detected: aguarda_usuario(timeout=120)
Conquista do time

Uma conquista do time

Este foi o primeiro projeto técnico desenvolvido com o time acompanhando em tempo real — do levantamento de requisitos na operação até a validação em produção. Cada bloqueio superado, cada regra de categoria ajustada, cada log revisado foi uma construção coletiva. Obrigada a todos que tornaram isso possível.

Levantamento colaborativo
Iteração constante
Entrega em produção
Zero lançamento manual