[[:ajuda|{{ :ajuda:gsan-faturamento.png?nolink&200|}}]]
====== Gerar TXT das Contas dos Projetos Especiais ======
<columns>
O objetivo desta funcionalidade é gerar um arquivo TXT das contas dos projetos especiais. Ela pode ser acessada via **Menu de Sistema**, mediante o caminho: **[[:ajuda:pagina_inicial|GSAN]] > [[:ajuda:Faturamento]] > Gerar TXT das Contas dos Projetos Especiais**.
</columns>

Feito isso, o sistema visualiza tela 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:y_gerar_txt_cpe.jpg?nolink  |}}
</WRAP>

<columns>
Acima, o sistema exibe a tela para que sejam informados: 
  * Mês/Ano de Referência;
  * Cliente.

O sistema pesquisa a fatura do cliente. Caso encontre a fatura do cliente, todos os itens são selecionados e o TXT é gerado. Caso contrário, será exibida a mensagem **Não existe dados para a geração do TXT**.

Para cada fatura selecionada, o sistema gera os dados para o TXT:
  * Código da Localidade;
  * Nome da Localidade/Escritório;
  * Matrícula do Imóvel;
  * Nome do Cliente Usuário;
  * Endereço do Imóvel;
  * Numero do Hidrômetro;
  * Ano/Mês de Referência da Fatura;
  * Consumo de água;
  * Valor da Fatura;
  * CPF;
  * Setor Comercial;
  * Grupo Faturamento.

Antes, porém, o sistema executa algumas validações:

  * Validar referência:
    * Caso a referência esteja inválida, será exibida a mensagem **Referência inválida**.
    * Caso o mês e ano de referência informado seja maior que o mês e o ano do faturamento, será exibida a mensagem **Mês/Ano de Referência deve ser menor ou  igual do que mês e ano atual de faturamento**.
  * Verificar se existe cliente: 
    * Caso o cliente seja igual ao informado, o sistema verifica se o cliente é Ativo; Caso contrário, exibe a mensagem **Cliente não existe**.
  * Verificar se o cliente é Ativo:
    * Caso o indicador de uso do cliente informado esteja como inativo no cadastro GSAN, será exibida a mensagem **Cliente inativo**.
  * Verificar sucesso da transação:
    * Caso o código de retorno da gravação do arquivo ou o código de retorno da operação efetuada no banco de dados seja diferente de zero, será exibida a mensagem conforme o código de retorno; caso contrário, exibe a mensagem **<<descrição da função>> efetuada com sucesso**.

Nome do arquivo texto

  * Formatado o nome do arquivo texto: formato XXXXXXXXAAAAMM.TXT onde:
    * XXXXXXXX – A ser definido;
    * AAAA – Ano de Referencia informado;
    * MM – Mes de Referencia informado;
    * TXT – Fixo TXT. 

Informe o mês/ano de referência, e o cliente, em seguida, clique no botão {{:ajuda:relatorios:arrecadacao:b_gerar.jpg?nolink|}}.
</columns>

====== Preenchimento dos Campos ======
^Campo^Preenchimento dos Campos^
|**Referência**|Campo obrigatório - Informe a referência do faturamento, no formato mm/aaaa (mês, ano).|
|**Cliente**|Campo obrigatório - Informe o código do cliente, ou clique no botão {{:ajuda:lupa.gif?nolink|}}, link **[[:ajuda:pesquisar_cliente|Pesquisar Cliente]]**, para selecionar o cliente desejado. O nome será exibido no campo ao lado.\\ Para apagar o conteúdo do campo, clique no botão {{:ajuda:borracha.gif?nolink|}} ao lado do campo em exibição.|

====== Funcionalidade dos Botões ======
^Botão^Descrição da Funcionalidade^
|{{:ajuda:lupa.gif?nolink|}}|Ao clicar neste botão, o sistema permite consultar um dado na base de dados.|
|{{:ajuda:borracha.gif?nolink|}}|Ao clicar neste botão, o sistema apaga o conteúdo do campo em exibição.|
|{{:ajuda:limpar.jpg?nolink|}}|Ao clicar neste botão, o sistema limpa o conteúdo dos campos na tela.|
|{{:ajuda:relatorios:arrecadacao:b_gerar.jpg?nolink|}}|Ao clicar neste botão, o sistema comanda a geração do TXT das contas dos projetos especiais.|

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

**[[=postgres:faturamento:uc0972|Gerar TXT das Contas dos Projetos Especiais]]**

==== Termos Principais ====

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