01. DADOS GERAIS

Produto:

Linha de Produto:

Virtual Age

Segmento:

Módulo:Comercial
Função:Realizar a consulta de CNPJ via API
Ticket:8736808
Requisito/Story/Issue (informe o requisito relacionado) :DVACOM-4622


02. SITUAÇÃO/REQUISITO

A atual forma de consulta de CNPJ no sistema não estava mais sendo possível devido a mudanças realizadas no site da Receita, com isso foi vista a necessidade de utilização da API ReceitaWS disponibilizada pela Receita Federal.

03. SOLUÇÃO

Foi implementada a consulta de CNPJ com base na API ReceitaWS (https://receitaws.com.br/api) nos componentes PESFM010 e PESFM086.


Imagem 01 - No componente ADMFM013 foi realizada a configuração do parâmetro corporativo "DS_URL_API_CONSULTA_CNPJ" com a URL da API que realizará a consulta do CNPJ.

  • URL: http://www.receitaws.com.br/v1/cnpj/


Imagem 02 - Foi configurado também o parâmetro corporativo "DS_TOKEN_API_CONSULT_CNPJ" com o TOKEN gerado através do site.


Imagem 03 - Ainda no componente ADMFM013 foi configurado o parâmetro corporativo "NR_DIA_API_CONSULTA_CNPJ" com o valor de "3", sendo a defasagem máxima dos dados. Caso necessite de uma informação mais atualizada basta informar a quantidade máxima de dias em que a consulta à Receita é aceitável para o seu caso de uso. 

Ex.: Caso um CNPJ consultado a quatro dias atrás seja consultado novamente, geraria uma nova atualização das informações referente a esse CNPJ.


Imagem 04 - Foi acessado o componente PESFM010, informado um CNPJ e acionado o botão de consulta (>>).


Imagem 05 - Nota-se que os dados foram carregados corretamente, permitindo realizar a gravação dos dados para o novo cliente.


Imagem 06 - É disponibilizado gratuitamente 1.000 consultas no banco de dados da API sem a necessidade do uso de consultas em tempo real na Receita Federal.


Imagem 07 - A API disponibiliza também 10 consultas em tempo real na Receita Federal, caso um novo CNPJ seja consultado e não encontrado no banco de dados da API após a utilização dessas consultas, se faz necessária a contratação de um plano disponibilizado pela API (https://receitaws.com.br/faq). 



<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}

.aui-tabs.horizontal-tabs>.tabs-menu>.menu-item.active-tab a::after { 
	background: #FF9900; !important 
}

.menu-item.active-tab { 
	border-bottom: none !important; 
}

</style>