Consultar CNPJ
Consultar CNPJ é a primeira tela da área logada (/app), para onde o TermoAuth devolve quem acabou de entrar. A pessoa digita um CNPJ e vê tudo o que a Receita publica sobre aquele estabelecimento.
Entradas e saídas
| Ponto | Descrição |
|---|---|
| Entrada | Um CNPJ de 14 dígitos, com ou sem máscara (04.252.011/0001-10 ou 04252011000110) |
| Saída | A ficha do estabelecimento, ou o aviso de que o CNPJ não está na base |
| Operação | buscarPeloId da feature cnpj: GET /api/cnpj/{cnpj} |
Etapas
1. Informar o CNPJ
O campo aplica a máscara enquanto a pessoa digita. A consulta só é enviada com os 14 dígitos; fora disso, a tela mostra "Informe um CNPJ com 14 dígitos." Enquanto nada foi consultado, a tela sugere alguns CNPJs de empresas conhecidas para consultar com um clique.
2. Buscar na base
O frontend envia só os dígitos. O backend normaliza de novo (descarta tudo que não é dígito e exige 14) e busca a linha pela chave primária da tabela cnpj.
3. Mostrar a ficha
A resposta já traz tudo: dados da empresa, do estabelecimento, do Simples e a lista de sócios, com as descrições resolvidas na importação. Nenhuma outra chamada é feita.
O que a ficha mostra
| Bloco | Conteúdo |
|---|---|
| Resumo | Razão social, porte, capital social, data de início da atividade e número de sócios, com os botões para copiar o CNPJ formatado e abrir o endereço no Google Maps. |
| Empresa | Natureza jurídica, porte, capital social, qualificação do responsável e, quando existe, o ente federativo responsável. |
| Estabelecimento | Início da atividade, situação cadastral e motivo, CNAE principal e secundários, endereço, cidade no exterior (quando houver), telefones, fax e e-mail. |
| Simples / MEI | Se é optante pelo Simples Nacional e pelo MEI, com as datas de opção e de exclusão. |
| Sócios | Cada sócio com tipo, CPF ou CNPJ como a Receita publica, qualificação, data de entrada, país, faixa etária e representante legal. |
Os dados chegam como a Receita os publica e são formatados só na tela: datas AAAAMMDD viram DD/MM/AAAA (a data 00000000 aparece como vazia), o capital social vira valor em reais e os códigos aparecem com a descrição ao lado.
Respostas da API
| Situação | Resposta |
|---|---|
| CNPJ encontrado | 200 com o registro completo |
| Menos ou mais de 14 dígitos | 400, "CNPJ invalido: informe os 14 digitos" |
| CNPJ fora da base | 404, "CNPJ nao encontrado" |
| Falha no banco | 500, "Falha ao consultar o banco" |
Regras
- A rota da API é pública.
GET /api/cnpj/{cnpj}não exige token, para permitir consulta por integração. A tela, por estar em/app, exige login. - A ficha é de um estabelecimento. Matriz e filiais têm CNPJs diferentes. Os dados da empresa e os sócios se repetem em todas as unidades do mesmo CNPJ básico.
- Abrir já consultado. A tela aceita
?cnpj=na URL e consulta ao abrir. É assim que o botão de ficha da tela Localizar Empresas leva a pessoa até aqui. - A ficha reflete a última importação. Um CNPJ aberto depois da publicação da Receita só aparece depois que o master importa o mês novo.