TOTVS Moda

Páginas filhas
  • DT Consulta de CNPJ via API


01. DADOS GERAIS

Produto:

TOTVS Moda

Linha de Produto:

Virtual Age

Segmento:

Varejo

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).