Pular para o conteúdo principal

CNPJ/CNAE: Consulta de estabelecimentos por CNAE

A Nuvem Fiscal oferece uma ferramenta útil para sua equipe de vendas e marketing: uma listagem de estabelecimentos por código CNAE (Classificação Nacional de Atividades Econômicas). Outros dois filtros obrigatórios são o município e a natureza jurídica. Nas informações retornadas estão o CNPJ, endereço e e-mail cadastrado na Receita Federal, entre outros.

Isso permite que você possa, por exemplo, listar estabelecimentos na sua cidade de um segmento comercial específico. São informações valiosas para ajudar na sua estratégia de vendas.

Utilização​

Os detalhes estão disponíveis na documentação do endpoint ListarCnpj.

A requisição a seguir é um exemplo que traz as 50 primeiras empresas no ramo de desenvolvimento de software customizável (6202300) na cidade de Curitiba (código IBGE 4106902) que são micro empresas individuais (MEI, natureza jurídica 2135):

GET https://api.nuvemfiscal.com.br/cnpj?$top=50&cnae_principal=6202300&municipio=4106902&natureza_juridica=2135

Para obter os próximos 50 estabelecimentos com o mesmo critério, basta incluir o parâmetro $skip e indicar quantos estabelecimentos você já consultou anteriormente, e que serão ignorados:

GET https://api.nuvemfiscal.com.br/cnpj?$top=50&$skip=50&cnae_principal=6202300&municipio=4106902&natureza_juridica=2135

A quantidade de estabelecimentos retornados serão contabilizados como consumo na conta cnpj-listagem.

info

O consumo da conta não discrimina estabelecimentos repetidos. Ou seja, se você fizer a mesma consulta duas vezes e trouxer os mesmos 50 estabelecimentos, seu consumo será contabilizado como 100. Sempre use os parâmetros $top e $skip para fazer a paginação correta e evitar trazer estabelecimentos duplicados.

O código CNAE deve ser fornecido sem máscara (apenas números).

No código do município você pode utilizar o código IBGE ou o código TOM, também somente dígitos.

A natureza jurídica deve ser somente com dígitos. A lista de códigos está disponível no Anexo V da Instrução Normativa RFB 2119/2002.

Alguns exemplos de códigos são:

  • 2062 - Sociedade Empresária Limitada
  • 2135 - Empresário Individual
  • 2143 - Cooperativa
  • 2305 - Empresa Individual de Responsabilidade Limitada (de Natureza Empresária)
  • 2313 - Empresa Individual de Responsabilidade Limitada (de Natureza Simples)
  • 3085 - Condomínio Edifício
  • 4014 - Empresa Individual Imobiliária
  • 4120 - Produtor Rural (Pessoa Física)