[[ajuda:cadastro|{{ :ajuda:gsan-cadastro.png?nolink&200|}}]]
====== Filtrar Clientes para Validação a Base Receita Federal ======
<columns>
O objetivo desta funcionalidade é validar os clientes que possuem CPF/CNPJ, através da ferramenta de validação na base da Receita Federal, desprezando aqueles clientes que já foram validados. A funcionalidade pode ser acessada via **Menu de sistema**, no caminho: **[[:ajuda:pagina_inicial|GSAN]] > [[:ajuda:Cadastro]] > [[:ajuda:Cliente]] > Filtrar Clientes para Validação a Base Receita**.
</columns>

Feito isso, o sistema acessa a tela de filtro a seguir:

==== Observação ====
^Informamos que os dados exibidos nas telas a seguir são fictícios, e não retratam informações de clientes.^
<WRAP center round box 100%>
{{  :ajuda:cad_-_cliente_-_filtrarclientesvalidarrecfed_-_filtro.png?nolink  |}}
</WRAP>

<columns>
Informe o campo obrigatório **Validação** e os demais dados que julgar necessários. Depois, clique no botão {{:ajuda:arrecadacao:filtrar_1509.jpg?nolink|}}:

Caso esta funcionalidade seja chamada pela funcionalidade **Consultar Dados do Registro** (Webservice Gateway), não será apresentada mensagem para o usuário, e será aceito o nome do cliente que está na Receita Federal. No caso de alguma falha no serviço, o sistema retorna a descrição do erro para esta funcionalidade, para que seja apresentada.

Na tela de filtro, é possível escolher a validação por informar um CPF/CNPJ ou processar por um conjunto de clientes. 

A funcionalidade apresenta o(s) cliente(s) que serão validados na base da Receita Federal, que ainda não tenha(m) sido validado, desprezando os inativos e os clientes de órgãos públicos.

No caso de não ter sido informado o documento, a funcionalidade apresenta na lista até os 20 (vinte) primeiros clientes para serem atualizados.

Para cada cliente a ser processado, o sistema chama a funcionalidade **Consultar Dados do Registro** (Webservice Gateway), para validação. Caso retorne com informação, atualiza o CLIENTE com o nome cadastrado na Receita Federal e informa no relatório no campo de mensagem **Nome do Cliente Atualizado**; caso contrário, informa o **Código do Retorno – Descrição da Falha**.

Ao final do processamento o sistema gera o resultado da validação, conforme modelo de relatório visualizado **[[=ajuda:filtrar_clientes_para_validacao_a_base_receita_federal#modelorelatorio_de_validacao_dos_clientes_na_base_da_receita_federal_-_r7681|AQUI]]**.

Após a realização do filtro, o sistema exibe a tela abaixo, com base nos parâmetros informados. Para comandar a validação do CPF/CNPJ, clique no botão {{:ajuda:validar.png?nolink|}}.
</columns>

<WRAP center round box 100%>
{{  :ajuda:validacao_brf.jpg?nolink  |}}
</WRAP>

===== MODELO: RELATÓRIO DE VALIDAÇÃO DOS CLIENTES NA BASE DA RECEITA FEDERAL - R7681 ====
<WRAP center round box 100%>
{{  :ajuda:cad_-_cliente_-_filtrarclientesvalidarrecfed_-_r7681.png?nolink  |}}
</WRAP>

===== Tela de Sucesso =====
<WRAP center round box 100%>
{{  :ajuda:cad_-_cliente_-_filtrarclientesvalidarrecfed_-_telasucesso.png?nolink  |}}
</WRAP>


===== Preenchimento dos campos =====
^Campo^Orientações para Preenchimento^
|Validação|Campo obrigatório - Selecione uma das opções:\\ **Por Conjunto de Clientes**: nesta opção, os campos //CPF// e //CNPJ// são opcionais, ou\\ **Por Documento**: nesta opção é obrigatório informar o //CPF// ou //CNPJ//.|
|CPF|Informe o CPF que deseja validar.|
|CNPJ|Informe o CNPJ que deseja validar.|

===== Funcionalidade dos Botões =====
^Botão^Descrição da Funcionalidade^
|{{:ajuda:limpar.jpg?nolink|}}|Ao clicar neste botão, o sistema limpa o conteúdo da tela.|
|{{:ajuda:arrecadacao:filtrar_1509.jpg?nolink|}}|Ao clicar neste botão, o sistema comanda a execução do filtro com base nos parâmetros informados.|
|{{:ajuda:arrecadacao:b_cancelar_.jpg?nolink|}}|Ao clicar neste botão, o sistema cancela a operação e retorna à tela principal.|
|{{:ajuda:validar.png?nolink|}}|Ao clicar neste botão, o sistema comanda o processamento da validação dos registros filtrados.|

===== Referências =====

**Filtrar Clientes para Validação a Base Receita Federal**

==== Termos Principais ====

**[[=ajuda:cliente|Cliente]]**

\\   
\\
Clique **[[:ajuda|aqui]]** para retornar ao Menu Principal do GSAN