Documentação API MapaCNPJ

API REST para consulta de dados empresariais via CNPJ. Desenvolvida para ERPs, CRMs e software houses.

Base URL

https://mapacnpj.seunegocionanuvem.com.br/api/

Autenticação

Autenticação via Bearer Token no header HTTP:

Authorization: Bearer SUA_API_KEY

Requisições sem chave válida retornam:

401 Unauthorized

Endpoint de Consulta

GET /api/{CNPJ}

Exemplo:

GET https://mapacnpj.seunegocionanuvem.com.br/api/25012398000107

Exemplo em PHP (cURL)

{"status":401,"titulo":"Não autorizado","detalhes":"API Token inválido ou inexistente. Envie o token no header \"X-API-Key\" ou \"Authorization: Bearer\".","validacao":[]}

Exemplo de Resposta JSON

{
  "cnpj": "25012398000107",
  "razao_social": "EMPRESA EXEMPLO LTDA",
  "nome_fantasia": "EMPRESA EXEMPLO",
  "situacao_cadastral_codigo": "02",
  "situacao_cadastral_descricao": "Ativa",
  "natureza_juridica_codigo": "2062",
  "natureza_juridica_descricao": "Sociedade Empresária Limitada",
  "cnae_principal_codigo": "6201501",
  "cnae_principal_descricao": "Desenvolvimento de programas de computador",
  "data_abertura": "2015-03-10",
  "capital_social": "100000.00"
}

Campos Retornados

Campo	Tipo	Descrição
cnpj	string	CNPJ numérico
razao_social	string	Nome empresarial
nome_fantasia	string	Nome fantasia
situacao_cadastral_codigo	string	Código da situação
situacao_cadastral_descricao	string	Descrição da situação
natureza_juridica_codigo	string	Código natureza jurídica
natureza_juridica_descricao	string	Descrição natureza jurídica
cnae_principal_codigo	string	Código CNAE principal
cnae_principal_descricao	string	Descrição CNAE principal
data_abertura	date	Data de abertura
capital_social	decimal	Capital social

Status Codes

Status	Descrição
200	Consulta realizada com sucesso
400	CNPJ inválido
401	API Key inválida ou ausente
404	CNPJ não encontrado
429	Rate limit excedido
500	Erro interno

Rate Limit

O limite de requisições depende do plano contratado. Exceder o limite retorna 429.

Suporte

Solicitação de API Key ou dúvidas técnicas:

Falar no WhatsApp