Documentação Técnica

Consulta de Optante pelo Simples

Descrição

A consulta de Optante pelo Simples* retorna o resultado da consulta de optantes pelo Simples Nacional, disponível no site da Receita Federal. Não são retornadas as informações contidas no cartão CNPJ. Todos os dados de consultas online executadas em um modelo "on-demand" são retornados em uma mesma estrutura de objetos, e os objetos em si são retornados no campo de OnlineQueries do objeto principal de retorno.

Origem da Informação

As informações retornadas nesta consulta são retiradas da consulta pública de optantes pelo Simples no site da Receita Federal.

Tabela de preços para esse dataset

Consultas Realizadas no MêsValor por consulta
1 - 10000R$ 0,090
10001 - 50000R$ 0,085
50001 - 100000R$ 0,081
100001 - 500000R$ 0,077
500001 - 1000000R$ 0,073
1000001 - 5000000R$ 0,069
5000001 - 10000000R$ 0,066
10000001 - 50000000R$ 0,063
50000001 e acimaR$ 0,060

Parâmetros de consulta

A tabela abaixo detalha os campos aceitos na consulta a este dataset.

CampoDescriçãoValores PossíveisTipo de Campo
docDocumento de identificaçãoCNPJ🛑 Obrigatório

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": "ondemand_simples_company",
    "q": "doc{CNPJ}"  
}  

Atenção

Não recomendamos a utilização dessa consulta, uma vez que a base de CNPJs da BigData Corp. é atualizada mensalmente tanto com novos CNPJs quanto com o status dos CNPJs já existentes, minimizando assim a possibilidade de informações defasadas. Recomendamos que seja utilizado, em seu lugar, o dataset de Dados Cadastrais Básicos.

Descrição dos campos do objeto principal de retorno

CampoDescrição
OriginFonte dos Dados Entregues
InputParametersParâmetros de entrada
QueryDateData de realização da consulta
QueryResultData.IdNumberNúmero de identificação da empresa
QueryResultData.OfficialNameRazão Social da empresa
QueryResultData.EntityTypeTipo de Entidade
QueryResultData.RelationshipTypeTipo da relação com a empresa consultada
QueryResultData.SimplesNacionalStatusStatus do Simples Nacional
QueryResultData.SimeiStatusStatus Simei
QueryResultData.PriorPeriodsHeaderChave que contém a descrição da saída de Períodos Prévios (exemplo: DATA INICIAL;DATA FINAL;DETALHAMENTO)
QueryResultData.PriorPeriodsChave que contém a informação de saída de Períodos Prévios (exemplo: 01/01/2014;31/12/2017;EXCLUIDA POR ATO ADMINISTRATIVO)
QueryResultData.SimeiPriorPeriodsHeaderChave que contém a descrição da saída de Períodos Prévios Simei
QueryResultData.SimeiPriorPeriodsChave que contém a informação da saída de Períodos Prévios Simei
QueryResultData.AppointmentsHeaderChave que contém a descrição da saída de Agendamentos
QueryResultData.AppointmentChave que contém a informação da saída de Agendamentos
QueryResultData.DtQueryData de realização da consulta
Language
Credentials
Click Try It! to start a request and see the response here!