COMERCIAL-GTI

Files

T

Gustavo d330bb5ff0 Baseline commit of the existing Maquina Comercial Pessoal project

Tracks the app that was already in place (capture, treatment, outreach,
WhatsApp integration, server, frontend, tests, docs) so future feature
work can branch and use isolated worktrees.

2026-07-31 10:54:07 -03:00

README.md

Baseline commit of the existing Maquina Comercial Pessoal project

2026-07-31 10:54:07 -03:00

README.md

Coloque aqui arquivos CSV extraidos da base publica de CNPJ da Receita Federal ou uma planilha ja tratada.

O captador aceita CSV com cabecalho e tenta reconhecer colunas comuns como:

cnpj
razao_social ou razao social
nome_fantasia ou nome fantasia
telefone, telefone 1, ddd, ddd 1
municipio ou cidade
uf
cnae, cnae_fiscal ou cnae principal
logradouro, numero, bairro

Comando para baixar/retomar somente os 21 ZIPs necessários da Receita Federal (cerca de 6 GB):

npm run download-rfb

Snapshots novos exigem 8 GiB livres antes de tocar a base existente. Na retomada do mesmo snapshot, arquivos finais confirmados e parciais retomáveis são descontados, mantendo ao menos 2 GiB para extração. A base completa anterior permanece em .rfb-backup até a substituta ser validada; estados incompletos preservados usam .rfb-incomplete*.

Comando para baixar o que estiver faltando e extrair uma UF (gera o CSV estabelecimentos-<UF>.csv usado pela captura):

npm run extract -- --uf=BA

Use --no-download apenas para exigir a base local completa sem consultar ou baixar o snapshot atual.

Comando para capturar leads usando a base já extraída:

npm run capture -- --sources=cnpj-base --uf=BA --cities="Ilheus"

Com enriquecimento pela BrasilAPI, inclua a fonte brasilapi:

npm run capture -- --sources=cnpj-base,brasilapi --uf=BA --cities="Ilheus"

O modo brasilapi usa os CNPJs encontrados nos CSVs locais para consultar dados atualizados por CNPJ.