Perguntas frequentes
Respostas curtas sobre cobertura, atualização, autenticação, limites e uso dos dados.
Posso buscar uma empresa pelo nome?
Não. O contrato atual consulta CNPJ exato e relações pela raiz do CNPJ. Busca por razão social ou nome fantasia está fora do MVP implementado.
A API informa matriz e filiais?
Sim. GET /v1/cnpjs/{cnpj}/estabelecimentos lista estabelecimentos pela raiz de oito dígitos, incluindo identificador_matriz_filial quando publicado.
Há CNAE e quadro societário?
O perfil/estabelecimento expõe CNAE principal e secundários brutos. /socios expõe o quadro societário publicado. A API não fornece catálogo descritivo de CNAEs nem histórico societário.
Simples Nacional e MEI estão disponíveis?
Sim, no objeto opcional simples do perfil. Ele pode ser null e os campos refletem o snapshot público.
Uma lista vazia garante que não existe dívida ou ocorrência?
Não quando fonte.status for indisponivel. Nesse caso não há snapshot publicado para responder com segurança. Com fonte disponível, a lista vazia indica que a consulta não encontrou itens naquele snapshot e nos filtros usados.
Posso consultar créditos ativos por CNPJ?
Não. /v1/rfb/creditos-ativos expõe dados agregados e aceita filtros como UF e ano/mês.
CAFIR é ligado automaticamente ao CNPJ?
Não. O contrato oferece NIRF e filtros geográficos. Nome, UF ou município não são usados para inferir propriedade.
Qual é o limite de requisições?
O fallback implementado é 60/minuto por IP. Chaves podem ter limite individual. Planos, quotas e SLA comercial estão a confirmar.
Existe sandbox?
Há suporte técnico para chaves development, review e production, mas a infraestrutura e os dados de um sandbox público ainda estão a confirmar.
RapidAPI já está integrada?
Não. É uma possibilidade futura e não faz parte do portal ou contrato atual.