> For the complete documentation index, see [llms.txt](https://docs.cnpj.ws/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cnpj.ws/blog/como-automatizar-o-cadastro-de-clientes-com-uma-api-de-consulta-cnpj.md). # Como automatizar o cadastro de clientes com uma API de consulta CNPJ Quantas vezes a sua equipe já digitou razão social, endereço, CNAE e inscrição estadual de um cliente novo — campo por campo — copiando do cartão CNPJ da Receita Federal? Além de lento, esse processo é a principal porta de entrada de erros cadastrais: um dígito trocado no CNPJ, um endereço desatualizado, uma razão social abreviada de forma diferente em cada sistema. A boa notícia é que nada disso precisa ser manual. Com uma **API de consulta CNPJ**, o seu sistema pede apenas um dado ao usuário — o número do CNPJ — e preenche todo o resto sozinho, com informações oficiais e atualizadas. Neste post, mostramos como esse fluxo funciona, como implementá-lo com a API do CNPJ.ws e como um ERP brasileiro usa exatamente essa abordagem em produção. ### O problema do cadastro manual Todo sistema que atende empresas — ERP, CRM, plataforma de cobrança, e-commerce B2B — precisa cadastrar pessoas jurídicas. No fluxo manual, isso significa um formulário com 10 a 20 campos que alguém preenche consultando documentos. Os custos aparecem em três frentes: * **Tempo**: cada cadastro consome minutos de trabalho repetitivo, multiplicado por todos os clientes e fornecedores da base. * **Erros**: digitação manual gera divergências que se propagam para notas fiscais, boletos e contratos — e retrabalho para corrigir. * **Dados desatualizados**: a empresa muda de endereço ou de situação cadastral, e o cadastro no sistema continua com a informação antiga. ### Como funciona uma API de consulta CNPJ Uma API de consulta CNPJ expõe os dados públicos das empresas brasileiras em formato estruturado (JSON), pronto para ser consumido por qualquer aplicação. No caso do CNPJ.ws, uma única requisição HTTP retorna razão social, nome fantasia, situação cadastral, natureza jurídica, porte, endereço completo, CNAEs, quadro societário, inscrições estaduais e regime tributário (Simples Nacional/MEI). O fluxo de automação tem três passos: #### 1. O usuário informa só o CNPJ No formulário de cadastro, o único campo obrigatório passa a ser o CNPJ. Vale validar os dígitos verificadores no front-end antes de consultar, evitando chamadas desnecessárias. #### 2. O sistema consulta a API ```bash curl https://publica.cnpj.ws/cnpj/00000000000191 ``` A resposta traz o objeto completo da empresa. A API pública do CNPJ.ws permite até 3 consultas por minuto — suficiente para testar e para volumes baixos. Para uso em produção, a API comercial oferece limites maiores, dados adicionais e SLA. #### 3. O formulário se preenche sozinho Com a resposta em mãos, o sistema popula todos os campos: razão social, endereço, CNAE principal, regime tributário. O usuário apenas confere e confirma. O que antes levava minutos passa a levar segundos — e os dados chegam exatamente como constam na base oficial. ### Caso real: cadastro de clientes por IA no bitERP Um exemplo de quem usa esse fluxo em produção é o [bitERP, um ERP com inteligência artificial](https://www.biterp.ai) desenvolvido no Brasil. No bitERP, o usuário pode pedir no chat algo como *"cadastra o cliente CNPJ 00.000.000/0001-00"* — e o agente de IA consulta a API do CNPJ.ws, preenche o cadastro completo na tela e pede apenas a confirmação final. A combinação é interessante porque junta duas automações: a IA elimina a navegação por menus e formulários, e a API de consulta CNPJ elimina a busca e digitação dos dados. O resultado é um onboarding de cliente que se resolve em uma única frase, com dados oficiais da Receita Federal — sem erro de digitação e sem cadastro incompleto. O mesmo padrão se aplica a fornecedores, transportadoras e qualquer outra entidade PJ do sistema. ### Boas práticas ao integrar Para tirar o máximo da integração, vale seguir algumas recomendações: * **Valide o CNPJ antes de consultar** — dígito verificador é cálculo local, não gaste requisição com número inválido. * **Trate os limites de requisição** — implemente retry com backoff para o erro 429 e considere a API comercial para volume. * **Guarde a data da consulta** — dados cadastrais mudam; saber quando o cadastro foi sincronizado permite programar atualizações periódicas. * **Alerta de situação cadastral** — se a empresa constar como baixada, suspensa ou inapta, sinalize antes de concluir o cadastro. Isso evita emitir nota para CNPJ irregular. * **Deixe o usuário revisar** — automação preenche, humano confirma. Especialmente campos que o cliente pode querer sobrescrever, como nome fantasia. ### Comece agora Você pode testar a consulta neste momento, sem cadastro: basta chamar `https://publica.cnpj.ws/cnpj/{número}` e ver o JSON retornado. Para levar a integração para produção, conheça os [planos da API comercial do CNPJ.ws](https://www.cnpj.ws) — e se quiser ver o fluxo de cadastro automatizado funcionando dentro de um ERP, o exemplo do bitERP mostra até onde essa automação pode chegar. --- # 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://docs.cnpj.ws/blog/como-automatizar-o-cadastro-de-clientes-com-uma-api-de-consulta-cnpj.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.