This work already existed uncommitted in the main working tree (not authored by this branch) and is required as a runtime dependency for the campaign outreach port (zpro-client, templates, outreach routes/UI). Copied in as-is, untouched, so this feature branch has a working baseline; the original uncommitted state in the main checkout is left exactly as it was.
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:
cnpjrazao_socialourazao socialnome_fantasiaounome fantasiatelefone,telefone 1,ddd,ddd 1municipiooucidadeufcnae,cnae_fiscaloucnae principallogradouro,numero,bairro
Comando para extrair a base de uma UF a partir dos zips brutos da Receita
(gera o CSV estabelecimentos-<UF>.csv usado pela captura):
npm run extract -- --uf=BA
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.