Self-service total

Perguntas frequentes

Respostas diretas — sem promessa de suporte manual, sem SLA, sem white-label. Se algo aqui não responder, considere fonte alternativa antes de assinar.

Produto e features

A plataforma entrega email do decisor (sócio/diretor)?
Não. A Receita Federal publica o email da empresa (uma caixa institucional, geralmente contato@ ou similar) — não o email pessoal do sócio/diretor. Quem precisa de email validado de decisor por nome geralmente complementa com enrichment de fornecedores como Apollo, Lusha, ZoomInfo etc. Não fazemos enrichment. Servimos dados públicos da RF do jeito que ela publica — nada inflado, nada inventado.
Por que minha busca pediu para refinar?
Buscas muito amplas (sem município, CNAE, contato público ou data de abertura) podem demorar segundos a minutos porque cobrem uma fatia muito grande das 67 milhões de empresas da Receita Federal. Pra proteger a estabilidade da plataforma — e pra entregar resultado útil pra você — pedimos refinamento antes de devolver erro técnico.

Como refinar (qualquer uma destas funciona):
  • Adicione UF + município (ex: SP + 7107 = capital paulista)
  • Especifique CNAE fiscal (ex: 5611201 = restaurantes)
  • Marque com email ou com telefone público
  • Filtre por data de abertura (últimos N dias)

Sem SLA, sem tempo fixo prometido — best-effort. A plataforma é otimizada pro caso típico (cliente com nicho claro), não pra varredura aberta de tudo. Se você precisa baixar a base inteira pra processar offline, considere assinar Enterprise (5M leads/mês) e fatiar com filtros progressivos.

O que são decisores prováveis?
São sugestões baseadas em dados públicos e qualificação societária da Receita Federal. No detalhe de cada CNPJ você vê uma classificação de quem provavelmente toma decisão na empresa (administradores, diretores, fundadores, sócios), ranqueada pela qualificação RF de cada sócio.

Servem pra priorizar contatos antes de prospectar — útil pra evitar mandar email pro estagiário em vez de pro administrador. Não são decisores confirmados: a plataforma não valida humanamente nem cruza com Apollo/LinkedIn.

Não inclui: email, telefone ou LinkedIn validado do decisor. A Receita Federal não publica esses campos por sócio — quem precisa de contato direto cruza com fornecedor de enrichment próprio. A gente entrega só o que a RF tem: nome, CPF mascarado, qualificação, data de entrada na sociedade.
O Lead Score é IA ou modelo fechado?
Não, é determinístico. Cada empresa recebe Score Comercial e Score de Risco calculados em SQL puro sobre os dados da Receita Federal — porte, capital, idade, situação cadastral, CNAE, volume de sócios, etc. Sem rede neural, sem LLM, sem caixa-preta. A fórmula é estável (mudanças versionadas em score_version) e o motivo de cada nota fica salvo em breakdown — você sempre pode pedir "por que essa empresa pontuou 78?" e a resposta é uma lista de regras, não um vetor opaco.
O Starter tem score no CSV exportado?
Não. Starter (R$ 39/mês) inclui Lead Score na busca e ordenação por Score Comercial / Score de Risco, mas o CSV exportado vem sem as colunas de score. Score em colunas do CSV é a partir do Pro (R$ 149/mês) — onde o CSV passa a ter score_commercial, score_risk, segment, persona.
O Pro tem API pública?
Sim. Pro inclui até 2 chaves de API (rotacionáveis), 60 requisições por minuto, e até 50 resultados por chamada em busca paginada. Documentação técnica: /docs — exemplos cURL, Node.js e Python prontos pra colar.
Posso salvar buscas para reutilizar depois?
Sim. Em /buscar, aplique os filtros que você usa com frequência e clique em Salvar busca. Depois, gerencie tudo em /dashboard/buscas-salvas: aplicar de novo, renomear, apagar. Limite por plano: Free 1, Starter 5, Pro 20, Enterprise 100.
Saved searches enviam email automático quando aparecem leads novos?
Não. Esta versão de buscas salvas é apenas atalho de filtros — você clica em Aplicar quando quiser e a página /buscar recarrega com os filtros salvos. Sem alerta por email, sem notificação automática, sem cron, sem scheduler. Você decide quando rodar a busca.
Posso subir uma planilha com CNPJs pra enriquecer minha lista?
Sim, a partir do Starter. Em /dashboard/enriquecer você sobe um CSV ou XLSX com uma coluna chamada cnpj e baixa o mesmo arquivo enriquecido com razão social, situação cadastral, CNAE, UF, município e capital social. Pro+ inclui também as colunas de Lead Score (commercial, risk, segment, persona). Detalhes técnicos: /docs#bulk-upload.
Quais formatos de planilha são aceitos no bulk upload?
CSV e XLSX. Saída no mesmo formato do input (CSV → CSV, XLSX → XLSX). Arquivos até 10 MB. Planilhas com macro (.xlsm) não são aceitas por segurança — salve como .xlsx normal antes de subir.
O Free pode usar bulk upload?
Não. Bulk upload é unlock do Starter pra cima (R$ 39/mês). O Free continua com busca + 100 leads/mês exportados via UI. A rota /v1/enrich retorna 402 plan_required pra usuário Free, com link pra /precos.
O bulk upload usa API key (x-api-key)?
Não nesta versão. Upload de planilha é feito pelo dashboard, com usuário logado (cookie de sessão). A rota /v1/enrich rejeita header x-api-key e também Authorization: Bearer — ambos retornam 401. Motivo: upload de arquivo tem risco maior de abuso e ficamos no fluxo dashboard até estabilizar. Pra automação recorrente em batch, abra /dashboard/enriquecer manualmente.
O que significam enriched, not_found e invalid_cnpj no output?
Toda linha do output tem uma coluna status_lookup:
  • enriched — encontrado na base RF; colunas preenchidas.
  • not_found — CNPJ válido (DV módulo-11 OK) mas não consta na nossa cópia da base RF. Pode ter sido baixado antes da release vigente.
  • invalid_cnpj — não passou no check de 14 dígitos ou DV. A coluna error_reason mostra o que veio no campo.

Linhas inválidas não derrubam o job — você recebe o arquivo completo e revisa o que falhou.

O arquivo enriquecido fica salvo pra sempre?
Não. O arquivo enriquecido (download) expira em 7 dias e é removido automaticamente do servidor. O arquivo de upload original é descartado logo após o processamento — não persistimos o que você sobe. Se precisar guardar, baixe local antes do prazo. As linhas que você processou continuam contando pra cota mensal mesmo depois do arquivo expirar (anti-abuse).
A cota mensal de bulk upload é separada da cota de export?
Não — é compartilhada. O backend soma export_jobs.rows_written + enrich_jobs.ok_rows (apenas jobs concluídos) e compara com o cap do plano. Se você é Pro (5.000 linhas/mês de enrich) e usou 4.000 em exports, sobram 1.000 pra enriquecimento.

O painel de /dashboard/enriquecer mostra o breakdown — quanto você usou de cada feature no mês.

Detalhes técnicos: apenas linhas com status_lookup=enriched contam (linhas not_found e invalid_cnpj NÃO bilham). Jobs failed/cancelled também não contam. Tombstones (jobs apagados) continuam contando — anti-abuse.

Posso exportar em Excel (.xlsx) ou só CSV?
Sim, ambos. Na tela de busca você escolhe o formato antes de exportar:
  • CSV — universal, melhor para integrações com CRM, ferramentas de automação e arquivos grandes. Encoding UTF-8 com BOM e separador ;(Excel BR abre direto sem importar).
  • Excel (.xlsx) — abre direto no Excel/Google Sheets já formatado: header congelado, CNPJ como texto (sem virar notação científica), capital social como número, data de abertura como data. CEP/CNAE/telefone preservam zeros à esquerda.

O limite de linhas por export é o mesmo independente do formato — depende do plano (Free 100 · Starter 5.000 · Pro 50.000 · Enterprise 1.000.000). Cota mensal também conta igual: linhas exportadas em XLSX descontam da mesma cota que CSV.

Pagamento e cobrança

Posso pagar com Pix, cartão ou boleto?
Sim, todos os três. O checkout é processado pela Cakto (vendedor visível: Cakto Pay LTDA, CNPJ 52.328.926/0001-04). Você escolhe o método na página de pagamento deles — Pix gera QR + copia-e-cola, boleto sai em PDF, cartão recorrente cobra mensalmente até você cancelar. Aceita débito automático Visa/Master também.
O checkout é da Cakto. Vocês coletam meu cartão?
Não. A CNPJ.Platform não coleta nem armazena dados de cartão. Quando você clica em "Assinar Pro" no /precos, redirecionamos pra pay.cakto.com.br — ambiente PCI-compliant deles. Recebemos só um webhook avisando que o pagamento foi aprovado, sem ver número de cartão, CVV ou validade.
Posso cancelar a qualquer momento?
Sim. Cancelamento é feito direto no painel da Cakto (você recebeu link no email da compra). Cancelando hoje, seu acesso continua ativo até o fim do ciclo já pago — depois desce automaticamente pra Free, sem perder os exports anteriores.

Dados e atualização

De onde vêm os dados das empresas?
Tudo vem da base pública da Receita Federal gov.br/receitafederal/dados. CC0 (domínio público). Nós só reorganizamos em estrutura consultável com índices (FTS, trigram, partial). Sem enrichment externo, sem scraping, sem dados de terceiros.
Com que frequência os dados são atualizados?
Atualização conforme bases públicas da Receita Federal. A RF publica uma release nova até o dia 14 de cada mês. Quando carregamos uma release nova, sua busca passa a refletir o novo estado da base — incluindo empresas recém-abertas com data_inicio_atividade recente.

Não é monitoramento em tempo real, e não prometemos atualização diária: você consulta a base que está carregada no momento. Sem cron diário, sem captura automática diária, sem alerta automático. A última release servida é exibida no rodapé da home e em /api (campo servingRun.release).
Vocês mostram empresas recém-abertas?
Sim — as que já estão na base da Receita Federal carregada. A busca aceita filtro por data de abertura (data_inicio_atividade), e usuários Pro+ têm também o atalho /v1/public/aberturas?dias=N que lista as últimas empresas abertas até 90 dias (Pro) ou 365 dias (Enterprise), ordenadas mais recente primeiro.

Importante: a plataforma encontra empresas recém-abertas que já constam na base RF carregada. Não é monitoramento em tempo real, não é cron diário garantido, não é captura automática diária. Quando a RF publica uma release nova e nós carregamos, novos CNPJs entram na busca — sem promessa de prazo entre a publicação RF e a carga aqui.
A plataforma mostra faturamento da empresa?
Não. Removemos qualquer estimativa de faturamento em 2026-05-09. O único campo fiscal exposto é o capital social cru da Receita Federal — número que a empresa declarou ao registrar o CNPJ.

Não estimamos receita por heurística, não calculamos faixa, não inventamos múltiplo de capital. Para receita real auditada/declarada, consulte balanço publicado em junta comercial, demonstrações na CVM (S.A. de capital aberto) ou peça à empresa diretamente.

Planos e API

Posso usar a API só com o Free?
Não. API pública (/v1/public/*) exige plano Pro ou superior. Free serve pra você testar a busca + 100 leads/mês exportados via UI. Quando precisar bater na API por código, upgrade pra Pro. Detalhes: /docs.

Suporte (e o que NÃO oferecemos)

Tem suporte manual / atendimento humano?
Não. A plataforma é 100% self-service. Esta FAQ + /docs cobrem 95% das dúvidas. Pra bug reproduzível ou erro técnico real, existe um único canal: contato@cnpjplatform.com.br. Sem prazo de resposta, sem fila, sem ticket. Eu leio quando consigo. Se você precisa de SLA contratual ou gerente de conta, esta plataforma não é pra você.
Tem SLA de uptime / contrato de disponibilidade?
Não temos SLA. Operamos em modelo best-effort com disponibilidade observada típica perto de 99%, mas sem garantia contratual. Se o seu pipeline crítico depende de 99.9% uptime com penalidade financeira, esta plataforma não atende — considere uma fonte com SLA formal.
Tem white-label / brand customizado / instância dedicada?
Não. A plataforma é uma única instância compartilhada sob a marca CNPJ.Platform. Não revendemos com seu logo, não rodamos cópia dedicada do banco de 67M empresas pra cliente exclusivo, e não fazemos integração privada via SDK rebadged. Pra esse caso, uma fonte com licença redistributiva (ex: baixar a base RF direto e hospedar internamente) costuma fazer mais sentido.
Tem CRM, WhatsApp ou cadência outbound integrada?
Não. A plataforma exporta CSV/Excel (.xlsx) no formato que HubSpot/Pipedrive/RD/Google Sheets aceitam direto. Quem aplica a cadência é seu CRM — não a gente. Não enviamos email pra leads em seu nome, não disparamos WhatsApp, não agendamos ligação. A plataforma é fonte de dados — distribuição é por sua conta.
Perguntas frequentes · CNPJ.Platform