{"id":6801,"date":"2026-08-19T14:20:03","date_gmt":"2026-08-19T14:20:03","guid":{"rendered":"https:\/\/ajuda.ez4.com.br\/index.php\/docs\/produtos-ez4\/runner-meus-cadastros\/integracao-cnpja\/"},"modified":"2026-08-19T19:32:32","modified_gmt":"2026-08-19T19:32:32","slug":"integracao-cnpja","status":"publish","type":"docs","link":"https:\/\/ajuda.ez4.com.br\/index.php\/docs\/produtos-ez4\/runner-meus-cadastros\/integracao-cnpja\/","title":{"rendered":"Integra\u00e7\u00e3o CNPJA"},"content":{"rendered":"\n<h3 class=\"wp-block-heading\">Vis\u00e3o geral<\/h3>\n\n\n\n<p>A integra\u00e7\u00e3o com a CNPJ\u00e1 permite buscar automaticamente os dados cadastrais de uma empresa a partir do CNPJ, preenchendo os campos do cadastro (raz\u00e3o social, nome fantasia, endere\u00e7o, CEP, bairro, cidade, estado, inscri\u00e7\u00f5es etc.) sem digita\u00e7\u00e3o manual. A consulta \u00e9 acionada pelo bot\u00e3o Consultar, exibido ao lado do campo de CNPJ nos formul\u00e1rios de cadastro de Clientes e Fornecedores.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Origem dos dados<\/h3>\n\n\n\n<p>Os dados s\u00e3o fornecidos pela CNPJ\u00e1 (<a href=\"https:\/\/api.cnpja.com\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/api.cnpja.com<\/a>): informa\u00e7\u00f5es cadastrais de pessoa jur\u00eddica originadas da Receita Federal do Brasil (CNPJ), complementadas \u2014 conforme o plano e os par\u00e2metros da consulta \u2014 com Simples Nacional e Inscri\u00e7\u00f5es Estaduais (Sintegra\/SEFAZ). Endpoint: GET <a href=\"https:\/\/api.cnpja.com\/office\/{CNPJ}\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/api.cnpja.com\/office\/{CNPJ}<\/a>, com par\u00e2metros opcionais como ?simples=true e ?registrations=BR.<\/p>\n\n\n\n<p>Importante: a solu\u00e7\u00e3o apenas consome e exibe as informa\u00e7\u00f5es retornadas pela CNPJ\u00e1, n\u00e3o sendo a fonte prim\u00e1ria nem respons\u00e1vel por diverg\u00eancias ou desatualiza\u00e7\u00f5es na base de origem.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Pr\u00e9-requisitos e depend\u00eancias t\u00e9cnicas<\/h3>\n\n\n\n<ul>\n<li>Token da consulta (fornecido pela BOA Digital) \u2014 o token de API \u00e9 fornecido e configurado pela equipe BOA Digital durante a implanta\u00e7\u00e3o. O cliente n\u00e3o precisa contratar conta ou plano pr\u00f3prios na CNPJ\u00e1.<\/li>\n\n\n\n<li>Acesso de rede (sa\u00edda HTTPS) \u2014 libera\u00e7\u00e3o para <a href=\"https:\/\/api.cnpja.com\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/api.cnpja.com<\/a> (porta 443) a partir do ambiente Fluig e dos navegadores dos usu\u00e1rios. Em ambientes com proxy\/firewall, o dom\u00ednio deve ser liberado.<\/li>\n\n\n\n<li>Solu\u00e7\u00e3o instalada<\/li>\n\n\n\n<li>Usu\u00e1rio com permiss\u00e3o para executar a tela de configura\u00e7\u00e3o de Servi\u00e7os da solu\u00e7\u00e3o.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Configura\u00e7\u00e3o e habilita\u00e7\u00e3o<\/h3>\n\n\n\n<p>Toda a configura\u00e7\u00e3o \u00e9 feita em uma \u00fanica tela: a tela de Servi\u00e7os da solu\u00e7\u00e3o (etapa de instala\u00e7\u00e3o\/configura\u00e7\u00e3o). Ao preencher os campos de consulta e salvar, a pr\u00f3pria solu\u00e7\u00e3o cria (ou atualiza) automaticamente o servi\u00e7o CNPJA na plataforma Fluig (servi\u00e7o REST) e grava os par\u00e2metros \u2014 n\u00e3o \u00e9 necess\u00e1rio cadastrar o servi\u00e7o manualmente no Painel de Controle.<\/p>\n\n\n\n<p>Na se\u00e7\u00e3o de Consulta de CNPJ da tela de Servi\u00e7os:<\/p>\n\n\n\n<ul>\n<li>Tipo CNPJ (tipo_cnpj): provedor da consulta. Ex.: cnpja<\/li>\n\n\n\n<li>URL CNPJ (url_cnpj): endpoint com o marcador ||cnpj||, substitu\u00eddo pelo CNPJ na consulta. Ex.: <a href=\"https:\/\/api.cnpja.com\/office\/||cnpj||?registrations=BR\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/api.cnpja.com\/office\/||cnpj||?registrations=BR<\/a><\/li>\n\n\n\n<li>Token \/ Par\u00e2metro (par_cnpj): token da CNPJ\u00e1, enviado no cabe\u00e7alho Authorization a cada consulta. (fornecido pela BOA Digital)<\/li>\n<\/ul>\n\n\n\n<p>O campo Token \/ Par\u00e2metro j\u00e1 \u00e9 preenchido com o token fornecido pela BOA Digital no momento da implanta\u00e7\u00e3o. N\u00e3o \u00e9 necess\u00e1rio que o cliente gere ou informe um token pr\u00f3prio.<\/p>\n\n\n\n<p>Ao salvar:<\/p>\n\n\n\n<ul>\n<li>A solu\u00e7\u00e3o verifica se o servi\u00e7o CNPJA j\u00e1 existe na plataforma; se n\u00e3o existir, cria; se existir, atualiza com a URL informada.<\/li>\n\n\n\n<li>Os par\u00e2metros (tipo, URL e token) ficam gravados no formul\u00e1rio de Servi\u00e7os e passam a ser usados pelo bot\u00e3o Consultar nos cadastros.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Como utilizar<\/h3>\n\n\n\n<ul>\n<li>No cadastro de Cliente ou Fornecedor, informe o CNPJ no campo correspondente.<\/li>\n\n\n\n<li>Clique no bot\u00e3o Consultar ao lado do campo.<\/li>\n\n\n\n<li>A solu\u00e7\u00e3o consulta a CNPJ\u00e1 e preenche automaticamente os campos dispon\u00edveis (nome, endere\u00e7o, CEP, bairro, cidade, UF etc.).<\/li>\n\n\n\n<li>Cada consulta \u00e9 registrada em log (CNPJ, dados retornados, data e hora). Se j\u00e1 houver consulta recente para o mesmo CNPJ, o sistema oferece reaproveitar a consulta anterior ou realizar nova consulta, evitando consumo desnecess\u00e1rio.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Limita\u00e7\u00f5es e premissas<\/h3>\n\n\n\n<ul>\n<li>Token fornecido pela BOA Digital \u2014 o token e o plano da CNPJ\u00e1 s\u00e3o fornecidos e gerenciados pela EZ4; o volume de consultas est\u00e1 sujeito aos limites do plano contratado pela BOA Digital.<\/li>\n\n\n\n<li>Depend\u00eancia de disponibilidade externa \u2014 se a API da CNPJ\u00e1 estiver indispon\u00edvel ou a rede bloqueada, a consulta n\u00e3o retorna dados. A chamada possui timeout (\u00e9 interrompida se o servi\u00e7o n\u00e3o responder em poucos segundos).<\/li>\n\n\n\n<li>Qualidade do dado \u2014 os campos preenchidos dependem do que a base de origem disponibiliza; empresas com cadastro incompleto podem retornar campos em branco.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Erros comuns<\/h3>\n\n\n\n<ul>\n<li>Consulta retorna vazia \u2192 Token inv\u00e1lido\/expirado ou CNPJ sem dados na base \u2192 Contatar o suporte EZ4; confirmar o CNPJ.<\/li>\n\n\n\n<li>&#8220;Nenhum resultado&#8221; \/ timeout \u2192 Rede sem libera\u00e7\u00e3o para api.cnpja.com ou API fora do ar \u2192 Liberar o dom\u00ednio no firewall\/proxy; tentar novamente.<\/li>\n\n\n\n<li>Falha ap\u00f3s muitas consultas \u2192 Limite do plano atingido \u2192 Aguardar; contatar o suporte EZ4.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>Vis\u00e3o geral A integra\u00e7\u00e3o com a CNPJ\u00e1 permite buscar automaticamente os dados cadastrais de uma empresa a partir do CNPJ, preenchendo os campos do cadastro (raz\u00e3o social, nome fantasia, endere\u00e7o, CEP, bairro, cidade, estado, inscri\u00e7\u00f5es etc.) sem digita\u00e7\u00e3o manual. A consulta \u00e9 acionada pelo bot\u00e3o Consultar, exibido ao lado do campo de CNPJ nos formul\u00e1rios [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":6797,"menu_order":29,"comment_status":"open","ping_status":"closed","template":"","doc_tag":[],"acf":[],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/ajuda.ez4.com.br\/index.php\/wp-json\/wp\/v2\/docs\/6801"}],"collection":[{"href":"https:\/\/ajuda.ez4.com.br\/index.php\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/ajuda.ez4.com.br\/index.php\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/ajuda.ez4.com.br\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ajuda.ez4.com.br\/index.php\/wp-json\/wp\/v2\/comments?post=6801"}],"version-history":[{"count":2,"href":"https:\/\/ajuda.ez4.com.br\/index.php\/wp-json\/wp\/v2\/docs\/6801\/revisions"}],"predecessor-version":[{"id":6809,"href":"https:\/\/ajuda.ez4.com.br\/index.php\/wp-json\/wp\/v2\/docs\/6801\/revisions\/6809"}],"up":[{"embeddable":true,"href":"https:\/\/ajuda.ez4.com.br\/index.php\/wp-json\/wp\/v2\/docs\/6797"}],"wp:attachment":[{"href":"https:\/\/ajuda.ez4.com.br\/index.php\/wp-json\/wp\/v2\/media?parent=6801"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/ajuda.ez4.com.br\/index.php\/wp-json\/wp\/v2\/doc_tag?post=6801"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}