CFO dados de empresasFatos e fontes
- CFO: format=csv seleciona a saída em CSV; o formato documentado usa UTF-8 com BOM e separador ponto e vírgula. CFO — formato e limites do CSV.
- CFO: se o tempo de leitura se esgotar, a exportação pode terminar com aviso de arquivo parcial, informando as linhas entregues. CFO — formato e limites do CSV.
- CFO: a saída respeita o teto da conta; exportar não elimina as condições de revelação de contatos. CFO — documentação da API.
- O identificador do estabelecimento é composto por partes no leiaute da Receita e deve ser preservado integralmente na planilha. Receita Federal — leiaute dos dados abertos do CNPJ.
Como importar sem alterar o CNPJ?
- Guardar uma cópia do CSV original junto dos filtros e da data da extração.
- Usar o recurso de importação de texto/CSV da planilha e selecionar UTF-8 e ponto e vírgula.
- Definir CNPJ e raiz como colunas de texto antes de concluir a importação.
- Conferir acentos, zeros iniciais, letras e quantidade de linhas.
- Separar eventuais mensagens de aviso dos registros de empresas.
Por que abrir o arquivo com duplo clique pode causar erro?
A planilha pode aplicar conversão automática conforme sua configuração. Identificadores numéricos podem perder zeros, enquanto outros campos podem virar datas ou números. A importação com tipo explícito oferece controle sobre essas decisões.
| Campo ou item | Resultado esperado |
|---|---|
| CNPJ | Texto completo, sem perda de posições |
| Raiz | Texto de oito posições |
| Município e razão social | Acentos preservados |
| Contatos | Máscara mantida onde o acesso não revelou o valor |
| Total de linhas | Coerente com a página exportada |
| Rodapé de aviso | Identificado e tratado antes da consolidação |
O que fazer com uma exportação parcial?
O aviso deve impedir que a página seja tratada como completa. A documentação orienta repetir a página ou reduzir per_page. Ao consolidar tentativas, é necessário deduplicar por CNPJ e conferir a cobertura; anexar o arquivo repetido sem controle pode duplicar registros.
Uma página exportada contém toda a pesquisa?
A saída corresponde ao recorte e à paginação solicitados, dentro dos limites aplicáveis. Para obter outras páginas, a integração precisa percorrê-las e registrar o progresso. A contagem final deve separar linhas recebidas, linhas duplicadas e registros únicos.
As condições de acesso e os parâmetros devem ser conferidos na documentação de CSV. A integração também pode consultar os limites da conta pelo recurso de metadados. O guia de integração com CRM detalha a etapa de mapeamento após a importação.
Aplicar esta consulta no CFO
Confira o formato, a paginação e os limites da conta antes de exportar. O CSV preserva o mascaramento dos contatos que não foram revelados.
Fontes e orientações conferidas em . Exemplos identificados como hipotéticos ou ilustrativos não representam consultas a empresas reais.