Consultar e validar CNPJ e inscrição estadual

Etapa 6 de 7 do processo Cadastrar parceiros. Anterior: Cadastrar órgão público ou ente estatal. Próxima: Cadastrar parceiro com CNPJ alfanumérico.

Como o cadastro de parceiro confere o CNPJ e a inscrição estadual ao salvar, e onde fica a lupa da consulta automática de CNPJ na Receita, que o vídeo só aponta. A validação dos dígitos funciona sem internet; a consulta online depende de serviço externo e a consulta de IE não é mostrada.

Visão geral: Cadastrar um cliente no Brasil

Limites deste cenário

A consulta online de CNPJ (módulo l10n_br_cnpj_search) depende de internet e, conforme o provedor, de chave; o vídeo mostra onde a lupa fica, mas não a aciona. A consulta de IE (módulo l10n_br_ie_search) não é mostrada nem acionada. Só a validação local dos dígitos do CNPJ e da IE é demonstrada. CNPJ alfanumérico: a Receita passou a emitir CNPJ com letras nas 12 primeiras posições e dois dígitos verificadores numéricos (IN RFB 2.229/2024, https://www.gov.br/receitafederal/pt-br/acesso-a-informacao/acoes-e-programas/programas-e-atividades/cnpj-alfanumerico), e o CNPJ numérico existente continua valendo, então os dois formatos convivem. O cadastro da 16.0 aceita e valida os dois (cenário Cadastrar parceiro com CNPJ alfanumérico), mas o vídeo mostra só o numérico. Fontes: https://www.projetoacbr.com.br/forum/topic/93888 e https://www.projetoacbr.com.br/forum/topic/95165 .

Importante

A consulta online de CNPJ não é acionada neste vídeo: depende de serviço externo.

Vídeo

Duração: 1 min 52 s. Sem áudio: a narração está nas legendas, na faixa de baixo do vídeo.

Antes de começar

Exemplo usado neste cenário

Cadastro do fornecedor fictício Serviços Exemplo Ltda, de São Paulo. O vídeo digita primeiro um CNPJ com o último dígito errado (87.054.331/0001-93) e uma inscrição estadual inválida, vê as duas recusas e corrige para o CNPJ 87.054.331/0001-92 e a IE 387120502648, fictícios e válidos.

Como os valores são calculados:

  • Primeiro dígito verificador do CNPJ: pesos 5,4,3,2,9,8,7,6,5,4,3,2 sobre 870543310001 dão soma 167; 167 mod 11 = 2, DV = 11 - 2 = 9.

  • Segundo dígito verificador: pesos 6,5,4,3,2,9,8,7,6,5,4,3,2 sobre 8705433100019 dão soma 185; 185 mod 11 = 9, DV = 11 - 9 = 2. O correto é 87.054.331/0001-92; terminar em 93 é recusado.

  • A inscrição estadual é conferida pelo algoritmo do estado do endereço (SP: dois dígitos verificadores em módulo 11); 123456789012 não fecha para SP.

Passo a passo

  1. Abra o aplicativo Contatos pelo menu de aplicativos e clique em Novo.

  2. Marque a opção Empresa.

  3. No campo do nome, digite Serviços Exemplo Ltda.

  4. Escolha o Estado São Paulo e a Cidade São Paulo.

  5. Aponte a lupa ao lado do CNPJ: ela consulta a Receita (serviço externo, não acionada aqui).

  6. Em CNPJ/Id Estrangeiro, digite 87.054.331/0001-93, com o último dígito errado.

  7. Salve o cadastro: o sistema recusa o CNPJ inválido.

  8. Clique em OK para fechar o aviso.

  9. Corrija o CNPJ para 87.054.331/0001-92.

  10. Em IE, digite 123456789012, que não é válida para SP.

  11. Salve de novo: o sistema recusa a inscrição estadual inválida.

  12. Clique em OK para fechar o aviso.

  13. Corrija a IE para 387120502648.

  14. Salve o cadastro: agora CNPJ e IE são aceitos.

Resultado esperado

O sistema recusou o CNPJ e a inscrição estadual inválidos com mensagem clara e aceitou os dados corrigidos. O cadastro fica com CNPJ e IE válidos.

Se houver erro

  • A lupa de consulta mostra erro de tempo esgotado ou de chave. O serviço externo (ReceitaWS ou Serpro) está indisponível ou o provedor exige chave. Preencha o cadastro manualmente ou configure o provedor e a chave em Definições -> Configurações Gerais.

  • A consulta traz dados diferentes dos documentos do cliente. O provedor devolve o cadastro da Receita, que pode estar desatualizado. Revise os campos antes de clicar em Atualizar Parceiro.

Módulos usados

Também usa: l10n_br_cnpj_search, l10n_br_ie_search. Os valores do exemplo foram conferidos automaticamente na execução gravada; a conferência não substitui a validação do contador da sua empresa.