...
| Produto: | | Solucoes_totvs |
|---|
| | Solucoes_totvs_cross |
|---|
SolucaoCross | | Solucoes_totvs_parceiros |
|---|
SolucaoParceiros | | Solucoes_totvs_parceirosexptotvs |
|---|
SolucaoParcsExpsTOTVS |
|
|---|
| 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. | | Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | passo2 |
|---|
|
|
04. DEMAIS INFORMAÇÕES
| Card documentos |
|---|
| Informacao | Use esse box para destacar informações relevantes e/ou de destaque. |
|---|
| Titulo | IMPORTANTE! |
|---|
|
...
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.
 Image Added
Imagem 04 - Foi acessado o componente PESFM010, informado um CNPJ e acionado o botão de consulta (>>).
 Image Added
Imagem 05 - Nota-se que os dados foram carregados corretamente, permitindo realizar a gravação dos dados para o novo cliente.
 Image Added
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.
 Image Added
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). |
|
| HTML |
|---|
<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>
|
