Gera Valor BPO: levantamento para pré-orçamento

Versão: 0.2 Base: reunião de 06/11/2026 com o Abel (transcrição, notas do Gemini, vídeo), 9 arquivos enviados por WhatsApp e testes de leitura no I-Control Status: a integração com o I-Control está validada tecnicamente nos 5 relatórios, por tela e por HTTP. Seguem pendentes a empresa piloto, a conta de teste do robô, o acesso ao MR e ao Sicredi, o contrato com o Flwe e a decisão sobre as colunas derivadas (seção 10).

Marcações: [LACUNA] é algo que falta e precisa de resposta; [HIPÓTESE] é leitura nossa ainda não confirmada.

---

1. Resumo

O Abel (Gera Valor BPO, empresa familiar) está no limite de capacidade e recusa tarefas. Todo dia ele baixa relatórios do ERP do cliente, cola em planilhas próprias, sobe arquivos num sistema de conciliação e envia um painel Power BI para o cliente aprovar pagamentos. Tudo manual.

Proposta: o Flwe (plataforma do Francisco) é o orquestrador e dispara a rotina todo dia; um robô baixa os relatórios, escreve nas planilhas, valida o recálculo, gera o arquivo do sistema de conciliação e devolve ao Flwe apenas o status. O piloto previsto é a Casa do Produtor (Umuarama), no I-Control. O acesso recebido é da Cama e Conforto, provavelmente o segundo cliente do Abel no mesmo ERP [HIPÓTESE].

Combinado até agora

• Ordem de integração com o I-Control: 1) API oficial; 2) API não oficial, consumida de forma balanceada; 3) navegação pela plataforma.
• Rotina de segunda a sexta, 6h.
• Antes de produção, rodar sobre uma cópia e comparar o dia anterior (Abel x robô) até dar zero a zero.
• O Flwe orquestra e recebe só o status; os dados extraídos ficam nas planilhas do Abel e no MR.

O que já foi validado (11/11)

• Os 5 relatórios do I-Control exportam por script de tela, sem MFA e sem captcha.
• Os 5 relatórios também funcionam por HTTP, sem navegador, com os mesmos totais da tela e com todas as colunas, inclusive as que a tela esconde.
• Janelas grandes respondem rápido: de 2.911 a 13.949 registros em 1,8 a 7,5 s.
• A sessão aguenta pelo menos 35 minutos parada, e duas sessões do mesmo usuário convivem.

O que bloqueia

• O acesso recebido abre a Cama e Conforto, mas os arquivos e a demonstração são da Casa do Produtor.
• Falta acesso ao MR e definição para o Sicredi (extrato e vendas).
• Falta o contrato entre o Flwe e o robô.
• Falta uma conta de teste exclusiva do robô: hoje usamos a conta pessoal do Abel.

2. Nomes que a transcrição errou

Na transcrição/notas	Correto	Como sei
CCRED, Secret	Sicredi	Favoritos do navegador, planilha "Máquina Sicredi 2026"
Vico, Vic	Provavelmente MR	URL web.sistemamr.app.br, planilha "Todos os Extratos MR" [LACUNA: confirmar com o Abel]
Flujo, flu, fluido	Flwe	Confirmado

3. Fluxo diário atual

Verde: robô na fase 1. Amarelo: decisão pendente. Cinza: humano hoje. Azul: já automático. Roxo: fase 2.

Papel do Flwe (reunião de 06/11 e conversa do Francisco em 09/11): chama o serviço uma vez por dia; planeja as etapas em sequência, com tarefa manual seguida de automática; recebe de volta o status (ok, problema na planilha, categoria nova, falha de acesso) e acompanha o andamento, inclusive o envio do link ao cliente e a resposta (fase 2). Os dados extraídos não passam por ele. A orquestração em si (por exemplo com LangGraph) é decisão do Francisco e do desenvolvedor sócio e não entra no nosso orçamento.

Contas a pagar

1. Baixar o extrato do Sicredi em Excel e OFX (com Open Finance, o MR importa direto).
2. Conferir se os pagamentos agendados ontem (Pix, boleto) foram efetivados.
3. Dar baixa no I-Control.
4. Extrair "Títulos a pagar gerencial" (relatório 1026): tipo de data Inclusão, de 01/01/2025 até ontem, situações Aberta e Quitada. O período antigo pega lançamento retroativo ou pago em dinheiro.
5. Colar na matriz do cliente. Colunas A a AB são o original; da C em diante há fórmulas.
6. A planilha marca o que ainda não subiu para o MR e gera o arquivo no template dele.
7. Subir no MR (validação, depois carga efetiva). O MR concilia com o extrato e traz o número do título para a linha do extrato.
8. Exportar "Todos os extratos" do MR e cruzar com o I-Control.

Contas a receber e maquininha

1. I-Control, "Títulos a receber por Nome - Baixado" (relatório 228), só o período novo.
2. Portal do Sicredi: relatório de vendas da maquininha.
3. Cruzar pelo código de autorização (número da via impressa). Célula azul = bateu.
4. Comparar o crédito no extrato com o valor bruto menos a taxa esperada. A diferença vai ao cliente, que negocia com a operadora.
5. Calcular a taxa efetiva paga, que entra no resultado real do cliente.

Entrega ao cliente

O Power BI lê as planilhas salvas. O Abel manda o link; o cliente marca o que pagar na semana (por exemplo, exclui um título que vai pagar em dinheiro) e devolve; só então o Abel agenda.

4. Regras de negócio e exceções

• Uma planilha por cliente, no mesmo padrão. O dado original nunca é alterado; o cálculo fica nas colunas à direita.
• Dois modos de atualização: regenerativa (matriz a pagar: apaga e cola, é só fórmula) e incremental (a receber e extratos: tem valor absoluto e histórico, só acrescenta).
• Padrão de colunas e dicionários igual entre clientes (tipo de cartão, bandeira, parcelas).
• Cada aba tem um dicionário de categorias. Categoria nova (exemplo: "feiras e eventos") quebra o dicionário e hoje vira #N/D. Requisito: o robô detectar e sinalizar no Flwe.
• O extrato bancário é a fonte da verdade: o saldo do MR tem de bater com o de cada banco.
• Débito quase não diverge. Crédito parcelado e antecipação divergem quando o lojista não cumpre a meta do contrato com a operadora. Divergências típicas: venda na maquininha sem pedido no ERP e cancelamento posterior.
• Nenhum agendamento antes da resposta do cliente.
• O export da tela traz no fim uma linha de totais (somas de valor, juros, multa, baixado, desconto): descartar ao escrever na planilha e usar como conferência. A chamada HTTP não traz essa linha.

5. Integração com o I-Control: o que foi testado

Testes de leitura em 11/11/2026, na Cama e Conforto (único acesso recebido), sem alterar nada no sistema.

Os cinco relatórios, por tela e por HTTP

Código	Relatório	Menu	Registros (tela = HTTP)	Colunas: export da tela / resposta HTTP / arquivo do Abel
1026	A pagar, gerencial	Financeiro > A Pagar > Pesquisas	151	19 / 28 / 28
228	A receber, baixados	Financeiro > A Receber > Pesquisas > Título A Receber	12	24 / 30 / 56
451	A receber, em aberto	mesmo menu do 228	18	15 / 37 / 37
464	Margem de venda realizada	Vendas > Vendas - Margem	44	23 / 29 / 29
505	Fechamento de caixa, recebimento analítico	Financeiro > Caixa > Pesquisas > Fechamento de Caixa	4	9 / 17 / 17

As colunas escondidas explicam o arquivo do Abel. A grade esconde colunas e o export da tela só leva as visíveis. Pela chamada HTTP vêm todas, e o número delas é igual ao do arquivo do Abel em quatro relatórios (28, 37, 29 e 17): ele habilita as colunas escondidas na grade antes de exportar. Boa parte do que parecia "coluna acrescentada por ele" já existe nos dados: loja e empresa (451), hora (464), caixa, data, hora, ordem e registros (505). [HIPÓTESE] nº Loja e nome loja do 228 vêm de idfilial e EMPRESA. Restam como derivadas dele, até onde vimos, tipo (228) e Categoria (505), além das colunas de fórmula à direita.

Volumes em janelas maiores (uma chamada por vez, com pausa):

Relatório	Janela	Registros	Tempo	Resposta
228	desde 01/01/2025	2.911	1,8 s	1,9 MB
1026	inclusão desde 01/01/2025	9.616	3,5 s	6,5 MB
451	vencimento 01/01/2026 a 31/12/2027	13.949	7,5 s	11,8 MB
464	desde 01/01/2026	2.166	1,3 s	1,6 MB
505	desde 01/01/2026	64	0,2 s	46 KB

Sem paginação, sem timeout e sem limite visível. A Casa do Produtor tem volume maior (cerca de 28 mil baixas no 228 em 10 meses); a conta linear dá algo como 18 MB por resposta: falta medir.

Navegação por script de tela

Funciona nos 5 relatórios. Armadilhas já resolvidas: o seletor de datas cobre o botão Pesquisar e exige digitação; o relatório 505 vem pré-selecionado e clicar de novo esconde o formulário; há elementos duplicados e ocultos com o mesmo id, então o robô deve usar sempre o visível.

Consumo por HTTP, sem navegador

Login por POST /icontrol/controllers/CLogin/login (txtEmpresa, txtUsuario, txtSenha), sessão por cookie e pesquisa por POST /icontrol/views/pesquisagrid, com os filtros como campos de formulário. A resposta é um trecho de JavaScript com columnsMeta e data em JSON. Mais de 70 requisições, uma por vez, com pausa de 1,5 a 3 s:

Teste	Resultado
Mesma pesquisa por HTTP e pela tela	Resultado idêntico nos 5 relatórios
Cabeçalhos (X-Requested-With, Origin, Referer, User-Agent)	Sem validação escondida; funciona com User-Agent que identifica o robô
Sem cookie de sessão	Devolve a página de login; o robô detecta pela ausência dos dados
Corpo da requisição	Os campos de controle da tela não são necessários; numerofilial e as listas de processo são obrigatórias; cada relatório tem seu conjunto de parâmetros, que o robô guarda por relatório
Cadência	10 pesquisas pequenas e várias grandes: sem 429, sem bloqueio, sem cabeçalho de limite
Duas sessões do mesmo usuário	Convivem; o robô não derruba o Abel
Expiração por inatividade	Sessões paradas 5, 15, 25 e 35 min continuaram válidas; uma sessão mantida viva por 35 min também. O limite não apareceu; o robô refaz o login ao ver a página de login
Login com usuário inexistente (2 tentativas)	Mensagem simples ("Usuário/Senha não confere"), sem captcha

Três níveis de integração (ordem de prioridade)

1. API oficial, sob solicitação do cliente final. Mais estável e documentada; pode ter custo e prazo.
2. API não oficial: a chamada que a tela faz, por HTTP, de forma balanceada. Funciona hoje, mas não tem documentação, pode mudar sem aviso, e o consumo balanceado reduz o impacto no servidor sem substituir a autorização do fornecedor e do cliente. Falha de forma explícita (erro HTTP ou ausência do JSON).
3. Navegação pela plataforma (script de tela): funciona nos 5 relatórios; é a mais frágil a mudanças de tela.

Perfil de consumo balanceado proposto para o nível 2: uma chamada por vez, pausa de 1,5 a 3 s, execução diária às 6h, janelas incrementais em vez do acumulado do ano, User-Agent que identifica o robô, repetição com espera crescente em erro, parada automática após erros em sequência e usuário dedicado, só leitura.

Conta de teste para o robô (proposta)

Pedir ao Abel e ao fornecedor uma conta de teste exclusiva do robô: de preferência uma empresa ou base de teste; na falta, um usuário só leitura numa empresa real. Motivos:

• Hoje usamos a conta pessoal do Abel (abel.grego) numa empresa que não é a do piloto.
• Permite desenvolver e repetir testes sem dados reais de clientes finais (nomes e CPFs), o que reduz o risco de LGPD.
• Permite testar com segurança o que ainda não testamos: senha errada repetida, limite de tentativas, captcha e limite de requisições por minuto.
• Em produção, o robô usa um usuário próprio, separado do Abel, com leitura apenas.

Observação para o fornecedor: quando faltam parâmetros, a resposta mostra a mensagem de erro do banco ao cliente. Não exploramos isso e não fizemos teste de injeção.

6. Planilhas recebidas: o que mostram

• Matriz a pagar (24_02_26 PRODUTOR a RECEBER e PAGAR iControl base geral): colunas A a AB são o relatório original do I-Control (as mesmas 28 do 1026); AC a AV são fórmulas; AW a BD são as colunas do template do MR. Abas de apoio: pagamentos, filiais (com o parâmetro "inclusão a partir de"), contatos (de-para I-Control x MR, 436 linhas), dicionário de categorias (14 mil linhas) e folha.
• Todos os Extratos MR até 29/10: A a O são o original do MR; de P em diante, fórmulas, com uma coluna por conta bancária e o cruzamento com o I-Control. Junta duas empresas (Casa do Produtor e Criador Agro & Pet).
• Máquina Sicredi 2026: só as 22 colunas originais do portal (31.539 vendas, 03/01/2025 a 03/11/2026). Veio sem as fórmulas que o Abel mostrou na reunião.
• Casa do Produtor Recebíveis 2026 (50 MB, 11 abas): matriz de a receber, com uma linha por pedido de venda, condições de pagamento e análise de taxas (MDR, antecipação, aluguel).
• Os relatórios chegaram com acentos corrompidos nos cabeçalhos do 451 e do 464 e colunas sem nome. O 505 enviado está tratado (links externos), não é o original.
• A matriz depende da posição das colunas: o robô precisa escrever as colunas do relatório na mesma ordem do arquivo do Abel.

7. Fontes de dados e riscos

Fonte	O que se tira	Caminho	Risco
I-Control	5 relatórios	API oficial, HTTP balanceado ou navegação (seção 5)	Baixo: testado, sem MFA nem captcha; depende de autorização e de conta de teste
Portal Sicredi	Extrato Excel/OFX; vendas da maquininha	Open Finance, RPA ou manual	Alto: portal bancário costuma ter MFA e captcha; sem acesso para testar
MR	Subir planilha; baixar "Todos os extratos"	Sem API pública conhecida: RPA de upload	Médio; sem acesso para testar
Planilhas do cliente	Escrever, recalcular, ler colunas de validação	API do Excel (Graph), ONLYOFFICE ou arquivo local	Alto: fórmulas entre arquivos; arquivo de 50 MB
Power BI	Lê as planilhas	Nada a fazer	Baixo, se o caminho do arquivo não mudar

Riscos específicos

• Fórmulas entre arquivos. A matriz de extratos busca dados em outro arquivo; com o outro fechado dá #N/D. É o maior risco técnico e precisa de teste com a planilha real.
• Planilha de 50 MB. Escrever por API ou recalcular fora do Excel será pesado.
• Caminho e nome dos arquivos. Os nomes têm data (24_02_26 ...). Se o Abel renomeia a cada versão, o robô precisa de caminho fixo.
• LGPD. Os relatórios e a aba de folha trazem nome e valores de pessoas. Definir onde o robô pode guardar e como tratar logs.
• Autorização. O acesso recebido é a conta pessoal do Abel numa empresa que não é a do piloto. O ideal é uma conta de teste e um usuário do robô só com leitura.

8. Escopo proposto

Tamanhos relativos, sem horas: as horas saem depois das respostas da seção 10 e do exercício com a planilha real.

Bloco	Tamanho	Depende de
A. Integração com o I-Control (3 cenários por prioridade): login e 5 relatórios, extração	P em cada cenário testável (HTTP e navegação funcionam nos 5 relatórios)	Empresa certa; autorização; conta de teste; API oficial para o cenário 1
B. Escrita na planilha do cliente (a pagar regenerativa, a receber incremental), na ordem de colunas da matriz	M (diminui: as colunas escondidas já vêm; sobe se o robô gerar tipo, Categoria e afins)	Decisão sobre colunas derivadas; teste de recálculo
C. Validação pós-cálculo e status de alerta ao Flwe	M	B; contrato com o Flwe
D. Gerar arquivo no template do MR e subir	M	Acesso ao MR
E. Baixar extrato e vendas do Sicredi	M a G	Decisão: Open Finance, RPA ou manual
F. Integração com o Flwe: ser chamado por ele e devolver o status	P a M	Contrato com o Flwe [LACUNA]
G. Aprovação do cliente por formulário (fase 2)	M	Definição do Francisco
H. Migração para a API oficial do I-Control	M	Resposta e custo do fornecedor

Fase 1: A, B, C, D, F (E conforme decisão). Fase 2: G. Depois: H.

Exercício técnico que falta: escrever numa cópia da planilha do Abel e devolver para ele conferir, gerar um arquivo de teste e ver se o MR importa, comparar o dia anterior até dar zero a zero. (Baixar os relatórios do I-Control já está feito.)

9. Ferramentas

• Em uso: script de navegador (Playwright) e cliente HTTP (Python) para o I-Control; openpyxl para mapear as planilhas.
• A testar: LibreOffice headless e ONLYOFFICE (recálculo e referências entre arquivos); Microsoft Graph, se as planilhas estiverem no OneDrive/SharePoint.
• Opcional: Firecrawl (extração web com IA, proposta do Bruno). Antes de adotar: download de arquivo, MFA e captcha no Sicredi, e credenciais e dados pessoais passando pela nuvem de um terceiro. Ainda não testado.
• Lado do Flwe: LangGraph ou similar para orquestração, fora do nosso orçamento.

10. O que ainda está pendente

Com o Abel

1. Qual será o piloto, Casa do Produtor ou Cama e Conforto? Há acesso à Casa do Produtor? O cliente da Cama e Conforto sabe e autoriza o uso por robô?
2. Conta de teste do robô: existe empresa ou base de teste no I-Control, ou dá para criar um usuário de teste só leitura? E um usuário dedicado só leitura em cada empresa de produção?
3. Acesso ao MR (e nome correto do sistema, hoje "Vico"/MR).
4. Sicredi: há Open Finance também para as vendas da maquininha? Quem baixa hoje o relatório de vendas e como?
5. A Máquina Sicredi 2026 completa (com as fórmulas) e a planilha da Rede (trecho "até a coluna XX" da reunião).
6. De onde vêm tipo (228) e Categoria (505), que não existem nos dados do I-Control, e as colunas sem nome? Por que os cabeçalhos mudam de nome?
7. Para que servem o 464 (margem de venda) e o 505 (fechamento de caixa) e onde entram no fluxo? Onde está o 505 original?
8. Baixa o acumulado do ano todo dia ou só o incremento? Usa a Conciliação de Cartão/Pix/Link e a Taxa de Operadora do próprio I-Control?
9. "Uma planilha por cliente" vale por CNPJ, por grupo ou por cliente do BPO? (os extratos juntam duas empresas)
10. Onde ficam as planilhas (OneDrive/SharePoint ou disco)? Os arquivos são renomeados a cada versão? A de a receber pode ser dividida por ano?
11. O parâmetro "inclusão a partir de" (aba filiais) é atualizado à mão a cada carga?
12. Como funciona o cruzamento "manual" das colunas de extratos e de taxas (P em diante): o que dá para automatizar?
13. A conferência dos pagamentos agendados fica fora da automação? Quantos clientes além dos dois usam o I-Control?
14. Quem é o controlador dos dados pessoais dos relatórios e onde o robô pode guardá-los?

Com o Francisco

1. Contrato Flwe e robô: como o Flwe chama o robô (API, fila, MCP) e com qual autenticação; o robô responde na hora ou devolve depois (callback); quais status existem e que detalhe vai junto.
2. Formato do alerta de categoria nova e de #N/D ("ponto vermelho"): o que o Abel vê e onde.
3. Autorização para o consumo balanceado da chamada interna do I-Control (nível 2) enquanto a API oficial não chega, e quem pede ao fornecedor a API oficial e a conta de teste.
4. Um robô por empresa do I-Control, ou um robô que troca de empresa no mesmo login?
5. Formulário de aprovação do cliente (fase 2): entra no orçamento atual ou fica separado? Custo de assinatura do Flwe para o Abel e como entra na proposta.

Decisões nossas

1. Colunas derivadas: o robô escreve só as colunas do relatório (todas, na ordem da matriz) e a planilha do Abel continua derivando o resto, ou o robô também gera tipo, Categoria e afins? Define o tamanho do bloco B.
2. Sicredi na fase 1: Open Finance, RPA ou manual?
3. Escrever nas planilhas por API do Excel, ONLYOFFICE ou arquivo local? Depende da resposta 10 do Abel e do teste de fórmulas entre arquivos.
4. Apresentar a estimativa em horas por bloco ou por fase, em três cenários de integração.

Testes que ainda faltam

• Volume real da Casa do Produtor (o 228 dela tem cerca de 28 mil linhas; estimativa linear de uns 18 MB por resposta).
• Senha errada repetida no usuário real, limite de tentativas, captcha após muitas falhas e limite de requisições por minuto: não testados para não bloquear a conta do Abel; ficam para a conta de teste.
• Estabilidade em outros dias e após mudanças de tela do fornecedor.
• Recálculo de planilhas com referência entre arquivos; escrita numa cópia da planilha.

O que ainda é hipótese

• nº Loja e nome loja do 228 vêm de idfilial e EMPRESA.
• A API oficial expõe os mesmos dados da tela e não tem custo proibitivo.
• Os números de "processo" dos filtros são constantes da instalação do I-Control (vimos os mesmos valores nas duas empresas) e servem de chave para extração incremental: não confirmado.
• O MR aceita upload automatizado sem captcha ou outra barreira.

11. Próximos passos

Quem	O quê	Quando
Francisco	Levar as perguntas ao Abel; definir o contrato Flwe e robô; autorização para o consumo balanceado	em andamento
Abel	Empresa piloto e acesso à Casa do Produtor, acesso ao MR, Máquina Sicredi completa, pedido da API oficial ao fornecedor	sem data
Abel e Francisco	Conta de teste exclusiva do robô e usuário só leitura em produção	a combinar
Bruno	Exercício na cópia da planilha; teste de recálculo	em paralelo
Bruno	Estimativa de horas e orçamento, por cenário de integração	após as respostas
Francisco	Devolver a estimativa ao Abel	cerca de 2 dias úteis após as respostas

---

Fontes: reunião de 06/11 (transcrição, notas do Gemini), arquivos e acessos enviados em 10/11, testes de 11/11.