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
Primeiro, é importante lembrar que para a grande maioria dos casos não é necessário fazer uma consulta direto no site da Receita Federal. Atualizamos a nossa base interna de CNPJs mensalmente, e a de CPFs a cada 3 meses e meio. Além disso, incluímos novas pessoas e empresas na base diariamente, e consultamos com frequencia semanal CPFs ou CNPJs com algum status de "risco", como "SUSPENSOS", "PENDENTES", ou mesmo de pessoas que tem idade superior a 65 anos. Com isso, você dificilmente precisará acessar diretamente o site da Receita.
Se ainda assim você precisa realizar a consulta diretamente à RF, pode realizar a consulta on-demand de Consulta de CPF na Receita Federal. No caso da consulta on-demand, o retorno dos dados e o tempo de resposta depende diretamete da disponibilidade do serviço da Receita Federal e não temos como controlar o mesmo.