7.0 API - ReceitaWS
ReceitaWS no CRM One
A API ReceitaWS é utilizada para consultar automaticamente os dados de CNPJ diretamente na base da Receita Federal. No CRM One, essa integração pode ser habilitada para facilitar o preenchimento automático de informações do parceiro de negócios no momento do cadastro.
O que é o ReceitaWS?
O ReceitaWS é um serviço de terceiros que permite a consulta de dados públicos do CNPJ, como:
- Razão Social
- Nome Fantasia
- Situação cadastral
- Endereço completo
- Atividade econômica (CNAE)
- Dados de contato
Essa consulta é feita através de uma requisição à API externa do ReceitaWS, a partir de um CNPJ informado no CRM One.
Quando usar?
A consulta ReceitaWS pode ser usada:
- No momento do cadastro de um novo cliente , digitando o CNPJ.
- Em atualizações, onde as informações de endereço cadastradas no PN precisam ser alteradas..
- Em processos internos que exigem validação cadastral via CNPJ.
Como configurar no CRM One
- Acesse o menu: no SAP
Módulos> CRM One > Configurações > Configurações Gerais > Extensão CRM One: Aba Cad,PN - Localize a seção “API para busca de CNPJ”.
- Abra as opções e vá em:
- ReceitaWS: .
- Clique em Atualizar.
Como utilizar
- No cadastro de um novo parceiro de negócios, digite o CNPJ.
- Clique no botão OK
- Os campos serão preenchidos automaticamente com os dados retornados da Receita Federal.
Boas práticas
- Se algum campo não for preenchido automaticamente, é importante validar se essa informação realmente está disponível na API:
- Acesse diretamente o site do ReceitaWS (ou faça uma chamada manual via Postman, por exemplo).
- Digite o mesmo CNPJ utilizado no CRM One.
- Confirme se o dado desejado (ex: nome fantasia, telefone, etc) está presente na resposta da API.
- A ReceitaWS é uma API pública e gratuita, por isso:
- Existem limitações no número de consultas permitidas por período.
- Consultas para CNPJs muito recentes ou com informações restritas podem retornar dados incompletos ou vazios.
- Para ambientes com maior volume de requisições, recomendamos avaliar soluções pagas como "SintegraWS".