Atualiza Cadastros de Clientes a Partir de Sites Governamentais

Aplica-se apenas aos produtos Omega
Observação:
Os dados utilizados neste documento são genéricos e simulados no ambiente de homologação.
As imagens deste documento são meramente ilustrativas.

Introdução:

O processo TP530pr - Atualização de Dados do Cliente

Este processo executa a atualização automática de alguns dados dos clientes a partir de sites governamentais.

Quando o processo for executado, serão executadas as ações abaixo:

1) Serão selecionados para alteração todos os clientes que NÃO tiveram movimentação nos últimos ‘N’ meses, de acordo com o valor informado no campo ‘Número de meses de inatividade’ da janela. Para considerar se um cliente teve movimentação, será verificado:

1. Se o cliente teve alguma nota fiscal no período
2. Se o cliente teve alguma movimentação em contas a receber no período
3. Se o cliente teve algum pedido de venda com data no período

2) Para verificar se o cliente deve ser atualizado, será verificado também a última vez em que foi realizada a busca para o cliente, de acordo com o parâmetro ‘Número de meses para nova atualização’. Se a última atualização do cliente foi em um período menor que o número de meses informados, o cliente não será tratado novamente. Para cada cliente selecionado, o processo irá buscar os dados do cliente na internet, e atualizar no ERP.

Para realizar a busca dos dados, com exceção da inscrição estadual, será utilizado o mesmo WebService utilizado atualmente no cadastro de clientes para buscar os dados a partir do CNPJ (WebService ReceitaWS).

A busca da inscrição estadual será realizada em uma base centralizada disponibilizada pelo Rio Grande do Sul, utilizando-se o WebService (https://cad.svrs.rs.gov.br/ws/cadconsultacadastro/cadconsultacadastro4.asmx).

 Se o CNPJ do cliente for encontrado, serão realizados os tratamentos/serão atualizados no cadastro os campos abaixo:

• Razão Social
• Nome Fantasia
• CEP
• Endereço (com número e complemento)
• Bairro
• Cidade
• Estado
• Livre4. Neste campo será armazenado o telefone que é retornado pela API de busca.
• Inscrição Estadual

3) Para cada dado alterado será gerado um histórico de alteração do cliente, que poderá ser consultado na guia ‘Histórico de Alterações’ da janela de cadastro do cliente (Janela de sigla CRCLED).

4) O processo irá formatar o endereço utilizando as mesmas regras utilizadas para NF-e e processos fiscais, concatenando o número e complemento. Como o tamanho máximo do campo endereço no ERP é de 50 posições, contando o número e complemento, se o novo endereço formatado possuir mais de 50 posições, ele não será alterado, e o endereço atual e novo serão gravados no arquivo .CSV ‘Arquivo de endereços não alterados’ que será gerado pelo processo.

5) Além da gravação do histórico dos campos, será gravado no cliente um histórico indicando que foi realizada a busca e atualização dos dados do cliente pelo processo. Este histórico também poderá ser consultado na guia de histórico e será utilizado pelo processo para indicar se deve ser feita nova busca para o cliente, de acordo com o parâmetro ‘Número de meses para nova atualização’ da janela do processo.

6) Se o WebService retornar que o CNPJ está inativo, o cliente será bloqueado, utilizando o motivo de bloqueio informado na janela do processo. Será gerado um histórico no cliente indicando este bloqueio, que poderá ser consultado na guia ‘Histórico de Alterações’ da janela de cadastro do cliente (Janela de sigla CRCLED).

7) O cliente alterado será gravado no arquivo ‘Arquivo de clientes alterados’, que será gerado pelo processo.

8) Se ocorrer algum erro na atualização do cliente, o cliente e a mensagem de erro serão listados em um relatório que será gerado no final do processo, contendo as colunas Código, CNPJ e mensagem de erro.

9) Se o WebService de busca da inscrição estadual não localizar a inscrição do cliente na base centralizada disponibilizada pelo Rio Grande do Sul, a inscrição atual do cliente não será alterada, e será gerada uma crítica no relatório de erros ('Inscrição Estadual não localizada').

10) Arquivo de clientes alterados. Ao final do processo será gerado um arquivo CSV com os clientes alterados pelo processo, contendo as colunas:

1. Código do cliente
2. CNPJ do cliente
3. Razão Social
4. Endereço
5. CEP
6. Bairro
7. Cidade
8. Estado
9. Livre4 (Telefone)
10. Inscrição Estadual

Observações:
Os dados das colunas serão os novos dados dos campos, após a alteração.
Na primeira linha do arquivo será o gerado um cabeçalho com os nomes das colunas.

11) Arquivo de endereços não alterados. Ao final do processo será gerado um arquivo CSV com os endereços não alterados por limite de tamanho, contendo as colunas:

1. Código do cliente
2. CNPJ do cliente
3. Endereço atual
4. Endereço novo

Observação:
Na primeira linha do arquivo será o gerado um cabeçalho com os nomes das colunas.

12) Alterar rotina da busca de dados do WebService ReceitaWS para passar a buscar a situação do CNPJ, para permitir bloquear o cliente quando o CNPJ estiver inativo.

13) Foi criado nova função para busca da Inscrição Estadual na base centralizada do Rio Grande do Sul, a partir do CNPJ e estado do cliente, usando-se o endereço https://cad.svrs.rs.gov.br/ws/cadconsultacadastro/cadconsultacadastro4.asmx

Observação:
Para a utilização deste serviço de busca da inscrição estadual é exigido pela receita o uso do certificado digital. Este certificado pode ser o mesmo utilizado pela NFe. Com isto, o certificado deve estar instalado na máquina onde o processo será executado. Se o processo for agendado, ele deve estar instalado no servidor, na área da máquina do certificate store. O certificado a ser utilizado será obtido a partir da configuração de NFe da empresa logada.

Processo possui os campos (os campos com * ‘asterisco’ são de preenchimento obrigatório):

• Número de meses de inatividade: Número mínimo de meses de inatividades dos clientes que devem ser tratados pelo processo. *
  
  
• Número de meses para atualização: Número de meses mínimo para próxima atualização, desde a última vez que foi atualizado pelo processo. *
  
  
• Motivo de bloqueio de inatividade: Código de bloqueio a ser utilizado para bloquear os clientes com CNPJ inativo.

• Arquivo de clientes alterados: Nome do arquivo para gravar os clientes que tiveram dados alterados pelo processo.

• Arquivo de endereços não alterados: Nome do arquivo para gravar os clientes em que o endereço não foi alterado por ser maior que o campo no sistema.

• Certificado: Este campo será apenas de leitura e o usuário não poderá alterar. Ao abrir a janela, o sistema irá exibir neste campo o ID do certificado informado na janela de parâmetros de NF-e (janela de sigla NFEPARED).

Observação:

Os dados informados nos campos, com exceção do certificado, serão armazenados em banco de dados para serem exibidos quando a janela for aberta novamente.