...
| Produto: | | Solucoes_totvs_parceirosexptotvs |
|---|
|
|
|---|
| Linha de Produto: | |
|---|
| 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.
| Totvs custom tabs box |
|---|
| tabs | Passo 01, Passo 02, Passo 03, Passo 04 |
|---|
| ids | passo1,passo2 |
|---|
|
| Totvs custom tabs box items |
|---|
| default | yes |
|---|
| referencia | passo1 |
|---|
| 
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. |
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | passo2 |
|---|
| |
|
...