Papo Extrator CNPJ
E-mail e senha de ADMIN_EMAIL / ADMIN_PASSWORD (em produção, os do stack — não o login local).
Gere um token e use no Extrator: Authorization: Bearer papo_…
Em produção isso fica em https://extrator.papo.global.
| Nome | Prefixo | Criado | Último uso |
|---|
Inventário do dump da Receita neste Postgres — o que já entrou, não o que cada conta Papo já puxou.
Local (este PC) e produção (extrator.papo.global).
O que a base da Receita tem com contato publicado — o Extrator consulta daqui. Não é o que a conta do Papo já puxou (isso fica no Extrator da conta).
Porte da Receita (ME / EPP / Demais) e sócios distintos no dump.
Distribuição do cadastro de empresas (código da Receita).
| Código | Porte | Empresas |
|---|
Porte Receita “Demais” (05) e capital social alto — o grosso do cadastro grande.
MEI/Simples, matriz com contato, aberturas, capital e o que já foi extraído no Papo.
Atividades mais comuns entre estabelecimentos ativos.
| CNAE | Descrição | Ativas |
|---|
Onde há mais estabelecimentos ativos no dump.
| UF | Município | Ativas |
|---|
Faixas do cadastro de empresas (Receita).
| Faixa | Empresas |
|---|
Estabelecimentos ativos, com o contato que a Receita publicou.
| UF | Ativas | Com e-mail | Com telefone |
|---|
CNPJ, e-mail, telefone ou nome. A tabela mostra a ficha extraível completa
(os mesmos campos do GET /v1/empresas). Extraído = vezes no Extrator Papo (todas as contas).
Os filtros abaixo seguem a aba API.
| CNPJ | Extraído | Contas | Extraído em | Razão social | Nome fantasia | Sócio | Telefone | UF | Município | Bairro | Cód. mun. | CNAE | CNAE descrição | Porte | Natureza | Capital | Abertura | Regime | MEI | Simples | Situação | |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Digite um CNPJ ou contato para ver a ficha extraível completa. | ||||||||||||||||||||||
Destino: extrator.papo.global — baixa neste PC, manda os ZIPs por rsync e aciona o pipeline offline no servidor.
Carregando…
Enquanto “enviando…” o botão 1 fica bloqueado de propósito — o download já está rodando
e continua do .part. Não precisa clicar de novo.
A Receita bloqueia o IP do Hetzner. Use os botões acima no localhost. No site de produção, Continuar só processa ZIPs já no disco.
temp-prod/ neste PC.--offline (descompacta + INSERT).—
| Status | Arquivo | Tamanho | Neste PC | No servidor |
|---|
ZIPs no disco do servidor (após rsync). O pipeline offline lê daqui; depois de importar pode limpar.
Use só localhost:8090 para enviar. Em extrator.papo.global
esta aba mostra os lotes recebidos neste banco.
Túnel no PC: just papo-prod-tunnel.
Empresa/estabelecimento já online não duplica (chave primária + ignora repetido).
—
—
| Tabela | Neste PC | Online | Já enviados | |
|---|---|---|---|---|
| Carregando… | ||||
O destino grava cada lote que chega neste banco.
| Quando | Tabela | Linhas |
|---|---|---|
| Aguardando lotes… | ||
Cada GET /v1/empresas (lista ou CNPJ) fica registrado: quem chamou, filtros, status e quantas linhas saíram.
| Quem | Tipo | Consultas | Linhas de saída |
|---|---|---|---|
| Carregando… | |||
—
| Quando | Quem | Rota | Filtros | Status | Saída | Total | ms |
|---|---|---|---|---|---|---|---|
| Carregando… | |||||||
Estabelecimentos do mundo inteiro (Overture Maps), um país por vez. Fica separada da Receita:
o Extrator usa GET /v1/lugares para países fora do Brasil, com o mesmo token.
Código ISO de 2 letras, separados por vírgula (ex.: PT, ES, US). O worker
pipeline-global lê direto do Overture; Portugal leva cerca de 3 minutos.
Quando sai uma versão nova do Overture, os países carregados são atualizados sozinhos.
| País | Estabelecimentos | Telefone | Celular | Versão Overture | Carregado em | ||
|---|---|---|---|---|---|---|---|
| Carregando… | |||||||
| # | País | Ação | Status | Linhas | Mensagem | Pedido em | Terminou |
|---|---|---|---|---|---|---|---|
| Carregando… | |||||||
Mesma busca que o Extrator faz. Categoria e cidade sugerem enquanto você digita.
| Nome | Categoria | Telefone | Tipo | Site | Endereço | Cidade | |
|---|---|---|---|---|---|---|---|
| Escolha um país e pesquise. | |||||||
A API é só leitura. Você gera um token em Tokens e o Extrator
(ou qualquer cliente) chama GET com Bearer.
Em produção a base é https://extrator.papo.global.
Filtros padrão (ativas, e-mail, telefone, MEI) e se o cliente pode soltá-los
ficam em API.
Todo endpoint de dados exige o token gerado nesta tela:
Authorization: Bearer papo_...
Em Sincronização da Receita use Pausar / Continuar. O sync para no ZIP atual e, no próximo start, pula os arquivos já marcados como ok.
O dump baixa ZIP/CSV em temp. Depois de entrar no banco, esses
arquivos não servem mais. Em Sincronização da Receita, use
Limpar arquivos (ou Apagar numa linha). O banco permanece.
Pause o dump antes — se apagar no meio, o próximo Continuar baixa de novo
o que faltar (inclusive .part).
Na aba API você escolhe o que sai em GET /v1/empresas:
somente ativas, e-mail, telefone, MEI. Padrão = se o cliente omitir o param,
vale a tela; se mandar ativa=0, a query ganha.
Travar = o que estiver marcado não desliga.
Dá para aplicar só nos tokens (Extrator), só nesta tela, ou nos dois.
A ficha GET /v1/empresas/:cnpj só usa o filtro de ativas.
GET /v1/empresas?uf=SC&tem_email=1&limit=50
Query params:
| Param | Exemplo | O que faz |
|---|---|---|
uf | SC | Estado |
cnae | 6201501 | CNAE principal |
municipio | Joinville | Nome ou código |
q | CNPJ, e-mail, telefone ou padaria | Busca manual |
ativa | 1 (padrão da aba API) | Só situação 02 (Ativa). No modo Padrão, 0 inclui nula/suspensa/inapta/baixada. No modo Travar, a tela manda. |
abertas_dias | 30 | Abertas nos últimos N dias |
tem_email | 1 | Só com e-mail. Se estiver marcado e travado na aba API, não desliga. |
tem_telefone | 1 | Só com telefone |
mei | 1 | Só MEI |
limit | 50 | Máx. 100 |
offset | 0 | Paginação |
aleatorio | 1 | Começa num CNPJ aleatório (evita sempre as mesmas primeiras empresas). Ignora offset. |
curl -s 'https://extrator.papo.global/v1/empresas?uf=SC&limit=20' \ -H 'Authorization: Bearer papo_SEU_TOKEN'
GET /v1/empresas/12345678000199
{
"data": [
{
"cnpj": "12345678000199",
"razao_social": "...",
"nome_fantasia": "...",
"uf": "SC",
"municipio": "8105",
"municipio_nome": "JOINVILLE",
"bairro": "CENTRO",
"cep": "89200000",
"endereco": "RUA XV DE NOVEMBRO, 100, CENTRO, JOINVILLE/SC, 89200000",
"cnae": "6201501",
"cnae_descricao": "...",
"cnaes_secundarios": [{ "codigo": "6202300", "descricao": "..." }],
"porte": "03",
"porte_descricao": "EPP",
"natureza_juridica": "2062",
"natureza_juridica_descricao": "Sociedade Empresária Limitada",
"capital_social": 10000,
"data_abertura": "2026-09-01",
"telefone": "4733334444",
"telefones": [{ "completo": "4733334444", "ddd": "47", "numero": "33334444", "tipo": "fixo" }],
"email": "contato@empresa.com",
"emails": [{ "email": "contato@empresa.com", "valido": true }],
"mei": "N",
"simples": "S",
"regime": "SIMPLES",
"situacao_cadastral": "02",
"matriz": true,
"socio": "MARIA SILVA",
"socios_count": 1,
"socios": [{ "nome": "MARIA SILVA", "tipo": "2", "qualificacao": "49" }],
"website": null,
"extraido_vezes": 0,
"extraido_contas": 0,
"extraido_em": null
}
],
"meta": { "total": 120, "limit": 50, "offset": 0, "kind": "text", "ativa": true, "tem_email": false, "tem_telefone": false, "mei": false, "modo": "padrao" }
}
Login desta tela é só para gerar token. O Extrator não usa e-mail/senha — só o Bearer papo_….