Descrição
O dataset de Dados Cadastrais Básicos contém o conjunto mais simples de informações dentre todos os datasets, com informações cadastrais recuperadas de fontes oficiais. Exemplos de informações retornadas nesse escopo são o CNPJ, a razão social, o nome de fantasia e a data de fundação da empresa. Para consultas realizadas através de chaves de entrada que não são o CNPJ (consulta por nome, ou por telefone, ou qualquer outra chave), podem ser retornados múltiplos objetos de Dados Cadastrais Básicos, um para cada "candidato" encontrado na pesquisa.
Origem da Informação
Esse dataset reúne principalmente informações que tem como origem a Receita Federal do Brasil (e órgãos equivalentes no exterior), sejam coletados diretamente do site da Receita Federal ou através de sites de transparência e divulgação de informações.
Tabela de preços para esse dataset
| Consultas Realizadas no Mês | Valor por consulta |
|---|---|
| 1 - 10000 | R$ 0,020 |
| 10001 - 50000 | R$ 0,019 |
| 50001 - 100000 | R$ 0,018 |
| 100001 - 500000 | R$ 0,017 |
| 500001 - 1000000 | R$ 0,016 |
| 1000001 - 5000000 | R$ 14,000.00 (preço fixo) |
| 5000001 e acima | Entre em contato |
Parâmetros de consulta
A tabela abaixo detalha os campos aceitos na consulta a este dataset.
| Campo | Descrição | Valores Possíveis | Tipo de Campo |
|---|---|---|---|
| doc | Documento de identificação | CNPJ | 🛑 Obrigatório |
| name | Este dataset suporta um parâmetro opcional, chamado name, que possibilita a comparação de um nome informado na entrada com a razão social e nome fantasia encontrados na base, e o retorno do percentual de similaridade entre os mesmos. | Nome da empresa | ℹ️ Opcional |
Clique aqui para saber mais sobre os parâmetros de consulta da Plataforma de Dados.
Abaixo está um exemplo de como realizar a chamada apenas com os parâmetros obrigatórios:
{
"Datasets": "basic_data",
"q": "doc{CNPJ}"
}
Alguns dos campos contidos nesse dataset tem valores predefinidos, conforme a tabela abaixo:
| Campo | Valores Possíveis |
|---|---|
| LegalNature.Code | 0, 1015, 1023, 1031, 1040, 1058, 1066, 1074, 1082, 1090, 1104, 1112, 1120, 1139, 1147, 1155, 1163, 1171, 1180, 1198, 1201, 1210, 1228, 1236, 1244, 1252, 1260, 1279, 2011, 2038, 2046, 2054, 2062, 2070, 2089, 2097, 2100, 2127, 2135, 2143, 2151, 2160, 2178, 2216, 2224, 2232, 2240, 2259, 2267, 2275, 2283, 2291, 2305, 2313, 2321, 3034, 3069, 3077, 3085, 3093, 3107, 3115, 3123, 3131, 3204, 3212, 3220, 3239, 3247, 3255, 3263, 3271, 3280, 3298, 3301, 3999, 4014, 4081, 4090, 4120, 5010, 5029, 5037, 8885 |
| TaxIdStatus | ATIVA, ATIVA - EMPRESA DOMICILIADA NO EXTERIOR, BAIXADA, CNPJ DOES NOT EXIST IN RECEITA FEDERAL DATABASE, INAPTA, NULA, NULA - EMPRESA DOMICILIADA NO EXTERIOR, SUSPENSA, SUSPENSA - EMPRESA DOMICILIADA NO EXTERIOR |
| TaxRegime | EIRELI, EPP, ISENTO, LTDA, LUCRO PRESUMIDO, LUCRO REAL, ME, MEI, NAO ATIVA, S.A., SIMPLES, ADMINISTRACAO PUBLICA |
Consulta direta ao site da Receita Federal
Se o CNPJ consultado não estiver presente em nossa base de dados, realizaremos uma captura on-demand diretamente junto à Receita Federal, integrada à própria requisição ao dataset de Dados Básicos. Por se tratar de um processo complexo e dependente da disponibilidade do serviço da Receita Federal, o tempo de resposta nesses casos poderá ser maior.
Em geral, não é necessário recorrer à consulta direta no site da Receita, pois nossa base é mantida atualizada de forma contínua. Atualizamos os dados dos CNPJs mensalmente, além de adicionarmos novos registros diariamente.
Caso seja necessária a obtenção dos dados ainda mais atualizados, recomendamos o uso do nosso serviço on-demand de Consulta de CNPJ na Receita Federal. Ressaltamos que o tempo de resposta e a disponibilidade dos dados estão sujeitos ao funcionamento do serviço da Receita Federal.