> For the complete documentation index, see [llms.txt](https://ajuda.consistem.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.consistem.com.br/consistem-integracoes/areas-de-negocio/financeiro/cnpja.md). # CNPJá #### Visão Geral A integração entre o Consistem ERP e o serviço CNPJá permite que a sua empresa consulte a Receita Federal em tempo real diretamente do sistema. O objetivo principal é automatizar a captura de dados cadastrais como registro, situação cadastral, CNAEs, contatos, endereço, quadro de sócios (QSA) , além de retornar a Inscrição Estadual e verificar se a empresa é optante do Simples Nacional. Isso otimiza o processo de cadastro e evita erros fiscais. Vale destacar que o serviço é exclusivo para dados de CNPJ, não retornando informações de CPF.
Consistem ERPCNPJá

Compatibilidade: 7.5 ou superiores do Consistem ERP.

Módulos: Comercial, Financeiro e Cadastros Gerais.

Orientamos o acompanhamento da nossa equipe de consultores.

Aquisição de licença e implantação deve ser verificada com a empresa fornecedora.
Saiba mais
Limitações de Uso: Fique atento ao plano contratado, visto que o serviço possui limitações de solicitações por minuto ou por dia (principalmente em modalidades gratuitas/testes).
#### Configuração da Integração **No Consistem ERP:** 1. Acesse o programa [Configurações de Integrações (CSWMEN180)](/modulos/componentes/manuais-de-telas/configuracao-dos-componentes/configuracoes-de-integracoes.md) e acione a [Aba Serviço Consulta CNPJ (CSWMEN180TAB1)](/modulos/componentes/manuais-de-telas/configuracao-dos-componentes/configuracoes-de-integracoes/aba-servico-consulta-cnpj.md).
2. No campo **Serviço Consulta CNPJ**, selecione a opção *2-CNPJá* para definir que este será o provedor oficial utilizado pelo sistema para sugerir dados nos cadastros. 3. No campo **Token Serviço CNPJ**, insira a chave de segurança/token de autenticação gerada previamente diretamente no site da [cnpja.com.br](https://cnpja.com.br). {% hint style="info" %} Essa configuração habilitará a sugestão automatizada de dados (como Razão Social, CEP, Endereço, Número, Bairro, E-mail, Telefone e Inscrição Estadual) ao abrir novos registros nos seguintes programas do ERP: * [Cadastro de Cliente (CCCDB005)](/modulos/cadastros-gerais/manuais-de-telas/clientes/cadastro-de-cliente.md) * [Cadastro de Fornecedor (CCFFB005)](/modulos/financeiro/manuais-de-telas/financeiro-contas-a-pagar/fornecedor/cadastro-de-fornecedor.md) * [Cadastro de Transportadora (CCAPL020)](/modulos/cadastros-gerais/manuais-de-telas/cadastros-gerais/cadastro-de-transportadora.md) * [Cadastro de Conta (CCTELCO010)](/modulos/comercial/manuais-de-telas/comercial-crm/contas/cadastro-de-conta.md) {% endhint %} **No CNPJá:** 1. Acesse o painel da fornecedora para obter a chave de API/Token necessária para a comunicação com o ERP. 2. Verifique os limites de requisições configurados no seu plano para garantir que atendam à demanda diária da sua operação. #### Como a Integração Funciona A comunicação entre as plataformas ocorre de forma síncrona através de consultas por *webservice* (API REST). O Consistem ERP atua como o emissor da requisição, disparando uma chamada HTTP que envia o número do CNPJ limpo (apenas os dígitos) para o sistema externo. A API da CNPJá recebe esse dado, realiza a consulta em tempo real diretamente na base da Receita Federal e retorna uma estrutura de dados padronizada ao ERP. O conteúdo retornado pela integração alimenta o sistema com as seguintes informações consolidadas: Razão Social, CEP, Endereço, Número, Bairro, E-mail, Telefone, Quadro de Sócios (QSA), CNAEs, Inscrição Estadual (IE) e o indicador se a empresa é optante pelo Simples Nacional. Cabe ressaltar que o fluxo foi desenhado estritamente para a validação de CNPJs, não trafegando dados relacionados a CPFs. #### Fluxo do Processo O fluxo operacional, de segurança e de validação da integração baseia-se no padrão de comunicação síncrona via *webservice* e é executado através dos seguintes passos sequenciais: 1. **Gatilho de Consulta (O que o Consistem Envia):** Ao cadastrar ou atualizar um parceiro nos programas de cadastro ([Cadastro de Cliente (CCCDB005)](/modulos/cadastros-gerais/manuais-de-telas/clientes/cadastro-de-cliente.md)), [Cadastro de Fornecedor (CCFFB005)](/modulos/financeiro/manuais-de-telas/financeiro-contas-a-pagar/fornecedor/cadastro-de-fornecedor.md), entre outros.) ou ao movimentar um pedido de venda, o ERP dispara uma requisição de consulta externa. O Consistem envia apenas o número do CNPJ limpo (formatado apenas com dígitos), que serve como a chave de busca para o *webservice*. 2. **Padrão de Comunicação (Leiautes):** A transmissão utiliza o leiaute padrão da Consistem para envio de dados via *webservice*. A API da CNPJá processa essa requisição em tempo real na base da Receita Federal e da Sefaz, devolvendo as informações estruturadas no leiaute de retorno padrão da Consistem para a recepção de dados. 3. **Recepção de Dados (O que o Consistem Recebe):** O ERP recebe o leiaute de retorno preenchido pela CNPJá com os dados consolidados do parceiro: Razão Social, CEP, Endereço, Número, Bairro, E-mail, Telefone, Quadro de Sócios (QSA), CNAEs, Inscrição Estadual (IE) e o indicador de enquadramento no Simples Nacional. 4. **Validação:** Na mudança de etapa do pedido de venda, o programa [Validação Dados Cadastrais de Clientes (CCCDB670)](/modulos/comercial/manuais-de-telas/comercial-carteira-de-pedidos/controle-de-etapas-por-fluxo-de-pedido/validacao-dados-cadastrais-de-clientes.md) intercepta o fluxo para realizar a verificação cadastral. Os dados recebidos no leiaute de retorno alimentam duas novas colunas estruturadas na tela: Situação CNPJ e Situação IE. 5. **Regra de Bloqueio e Crítica:** Caso o leiaute de retorno aponte que a situação cadastral do CNPJ ou da IE não está em conformidade com os requisitos fiscais configurados, o sistema executa duas ações de segurança: 1. Bloqueia a correção manual do cadastro e exibe uma mensagem de erro impeditiva. 2. Ao tentar avançar o pedido no programa [Consulta de Etapas por Pedido (CCPVE600)](/modulos/comercial/manuais-de-telas/comercial-carteira-de-pedidos/controle-de-etapas-por-fluxo-de-pedido/consulta-de-etapas-por-pedido.md) (através do botão **Próxima Etapa**), a mesma crítica é disparada, travando a evolução do pedido até a regularização fiscal do cliente. 6. **Gravação e Liberação:** Se o retorno do *webservice* for validado com sucesso e a situação cadastral estiver totalmente regular, as informações do leiaute atualizam automaticamente o banco de dados do Consistem ERP, gravando o cadastro e liberando o fluxo comercial do pedido de venda normalmente. 7. **Auditoria e Monitoramento (Pós-fluxo):** Cada consulta realizada nesse fluxo (seja com sucesso ou com erro de retorno do *webservice*) gera um log automático no programa [Monitor do Serviço Consulta CNPJ (CSWMEN655)](/modulos/componentes/manuais-de-telas/consulta-de-componentes/monitor-do-servico-consulta-cnpj.md). Através dele, os administradores podem utilizar os filtros de **Data Início/Fim** e **Tipo Serviço** (*CNPJá*) para rastrear o histórico completo da transação, identificando a **Data/Hora** da consulta, o **Cód./Nome do Programa** que originou a chamada, o **Cód./Descrição do Usuário** solicitante e o código de **Retorno** enviado pela API.

Esse conteúdo foi útil?

Sim Não

--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://ajuda.consistem.com.br/consistem-integracoes/areas-de-negocio/financeiro/cnpja.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.