Cadastro
Razão social, situação cadastral, CNAE, porte, endereço, capital social e opção pelo Simples.
Cadastro, dívida ativa, sanções e sócios numa chamada HTTP. O plano inicial custa R$ 149 por mês e inclui 5.000 consultas. A chave é sua, separada da extensão.
R$ 149 ÷ 5.000 = R$ 0,0298 por consulta. A chave chega por e-mail quando o pagamento confirma.
Os mesmos dados do plano Pro da extensão. A resposta é informativa: não é certidão e não substitui a consulta oficial.
Razão social, situação cadastral, CNAE, porte, endereço, capital social e opção pelo Simples.
Dívida ativa da PGFN, com valor e semáforo, e sanções do CEIS, do CNEP e da lista do MTE.
Quadro de sócios e CNAEs secundários. CPF de pessoa física permanece mascarado.
A cota é do ciclo da assinatura e zera quando ela renova. Passou de 5.000, a API responde com o link para pedir o plano de 25.000 consultas. Não há checkout automático desse segundo degrau.
Precisa de mais volume? O plano de até 25.000 consultas por mês sai a R$ 399. Falar com o suporte.
A base é https://api.hovercnpj.com.br. Mande a chave no header, a partir do seu servidor. Não coloque a chave no navegador do seu cliente.
200Consulta contabilizada. Os headers X-Quota-Limit, X-Quota-Remaining e X-Quota-Period dizem quanto ainda resta no ciclo.
400 invalid_cnpjDígito verificador inválido. Essa chamada não consome cota.
401 invalid_api_keyChave ausente, revogada ou desconhecida.
402 quota_exceededCota do ciclo esgotada. O corpo traz upgrade_url para o plano de 25.000.
402 subscription_inactiveAssinatura vencida ou cancelada fora do período já pago.
404 not_foundCNPJ válido que não está na base. Conta na cota.
429 rate_limitedMuitas chamadas no último minuto. Espere e tente de novo. Não é a cota mensal.
14 dígitos, sem pontuação. A resposta abaixo é o corpo de um 200.
curl -s https://api.hovercnpj.com.br/v1/cnpj/00000000000191 \ -H "Authorization: Bearer hcnpj_sua_chave"
Com a chave da API o corpo vem com pro: true: dívida, sanções, sócios e CNAEs secundários.
{
"cnpj": "11222333000181",
"razao_social": "MERIDIANO CONSTRUCOES LTDA",
"nome_fantasia": "CONSTRUTORA MERIDIANO",
"situacao": "ATIVA",
"data_abertura": "2018",
"data_situacao": "03/02/2018",
"porte": "DEMAIS",
"natureza_juridica": "Sociedade Empresária Limitada",
"capital_social": 2400000,
"cnae_principal": {
"codigo": "4120400",
"descricao": "Construção de edifícios"
},
"cnaes_secundarios": [
{ "codigo": "4110700", "descricao": "Incorporação de empreendimentos imobiliários" }
],
"endereco": {
"tipo_logradouro": "AVENIDA",
"logradouro": "BRASIL",
"numero": "1000",
"complemento": "SALA 12",
"bairro": "CENTRO",
"municipio": "CAMPINAS",
"uf": "SP",
"cep": "13010001",
"lat": -22.9056,
"lng": -47.0608
},
"matriz_filial": "matriz",
"simples": { "optante": false, "mei": false },
"pro": true,
"socios": [
{ "nome": "ANA MERIDIANO", "qualificacao": "Sócio-Administrador" }
],
"divida_ativa": {
"tem_divida": true,
"semaforo": "vermelho",
"valor_total": 487230.15,
"valor_em_cobranca": 487230.15,
"qtd_inscricoes": 3,
"ajuizado": true,
"fontes": "FGTS,SIDA"
},
"sancoes": {
"tem_sancao": false,
"vigentes": 0,
"semaforo": "verde",
"total": 0,
"itens": []
}
}
Exemplo ilustrativo, não é uma empresa real. Sem dívida, divida_ativa volta só com tem_divida: false e semaforo: "verde". endereco.distancia_km só aparece se a chamada mandar ?lat=&lng=. O CPF de sócio pessoa física permanece mascarado.
Não. O Pro da extensão e a API são assinaturas diferentes. A chave da API começa com hcnpj_ e chega por e-mail depois do pagamento.
Na renovação da assinatura. Se a licença não tiver data de renovação, a contagem zera no dia 1, no horário de Brasília.
Não. A cota cobre o uso nos sistemas da sua empresa. A base não pode ser revendida. Os termos estão em /termos.
Peça outra em /recuperar, com o e-mail da assinatura. A chave nova substitui a anterior.